https://github.com/butterdebugger/jsbin
https://github.com/butterdebugger/jsbin
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/butterdebugger/jsbin
- Owner: ButterDebugger
- License: mit
- Created: 2024-11-12T15:00:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-19T07:00:34.000Z (10 months ago)
- Last Synced: 2025-04-19T14:19:49.642Z (10 months ago)
- Language: TypeScript
- Size: 34.2 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# JsBin
A simple and lightweight library designed to provide efficient binary
serialization for JavaScript objects. This makes it easy to encode JavaScript
data structures into compact binary formats, saving space and improving
transmission speeds.
## Installation
For Node.js:
```bash
npx jsr add @debutter/jsbin
```
For Deno:
```bash
deno add jsr:@debutter/jsbin
```
For Browsers:
```javascript
import * as JsBin from "https://esm.sh/jsr/@debutter/jsbin@VERSION";
```
## Usage
Example usage for encoding and decoding objects:
```javascript
import { decode, encode } from "@debutter/jsbin";
const data = {
message: "Hello, world!",
};
// Encode to binary
const encoded = encode(data);
// Decode from binary
const decoded = decode(encoded);
console.log(decoded); // { message: "Hello, world!" }
```
## Extensibility
JsBin is designed to be extensible, allowing you to add support for custom data
types. You can do this by creating your own transformers to handle specific data
types.
```javascript
import { registerTransformer } from "@debutter/jsbin";
// Define a custom transformer for a specific data type
const MyCustomTransformer = registerTransformer(0, {
isApplicable: (value) => value instanceof MyCustomType,
serialize: (encoder, value) => {
encoder.write(/* Encode the value */);
// ...
},
deserialize: (decoder) => {
return new MyCustomType(/* Decode the value */);
},
});
```
Additionally, you can also chain together other transformers to encode and
decode more complex data structures.
```javascript
import { NumberTransformer, registerTransformer } from "@debutter/jsbin";
// Define a custom transformer for a specific data type
const Vector2dTransformer = registerTransformer(0, {
isApplicable: (value) => value instanceof Vector2d,
serialize: (encoder, vector) => {
encoder.chain(NumberTransformer, vector.x);
encoder.chain(NumberTransformer, vector.y);
},
deserialize: (decoder) => {
const x = decoder.chain(NumberTransformer);
const y = decoder.chain(NumberTransformer);
return new Vector2d(x, y);
},
});
```
# Contributing
Contributions are welcome! Please feel free to submit a Pull Request.