Minimal JSON-like binary schema-full protocol for JS/TS with BYO runtime data validations.
- Small (< 1.5 KB)
- Minimal runtime overhead
- Runtime data validations
- 36 types
BoolUInt8UInt16UInt32Int8Int16Int32Float32Float64Ascii8Ascii16Unicode8Unicode16StructArray8Array16EnumTupleNBoolNUInt8NUInt16NUInt32NInt8NInt16NInt32NFloat32NFloat64NAscii8NAscii16NUnicode8NUnicode16NStructNArray8NArray16NEnumNTuple
- Estimate payload size
- Static type inference
Encodes JS data into ArrayBuffer based on Type.
const arrayBuffer = encode({
type: Struct,
value: [
{ key: "name", type: Ascii8 },
{ key: "age", type: UInt8 }
]
}, {
name: "Yamiteru",
age: 27
});Decodes ArrayBuffer into JS data based on Type.
const data = decode({
type: Struct,
value: [
{ key: "name", type: Ascii8 },
{ key: "age", type: UInt8 }
]
}, arrayBuffer);Estimates payload size of Type in bytes and chunks.
const {
bytes, // 66
chunks // 1
} = estimate({
type: Struct,
value: [
{ key: "name", type: Ascii8, maxLength: 64 },
{ key: "age", type: UInt8 }
]
});Once you create a Type you can easily infer it with Infer.
encode uses Infer for its input value and decode for its output value.
const user = {
type: Struct,
value: [
{ key: "name", type: Ascii8 },
{ key: "age", type: UInt8 }
]
} as const;
// {
// name: string,
// age: number
// }
type User = Infer<typeof user>;All nullable types have N prefix.
{
type:
| Type.Bool
| Type.NBool;
}{
type:
| Type.UInt8
| Type.UInt16
| Type.UInt32
| Type.NUInt8
| Type.NUInt16
| Type.NUInt32;
}{
type:
| Type.Int8
| Type.Int16
| Type.Int32
| Type.NInt8
| Type.NInt16
| Type.NInt32;
}{
type:
| Type.Float32
| Type.Float64
| Type.NFloat32
| Type.NFloat64;
}{
type:
| Type.Ascii8
| Type.Ascii16
| Type.NAscii8
| Type.NAscii16;
}{
type:
| Type.Unicode8
| Type.Unicode16
| Type.NUnicode8
| Type.NUnicode16;
}{
type:
| Type.Struct
| Type.NStruct;
value: (AnyType & Required<Type.Keyable>)[];
}{
type:
| Type.Array8
| Type.Array16
| Type.NArray8
| Type.NArray16;
value: AnyType;
}{
type:
| Type.Tuple
| Type.NTuple;
value: AnyType[];
}{
type:
| Type.Enum
| Type.NEnum;
value: unknown[];
}Used in Object for property names.
{
key?: string;
}Any type can be asserted by adding assert property to it.
In encode it's run before encoding and in decode it's run after decoding.
If type is nullable and the value is null we don't run assert in either encode or decode.
{
assert?: (v: unknown) => undefined | unknown;
}