@ntf/buffer

Another binary data manipulation library

Why

Because I like reinventing the wheel :)

Installation

Use your favourite package manager, idk

npm install @ntf/buffer

yarn add @ntf/buffer

pnpm install @ntf/buffer

Usage

Importing

This library can be used in CommonJS and ESModule environments

const { ... } = require("@ntf/buffer");

import { ... } from "@ntf/buffer";

MemoryRegion

The class MemoryRegion is a view of an array buffer, it wraps around DataView. Unlike Typed Arrays and NodeJS's Buffer it can do the following:

• reading/writing data will cause to step to the next data in the region (like a stream or better yet: the Java DataInputStream and DataOutputStream class)
• you can change the positions with the readOffset/writeOffset attribute or their methods setReadOffset/setWriteOffset
• you can allocate a zero-filled buffer with the static allocate method
• the static methods fromArrayBufferView/fromAsync converts Blob, Response instances and any kind of Typed Array to a MemoryRegion (this includes the NodeJS Buffer class because it's just a Uint8Array ~~but with shitty read/write functions in my opinion~~)
• merge any kind of binary data into one with the static method merge

import { MemoryRegion } from "@ntf/buffer";

const myVeryCoolBuffer = MemoryRegion.allocate(100); // allocates a zero-filled memory region with the size of 100 bytes
const someRandomAssBuffer = await Buffer.fromAsync(someRandomAssBlobOrResponse) // this static method returns a Promise<MemoryRegion>

License stuff that nobody reads

Just like any Open Source Project this has a License, the MIT License