@bun-win32/secur32
v3.0.0
Published
Zero-dependency, zero-overhead Win32 SECUR32 bindings for Bun (FFI) on Windows.
Maintainers
Readme
@bun-win32/secur32
Zero-dependency, zero-overhead Win32 Secur32 bindings for Bun on Windows.
Overview
@bun-win32/secur32 exposes the secur32.dll exports using Bun's FFI. It provides a single class, Secur32, which lazily binds native symbols on first use. You can optionally preload a subset or all symbols up-front via Preload().
The bindings are strongly typed for a smooth DX in TypeScript.
Features
- Bun-first ergonomics on Windows 10/11.
- Direct FFI to
secur32.dll(SSPI authentication, credential management, security context negotiation, LSA logon sessions, SASL, and more). - In-source docs in
structs/Secur32.tswith links to Microsoft Docs. - Lazy binding on first call; optional eager preload (
Secur32.Preload()). - No wrapper overhead; calls map 1:1 to native APIs.
- Strongly-typed Win32 aliases (see
types/Secur32.ts).
Requirements
- Bun runtime
- Windows 10 or later
Installation
bun add @bun-win32/secur32Quick Start
import Secur32 from '@bun-win32/secur32';
// Optionally bind a subset up-front
Secur32.Preload(['InitSecurityInterfaceW', 'FreeContextBuffer']);
// Get the SSPI function table
const table = Secur32.InitSecurityInterfaceW();
console.log('SSPI function table:', Boolean(table));
// Connect to LSA
const hLsa = Buffer.alloc(8);
const status = Secur32.LsaConnectUntrusted(hLsa.ptr);
console.log('LsaConnectUntrusted:', status);[!NOTE] AI agents: see
AI.mdfor the package binding contract and source-navigation guidance. It explains how to use the package without scanning the entire implementation.
Examples
Run the included examples:
bun run example # SSPI function table + LSA connectionNotes
- Either rely on lazy binding or call
Secur32.Preload(). - Windows only. Bun runtime required.
- SAL types & naming: nullability is in the type —
Optional<T>(formally optional, SAL_*opt_) andNullable<T>(plain[in]/[out]the docs say can be NULL), the null sentinel derived fromT(nullfor pointersLP*/P*,0nfor handles/by-value addresses); direction is in the parameter name —_out(_Out_),_in_out(_Inout_),_In_bare. SeeAI.mdand the repoAGENTS.md.
