koffi 3.0.1 → 3.1.0

package/vendor/node-addon-api/napi.h

@@ -17,7 +17,9 @@
 #if NAPI_HAS_THREADS
 #include <mutex>
 #endif  // NAPI_HAS_THREADS
+#include <chrono>
 #include <string>
+#include <string_view>
 #include <vector>
 
 // VS2015 RTM has bugs with constexpr, so require min of VS2015 Update 3 (known
@@ -359,10 +361,10 @@ class BasicEnv {
   // ... occurs when comparing foo.Env() == bar.Env() or foo.Env() == nullptr
   bool operator==(const BasicEnv& other) const {
     return _env == other._env;
-  };
+  }
   bool operator==(std::nullptr_t /*other*/) const {
     return _env == nullptr;
-  };
+  }
 
 #if NAPI_VERSION > 2
   template <typename Hook, typename Arg = void>
@@ -543,6 +545,9 @@ class Value {
   bool IsDataView() const;    ///< Tests if a value is a JavaScript data view.
   bool IsBuffer() const;      ///< Tests if a value is a Node buffer.
   bool IsExternal() const;  ///< Tests if a value is a pointer to external data.
+#ifdef NODE_API_EXPERIMENTAL_HAS_SHAREDARRAYBUFFER
+  bool IsSharedArrayBuffer() const;
+#endif
 
   /// Casts to another type of `Napi::Value`, when the actual type is known or
   /// assumed.
@@ -682,6 +687,12 @@ class Date : public Value {
                   double value   ///< Number value
   );
 
+  /// Creates a new Date value from a std::chrono::system_clock::time_point.
+  static Date New(
+      napi_env env,  ///< Node-API environment
+      std::chrono::system_clock::time_point time_point  ///< Time point value
+  );
+
   static void CheckCast(napi_env env, napi_value value);
 
   Date();  ///< Creates a new _empty_ Date instance.
@@ -715,6 +726,11 @@ class String : public Name {
                     const std::u16string& value  ///< UTF-16 encoded C++ string
   );
 
+  /// Creates a new String value from a UTF-8 encoded C++ string view.
+  static String New(napi_env env,           ///< Node-API environment
+                    std::string_view value  ///< UTF-8 encoded C++ string view
+  );
+
   /// Creates a new String value from a UTF-8 encoded C string.
   static String New(
       napi_env env,      ///< Node-API environment
@@ -788,6 +804,13 @@ class Symbol : public Name {
           description  ///< UTF-8 encoded C++ string describing the symbol
   );
 
+  /// Creates a new Symbol value with a description.
+  static Symbol New(
+      napi_env env,  ///< Node-API environment
+      std::string_view
+          description  ///< UTF-8 encoded C++ string view describing the symbol
+  );
+
   /// Creates a new Symbol value with a description.
   static Symbol New(napi_env env,       ///< Node-API environment
                     String description  ///< String value describing the symbol
@@ -805,6 +828,9 @@ class Symbol : public Name {
   // Create a symbol in the global registry, UTF-8 Encoded cpp string
   static MaybeOrValue<Symbol> For(napi_env env, const std::string& description);
 
+  // Create a symbol in the global registry, UTF-8 encoded cpp string view
+  static MaybeOrValue<Symbol> For(napi_env env, std::string_view description);
+
   // Create a symbol in the global registry, C style string (null terminated)
   static MaybeOrValue<Symbol> For(napi_env env, const char* description);
 
@@ -1115,6 +1141,12 @@ class Object : public TypeTaggable {
   /// https://tc39.es/ecma262/#sec-proxy-object-internal-methods-and-internal-slots-getprototypeof
   MaybeOrValue<bool> Seal() const;
 #endif  // NAPI_VERSION >= 8
+
+  MaybeOrValue<Object> GetPrototype() const;
+
+#ifdef NODE_API_EXPERIMENTAL_HAS_SET_PROTOTYPE
+  MaybeOrValue<bool> SetPrototype(const Object& value) const;
+#endif
 };
 
 template <typename T>
@@ -1202,6 +1234,21 @@ class Object::iterator {
 };
 #endif  // NODE_ADDON_API_CPP_EXCEPTIONS
 
+#ifdef NODE_API_EXPERIMENTAL_HAS_SHAREDARRAYBUFFER
+class SharedArrayBuffer : public Object {
+ public:
+  SharedArrayBuffer();
+  SharedArrayBuffer(napi_env env, napi_value value);
+
+  static SharedArrayBuffer New(napi_env env, size_t byteLength);
+
+  static void CheckCast(napi_env env, napi_value value);
+
+  void* Data();
+  size_t ByteLength();
+};
+#endif
+
 /// A JavaScript array buffer value.
 class ArrayBuffer : public Object {
  public:
@@ -1292,7 +1339,21 @@ class TypedArray : public Object {
 
   napi_typedarray_type TypedArrayType()
       const;  ///< Gets the type of this typed-array.
-  Napi::ArrayBuffer ArrayBuffer() const;  ///< Gets the backing array buffer.
+
+  // Gets the backing `ArrayBuffer`.
+  //
+  // If this `TypedArray` is not backed by an `ArrayBuffer`, this method will
+  // terminate the process with a fatal error when using
+  // `NODE_ADDON_API_ENABLE_TYPE_CHECK_ON_AS` or exhibit undefined behavior
+  // otherwise. Use `Buffer()` instead to get the backing buffer without
+  // assuming its type.
+  Napi::ArrayBuffer ArrayBuffer() const;
+
+  // Gets the backing buffer (an `ArrayBuffer` or `SharedArrayBuffer`).
+  //
+  // Use `IsArrayBuffer()` or `IsSharedArrayBuffer()` to check the type of the
+  // backing buffer prior to casting with `As<T>()`.
+  Napi::Value Buffer() const;
 
   uint8_t ElementSize()
       const;  ///< Gets the size in bytes of one element in the array.
@@ -1386,6 +1447,32 @@ class TypedArrayOf : public TypedArray {
       ///< template parameter T.
   );
 
+#ifdef NODE_API_EXPERIMENTAL_HAS_SHAREDARRAYBUFFER
+  /// Creates a new TypedArray instance over a provided SharedArrayBuffer.
+  ///
+  /// The array type parameter can normally be omitted (because it is inferred
+  /// from the template parameter T), except when creating a "clamped" array:
+  ///
+  ///     Uint8Array::New(env, length, buffer, 0, napi_uint8_clamped_array)
+  static TypedArrayOf New(
+      napi_env env,          ///< Node-API environment
+      size_t elementLength,  ///< Length of the created array, as a number of
+                             ///< elements
+      Napi::SharedArrayBuffer
+          arrayBuffer,      ///< Backing shared array buffer instance to use
+      size_t bufferOffset,  ///< Offset into the array buffer where the
+                            ///< typed-array starts
+#if defined(NAPI_HAS_CONSTEXPR)
+      napi_typedarray_type type =
+          TypedArray::TypedArrayTypeForPrimitiveType<T>()
+#else
+      napi_typedarray_type type
+#endif
+      ///< Type of array, if different from the default array type for the
+      ///< template parameter T.
+  );
+#endif
+
   static void CheckCast(napi_env env, napi_value value);
 
   TypedArrayOf();  ///< Creates a new _empty_ TypedArrayOf instance.
@@ -1432,13 +1519,37 @@ class DataView : public Object {
                       size_t byteOffset,
                       size_t byteLength);
 
+#ifdef NODE_API_EXPERIMENTAL_HAS_SHAREDARRAYBUFFER
+  static DataView New(napi_env env, Napi::SharedArrayBuffer arrayBuffer);
+  static DataView New(napi_env env,
+                      Napi::SharedArrayBuffer arrayBuffer,
+                      size_t byteOffset);
+  static DataView New(napi_env env,
+                      Napi::SharedArrayBuffer arrayBuffer,
+                      size_t byteOffset,
+                      size_t byteLength);
+#endif
+
   static void CheckCast(napi_env env, napi_value value);
 
   DataView();  ///< Creates a new _empty_ DataView instance.
   DataView(napi_env env,
            napi_value value);  ///< Wraps a Node-API value primitive.
 
-  Napi::ArrayBuffer ArrayBuffer() const;  ///< Gets the backing array buffer.
+  // Gets the backing `ArrayBuffer`.
+  //
+  // If this `DataView` is not backed by an `ArrayBuffer`, this method will
+  // terminate the process with a fatal error when using
+  // `NODE_ADDON_API_ENABLE_TYPE_CHECK_ON_AS` or exhibit undefined behavior
+  // otherwise. Use `Buffer()` instead to get the backing buffer without
+  // assuming its type.
+  Napi::ArrayBuffer ArrayBuffer() const;
+
+  // Gets the backing buffer (an `ArrayBuffer` or `SharedArrayBuffer`).
+  //
+  // Use `IsArrayBuffer()` or `IsSharedArrayBuffer()` to check the type of the
+  // backing buffer prior to casting with `As<T>()`.
+  Napi::Value Buffer() const;
   size_t ByteOffset()
       const;  ///< Gets the offset into the buffer where the array starts.
   size_t ByteLength() const;  ///< Gets the length of the array in bytes.
@@ -1715,7 +1826,7 @@ class ObjectReference : public Reference<Object> {
   MaybeOrValue<bool> Set(const std::string& utf8name, napi_value value) const;
   MaybeOrValue<bool> Set(const std::string& utf8name, Napi::Value value) const;
   MaybeOrValue<bool> Set(const std::string& utf8name,
-                         std::string& utf8value) const;
+                         const std::string& utf8value) const;
   MaybeOrValue<bool> Set(const std::string& utf8name, bool boolValue) const;
   MaybeOrValue<bool> Set(const std::string& utf8name, double numberValue) const;
 
@@ -3109,8 +3220,8 @@ class AsyncProgressWorkerBase : public AsyncWorker {
 
     AsyncProgressWorkerBase* asyncprogressworker() {
       return _asyncprogressworker;
-    };
-    DataType* data() { return _data; };
+    }
+    DataType* data() { return _data; }
 
    private:
     AsyncProgressWorkerBase* _asyncprogressworker;

package/doc/variables.md

@@ -1,102 +0,0 @@
-# Variable definitions
-
-*New in Koffi 2.6*
-
-To find an exported and  declare a variable, use `lib.symbol(name, type)`. You need to specify its name and its type.
-
-```c
-int my_int = 42;
-const char *my_string = NULL;
-```
-
-```js
-const my_int = lib.symbol('my_int', 'int');
-const my_string = lib.symbol('my_string', 'const char *');
-```
-
-You cannot directly manipulate these variables, use:
-
-- [koffi.decode()](#decode-to-js-values) to read their value
-- [koffi.encode()](#encode-to-c-memory) to change their value
-
-# Decode to JS values
-
-*New in Koffi 2.2, changed in Koffi 2.3*
-
-Use `koffi.decode()` to decode C pointers, represented by BigInt numbers.
-
-Some arguments are optional and this function can be called in several ways:
-
-- `koffi.decode(value, type)`: no offset
-- `koffi.decode(value, offset, type)`: explicit offset to add to the pointer before decoding
-
-By default, Koffi expects NUL terminated strings when decoding them. See below if you need to specify the string length.
-
-The following example illustrates how to decode an integer and a C string variable.
-
-```c
-int my_int = 42;
-const char *my_string = "foobar";
-```
-
-```js
-const my_int = lib.symbol('my_int', 'int');
-const my_string = lib.symbol('my_string', 'const char *');
-
-console.log(koffi.decode(my_int, 'int')) // Prints 42
-console.log(koffi.decode(my_string, 'const char *')) // Prints "foobar"
-```
-
-There is also an optional ending `length` argument that you can use in two cases:
-
-- Use it to give the number of bytes to decode in non-NUL terminated strings: `koffi.decode(value, 'char *', 5)`
-- Decode consecutive values into an array. For example, here is how you can decode an array with 3 float values: `koffi.decode(value, 'float', 3)`. This is equivalent to `koffi.decode(value, koffi.array('float', 3))`.
-
-The example below will decode the symbol `my_string` defined above but only the first three bytes.
-
-```js
-// Only decode 3 bytes from the C string my_string
-console.log(koffi.decode(my_string, 'const char *', 3)) // Prints "foo"
-```
-
-> [!NOTE]
-> In Koffi 2.2 and earlier versions, the length argument is only used to decode strings and is ignored otherwise.
-
-# Encode to C memory
-
-*New in Koffi 2.6*
-
-Use `koffi.encode()` to encode JS values into C symbols or pointers, which are represented by BigInt numbers.
-
-Some arguments are optional and this function can be called in several ways:
-
-- `koffi.encode(ptr, type, value)`: no offset
-- `koffi.encode(ptr, offset, type, value)`: explicit offset to add to the pointer before encoding
-
-We'll reuse the examples shown above and change the variable values with `koffi.encode()`.
-
-```c
-int my_int = 42;
-const char *my_string = NULL;
-```
-
-```js
-const my_int = lib.symbol('my_int', 'int');
-const my_string = lib.symbol('my_string', 'const char *');
-
-console.log(koffi.decode(my_int, 'int')) // Prints 42
-console.log(koffi.decode(my_string, 'const char *')) // Prints null
-
-koffi.encode(my_int, 'int', -1);
-koffi.encode(my_string, 'const char *', 'Hello World!');
-
-console.log(koffi.decode(my_int, 'int')) // Prints -1
-console.log(koffi.decode(my_string, 'const char *')) // Prints "Hello World!"
-```
-
-When encoding strings (either directly or embedded in arrays or structs), the memory will be bound to the raw pointer value and managed by Koffi. You can assign to the same string again and again without any leak or risk of use-after-free.
-
-There is also an optional ending `length` argument that you can use to encode an array. For example, here is how you can encode an array with 3 float values: `koffi.encode(symbol, 'float', [1, 2, 3], 3)`. This is equivalent to `koffi.encode(symbol, koffi.array('float', 3), [1, 2, 3])`.
-
-> [!NOTE]
-> The length argument did not work correctly before Koffi 2.6.11.

package/indirect.d.ts

@@ -1,322 +0,0 @@
-// SPDX-License-Identifier: MIT
-// SPDX-FileCopyrightText: 2026 Niels Martignène <niels.martignene@protonmail.com>
-
-declare module "koffi/indirect" {
-    type PrimitiveKind = 'Void' | 'Bool' | 'Int8' | 'UInt8' | 'Int16' | 'Int16S' | 'UInt16' | 'UInt16S' |
-                         'Int32' | 'Int32S' | 'UInt32' | 'UInt32S' | 'Int64' | 'Int64S' | 'UInt64' | 'UInt64S' |
-                         'String' | 'String16' | 'Pointer' | 'Record' | 'Union' | 'Array' | 'Float32' | 'Float64' |
-                         'Prototype' | 'Callback';
-    type ArrayHint = 'Array' | 'Typed' | 'String';
-
-    type PrototypeInfo = {
-        name: string;
-        arguments: TypeObject[];
-        result: TypeObject
-    };
-
-    interface IKoffiDirectionMarker { __brand: 'IKoffiDirectionMarker' }
-    interface IKoffiPointerCast { __brand: 'IKoffiPointerCast' }
-
-    export type TypeObject = {
-        name: string;
-        primitive: PrimitiveKind;
-        size: number;
-        alignment: number;
-        disposable: boolean;
-        length?: number;
-        hint?: ArrayHint;
-        ref?: TypeObject;
-        members?: Record<string, { name: string, type: TypeObject, offset: number }>;
-        proto?: PrototypeInfo;
-        values?: Record<string, number | bigint>;
-    };
-
-    type TypeSpec = string | TypeObject | IKoffiDirectionMarker;
-    type TypeSpecWithAlignment = TypeSpec | [number, TypeSpec];
-
-    type KoffiFunction = {
-        (...args: any[]) : any;
-        async: (...args: any[]) => any;
-        info: PrototypeInfo;
-    };
-    export type KoffiFunc<T extends (...args: any) => any> = T & {
-       async: (...args: [...Parameters<T>, (err: any, result: ReturnType<T>) => void]) => void;
-       info: PrototypeInfo;
-    };
-
-    type LoadOptions = {
-        lazy?: boolean,
-        global?: boolean,
-        deep?: boolean
-    };
-
-    export type LibraryHandle = {
-        func(definition: string): KoffiFunction;
-        func(name: string | number, result: TypeSpec, arguments: TypeSpec[]): KoffiFunction;
-        func(convention: string, name: string | number, result: TypeSpec, arguments: TypeSpec[]): KoffiFunction;
-
-        /** @deprecated */ cdecl(definition: string): KoffiFunction;
-        /** @deprecated */ cdecl(name: string | number, result: TypeSpec, arguments: TypeSpec[]): KoffiFunction;
-        /** @deprecated */ stdcall(definition: string): KoffiFunction;
-        /** @deprecated */ stdcall(name: string | number, result: TypeSpec, arguments: TypeSpec[]): KoffiFunction;
-        /** @deprecated */ fastcall(definition: string): KoffiFunction;
-        /** @deprecated */ fastcall(name: string | number, result: TypeSpec, arguments: TypeSpec[]): KoffiFunction;
-        /** @deprecated */ thiscall(definition: string): KoffiFunction;
-        /** @deprecated */ thiscall(name: string | number, result: TypeSpec, arguments: TypeSpec[]): KoffiFunction;
-
-        symbol(name: string, type: TypeSpec): any;
-
-        unload(): void;
-    };
-
-    export function load(path: string | null, options?: LoadOptions): LibraryHandle;
-
-    export function struct(name: string | null | undefined, def: Record<string, TypeSpecWithAlignment>): TypeObject;
-    export function struct(ref: TypeObject, def: Record<string, TypeSpecWithAlignment>): TypeObject;
-    export function struct(def: Record<string, TypeSpecWithAlignment>): TypeObject;
-    export function pack(name: string | null | undefined, def: Record<string, TypeSpecWithAlignment>): TypeObject;
-    export function pack(ref: TypeObject, def: Record<string, TypeSpecWithAlignment>): TypeObject;
-    export function pack(def: Record<string, TypeSpecWithAlignment>): TypeObject;
-
-    export function union(name: string | null | undefined, def: Record<string, TypeSpecWithAlignment>): TypeObject;
-    export function union(ref: TypeObject, def: Record<string, TypeSpecWithAlignment>): TypeObject;
-    export function union(def: Record<string, TypeSpecWithAlignment>): TypeObject;
-
-    export class Union {
-        constructor(type: TypeSpec);
-        [s: string]: any;
-    }
-
-    export function enumeration(name: string | null | undefined, def: Record<string, number | bigint>, storage?: TypeSpec | null) : TypeObject;
-    export function enumeration(def: Record<string, number | bigint>, storage?: TypeSpec | null) : TypeObject;
-
-    export function array(ref: TypeSpec, len: number, hint?: ArrayHint | null): TypeObject;
-    export function array(ref: TypeSpec, countedBy: string, maxLen: number, hint?: ArrayHint | null): TypeObject;
-
-    export function opaque(name: string | null | undefined): TypeObject;
-    export function opaque(): TypeObject;
-
-    export function pointer(ref: TypeSpec): TypeObject;
-    export function pointer(ref: TypeSpec, count: number): TypeObject;
-    export function pointer(name: string | null | undefined, ref: TypeSpec, countedBy?: string | null): TypeObject;
-    export function pointer(name: string | null | undefined, ref: TypeSpec, count: number): TypeObject;
-
-    export function out(type: TypeSpec): IKoffiDirectionMarker;
-    export function inout(type: TypeSpec): IKoffiDirectionMarker;
-
-    export function disposable(type: TypeSpec): TypeObject;
-    export function disposable(type: TypeSpec, freeFunction: Function): TypeObject;
-    export function disposable(name: string | null | undefined, type: TypeSpec): TypeObject;
-    export function disposable(name: string | null | undefined, type: TypeSpec, freeFunction: Function): TypeObject;
-
-    export function proto(definition: string): TypeObject;
-    export function proto(result: TypeSpec, arguments: TypeSpec[]): TypeObject;
-    export function proto(convention: string, result: TypeSpec, arguments: TypeSpec[]): TypeObject;
-    export function proto(name: string | null | undefined, result: TypeSpec, arguments: TypeSpec[]): TypeObject;
-    export function proto(convention: string, name: string | null | undefined, result: TypeSpec, arguments: TypeSpec[]): TypeObject;
-
-    export function register(callback: Function, type: TypeSpec): bigint;
-    /** @deprecated */ export function register(thisValue: any, callback: Function, type: TypeSpec): bigint;
-    export function unregister(callback: bigint): void;
-
-    export function as(value: any, type: TypeSpec): IKoffiPointerCast;
-    export function address(value: any): bigint;
-    export function call(value: any, type: TypeSpec, ...args: any[]): any;
-    export function view(ref: any, len: number): ArrayBuffer;
-
-    export const decode: {
-        (value: any, type: TypeSpec): any;
-        (value: any, type: TypeSpec, len: number): any;
-        (value: any, offset: number, type: TypeSpec): any;
-        (value: any, offset: number, type: TypeSpec, len: number): any;
-
-        char(ptr: any): number;
-        short(ptr: any): number;
-        int(ptr: any): number;
-        long(ptr: any): number | bigint;
-        longlong(ptr: any): number | bigint;
-        uchar(ptr: any): number;
-        ushort(ptr: any): number;
-        uint(ptr: any): number;
-        ulong(ptr: any): number | bigint;
-        ulonglong(ptr: any): number | bigint;
-
-        int8(ptr: any): number;
-        int16(ptr: any): number;
-        int32(ptr: any): number;
-        int64(ptr: any): number | bigint;
-        uint8(ptr: any): number;
-        uint16(ptr: any): number;
-        uint32(ptr: any): number;
-        uint64(ptr: any): number | bigint;
-
-        float(ptr: any): number;
-        double(ptr: any): number;
-
-        string(ptr: any, length?: number | bigint | null): string;
-        string16(ptr: any, length?: number | bigint | null): string;
-        string32(ptr: any, length?: number | bigint | null): string;
-    };
-
-    export function encode(ref: any, type: TypeSpec, value: any): void;
-    export function encode(ref: any, type: TypeSpec, value: any, len: number): void;
-    export function encode(ref: any, offset: number, type: TypeSpec): void;
-    export function encode(ref: any, offset: number, type: TypeSpec, value: any): void;
-    export function encode(ref: any, offset: number, type: TypeSpec, value: any, len: number): void;
-
-    export function type(type: TypeSpec): TypeObject;
-    export function sizeof(type: TypeSpec): number;
-    export function alignof(type: TypeSpec): number;
-    export function offsetof(type: TypeSpec, member_name: string): number;
-    /** @deprecated */ export function resolve(type: TypeSpec): TypeObject;
-    /** @deprecated */ export function introspect(type: TypeSpec): TypeObject;
-
-    export function alias(name: string, type: TypeSpec): TypeObject;
-
-    type KoffiConfig = {
-        sync_stack_size?: number;
-        sync_heap_size?: number;
-        async_stack_size?: number;
-        async_heap_size?: number;
-        resident_async_pools?: number;
-        max_async_calls?: number;
-        max_type_size?: number;
-    };
-    type KoffiStats = {
-        disposed: number
-    };
-
-    export function config(): KoffiConfig;
-    export function config(cfg: KoffiConfig): KoffiConfig;
-    export function stats(): KoffiStats;
-
-    export function alloc(type: TypeSpec, length: number): any;
-    export function free(value: any): void;
-
-    export function errno(): number;
-    export function errno(value: number): number;
-
-    export function reset(): void;
-
-    export const internal: boolean;
-    export const extension: string;
-
-    export const os: {
-        errno: Record<string, number>
-    };
-
-    // https://koffi.dev/input#standard-types
-    type PrimitiveTypes =
-        | 'bool'
-        | 'char'
-        | 'char16_t'
-        | 'char16'
-        | 'char32_t'
-        | 'char32'
-        | 'double'
-        | 'float'
-        | 'float32'
-        | 'float64'
-        | 'int'
-        | 'int8_t'
-        | 'int8'
-        | 'int16_be_t'
-        | 'int16_be'
-        | 'int16_le_t'
-        | 'int16_le'
-        | 'int16_t'
-        | 'int16'
-        | 'int32_be_t'
-        | 'int32_be'
-        | 'int32_le_t'
-        | 'int32_le'
-        | 'int32_t'
-        | 'int32'
-        | 'int64_be_t'
-        | 'int64_be'
-        | 'int64_le_t'
-        | 'int64_le'
-        | 'int64_t'
-        | 'int64'
-        | 'intptr_t'
-        | 'intptr'
-        | 'long long'
-        | 'long'
-        | 'longlong'
-        | 'short'
-        | 'size_t'
-        | 'str'
-        | 'str16'
-        | 'str32'
-        | 'string'
-        | 'string16'
-        | 'string32'
-        | 'uchar'
-        | 'uint'
-        | 'uint8_t'
-        | 'uint8'
-        | 'uint16_be_t'
-        | 'uint16_be'
-        | 'uint16_le_t'
-        | 'uint16_le'
-        | 'uint16_t'
-        | 'uint16'
-        | 'uint32_be_t'
-        | 'uint32_be'
-        | 'uint32_le_t'
-        | 'uint32_le'
-        | 'uint32_t'
-        | 'uint32'
-        | 'uint64_be_t'
-        | 'uint64_be'
-        | 'uint64_le_t'
-        | 'uint64_le'
-        | 'uint64_t'
-        | 'uint64'
-        | 'uintptr_t'
-        | 'uintptr'
-        | 'ulong'
-        | 'ulonglong'
-        | 'unsigned char'
-        | 'unsigned int'
-        | 'unsigned long long'
-        | 'unsigned long'
-        | 'unsigned short'
-        | 'ushort'
-        | 'void'
-        | 'wchar'
-        | 'wchar_t';
-    export const types: Record<PrimitiveTypes, TypeObject>;
-
-    export namespace node {
-        export const env: { __brand: 'IKoffiNodeEnv' };
-
-        type PollOptions = {
-            readable?: boolean;
-            writable?: boolean;
-            disconnect?: boolean;
-        };
-
-        type PollEvents = {
-            readable: boolean;
-            writable: boolean;
-            disconnect: boolean;
-        };
-
-        export class PollHandle {
-            start(opts: PollOptions, callback: (ev: PollEvents) => void): void;
-            start(callback: (ev: PollEvents) => void): void;
-            stop(): void;
-
-            close(): void;
-
-            unref(): void;
-            ref(): void;
-        }
-
-        export function poll(fd: number, opts: PollOptions, callback: (ev: PollEvents) => void): PollHandle;
-        export function poll(fd: number, callback: (ev: PollEvents) => void): PollHandle;
-    }
-
-    export const version: string;
-}