{"_id":"@bun-win32/dbghelp","_rev":"5-d2c6b9dd9be193803c9bd70f2d44fa07","name":"@bun-win32/dbghelp","dist-tags":{"latest":"2.0.1"},"versions":{"1.0.0":{"name":"@bun-win32/dbghelp","version":"1.0.0","keywords":["bun","ffi","win32","windows","dbghelp","bindings","typescript","dll"],"author":"Stev Peifer ","license":"MIT","_id":"@bun-win32/dbghelp@1.0.0","maintainers":[{"name":"obscuritysrl","email":"stev@bell.net"}],"homepage":"https://github.com/ObscuritySRL/bun-win32#readme","bugs":{"url":"https://github.com/ObscuritySRL/bun-win32/issues"},"dist":{"shasum":"fbbea724ab06885abec622398ed60aae3cae4ba0","tarball":"https://registry.npmjs.org/@bun-win32/dbghelp/-/dbghelp-1.0.0.tgz","fileCount":6,"integrity":"sha512-1Y4+dkg08UTnnDr0yBATxo4iDciPnp4fceJO5/Gw4w0VBuxEoXDNnLsct1svmW0C4dYf3bJhTxazGXPZXgo2Cw==","signatures":[{"sig":"MEYCIQC7+gUGKWuiGfV7z8/gGaFwH5pbPD1aTY+hnT6Quj5ppQIhAJ90d+djhev445k2DWDaOzZHQmjJTMBIIjZU5yCvdr/A","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88257},"main":"./index.ts","type":"module","module":"index.ts","shasum":"fbbea724ab06885abec622398ed60aae3cae4ba0","engines":{"bun":">=1.1.0"},"exports":{".":"./index.ts"},"private":false,"scripts":{"example:crash-report":"bun ./example/crash-report.ts","example:symbol-explorer":"bun ./example/symbol-explorer.ts"},"_npmUser":{"name":"obscuritysrl","email":"stev@bell.net"},"_integrity":"sha512-1Y4+dkg08UTnnDr0yBATxo4iDciPnp4fceJO5/Gw4w0VBuxEoXDNnLsct1svmW0C4dYf3bJhTxazGXPZXgo2Cw==","repository":{"url":"git://github.com/ObscuritySRL/bun-win32.git","type":"git","directory":"packages/dbghelp"},"_npmVersion":"10.8.3","description":"Zero-dependency, zero-overhead Win32 DBGHELP bindings for Bun (FFI) on Windows.","directories":{},"sideEffects":false,"_nodeVersion":"24.3.0","dependencies":{"@bun-win32/core":"1.1.2"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/dbghelp_1.0.0_1775784229153_0.09575724862863888","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bun-win32/dbghelp","version":"1.0.1","keywords":["bun","ffi","win32","windows","dbghelp","bindings","typescript","dll"],"author":"Stev Peifer ","license":"MIT","_id":"@bun-win32/dbghelp@1.0.1","maintainers":[{"name":"obscuritysrl","email":"stev@bell.net"}],"homepage":"https://github.com/ObscuritySRL/bun-win32#readme","bugs":{"url":"https://github.com/ObscuritySRL/bun-win32/issues"},"dist":{"shasum":"2b6c0f58f5e15028fc696234105dc04b988275f6","tarball":"https://registry.npmjs.org/@bun-win32/dbghelp/-/dbghelp-1.0.1.tgz","fileCount":6,"integrity":"sha512-CI/hramfuJ41I4Xkx78IAMwvNsCUSRfr3P+b/OXroKbgqR2nXkp3aOtvq5S10/sk2MtZvCDaSwL4d82Y0JSaaQ==","signatures":[{"sig":"MEUCIDrl/V3s9793YDQ1i4wLZ38LpHjpeatlFtDGVa9WEM/kAiEAufaShP3CnT+nq6UeoS+s/ECAWfOK4dXChNK+/7hdT8A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88277},"main":"./index.ts","type":"module","module":"index.ts","shasum":"2b6c0f58f5e15028fc696234105dc04b988275f6","engines":{"bun":">=1.1.0"},"exports":{".":"./index.ts"},"private":false,"scripts":{"example:crash-report":"bun ./example/crash-report.ts","example:symbol-explorer":"bun ./example/symbol-explorer.ts"},"_npmUser":{"name":"obscuritysrl","email":"stev@bell.net"},"_integrity":"sha512-CI/hramfuJ41I4Xkx78IAMwvNsCUSRfr3P+b/OXroKbgqR2nXkp3aOtvq5S10/sk2MtZvCDaSwL4d82Y0JSaaQ==","repository":{"url":"git://github.com/ObscuritySRL/bun-win32.git","type":"git","directory":"packages/dbghelp"},"_npmVersion":"10.8.3","description":"Zero-dependency, zero-overhead Win32 DBGHELP bindings for Bun (FFI) on Windows.","directories":{},"sideEffects":false,"_nodeVersion":"24.3.0","dependencies":{"@bun-win32/core":"1.1.2"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/dbghelp_1.0.1_1780581901132_0.7504579483102527","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@bun-win32/dbghelp","version":"1.0.2","keywords":["bun","ffi","win32","windows","dbghelp","bindings","typescript","dll"],"author":"Stev Peifer ","license":"MIT","_id":"@bun-win32/dbghelp@1.0.2","maintainers":[{"name":"obscuritysrl","email":"stev@bell.net"}],"homepage":"https://github.com/ObscuritySRL/bun-win32#readme","bugs":{"url":"https://github.com/ObscuritySRL/bun-win32/issues"},"dist":{"shasum":"8daa8fa13373d51704c57289ee0546443d67f528","tarball":"https://registry.npmjs.org/@bun-win32/dbghelp/-/dbghelp-1.0.2.tgz","fileCount":6,"integrity":"sha512-X21VxPg2Bqnsn6wIAs3K5TKRAIq7UEI1A4jPyssCjeekaPgKUQW5GVZYktHUlfefj7AmZrjUikHh5wr3vK2qgA==","signatures":[{"sig":"MEUCIGJzZfNeLmIGc656x0X23s/tmt5ukz7cCcQq+eTWLQM/AiEA+n+HVFAoTzCAdVD6LxEi78NeBATUpEDI7PZT6zOo2eA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89755},"main":"./index.ts","type":"module","module":"index.ts","shasum":"8daa8fa13373d51704c57289ee0546443d67f528","engines":{"bun":">=1.1.0"},"exports":{".":"./index.ts"},"private":false,"scripts":{"example:crash-report":"bun ./example/crash-report.ts","example:symbol-explorer":"bun ./example/symbol-explorer.ts"},"_npmUser":{"name":"obscuritysrl","email":"stev@bell.net"},"_integrity":"sha512-X21VxPg2Bqnsn6wIAs3K5TKRAIq7UEI1A4jPyssCjeekaPgKUQW5GVZYktHUlfefj7AmZrjUikHh5wr3vK2qgA==","repository":{"url":"git://github.com/ObscuritySRL/bun-win32.git","type":"git","directory":"packages/dbghelp"},"_npmVersion":"10.8.3","description":"Zero-dependency, zero-overhead Win32 DBGHELP bindings for Bun (FFI) on Windows.","directories":{},"sideEffects":false,"_nodeVersion":"24.3.0","dependencies":{"@bun-win32/core":"1.1.4"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/dbghelp_1.0.2_1781130813647_0.22558051786462174","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@bun-win32/dbghelp","version":"2.0.0","keywords":["bun","ffi","win32","windows","dbghelp","bindings","typescript","dll"],"author":"Stev Peifer ","license":"MIT","_id":"@bun-win32/dbghelp@2.0.0","maintainers":[{"name":"obscuritysrl","email":"stev.p@outlook.com"}],"homepage":"https://github.com/ObscuritySRL/bun-win32#readme","bugs":{"url":"https://github.com/ObscuritySRL/bun-win32/issues"},"dist":{"shasum":"d793f25e9f31278f9f1297d74e5ea8f8b3135822","tarball":"https://registry.npmjs.org/@bun-win32/dbghelp/-/dbghelp-2.0.0.tgz","fileCount":6,"integrity":"sha512-U4iiLMD+tKeyBcnSSBzbqppoFcbcoL+ucyM47CBwt3QXWqxjpoUxz/a+jmC5Y+FR0kiYj783DaDcoU9J3kAxZg==","signatures":[{"sig":"MEYCIQD8O5F8YT46HhFFO/QRmRN6bMW/Y+hBardp02RnF8MJ+AIhAPD42EyHX5CwxDbozdBKEmZuA7iOd1YfD99gVutE2MrR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":91526},"main":"./index.ts","type":"module","module":"index.ts","shasum":"d793f25e9f31278f9f1297d74e5ea8f8b3135822","engines":{"bun":">=1.1.0"},"exports":{".":"./index.ts"},"private":false,"scripts":{"example:crash-report":"bun ./example/crash-report.ts","example:symbol-explorer":"bun ./example/symbol-explorer.ts"},"_npmUser":{"name":"obscuritysrl","email":"stev.p@outlook.com"},"_integrity":"sha512-U4iiLMD+tKeyBcnSSBzbqppoFcbcoL+ucyM47CBwt3QXWqxjpoUxz/a+jmC5Y+FR0kiYj783DaDcoU9J3kAxZg==","repository":{"url":"git://github.com/ObscuritySRL/bun-win32.git","type":"git","directory":"packages/dbghelp"},"_npmVersion":"10.8.3","description":"Zero-dependency, zero-overhead Win32 DBGHELP bindings for Bun (FFI) on Windows.","directories":{},"sideEffects":false,"_nodeVersion":"26.3.0","dependencies":{"@bun-win32/core":"2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/dbghelp_2.0.0_1782435292000_0.9674492113463335","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"author":"Stev Peifer ","bugs":{"url":"https://github.com/ObscuritySRL/bun-win32/issues"},"dependencies":{"@bun-win32/core":"2.0.1"},"description":"Zero-dependency, zero-overhead Win32 DBGHELP bindings for Bun (FFI) on Windows.","devDependencies":{"@types/bun":"latest"},"exports":{".":"./index.ts"},"license":"MIT","module":"index.ts","name":"@bun-win32/dbghelp","peerDependencies":{"typescript":"^5"},"private":false,"homepage":"https://github.com/ObscuritySRL/bun-win32#readme","repository":{"type":"git","url":"git://github.com/ObscuritySRL/bun-win32.git","directory":"packages/dbghelp"},"type":"module","version":"2.0.1","main":"./index.ts","keywords":["bun","ffi","win32","windows","dbghelp","bindings","typescript","dll"],"sideEffects":false,"engines":{"bun":">=1.1.0"},"scripts":{"example:symbol-explorer":"bun ./example/symbol-explorer.ts","example:crash-report":"bun ./example/crash-report.ts"},"_id":"@bun-win32/dbghelp@2.0.1","_integrity":"sha512-ESeKh7T04HvVVD826wpUwlEWrDEuKqkuwzne7fMBzEDK5HqJwzNBEJ0vFX9wpL7ZE7Og6cIl1y/By+YTMunLyQ==","_nodeVersion":"26.3.0","_npmVersion":"10.8.3","shasum":"86643cb3d04a25f452475e73b3d7e2a8b96ce843","dist":{"integrity":"sha512-ESeKh7T04HvVVD826wpUwlEWrDEuKqkuwzne7fMBzEDK5HqJwzNBEJ0vFX9wpL7ZE7Og6cIl1y/By+YTMunLyQ==","shasum":"86643cb3d04a25f452475e73b3d7e2a8b96ce843","tarball":"https://registry.npmjs.org/@bun-win32/dbghelp/-/dbghelp-2.0.1.tgz","fileCount":6,"unpackedSize":91526,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICDcbvyhih3kodxovOTLvuseUflWvjwnlPLesrT/KGiCAiBLj+WpTPWLD5v2DJabYhurMm8VH9rkokBS9iIIYFYx9Q=="}]},"_npmUser":{"name":"obscuritysrl","email":"stev.p@outlook.com"},"directories":{},"maintainers":[{"name":"obscuritysrl","email":"stev.p@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dbghelp_2.0.1_1782437750766_0.8910597320582756"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-10T01:23:49.046Z","modified":"2026-06-26T01:35:51.022Z","1.0.0":"2026-04-10T01:23:49.307Z","1.0.1":"2026-06-04T14:05:01.345Z","1.0.2":"2026-06-10T22:33:33.828Z","2.0.0":"2026-06-26T00:54:52.181Z","2.0.1":"2026-06-26T01:35:50.891Z"},"bugs":{"url":"https://github.com/ObscuritySRL/bun-win32/issues"},"author":"Stev Peifer ","license":"MIT","homepage":"https://github.com/ObscuritySRL/bun-win32#readme","keywords":["bun","ffi","win32","windows","dbghelp","bindings","typescript","dll"],"repository":{"type":"git","url":"git://github.com/ObscuritySRL/bun-win32.git","directory":"packages/dbghelp"},"description":"Zero-dependency, zero-overhead Win32 DBGHELP bindings for Bun (FFI) on Windows.","maintainers":[{"name":"obscuritysrl","email":"stev.p@outlook.com"}],"readme":"# @bun-win32/dbghelp\n\nZero-dependency, zero-overhead Win32 Dbghelp bindings for [Bun](https://bun.sh) on Windows.\n\n## Overview\n\n`@bun-win32/dbghelp` exposes the `dbghelp.dll` exports using [Bun](https://bun.sh)'s FFI. It provides a single class, `Dbghelp`, which lazily binds native symbols on first use. You can optionally preload a subset or all symbols up-front via `Preload()`.\n\nThe bindings are strongly typed for a smooth DX in TypeScript.\n\n## Features\n\n- [Bun](https://bun.sh)-first ergonomics on Windows 10/11.\n- Direct FFI to `dbghelp.dll` (symbol engine, stack walking, minidumps, image helpers, and source-level debugging).\n- In-source docs in `structs/Dbghelp.ts` with links to Microsoft Docs.\n- Lazy binding on first call; optional eager preload (`Dbghelp.Preload()`).\n- No wrapper overhead; calls map 1:1 to native APIs.\n- Strongly-typed Dbghelp aliases, enums, and constants (see `types/Dbghelp.ts`).\n\n## Requirements\n\n- [Bun](https://bun.sh) runtime\n- Windows 10 or later\n\n## Installation\n\n```sh\nbun add @bun-win32/dbghelp\n```\n\n## Quick Start\n\n```ts\nimport Dbghelp, { SYMOPT_UNDNAME, SYMOPT_DEFERRED_LOADS } from '@bun-win32/dbghelp';\n\nconst hProcess = BigInt(process.pid);\n\nDbghelp.SymSetOptions(SYMOPT_UNDNAME | SYMOPT_DEFERRED_LOADS);\n\nif (!Dbghelp.SymInitialize(hProcess, null, 1)) {\n throw new Error('SymInitialize failed');\n}\n\ntry {\n const opts = Dbghelp.SymGetOptions();\n console.log(`Symbol options: 0x${opts.toString(16).padStart(8, '0')}`);\n} finally {\n Dbghelp.SymCleanup(hProcess);\n}\n```\n\n> [!NOTE]\n> AI agents: see `AI.md` for the package binding contract and source-navigation guidance. It explains how to use the package without scanning the entire implementation.\n\n## Examples\n\nRun the included examples:\n\n```sh\nbun run example:symbol-explorer\nbun run example:crash-report\n```\n\n## Notes\n\n- Either rely on lazy binding or call `Dbghelp.Preload()`.\n- `MiniDumpWriteDump` and `MiniDumpReadDumpStream` are forwarded to `dbgcore.dll` at the DLL level; the bindings load them from `dbghelp.dll` transparently.\n- Windows only. Bun runtime required.\n- **SAL types & naming:** nullability is in the **type** — `Optional` (formally optional, SAL `_*opt_`) and `Nullable` (plain `[in]`/`[out]` the docs say can be NULL), the null sentinel derived from `T` (`null` for pointers `LP*`/`P*`, `0n` for handles/by-value addresses); direction is in the **parameter name** — `_out` (`_Out_`), `_in_out` (`_Inout_`), `_In_` bare. See `AI.md` and the repo `AGENTS.md`.\n","readmeFilename":"README.md"}