@kenzuya/mediabunny 1.26.0 → 1.28.5

package/src/packet.ts

@@ -1,263 +0,0 @@
-/*!
- * Copyright (c) 2025-present, Vanilagy and contributors
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-import { SECOND_TO_MICROSECOND_FACTOR } from './misc';
-
-export const PLACEHOLDER_DATA = /* #__PURE__ */ new Uint8Array(0);
-
-/**
- * The type of a packet. Key packets can be decoded without previous packets, while delta packets depend on previous
- * packets.
- * @group Packets
- * @public
- */
-export type PacketType = 'key' | 'delta';
-
-/**
- * Holds additional data accompanying an {@link EncodedPacket}.
- * @group Packets
- * @public
- */
-export type EncodedPacketSideData = {
-	/**
-	 * An encoded alpha frame, encoded with the same codec as the packet. Typically used for transparent videos, where
-	 * the alpha information is stored separately from the color information.
-	 */
-	alpha?: Uint8Array;
-	/**
-	 * The actual byte length of the alpha data. This field is useful for metadata-only packets where the
-	 * `alpha` field contains no bytes.
-	 */
-	alphaByteLength?: number;
-};
-
-/**
- * Represents an encoded chunk of media. Mainly used as an expressive wrapper around WebCodecs API's
- * [`EncodedVideoChunk`](https://developer.mozilla.org/en-US/docs/Web/API/EncodedVideoChunk) and
- * [`EncodedAudioChunk`](https://developer.mozilla.org/en-US/docs/Web/API/EncodedAudioChunk), but can also be used
- * standalone.
- * @group Packets
- * @public
- */
-export class EncodedPacket {
-	/**
-	 * The actual byte length of the data in this packet. This field is useful for metadata-only packets where the
-	 * `data` field contains no bytes.
-	 */
-	readonly byteLength: number;
-
-	/** Additional data carried with this packet. */
-	readonly sideData: EncodedPacketSideData;
-
-	/** Creates a new {@link EncodedPacket} from raw bytes and timing information. */
-	constructor(
-		/** The encoded data of this packet. */
-		public readonly data: Uint8Array,
-		/** The type of this packet. */
-		public readonly type: PacketType,
-		/**
-		 * The presentation timestamp of this packet in seconds. May be negative. Samples with negative end timestamps
-		 * should not be presented.
-		 */
-		public readonly timestamp: number,
-		/** The duration of this packet in seconds. */
-		public readonly duration: number,
-		/**
-		 * The sequence number indicates the decode order of the packets. Packet A  must be decoded before packet B if A
-		 * has a lower sequence number than B. If two packets have the same sequence number, they are the same packet.
-		 * Otherwise, sequence numbers are arbitrary and are not guaranteed to have any meaning besides their relative
-		 * ordering. Negative sequence numbers mean the sequence number is undefined.
-		 */
-		public readonly sequenceNumber = -1,
-		byteLength?: number,
-		sideData?: EncodedPacketSideData,
-	) {
-		if (data === PLACEHOLDER_DATA && byteLength === undefined) {
-			throw new Error(
-				'Internal error: byteLength must be explicitly provided when constructing metadata-only packets.',
-			);
-		}
-
-		if (byteLength === undefined) {
-			byteLength = data.byteLength;
-		}
-
-		if (!(data instanceof Uint8Array)) {
-			throw new TypeError('data must be a Uint8Array.');
-		}
-		if (type !== 'key' && type !== 'delta') {
-			throw new TypeError('type must be either "key" or "delta".');
-		}
-		if (!Number.isFinite(timestamp)) {
-			throw new TypeError('timestamp must be a number.');
-		}
-		if (!Number.isFinite(duration) || duration < 0) {
-			throw new TypeError('duration must be a non-negative number.');
-		}
-		if (!Number.isFinite(sequenceNumber)) {
-			throw new TypeError('sequenceNumber must be a number.');
-		}
-		if (!Number.isInteger(byteLength) || byteLength < 0) {
-			throw new TypeError('byteLength must be a non-negative integer.');
-		}
-		if (sideData !== undefined && (typeof sideData !== 'object' || !sideData)) {
-			throw new TypeError('sideData, when provided, must be an object.');
-		}
-		if (sideData?.alpha !== undefined && !(sideData.alpha instanceof Uint8Array)) {
-			throw new TypeError('sideData.alpha, when provided, must be a Uint8Array.');
-		}
-		if (
-			sideData?.alphaByteLength !== undefined
-			&& (!Number.isInteger(sideData.alphaByteLength) || sideData.alphaByteLength < 0)
-		) {
-			throw new TypeError('sideData.alphaByteLength, when provided, must be a non-negative integer.');
-		}
-
-		this.byteLength = byteLength;
-		this.sideData = sideData ?? {};
-
-		if (this.sideData.alpha && this.sideData.alphaByteLength === undefined) {
-			this.sideData.alphaByteLength = this.sideData.alpha.byteLength;
-		}
-	}
-
-	/**
-	 * If this packet is a metadata-only packet. Metadata-only packets don't contain their packet data. They are the
-	 * result of retrieving packets with {@link PacketRetrievalOptions.metadataOnly} set to `true`.
-	 */
-	get isMetadataOnly() {
-		return this.data === PLACEHOLDER_DATA;
-	}
-
-	/** The timestamp of this packet in microseconds. */
-	get microsecondTimestamp() {
-		return Math.trunc(SECOND_TO_MICROSECOND_FACTOR * this.timestamp);
-	}
-
-	/** The duration of this packet in microseconds. */
-	get microsecondDuration() {
-		return Math.trunc(SECOND_TO_MICROSECOND_FACTOR * this.duration);
-	}
-
-	/** Converts this packet to an
-	 * [`EncodedVideoChunk`](https://developer.mozilla.org/en-US/docs/Web/API/EncodedVideoChunk) for use with the
-	 * WebCodecs API. */
-	toEncodedVideoChunk() {
-		if (this.isMetadataOnly) {
-			throw new TypeError('Metadata-only packets cannot be converted to a video chunk.');
-		}
-		if (typeof EncodedVideoChunk === 'undefined') {
-			throw new Error('Your browser does not support EncodedVideoChunk.');
-		}
-
-		return new EncodedVideoChunk({
-			data: this.data,
-			type: this.type,
-			timestamp: this.microsecondTimestamp,
-			duration: this.microsecondDuration,
-		});
-	}
-
-	/**
-	 * Converts this packet to an
-	 * [`EncodedVideoChunk`](https://developer.mozilla.org/en-US/docs/Web/API/EncodedVideoChunk) for use with the
-	 * WebCodecs API, using the alpha side data instead of the color data. Throws if no alpha side data is defined.
-	 */
-	alphaToEncodedVideoChunk(type = this.type) {
-		if (!this.sideData.alpha) {
-			throw new TypeError('This packet does not contain alpha side data.');
-		}
-		if (this.isMetadataOnly) {
-			throw new TypeError('Metadata-only packets cannot be converted to a video chunk.');
-		}
-		if (typeof EncodedVideoChunk === 'undefined') {
-			throw new Error('Your browser does not support EncodedVideoChunk.');
-		}
-
-		return new EncodedVideoChunk({
-			data: this.sideData.alpha,
-			type,
-			timestamp: this.microsecondTimestamp,
-			duration: this.microsecondDuration,
-		});
-	}
-
-	/** Converts this packet to an
-	 * [`EncodedAudioChunk`](https://developer.mozilla.org/en-US/docs/Web/API/EncodedAudioChunk) for use with the
-	 * WebCodecs API. */
-	toEncodedAudioChunk() {
-		if (this.isMetadataOnly) {
-			throw new TypeError('Metadata-only packets cannot be converted to an audio chunk.');
-		}
-		if (typeof EncodedAudioChunk === 'undefined') {
-			throw new Error('Your browser does not support EncodedAudioChunk.');
-		}
-
-		return new EncodedAudioChunk({
-			data: this.data,
-			type: this.type,
-			timestamp: this.microsecondTimestamp,
-			duration: this.microsecondDuration,
-		});
-	}
-
-	/**
-	 * Creates an {@link EncodedPacket} from an
-	 * [`EncodedVideoChunk`](https://developer.mozilla.org/en-US/docs/Web/API/EncodedVideoChunk) or
-	 * [`EncodedAudioChunk`](https://developer.mozilla.org/en-US/docs/Web/API/EncodedAudioChunk). This method is useful
-	 * for converting chunks from the WebCodecs API to `EncodedPacket` instances.
-	 */
-	static fromEncodedChunk(
-		chunk: EncodedVideoChunk | EncodedAudioChunk,
-		sideData?: EncodedPacketSideData,
-	): EncodedPacket {
-		if (!(chunk instanceof EncodedVideoChunk || chunk instanceof EncodedAudioChunk)) {
-			throw new TypeError('chunk must be an EncodedVideoChunk or EncodedAudioChunk.');
-		}
-
-		const data = new Uint8Array(chunk.byteLength);
-		chunk.copyTo(data);
-
-		return new EncodedPacket(
-			data,
-			chunk.type as PacketType,
-			chunk.timestamp / 1e6,
-			(chunk.duration ?? 0) / 1e6,
-			undefined,
-			undefined,
-			sideData,
-		);
-	}
-
-	/** Clones this packet while optionally updating timing information. */
-	clone(options?: {
-		/** The timestamp of the cloned packet in seconds. */
-		timestamp?: number;
-		/** The duration of the cloned packet in seconds. */
-		duration?: number;
-	}): EncodedPacket {
-		if (options !== undefined && (typeof options !== 'object' || options === null)) {
-			throw new TypeError('options, when provided, must be an object.');
-		}
-		if (options?.timestamp !== undefined && !Number.isFinite(options.timestamp)) {
-			throw new TypeError('options.timestamp, when provided, must be a number.');
-		}
-		if (options?.duration !== undefined && !Number.isFinite(options.duration)) {
-			throw new TypeError('options.duration, when provided, must be a number.');
-		}
-
-		return new EncodedPacket(
-			this.data,
-			this.type,
-			options?.timestamp ?? this.timestamp,
-			options?.duration ?? this.duration,
-			this.sequenceNumber,
-			this.byteLength,
-		);
-	}
-}

package/src/pcm.ts

@@ -1,112 +0,0 @@
-/*!
- * Copyright (c) 2025-present, Vanilagy and contributors
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-// https://github.com/dystopiancode/pcm-g711/blob/master/pcm-g711/g711.c
-
-export const toUlaw = (s16: number) => {
-	const MULAW_MAX = 0x1FFF;
-	const MULAW_BIAS = 33;
-
-	let number = s16;
-	let mask = 0x1000;
-	let sign = 0;
-	let position = 12;
-	let lsb = 0;
-
-	if (number < 0) {
-		number = -number;
-		sign = 0x80;
-	}
-
-	number += MULAW_BIAS;
-
-	if (number > MULAW_MAX) {
-		number = MULAW_MAX;
-	}
-
-	while ((number & mask) !== mask && position >= 5) {
-		mask >>= 1;
-		position--;
-	}
-
-	lsb = (number >> (position - 4)) & 0x0f;
-
-	return ~(sign | ((position - 5) << 4) | lsb) & 0xFF;
-};
-
-export const fromUlaw = (u8: number) => {
-	const MULAW_BIAS = 33;
-	let sign = 0;
-	let position = 0;
-
-	let number = ~u8;
-
-	if (number & 0x80) {
-		number &= ~(1 << 7);
-		sign = -1;
-	}
-
-	position = ((number & 0xF0) >> 4) + 5;
-
-	const decoded = ((1 << position) | ((number & 0x0F) << (position - 4))
-		| (1 << (position - 5))) - MULAW_BIAS;
-
-	return (sign === 0) ? decoded : -decoded;
-};
-
-export const toAlaw = (s16: number) => {
-	const ALAW_MAX = 0xFFF;
-	let mask = 0x800;
-	let sign = 0;
-	let position = 11;
-	let lsb = 0;
-
-	let number = s16;
-
-	if (number < 0) {
-		number = -number;
-		sign = 0x80;
-	}
-
-	if (number > ALAW_MAX) {
-		number = ALAW_MAX;
-	}
-
-	while ((number & mask) !== mask && position >= 5) {
-		mask >>= 1;
-		position--;
-	}
-
-	lsb = (number >> ((position === 4) ? 1 : (position - 4))) & 0x0f;
-
-	return (sign | ((position - 4) << 4) | lsb) ^ 0x55;
-};
-
-export const fromAlaw = (u8: number) => {
-	let sign = 0x00;
-	let position = 0;
-
-	let number = u8 ^ 0x55;
-
-	if (number & 0x80) {
-		number &= ~(1 << 7);
-		sign = -1;
-	}
-
-	position = ((number & 0xF0) >> 4) + 4;
-
-	let decoded = 0;
-	if (position !== 4) {
-		decoded = ((1 << position) | ((number & 0x0F) << (position - 4))
-			| (1 << (position - 5)));
-	} else {
-		decoded = (number << 1) | 1;
-	}
-
-	return (sign === 0) ? decoded : -decoded;
-};

package/src/reader.ts

@@ -1,323 +0,0 @@
-/*!
- * Copyright (c) 2025-present, Vanilagy and contributors
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-import { InputDisposedError } from './input';
-import { assert, clamp, getUint24, MaybePromise, toDataView } from './misc';
-import { Source } from './source';
-
-export class Reader {
-	fileSize!: number | null;
-
-	constructor(public source: Source) {}
-
-	requestSlice(start: number, length: number): MaybePromise<FileSlice | null> {
-		if (this.source._disposed) {
-			throw new InputDisposedError();
-		}
-
-		if (this.fileSize !== null && start + length > this.fileSize) {
-			return null;
-		}
-
-		const end = start + length;
-		const result = this.source._read(start, end);
-
-		if (result instanceof Promise) {
-			return result.then((x) => {
-				if (!x) {
-					return null;
-				}
-
-				return new FileSlice(x.bytes, x.view, x.offset, start, end);
-			});
-		} else {
-			if (!result) {
-				return null;
-			}
-
-			return new FileSlice(result.bytes, result.view, result.offset, start, end);
-		}
-	}
-
-	requestSliceRange(start: number, minLength: number, maxLength: number): MaybePromise<FileSlice | null> {
-		if (this.source._disposed) {
-			throw new InputDisposedError();
-		}
-
-		if (this.fileSize !== null) {
-			return this.requestSlice(
-				start,
-				clamp(this.fileSize - start, minLength, maxLength),
-			);
-		} else {
-			const promisedAttempt = this.requestSlice(start, maxLength);
-
-			const handleAttempt = (attempt: FileSlice | null) => {
-				if (attempt) {
-					return attempt;
-				}
-
-				const handleFileSize = (fileSize: number | null) => {
-					assert(fileSize !== null); // The slice couldn't fit, meaning we must know the file size now
-
-					return this.requestSlice(
-						start,
-						clamp(fileSize - start, minLength, maxLength),
-					);
-				};
-
-				const promisedFileSize = this.source._retrieveSize();
-				if (promisedFileSize instanceof Promise) {
-					return promisedFileSize.then(handleFileSize);
-				} else {
-					return handleFileSize(promisedFileSize);
-				}
-			};
-
-			if (promisedAttempt instanceof Promise) {
-				return promisedAttempt.then(handleAttempt);
-			} else {
-				return handleAttempt(promisedAttempt);
-			}
-		}
-	}
-}
-
-export class FileSlice {
-	/** The current position in the backing buffer. Do not modify directly, prefer `.skip()` instead. */
-	bufferPos: number;
-
-	constructor(
-		/** The underlying bytes backing this slice. Avoid using this directly and prefer reader functions instead. */
-		public readonly bytes: Uint8Array,
-		/** A view into the bytes backing this slice. Avoid using this directly and prefer reader functions instead. */
-		public readonly view: DataView,
-		/** The offset in "file bytes" at which `bytes` begins in the file. */
-		private readonly offset: number,
-		/** The offset in "file bytes" where this slice begins. */
-		public readonly start: number,
-		/** The offset in "file bytes" where this slice ends (exclusive). */
-		public readonly end: number,
-	) {
-		this.bufferPos = start - offset;
-	}
-
-	static tempFromBytes(bytes: Uint8Array) {
-		return new FileSlice(
-			bytes,
-			toDataView(bytes),
-			0,
-			0,
-			bytes.length,
-		);
-	}
-
-	get length() {
-		return this.end - this.start;
-	}
-
-	get filePos() {
-		return this.offset + this.bufferPos;
-	}
-
-	set filePos(value: number) {
-		this.bufferPos = value - this.offset;
-	}
-
-	/** The number of bytes left from the current pos to the end of the slice. */
-	get remainingLength() {
-		return Math.max(this.end - this.filePos, 0);
-	}
-
-	skip(byteCount: number) {
-		this.bufferPos += byteCount;
-	}
-
-	/** Creates a new subslice of this slice whose byte range must be contained within this slice. */
-	slice(filePos: number, length = this.end - filePos) {
-		if (filePos < this.start || filePos + length > this.end) {
-			throw new RangeError('Slicing outside of original slice.');
-		}
-
-		return new FileSlice(
-			this.bytes,
-			this.view,
-			this.offset,
-			filePos,
-			filePos + length,
-		);
-	}
-}
-
-const checkIsInRange = (slice: FileSlice, bytesToRead: number) => {
-	if (slice.filePos < slice.start || slice.filePos + bytesToRead > slice.end) {
-		throw new RangeError(
-			`Tried reading [${slice.filePos}, ${slice.filePos + bytesToRead}), but slice is`
-			+ ` [${slice.start}, ${slice.end}). This is likely an internal error, please report it alongside the file`
-			+ ` that caused it.`,
-		);
-	}
-};
-
-export const readBytes = (slice: FileSlice, length: number) => {
-	checkIsInRange(slice, length);
-
-	const bytes = slice.bytes.subarray(slice.bufferPos, slice.bufferPos + length);
-	slice.bufferPos += length;
-
-	return bytes;
-};
-
-export const readU8 = (slice: FileSlice) => {
-	checkIsInRange(slice, 1);
-	return slice.view.getUint8(slice.bufferPos++);
-};
-
-export const readU16 = (slice: FileSlice, littleEndian: boolean) => {
-	checkIsInRange(slice, 2);
-
-	const value = slice.view.getUint16(slice.bufferPos, littleEndian);
-	slice.bufferPos += 2;
-
-	return value;
-};
-
-export const readU16Be = (slice: FileSlice) => {
-	checkIsInRange(slice, 2);
-
-	const value = slice.view.getUint16(slice.bufferPos, false);
-	slice.bufferPos += 2;
-
-	return value;
-};
-
-export const readU24Be = (slice: FileSlice) => {
-	checkIsInRange(slice, 3);
-
-	const value = getUint24(slice.view, slice.bufferPos, false);
-	slice.bufferPos += 3;
-
-	return value;
-};
-
-export const readI16Be = (slice: FileSlice) => {
-	checkIsInRange(slice, 2);
-
-	const value = slice.view.getInt16(slice.bufferPos, false);
-	slice.bufferPos += 2;
-
-	return value;
-};
-
-export const readU32 = (slice: FileSlice, littleEndian: boolean) => {
-	checkIsInRange(slice, 4);
-
-	const value = slice.view.getUint32(slice.bufferPos, littleEndian);
-	slice.bufferPos += 4;
-
-	return value;
-};
-
-export const readU32Be = (slice: FileSlice) => {
-	checkIsInRange(slice, 4);
-
-	const value = slice.view.getUint32(slice.bufferPos, false);
-	slice.bufferPos += 4;
-
-	return value;
-};
-
-export const readU32Le = (slice: FileSlice) => {
-	checkIsInRange(slice, 4);
-
-	const value = slice.view.getUint32(slice.bufferPos, true);
-	slice.bufferPos += 4;
-
-	return value;
-};
-
-export const readI32Be = (slice: FileSlice) => {
-	checkIsInRange(slice, 4);
-
-	const value = slice.view.getInt32(slice.bufferPos, false);
-	slice.bufferPos += 4;
-
-	return value;
-};
-
-export const readI32Le = (slice: FileSlice) => {
-	checkIsInRange(slice, 4);
-
-	const value = slice.view.getInt32(slice.bufferPos, true);
-	slice.bufferPos += 4;
-
-	return value;
-};
-
-export const readU64 = (slice: FileSlice, littleEndian: boolean) => {
-	let low: number;
-	let high: number;
-
-	if (littleEndian) {
-		low = readU32(slice, true);
-		high = readU32(slice, true);
-	} else {
-		high = readU32(slice, false);
-		low = readU32(slice, false);
-	}
-
-	return high * 0x100000000 + low;
-};
-
-export const readU64Be = (slice: FileSlice) => {
-	const high = readU32Be(slice);
-	const low = readU32Be(slice);
-	return high * 0x100000000 + low;
-};
-
-export const readI64Be = (slice: FileSlice) => {
-	const high = readI32Be(slice);
-	const low = readU32Be(slice);
-	return high * 0x100000000 + low;
-};
-
-export const readI64Le = (slice: FileSlice) => {
-	const low = readU32Le(slice);
-	const high = readI32Le(slice);
-	return high * 0x100000000 + low;
-};
-
-export const readF32Be = (slice: FileSlice) => {
-	checkIsInRange(slice, 4);
-
-	const value = slice.view.getFloat32(slice.bufferPos, false);
-	slice.bufferPos += 4;
-
-	return value;
-};
-
-export const readF64Be = (slice: FileSlice) => {
-	checkIsInRange(slice, 8);
-
-	const value = slice.view.getFloat64(slice.bufferPos, false);
-	slice.bufferPos += 8;
-
-	return value;
-};
-
-export const readAscii = (slice: FileSlice, length: number) => {
-	checkIsInRange(slice, length);
-
-	let str = '';
-
-	for (let i = 0; i < length; i++) {
-		str += String.fromCharCode(slice.bytes[slice.bufferPos++]!);
-	}
-
-	return str;
-};