@mxjp/binary 1.0.0

package/dist/serializer.js

@@ -0,0 +1,177 @@
+import { asUint8Array } from "./bytes.js";
+export class Serializer {
+    #littleEndian;
+    #byteLength;
+    #parts;
+    constructor(littleEndian) {
+        this.#littleEndian = littleEndian ?? true;
+        if (typeof this.#littleEndian !== "boolean") {
+            throw new TypeError();
+        }
+        this.#byteLength = 0;
+        this.#parts = [];
+    }
+    get byteLength() {
+        return this.#byteLength;
+    }
+    #push(byteLength, serializeFn) {
+        this.#parts.push({ l: byteLength, s: serializeFn });
+        this.#byteLength += byteLength;
+    }
+    /** Serialize an unsigned 8 bit int. */
+    u8(value) {
+        if (typeof value !== "number") {
+            throw new TypeError();
+        }
+        if (!Number.isSafeInteger(value) || value < 0 || value > 0xFF) {
+            throw new RangeError();
+        }
+        this.#push(1, (ctx, byteOffset) => {
+            ctx.array[byteOffset] = value;
+        });
+    }
+    /** Serialize an unsigned 16 bit int in the serializer's endianess. */
+    u16(value) {
+        if (typeof value !== "number") {
+            throw new TypeError();
+        }
+        if (!Number.isSafeInteger(value) || value < 0 || value > 0xFF_FF) {
+            throw new RangeError();
+        }
+        this.#push(2, (ctx, byteOffset) => {
+            ctx.view.setUint16(byteOffset, value, this.#littleEndian);
+        });
+    }
+    /** Serialize an unsigned 32 bit int in the serializer's endianess. */
+    u32(value) {
+        if (typeof value !== "number") {
+            throw new TypeError();
+        }
+        if (!Number.isSafeInteger(value) || value < 0 || value > 0xFF_FF_FF_FF) {
+            throw new RangeError();
+        }
+        this.#push(4, (ctx, byteOffset) => {
+            ctx.view.setUint32(byteOffset, value, this.#littleEndian);
+        });
+    }
+    /** Serialize an unsigned 64 bit int in the serializer's endianess. */
+    u64(value) {
+        if (typeof value !== "number") {
+            throw new TypeError();
+        }
+        if (!Number.isSafeInteger(value) || value < 0) {
+            throw new RangeError();
+        }
+        this.#push(8, (ctx, byteOffset) => {
+            ctx.view.setBigUint64(byteOffset, BigInt(value), this.#littleEndian);
+        });
+    }
+    /** Serialize an unsigned 64 bit int in the serializer's endianess. */
+    bigU64(value) {
+        if (typeof value !== "bigint") {
+            throw new TypeError();
+        }
+        if (value < 0n || value > 0xffffffffffffffffn) {
+            throw new RangeError();
+        }
+        this.#push(8, (ctx, byteOffset) => {
+            ctx.view.setBigUint64(byteOffset, value, this.#littleEndian);
+        });
+    }
+    /** Serialize a 32-bit IEEE 754 floating point number in the serializer's endianess. */
+    f32(value) {
+        if (typeof value !== "number") {
+            throw new TypeError();
+        }
+        this.#push(4, (ctx, byteOffset) => {
+            ctx.view.setFloat32(byteOffset, value, this.#littleEndian);
+        });
+    }
+    /** Serialize a 64-bit IEEE 754 floating point number in the serializer's endianess. */
+    f64(value) {
+        if (typeof value !== "number") {
+            throw new TypeError();
+        }
+        this.#push(8, (ctx, byteOffset) => {
+            ctx.view.setFloat64(byteOffset, value, this.#littleEndian);
+        });
+    }
+    /**
+     * Serialize a boolean.
+     *
+     * + `false` is represented as `0x00`.
+     * + `true` is represented as `0x01`.
+     */
+    bool(value) {
+        if (typeof value !== "boolean") {
+            throw new TypeError();
+        }
+        this.u8(value ? 0x01 : 0x00);
+    }
+    /**
+     * Serialize an optional value.
+     *
+     * + `null` and `undefined` are serialized using {@link boolean `boolean(false)`}.
+     * + All other values are serialized using {@link boolean `boolean(true)`} followed by immediately calling the specified function.
+     */
+    option(value, fn) {
+        if (value === null || value === undefined) {
+            this.bool(false);
+        }
+        else {
+            this.bool(true);
+            fn(value, this);
+        }
+    }
+    /**
+     * Serialize bytes by copying them when {@link serialize serializing}.
+     */
+    unsafeBytes(value) {
+        const bytes = asUint8Array(value);
+        this.#push(value.byteLength, (ctx, byteOffset) => {
+            ctx.array.set(bytes, byteOffset);
+        });
+    }
+    /**
+     * Serialize bytes by copying them when {@link serialize serializing} prefixed by their byte length.
+     *
+     * See {@link unsafeBytes}.
+     */
+    prefixedUnsafeBytes(prefix, value) {
+        const bytes = asUint8Array(value);
+        prefix.call(this, value.byteLength);
+        this.unsafeBytes(bytes);
+    }
+    /**
+     * Serialize a utf-8 encoded string.
+     */
+    utf8(value) {
+        this.unsafeBytes(new TextEncoder().encode(value));
+    }
+    /**
+     * Serialize a utf-8 encoded string prefixed by it's byte length.
+     */
+    prefixedUtf8(prefix, value) {
+        this.prefixedUnsafeBytes(prefix, new TextEncoder().encode(value));
+    }
+    /**
+     * Write all parts in this serializer to an array buffer.
+     */
+    serialize() {
+        const buffer = new ArrayBuffer(this.#byteLength);
+        const context = {
+            buffer,
+            array: new Uint8Array(buffer),
+            view: new DataView(buffer),
+        };
+        const parts = this.#parts;
+        let byteOffset = 0;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            part.s(context, byteOffset);
+            byteOffset += part.l;
+        }
+        return buffer;
+    }
+}
+//# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,32 @@
+{
+	"name": "@mxjp/binary",
+	"homepage": "https://mxjp.github.io/binary",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/mxjp/binary"
+	},
+	"license": "MIT",
+	"type": "module",
+	"version": "1.0.0",
+	"main": "./dist/index.js",
+	"exports": {
+		".": "./dist/index.js"
+	},
+	"sideEffects": false,
+	"scripts": {
+		"build": "npm run build:es && npm run build:tests",
+		"build:es": "tsc -p tsconfig-es.json",
+		"build:tests": "tsc -p tsconfig-tests.json",
+		"start": "mx-parallel npm:start:*",
+		"start:es": "tsc -p tsconfig-es.json -w --preserveWatchOutput",
+		"start:tests": "tsc -p tsconfig-tests.json -w --preserveWatchOutput",
+		"test": "cd tests_out && node --enable-source-maps --test \"**/*.test.js\""
+	},
+	"devDependencies": {
+		"@mxjp/binary": "file:.",
+		"@mxjp/parallel": "^1.0.2",
+		"@types/node": "^24.6.2",
+		"tinybench": "^5.0.1",
+		"typescript": "^5.9.3"
+	}
+}

package/src/base32.ts

@@ -0,0 +1,57 @@
+import { asUint8Array, Bytes } from "./bytes.js";
+
+const BASE32_TO_ASCII = new TextEncoder().encode("ABCDEFGHIJKLMNOPQRSTUVWXYZ234567");
+const MASK = 0b11111;
+const PAD_ASCII = "=".charCodeAt(0);
+
+/**
+ * Base32 encode bytes without padding.
+ *
+ * See RFC 3548 for more info.
+ *
+ * @param bytes The bytes to encode.
+ * @param pad True, to include padding. Default is false.
+ */
+export function base32Encode(bytes: Bytes, pad = false): string {
+	const array = asUint8Array(bytes);
+	const rest = array.byteLength % 5;
+	const comp = array.byteLength - rest;
+	const base32Length = pad ? Math.ceil(array.byteLength / 5) * 8 : Math.ceil(array.byteLength / 5 * 8);
+	const base32 = new Uint8Array(base32Length);
+	let b = 0;
+	for (let i = 0; i < comp; i += 5) {
+		base32[b++] = BASE32_TO_ASCII[array[i] >>> 3];
+		base32[b++] = BASE32_TO_ASCII[((array[i] << 2) & MASK) | (array[i + 1] >>> 6)];
+		base32[b++] = BASE32_TO_ASCII[((array[i + 1] >>> 1) & MASK)];
+		base32[b++] = BASE32_TO_ASCII[((array[i + 1] << 4) & MASK) | (array[i + 2] >>> 4)];
+		base32[b++] = BASE32_TO_ASCII[((array[i + 2] << 1) & MASK) | (array[i + 3] >>> 7)];
+		base32[b++] = BASE32_TO_ASCII[((array[i + 3] >>> 2) & MASK)];
+		base32[b++] = BASE32_TO_ASCII[((array[i + 3] << 3) & MASK) | (array[i + 4] >>> 5)];
+		base32[b++] = BASE32_TO_ASCII[array[i + 4] & MASK];
+	}
+	if (rest > 0) {
+		base32[b++] = BASE32_TO_ASCII[array[comp] >>> 3];
+		if (rest > 1) {
+			base32[b++] = BASE32_TO_ASCII[((array[comp] << 2) & MASK) | (array[comp + 1] >>> 6)];
+			base32[b++] = BASE32_TO_ASCII[(array[comp + 1] >>> 1) & MASK];
+			if (rest > 2) {
+				base32[b++] = BASE32_TO_ASCII[((array[comp + 1] << 4) & MASK) | (array[comp + 2] >>> 4)];
+				if (rest > 3) {
+					base32[b++] = BASE32_TO_ASCII[((array[comp + 2] << 1) & MASK) | (array[comp + 3] >>> 7)];
+					base32[b++] = BASE32_TO_ASCII[(array[comp + 3] >>> 2) & MASK];
+					base32[b++] = BASE32_TO_ASCII[(array[comp + 3] << 3) & MASK];
+				} else {
+					base32[b++] = BASE32_TO_ASCII[(array[comp + 2] << 1) & MASK];
+				}
+			} else {
+				base32[b++] = BASE32_TO_ASCII[(array[comp + 1] << 4) & MASK];
+			}
+		} else {
+			base32[b++] = BASE32_TO_ASCII[(array[comp] << 2) & MASK];
+		}
+		base32.fill(PAD_ASCII, b);
+	}
+	const value = new TextDecoder().decode(base32);
+	base32.fill(0);
+	return value;
+}

package/src/base64.ts

@@ -0,0 +1,146 @@
+import { asUint8Array, Bytes } from "./bytes.js";
+
+const BASE64_TO_ASCII = new TextEncoder().encode("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");
+const BASE64URL_TO_ASCII = new TextEncoder().encode("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_");
+
+const ASCII_TO_BASE64 = new Uint16Array(123);
+const ASCII_TO_BASE64URL = new Uint16Array(123);
+for (let i = 0; i < 64; i++) {
+	ASCII_TO_BASE64[BASE64_TO_ASCII[i]] = i | 0x8000;
+	ASCII_TO_BASE64URL[BASE64URL_TO_ASCII[i]] = i | 0x8000;
+}
+
+const PAD_ASCII = "=".charCodeAt(0);
+
+function encode(bytes: Uint8Array<ArrayBuffer>, map: Uint8Array<ArrayBuffer>, padding: boolean): string {
+	const base64Length = padding ? Math.ceil(bytes.byteLength / 3) * 4 : Math.ceil(bytes.byteLength * 4 / 3);
+	const base64 = new Uint8Array(base64Length);
+	for (let i = 0, x = 0; i < bytes.byteLength;) {
+		const a = bytes[i];
+		base64[x++] = map[a >>> 2];
+		if (++i < bytes.byteLength) {
+			const b = bytes[i];
+			base64[x++] = map[((a & 3) << 4) | (b >>> 4)];
+			if (++i < bytes.byteLength) {
+				const c = bytes[i];
+				base64[x++] = map[((b & 0xf) << 2) | (c >>> 6)];
+				base64[x++] = map[c & 0x3f];
+				i++;
+			} else {
+				base64[x++] = map[(b & 0xf) << 2];
+				if (padding) {
+					base64[x++] = PAD_ASCII;
+				}
+			}
+		} else {
+			base64[x++] = map[(a & 3) << 4];
+			if (padding) {
+				base64[x++] = PAD_ASCII;
+				base64[x++] = PAD_ASCII;
+			}
+		}
+	}
+	const value = new TextDecoder().decode(base64);
+	base64.fill(0);
+	return value;
+}
+
+function decode(value: string, map: Uint16Array): Uint8Array {
+	if (typeof value !== "string") {
+		throw new TypeError();
+	}
+	const base64 = new TextEncoder().encode(value);
+	let padding = 0;
+	for (let i = value.length - 1; i >= 0; i--) {
+		if (base64[i] === PAD_ASCII) {
+			padding++;
+		} else {
+			break;
+		}
+	}
+	const base64Length = value.length - padding;
+	if (padding > 0 && ((value.length & 3) !== 0 || padding > 2)) {
+		throw new DecodeBase64Error();
+	}
+	const partial = base64Length & 3;
+	const byteLength = ((base64Length >>> 2) * 3) + (partial >>> 1) + (partial & 1);
+	const bytes = new Uint8Array(byteLength);
+	for (let i = 0, x = 0; i < byteLength;) {
+		const a = map[base64[x++]];
+		const b = map[base64[x++]];
+		if (a === 0 || a === undefined || b === 0 || b === undefined) {
+			throw new DecodeBase64Error();
+		}
+		bytes[i++] = (a << 2) | (b >>> 4);
+		if (i < byteLength) {
+			const c = map[base64[x++]];
+			if (c === 0 || c === undefined) {
+				throw new DecodeBase64Error();
+			}
+			bytes[i++] = (b << 4) | (c >>> 2);
+			if (i < byteLength) {
+				const d = map[base64[x++]];
+				if (d === 0 || d === undefined) {
+					throw new DecodeBase64Error();
+				}
+				bytes[i++] = (c << 6) | d;
+			} else if ((c & 3) > 0) {
+				throw new DecodeBase64Error();
+			}
+		} else if ((b & 7) > 0) {
+			throw new DecodeBase64Error();
+		}
+	}
+	base64.fill(0);
+	return bytes;
+}
+
+export class DecodeBase64Error extends SyntaxError {}
+
+/**
+ * Base64 encode bytes.
+ *
+ * See RFC 3548 for more info.
+ *
+ * @param bytes The bytes to encode.
+ * @param padding True, to include padding. Default is true.
+ */
+export function base64Encode(bytes: Bytes, padding = true): string {
+	return encode(asUint8Array(bytes), BASE64_TO_ASCII, padding);
+}
+
+/**
+ * Base64url encode bytes.
+ *
+ * See RFC 3548 for more info.
+ *
+ * @param bytes The bytes to encode.
+ * @param padding True, to include padding. Default is false.
+ */
+export function base64UrlEncode(bytes: Bytes, padding = false): string {
+	return encode(asUint8Array(bytes), BASE64URL_TO_ASCII, padding);
+}
+
+/**
+ * Decode a base64 encoded text with optional trailing padding.
+ *
+ * See RFC 3548 for more info.
+ *
+ * @param value The text to decode.
+ */
+export function base64Decode(value: string): Uint8Array {
+	return decode(value, ASCII_TO_BASE64);
+}
+
+/**
+ * Decode a base64 url encoded text with optional trailing padding.
+ *
+ * This does ignore padding characters, but not concatenated base64url strings.
+ *
+ * See RFC 3548 for more info.
+ *
+ * @param value The text to decode.
+ */
+export function base64UrlDecode(value: string): Uint8Array {
+	return decode(value, ASCII_TO_BASE64URL);
+}

package/src/bytes.ts

@@ -0,0 +1,26 @@
+
+export type Bytes = ArrayBuffer | Uint8Array<ArrayBuffer>;
+
+export function asUint8Array(value: Bytes): Uint8Array<ArrayBuffer> {
+	if (isArrayBuffer(value)) {
+		return new Uint8Array(value);
+	} else if (isUint8Array(value)) {
+		return value;
+	} else {
+		throw new TypeError();
+	}
+}
+
+/**
+ * Check if the specified value is exactly an {@link ArrayBuffer `ArrayBuffer`}.
+ */
+export function isArrayBuffer(value: unknown): value is ArrayBuffer {
+	return value instanceof ArrayBuffer && value.constructor === ArrayBuffer;
+}
+
+/**
+ * Check if the specified value is exactly a {@link Uint8Array `Uint8Array<ArrayBuffer>`}.
+ */
+export function isUint8Array(value: unknown): value is Uint8Array<ArrayBuffer> {
+	return value instanceof Uint8Array && value.constructor === Uint8Array && isArrayBuffer(value.buffer);
+}

package/src/deserializer.ts

@@ -0,0 +1,138 @@
+import { isArrayBuffer, isUint8Array } from "./bytes.js";
+
+export class Deserializer {
+	#littleEndian: boolean;
+	#buffer: ArrayBuffer;
+	#byteOffset: number;
+	#byteEnd: number;
+	#view: DataView;
+
+	constructor(buffer: ArrayBuffer, byteOffset: number, byteLength: number, littleEndian?: boolean) {
+		this.#littleEndian = littleEndian ?? true;
+		if (typeof this.#littleEndian !== "boolean" || !isArrayBuffer(buffer) || !Number.isSafeInteger(byteOffset) || !Number.isSafeInteger(byteLength)) {
+			throw new TypeError();
+		}
+		if (byteOffset < 0 || byteLength < 0 || (byteOffset + byteLength) > buffer.byteLength) {
+			throw new RangeError();
+		}
+		this.#buffer = buffer;
+		this.#byteOffset = byteOffset;
+		this.#byteEnd = byteOffset + byteLength;
+		this.#view = new DataView(buffer);
+	}
+
+	static from(source: ArrayBuffer | Uint8Array<ArrayBuffer>, littleEndian?: boolean) {
+		if (isArrayBuffer(source)) {
+			return new Deserializer(source, 0, source.byteLength, littleEndian);
+		} else if (isUint8Array(source)) {
+			return new Deserializer(source.buffer, source.byteOffset, source.byteLength, littleEndian);
+		} else {
+			throw new TypeError();
+		}
+	}
+
+	get bytesAvailable(): number {
+		return this.#byteEnd - this.#byteOffset;
+	}
+
+	#advanceBy(byteLength: number): number {
+		const byteOffset = this.#byteOffset;
+		const next = byteOffset + byteLength;
+		if (next > this.#byteEnd) {
+			throw new DeserializerEndError();
+		}
+		this.#byteOffset = next;
+		return byteOffset;
+	}
+
+	/**
+	 * Create a copy of this deserializer in it's current state that views the same underlying data.
+	 *
+	 * @param littleEndian True to use little endian byte order. Default is this deserializer's byte order.
+	 */
+	fork(littleEndian?: boolean): Deserializer {
+		return new Deserializer(this.#buffer, this.#byteOffset, this.bytesAvailable, littleEndian ?? this.#littleEndian);
+	}
+
+	/** Deserialize an unsigned 8 bit int. */
+	u8(): number {
+		return this.#view.getUint8(this.#advanceBy(1));
+	}
+
+	/** Deserialize an unsigned 16 bit int in the deserializer's endianess. */
+	u16(): number {
+		return this.#view.getUint16(this.#advanceBy(2), this.#littleEndian);
+	}
+
+	/** Deserialize an unsigned 32 bit int in the deserializer's endianess. */
+	u32(): number {
+		return this.#view.getUint32(this.#advanceBy(4), this.#littleEndian);
+	}
+
+	/** Deserialize an unsigned 64 bit int in the deserializer's endianess. */
+	u64(): number {
+		const value = this.bigU64();
+		if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+			throw new RangeError();
+		}
+		return Number(value);
+	}
+
+	/** Deserialize an unsigned 64 bit int in the deserializer's endianess. */
+	bigU64(): bigint {
+		return this.#view.getBigUint64(this.#advanceBy(8), this.#littleEndian);
+	}
+
+	/** Deserialize a 32-bit IEEE 754 floating point number in the deserializer's endianess. */
+	f32(): number {
+		return this.#view.getFloat32(this.#advanceBy(4), this.#littleEndian);
+	}
+
+	/** Deserialize a 64-bit IEEE 754 floating point number in the deserializer's endianess. */
+	f64(): number {
+		return this.#view.getFloat64(this.#advanceBy(8), this.#littleEndian);
+	}
+
+	/**
+	 * Deserialize a boolean.
+	 *
+	 * + `false` is represented as `0x00`.
+	 * + `true` is represented as `0x01`.
+	 */
+	bool(): boolean {
+		switch (this.u8()) {
+			case 0x00: return false;
+			case 0x01: return true;
+			default: throw new RangeError();
+		}
+	}
+
+	/**
+	 * Deserialize bytes by creating a view into the underlying data.
+	 *
+	 * @example
+	 * ```js
+	 * let array = d.unsafeViewBytes(7, Uint8Array);
+	 * ```
+	 */
+	unsafeViewBytes<T extends typeof Uint8Array<ArrayBuffer> | typeof DataView<ArrayBuffer>>(byteLength: number, ctor: T): InstanceType<T> {
+		if (!Number.isSafeInteger(byteLength) || ctor as unknown !== Uint8Array && ctor !== DataView) {
+			throw new TypeError();
+		}
+		const byteOffset = this.#advanceBy(byteLength);
+		return new (ctor as typeof Uint8Array)(this.#buffer, byteOffset, byteLength) as InstanceType<T>;
+	}
+
+	/**
+	 * Deserialize bytes by copying.
+	 */
+	copyBytes(byteLength: number): ArrayBuffer {
+		if (!Number.isSafeInteger(byteLength)) {
+			throw new TypeError();
+		}
+		const byteOffset = this.#advanceBy(byteLength);
+		return this.#buffer.slice(byteOffset, byteOffset + byteLength);
+	}
+}
+
+export class DeserializerEndError extends Error {}

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from "./base32.js";
+export * from "./base64.js";
+export * from "./bytes.js";
+export * from "./deserializer.js";
+export * from "./serializer.js";