minibit
TypeScript icon, indicating that this package has built-in type declarations

2.0.0 • Public • Published

minibit

Compression and decompression of data described by JSON Schema.

npm install minibit

MiniBit allows you to reuse validation JSON Schema to compress data to a smaller size than JSON serialization.

Typically, you can compress data to as little as 30% the size of arbitrary serialization such as JSON stringification and message pack.

This is achieved by:

  • Prioritizing minimal bit information over byte alignment.
  • Encoding content encoded strings and formats as bytes.
  • Compacting integer values used for lengths and counts down to exact bit depths based on expected ranges.
  • Storing references to const, enum and null values instead of actual values.

Note:

  • Data is not validated against the JSON schema.
  • References are not followed and "allOf", "anyOf", "oneOf" properties are ignored. Make sure you dereference your schemas beforehand.

Usage

import { encode, decode } from 'minibit';

const data = {
   // data
};

const schema = {
   // JSON Schema
};

const buffer = encode(data, schema)

const dataB = decode(buffer, schema)

API

buffer = encode(data, schema)

Encodes data to buffer.

data = decode(buffer, schema)

Decodes data from buffer.

Backwards Compatibility

The following changes in schema break backwards compatibility for encoded data:

  • Adding to object properties, enums, array prefix items anywhere other than at the end.
  • Removing object properties, enums, array prefix items.
  • Changing order of object properties, enums, array prefix items.
  • Changing length/quantity properties such as minItems, maxItems, minLength, maxLength, minimum, maximum, etc.
  • Changing string contentEncoding or format.

It is recommended to make the root schema an object, only add new properties and mark old properties as deprecated.

MiniBit does not validate data and treats object properties as optional. Decoding will not fail if a deprecated properties is not present.

Benchmarks

Benchmarks use a sample object that include all JSON schema types. The code for it can be found here.

Serializer Size
minibit 90 bytes
msgpack 232 bytes
JSON 306 bytes

License

MIT

Package Sidebar

Install

npm i minibit

Weekly Downloads

5

Version

2.0.0

License

ISC

Unpacked Size

53.8 kB

Total Files

7

Last publish

Collaborators

  • xkore