@wecandobetter/binay-buffer v0.0.1

Binary Buffer 💾

Binary Buffer is a versatile TypeScript library that provides tools for creating, manipulating, and serializing binary data buffers. It simplifies the process of working with binary data by offering an intuitive API for defining data structures, serializing data, and managing byte sequences.

Features 🚀

• ⚙️ Flexible Type System: Define custom data types using a simple and extensible API.
• 🔄 Serialization and Deserialization: Serialize and deserialize complex data structures with ease.
• 📚 Easy-to-Use API: Create, read, and manipulate binary data using an intuitive and well-documented API.
• ⚡ High Performance: Optimized for speed, making it suitable for performance-critical applications.
• 📜 MIT Licensed: Use it freely in both open-source and commercial projects.

Installation 📦

To install the Binary Buffer library, use npm:

npm install @wecandobetter/binary-buffer

Usage Example 🌟

import { BufferBuilder } from "@wecandobetter/binary-buffer";
import { string, uint8 } from "@wecandobetter/binary-buffer/dist/types.js";

// Create a BufferBuilder instance
const builder = new BufferBuilder();

// Register built-in types
builder.registerType(uint8);
builder.registerType(string);

// Define your data structure using the built-in types
const descriptor = {
  age: "uint8",
  name: "string",
};

// Create a builder function
const build = builder.createBuilder(descriptor);

// Build the binary buffer using the builder function
const { buffer, ops, copy } = build({
  age: 42,
  name: "John Doe",
});

// Get the values
ops.age.get(); // 42
ops.name.get(); // "John Doe"

// Set the values
ops.age.set(43);
ops.name.set("Jane Doe");

// Copy the buffer
const copiedBuffer = copy();

See the example and unit tests for more usage examples.

Built-in Types

Roadmap 🗺️

• Support browser, Deno, and Bun environments
• Some kind of benchmarking

Contributing 🤝

Contributions, issues, and feature requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

If you find Binary Buffer helpful, consider starring the repository ⭐ and contributing to its development. Feel free to report issues or submit pull requests to help us make it even better!

License 📜

Binary Buffer is licensed under the MIT License.