{"_id":"@bun-win32/ole32","_rev":"4-b4672437fa2644f1a85a37b44224ed04","name":"@bun-win32/ole32","dist-tags":{"latest":"2.0.1"},"versions":{"1.0.0":{"name":"@bun-win32/ole32","version":"1.0.0","keywords":["bun","ffi","win32","windows","ole32","bindings","typescript","dll"],"author":"Stev Peifer ","license":"MIT","_id":"@bun-win32/ole32@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":"afb4f32b55e10980abf32143770f27d81521bea5","tarball":"https://registry.npmjs.org/@bun-win32/ole32/-/ole32-1.0.0.tgz","fileCount":6,"integrity":"sha512-5M72DcKflMilsmuYuc3jS3S4kS3pUW0of3f2gxEyQyF2D3PCqMLPZKpyosqJzBBIQWcSeXq8U8OMKYAxBH5MAw==","signatures":[{"sig":"MEUCICt5X7UsGv7zOdzjRYBsl7oV8rBDw4wKGEUuL6FDwBlZAiEA77xubxJ9GedlqqiO1aIQmCGBqTPZNUX/7Aq6+SRiPCc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61365},"main":"./index.ts","type":"module","module":"index.ts","shasum":"afb4f32b55e10980abf32143770f27d81521bea5","engines":{"bun":">=1.1.0"},"exports":{".":"./index.ts"},"private":false,"scripts":{"example:storage-audit":"bun ./example/storage-audit.ts","example:property-set-galaxy":"bun ./example/property-set-galaxy.ts"},"_npmUser":{"name":"obscuritysrl","email":"stev@bell.net"},"_integrity":"sha512-5M72DcKflMilsmuYuc3jS3S4kS3pUW0of3f2gxEyQyF2D3PCqMLPZKpyosqJzBBIQWcSeXq8U8OMKYAxBH5MAw==","repository":{"url":"git://github.com/ObscuritySRL/bun-win32.git","type":"git","directory":"packages/ole32"},"_npmVersion":"10.8.3","description":"Zero-dependency, zero-overhead Win32 OLE32 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/ole32_1.0.0_1775749998168_0.9712256262095478","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bun-win32/ole32","version":"1.0.1","keywords":["bun","ffi","win32","windows","ole32","bindings","typescript","dll"],"author":"Stev Peifer ","license":"MIT","_id":"@bun-win32/ole32@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":"73026384a5dd38138a73cc4f83dc64a3bbf5f669","tarball":"https://registry.npmjs.org/@bun-win32/ole32/-/ole32-1.0.1.tgz","fileCount":6,"integrity":"sha512-lBE5SKYfspc267r6a9d2QxlfGoh9p7+OZKV2evEXt9l1sRTnNi5qiRve2rTXFF4Wdue7OILG1DTtyVo6nielvw==","signatures":[{"sig":"MEUCICOumqmbSbFwiNiqjg50Erj8besp1sXHzLfQKrI1cs/RAiEA8oebeNm2sM68YlvXHLuYon/zou3JHiaFj518z9G2G0k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61407},"main":"./index.ts","type":"module","module":"index.ts","shasum":"73026384a5dd38138a73cc4f83dc64a3bbf5f669","engines":{"bun":">=1.1.0"},"exports":{".":"./index.ts"},"private":false,"scripts":{"example:storage-audit":"bun ./example/storage-audit.ts","example:property-set-galaxy":"bun ./example/property-set-galaxy.ts"},"_npmUser":{"name":"obscuritysrl","email":"stev@bell.net"},"_integrity":"sha512-lBE5SKYfspc267r6a9d2QxlfGoh9p7+OZKV2evEXt9l1sRTnNi5qiRve2rTXFF4Wdue7OILG1DTtyVo6nielvw==","repository":{"url":"git://github.com/ObscuritySRL/bun-win32.git","type":"git","directory":"packages/ole32"},"_npmVersion":"10.8.3","description":"Zero-dependency, zero-overhead Win32 OLE32 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/ole32_1.0.1_1780581916335_0.12610230205356254","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@bun-win32/ole32","version":"2.0.0","keywords":["bun","ffi","win32","windows","ole32","bindings","typescript","dll"],"author":"Stev Peifer ","license":"MIT","_id":"@bun-win32/ole32@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":"9f7a476d98c26dc16f24750a27d5b0cfa9776e43","tarball":"https://registry.npmjs.org/@bun-win32/ole32/-/ole32-2.0.0.tgz","fileCount":6,"integrity":"sha512-tXPnZyzTINTAY5bZxu3RvYj/qGNusv1cAB1dI6Z5W/10JqnitZ+EdJjXF/UimIf7txKOCQxxKHxU1E4r9O4BTw==","signatures":[{"sig":"MEQCIF1i4xnErH7Ud1E3upJ5t6sqxxIoa9d9Ufdxs4TLYngCAiBPrDurwEn/wxxHuGWOXdVhLV4/gYIwNbdK9KkPbaIRXA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63871},"main":"./index.ts","type":"module","module":"index.ts","shasum":"9f7a476d98c26dc16f24750a27d5b0cfa9776e43","engines":{"bun":">=1.1.0"},"exports":{".":"./index.ts"},"private":false,"scripts":{"example:storage-audit":"bun ./example/storage-audit.ts","example:property-set-galaxy":"bun ./example/property-set-galaxy.ts"},"_npmUser":{"name":"obscuritysrl","email":"stev.p@outlook.com"},"_integrity":"sha512-tXPnZyzTINTAY5bZxu3RvYj/qGNusv1cAB1dI6Z5W/10JqnitZ+EdJjXF/UimIf7txKOCQxxKHxU1E4r9O4BTw==","repository":{"url":"git://github.com/ObscuritySRL/bun-win32.git","type":"git","directory":"packages/ole32"},"_npmVersion":"10.8.3","description":"Zero-dependency, zero-overhead Win32 OLE32 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/ole32_2.0.0_1782435484298_0.1979241449366227","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 OLE32 bindings for Bun (FFI) on Windows.","devDependencies":{"@types/bun":"latest"},"engines":{"bun":">=1.1.0"},"exports":{".":"./index.ts"},"homepage":"https://github.com/ObscuritySRL/bun-win32#readme","keywords":["bun","ffi","win32","windows","ole32","bindings","typescript","dll"],"license":"MIT","main":"./index.ts","module":"index.ts","name":"@bun-win32/ole32","peerDependencies":{"typescript":"^5"},"private":false,"repository":{"type":"git","url":"git://github.com/ObscuritySRL/bun-win32.git","directory":"packages/ole32"},"scripts":{"example:property-set-galaxy":"bun ./example/property-set-galaxy.ts","example:storage-audit":"bun ./example/storage-audit.ts"},"sideEffects":false,"type":"module","version":"2.0.1","_id":"@bun-win32/ole32@2.0.1","_integrity":"sha512-ZhtBavD8CXZ2bJ4bAxu8F5uZCyyaoIczmSCgJWNKpvpiJ7dqUYy+bStCXIGgma1ChXZIsomkbTcAWDWf/EpFdQ==","_nodeVersion":"26.3.0","_npmVersion":"10.8.3","shasum":"76d16d0e8ea6921e76a3c76fd9c26520047b6c68","dist":{"integrity":"sha512-ZhtBavD8CXZ2bJ4bAxu8F5uZCyyaoIczmSCgJWNKpvpiJ7dqUYy+bStCXIGgma1ChXZIsomkbTcAWDWf/EpFdQ==","shasum":"76d16d0e8ea6921e76a3c76fd9c26520047b6c68","tarball":"https://registry.npmjs.org/@bun-win32/ole32/-/ole32-2.0.1.tgz","fileCount":6,"unpackedSize":63871,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBqfKPNSY3yeNAQXI1U+opqni8vjfUXb2QYYEvoFMT8OAiEAibztIcC3FIRqsoQ/KpO/9XAgP16v4vfG2N3C9Ehcbig="}]},"_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/ole32_2.0.1_1782438144199_0.06146206604665361"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-09T15:53:18.081Z","modified":"2026-06-26T01:42:24.458Z","1.0.0":"2026-04-09T15:53:18.315Z","1.0.1":"2026-06-04T14:05:16.493Z","2.0.0":"2026-06-26T00:58:04.446Z","2.0.1":"2026-06-26T01:42:24.330Z"},"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","ole32","bindings","typescript","dll"],"repository":{"type":"git","url":"git://github.com/ObscuritySRL/bun-win32.git","directory":"packages/ole32"},"description":"Zero-dependency, zero-overhead Win32 OLE32 bindings for Bun (FFI) on Windows.","maintainers":[{"name":"obscuritysrl","email":"stev.p@outlook.com"}],"readme":"# @bun-win32/ole32\n\nZero-dependency, zero-overhead Win32 Ole32 bindings for [Bun](https://bun.sh) on Windows.\n\n## Overview\n\n`@bun-win32/ole32` exposes the `ole32.dll` exports using [Bun](https://bun.sh)'s FFI. It provides a single class, `Ole32`, 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. The package intentionally stays flat-FFI only: it binds exports, pointer types, and handles, but it does not wrap COM vtables or automate reference counting for returned interface pointers.\n\n## Features\n\n- Bun-first ergonomics on Windows 10/11.\n- Direct FFI to `ole32.dll` for COM/OLE helpers, monikers, structured storage, drag-drop, and property-set utilities.\n- In-source docs in `structs/Ole32.ts` with Microsoft Learn links.\n- Lazy binding on first call; optional eager preload with `Ole32.Preload()`.\n- No wrapper overhead; calls map 1:1 to the underlying DLL export.\n- Strongly-typed Win32 aliases for storage helpers, interface pointers, handles, and wide strings.\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/ole32\n```\n\n## Quick Start\n\n```ts\nimport Ole32 from '@bun-win32/ole32';\n\nconst comVersion = Ole32.CoBuildVersion();\nconst oleVersion = Ole32.OleBuildVersion();\n\nconsole.log({ comVersion, oleVersion });\n```\n\n> [!NOTE]\n> AI agents: see `AI.md` for the package binding contract and source-navigation guidance.\n\n## Examples\n\nRun the included examples:\n\n```sh\nbun run example:property-set-galaxy\nbun run example:storage-audit\n```\n\n## Notes\n\n- Use `Ole32.Preload()` when you want to front-load symbol resolution.\n- Interface pointers returned from APIs like `StgOpenStorage` are raw COM pointers; callers must manage any vtable-based lifetime and method invocation themselves.\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"}