@webbuf/fixedbuf

Fixed-size buffer wrapper with compile-time size enforcement.

Installation

``bash
npm install @webbuf/fixedbuf
`

Usage

`typescript
import { FixedBuf } from "@webbuf/fixedbuf";
import { WebBuf } from "@webbuf/webbuf";

// Create fixed-size buffers
const buf32 = FixedBuf.alloc<32>(32); // 32-byte buffer
const buf16 = FixedBuf.alloc<16>(16, 0xff); // 16 bytes filled with 0xff
const random = FixedBuf.fromRandom<32>(32); // 32 random bytes

// Create from encoded strings
const fromHex = FixedBuf.fromHex<4>(4, "deadbeef");
const fromB64 = FixedBuf.fromBase64(16, "SGVsbG8gV29ybGQhISE=");

// Create from WebBuf
const webBuf = WebBuf.alloc(32);
const fixed = FixedBuf.fromBuf<32>(32, webBuf);

// Access underlying buffer
const underlying: WebBuf = fixed.buf;

// Convert to strings
fromHex.toHex(); // "deadbeef"
fromB64.toBase64(); // "SGVsbG8gV29ybGQhISE="

// Clone and reverse
const cloned = fixed.clone();
const reversed = fixed.toReverse();
`

API

$3

| Method | Description |
| -------------------------------- | -------------------------- |
| FixedBuf.alloc(size, fill?) | Allocate fixed-size buffer |
| FixedBuf.fromBuf(size, buf) | Create from WebBuf |
| FixedBuf.fromHex(size, hex) | Create from hex string |
| FixedBuf.fromBase64(size, b64) | Create from base64 string |
| FixedBuf.fromRandom(size) | Create with random bytes |

$3

| Property/Method | Description |
| --------------- | ------------------------ |
| buf | Get underlying WebBuf |
| toHex() | Convert to hex string |
| toBase64() | Convert to base64 string |
| clone() | Create a copy |
| toReverse()` | Create reversed copy |

License

MIT