@moqtap/codec 0.2.2 → 0.3.0

package/dist/drafts/draft15/data-streams.js

@@ -1,675 +0,0 @@
-import { BufferReader } from "../../core/buffer-reader.js";
-import { BufferWriter } from "../../core/buffer-writer.js";
-import { DecodeError } from "../../core/types.js";
-// ─── Data Stream Encoding/Decoding ─────────────────────────────────────────────
-// Draft-15 subgroup stream types use 0x10-0x1D range.
-// For MVP, we use 0x10 (subgroupId=0, no extensions, no endOfGroup, priority present).
-const _SUBGROUP_STREAM_TYPE_SIMPLE = 0x10n;
-// Draft-15 fetch stream type
-const FETCH_STREAM_TYPE = 0x05n;
-/**
- * Encode a subgroup stream header + objects.
- * Uses the headerType from the stream to reproduce the exact wire type byte.
- */
-export function encodeSubgroupStream(stream) {
-    const w = new BufferWriter();
-    const streamType = stream.headerType;
-    w.writeVarInt(BigInt(streamType));
-    const extensionsPresent = (streamType & 0x01) !== 0;
-    const hasSubgroupField = (streamType & 0x04) !== 0;
-    const hasPriority = streamType < 0x30;
-    w.writeVarInt(stream.trackAlias);
-    w.writeVarInt(stream.groupId);
-    if (hasSubgroupField) {
-        w.writeVarInt(stream.subgroupId);
-    }
-    if (hasPriority) {
-        w.writeUint8(stream.publisherPriority);
-    }
-    // Objects: delta-encoded object IDs
-    let prevObjectId = -1n;
-    for (const obj of stream.objects) {
-        const delta = prevObjectId < 0n ? obj.objectId : obj.objectId - prevObjectId - 1n;
-        w.writeVarInt(delta);
-        if (extensionsPresent) {
-            w.writeVarInt(BigInt(obj.extensionData.length));
-            if (obj.extensionData.length > 0)
-                w.writeBytes(obj.extensionData);
-        }
-        w.writeVarInt(obj.payloadLength);
-        if (obj.payloadLength === 0) {
-            w.writeVarInt(obj.status ?? 0n);
-        }
-        else {
-            w.writeBytes(obj.payload);
-        }
-        prevObjectId = obj.objectId;
-    }
-    return w.finish();
-}
-/**
- * Encode a datagram object.
- * Uses type 0x00: Object ID present, priority present, no extensions, no EOG, payload.
- */
-export function encodeDatagram(dg) {
-    const w = new BufferWriter();
-    // Determine datagram type byte from fields
-    const dgType = dg.datagramType;
-    w.writeVarInt(BigInt(dgType));
-    w.writeVarInt(dg.trackAlias);
-    w.writeVarInt(dg.groupId);
-    // Datagram type flags:
-    // bit 2 (0x04): object_id ABSENT when set
-    // bit 1 (0x02): end-of-group
-    // bit 5 (0x20): status (replaces payload)
-    const objectIdAbsent = (dgType & 0x04) !== 0;
-    const isStatus = (dgType & 0x20) !== 0;
-    if (!objectIdAbsent) {
-        w.writeVarInt(dg.objectId);
-    }
-    w.writeUint8(dg.publisherPriority);
-    if (isStatus) {
-        w.writeVarInt(dg.objectStatus ?? 0n);
-    }
-    else {
-        w.writeBytes(dg.payload);
-    }
-    return w.finish();
-}
-/**
- * Encode a fetch stream header + objects.
- */
-export function encodeFetchStream(stream) {
-    const w = new BufferWriter();
-    w.writeVarInt(FETCH_STREAM_TYPE);
-    w.writeVarInt(stream.requestId);
-    for (const obj of stream.objects) {
-        w.writeUint8(obj.serializationFlags);
-        const flags = obj.serializationFlags;
-        if (flags & 0x08)
-            w.writeVarInt(obj.groupId);
-        // subgroup encoding: bits 0-1
-        const subgroupEncoding = flags & 0x03;
-        if (subgroupEncoding === 0x03)
-            w.writeVarInt(obj.subgroupId);
-        if (flags & 0x04)
-            w.writeVarInt(obj.objectId);
-        if (flags & 0x10)
-            w.writeUint8(obj.publisherPriority);
-        if (flags & 0x20) {
-            w.writeVarInt(BigInt(obj.extensionData.length));
-            if (obj.extensionData.length > 0)
-                w.writeBytes(obj.extensionData);
-        }
-        w.writeVarInt(obj.payloadLength);
-        if (obj.payloadLength === 0) {
-            w.writeVarInt(obj.status ?? 0n);
-        }
-        else {
-            w.writeBytes(obj.payload);
-        }
-    }
-    return w.finish();
-}
-/**
- * Decode a subgroup data stream from raw bytes.
- */
-export function decodeSubgroupStream(bytes) {
-    try {
-        const r = new BufferReader(bytes);
-        const streamType = Number(r.readVarInt());
-        // Valid subgroup types: 0x10-0x15, 0x18-0x1D, 0x30-0x35, 0x38-0x3D
-        if (!((streamType >= 0x10 && streamType <= 0x1d) || (streamType >= 0x30 && streamType <= 0x3d)) ||
-            (streamType & 0x06) === 0x06 // reserved SUBGROUP_ID_MODE (bits 2:1 = 0b11)
-        ) {
-            return {
-                ok: false,
-                error: new DecodeError("CONSTRAINT_VIOLATION", `Expected subgroup stream type 0x10-0x15/0x18-0x1D/0x30-0x35/0x38-0x3D, got 0x${streamType.toString(16)}`, 0),
-            };
-        }
-        // Decode type flags
-        const extensionsPresent = (streamType & 0x01) !== 0;
-        const hasSubgroupField = (streamType & 0x04) !== 0;
-        const subgroupIsFirstObjId = (streamType & 0x02) !== 0 && !hasSubgroupField;
-        const hasPriority = streamType < 0x30;
-        const trackAlias = r.readVarInt();
-        const groupId = r.readVarInt();
-        let subgroupId = 0n;
-        if (hasSubgroupField) {
-            subgroupId = r.readVarInt();
-        }
-        let publisherPriority = 128; // default
-        if (hasPriority) {
-            publisherPriority = r.readUint8();
-        }
-        const objects = [];
-        let prevObjectId = -1n;
-        let firstObject = true;
-        while (r.remaining > 0) {
-            const byteOffset = r.offset;
-            const delta = r.readVarInt();
-            let objectId;
-            if (firstObject) {
-                objectId = delta;
-                if (subgroupIsFirstObjId && firstObject) {
-                    subgroupId = objectId;
-                }
-                firstObject = false;
-            }
-            else {
-                objectId = prevObjectId + 1n + delta;
-            }
-            let extensionData = new Uint8Array(0);
-            if (extensionsPresent) {
-                const extLen = Number(r.readVarInt());
-                extensionData = extLen > 0 ? r.readBytes(extLen) : new Uint8Array(0);
-            }
-            const payloadLength = Number(r.readVarInt());
-            let payload;
-            let status;
-            let payloadByteOffset;
-            if (payloadLength === 0) {
-                // When payload_length is 0, an object status varint follows
-                status = r.readVarInt();
-                payloadByteOffset = r.offset;
-                payload = new Uint8Array(0);
-            }
-            else {
-                payloadByteOffset = r.offset;
-                payload = r.readBytes(payloadLength);
-            }
-            const obj = { type: "object", byteOffset, payloadByteOffset, objectId, payloadLength, extensionData, payload };
-            if (status !== undefined)
-                obj.status = status;
-            objects.push(obj);
-            prevObjectId = objectId;
-        }
-        return {
-            ok: true,
-            value: {
-                type: "subgroup",
-                headerType: streamType,
-                trackAlias,
-                groupId,
-                subgroupId,
-                publisherPriority,
-                objects,
-            },
-            bytesRead: r.offset,
-        };
-    }
-    catch (e) {
-        if (e instanceof DecodeError)
-            return { ok: false, error: e };
-        throw e;
-    }
-}
-/**
- * Decode a datagram object from raw bytes.
- */
-export function decodeDatagram(bytes) {
-    try {
-        const r = new BufferReader(bytes);
-        const dgType = Number(r.readVarInt());
-        // Datagram type flags:
-        // bit 2 (0x04): object_id ABSENT when set
-        // bit 1 (0x02): end-of-group
-        // bit 5 (0x20): status (replaces payload with status varint)
-        const objectIdAbsent = (dgType & 0x04) !== 0;
-        const endOfGroup = (dgType & 0x02) !== 0;
-        const isStatus = (dgType & 0x20) !== 0;
-        const trackAlias = r.readVarInt();
-        const groupId = r.readVarInt();
-        let objectId = 0n;
-        if (!objectIdAbsent) {
-            objectId = r.readVarInt();
-        }
-        const publisherPriority = r.readUint8();
-        let objectStatus;
-        let payload;
-        if (isStatus) {
-            objectStatus = r.readVarInt();
-            payload = new Uint8Array(0);
-        }
-        else {
-            payload = r.readBytes(r.remaining);
-        }
-        const payloadLength = payload.byteLength;
-        const result = {
-            type: "datagram",
-            datagramType: dgType,
-            trackAlias,
-            groupId,
-            objectId,
-            publisherPriority,
-            payloadLength,
-            payload,
-        };
-        if (endOfGroup)
-            result.endOfGroup = true;
-        if (objectStatus !== undefined)
-            result.objectStatus = objectStatus;
-        return { ok: true, value: result, bytesRead: r.offset };
-    }
-    catch (e) {
-        if (e instanceof DecodeError)
-            return { ok: false, error: e };
-        throw e;
-    }
-}
-/**
- * Decode a fetch data stream from raw bytes.
- */
-export function decodeFetchStream(bytes) {
-    try {
-        const r = new BufferReader(bytes);
-        const streamType = r.readVarInt();
-        if (streamType !== FETCH_STREAM_TYPE) {
-            return {
-                ok: false,
-                error: new DecodeError("CONSTRAINT_VIOLATION", `Expected fetch stream type 0x05, got 0x${streamType.toString(16)}`, 0),
-            };
-        }
-        const requestId = r.readVarInt();
-        const objects = [];
-        let prevGroupId = 0n;
-        let prevSubgroupId = 0n;
-        let prevObjectId = 0n;
-        let prevPriority = 128;
-        let first = true;
-        while (r.remaining > 0) {
-            const byteOffset = r.offset;
-            const flags = r.readUint8();
-            const subgroupEncoding = flags & 0x03;
-            const objectIdPresent = (flags & 0x04) !== 0;
-            const groupIdPresent = (flags & 0x08) !== 0;
-            const priorityPresent = (flags & 0x10) !== 0;
-            const extensionsPresent = (flags & 0x20) !== 0;
-            if (flags & 0xc0) {
-                return {
-                    ok: false,
-                    error: new DecodeError("CONSTRAINT_VIOLATION", "Reserved bits set in fetch object flags", r.offset),
-                };
-            }
-            let groupId = prevGroupId;
-            if (groupIdPresent) {
-                groupId = r.readVarInt();
-            }
-            else if (first) {
-                return {
-                    ok: false,
-                    error: new DecodeError("CONSTRAINT_VIOLATION", "First fetch object must include groupId", r.offset),
-                };
-            }
-            let subgroupId;
-            if (subgroupEncoding === 0x00) {
-                subgroupId = 0n;
-            }
-            else if (subgroupEncoding === 0x01) {
-                if (first) {
-                    return {
-                        ok: false,
-                        error: new DecodeError("CONSTRAINT_VIOLATION", "First fetch object cannot reference prior subgroupId", r.offset),
-                    };
-                }
-                subgroupId = prevSubgroupId;
-            }
-            else if (subgroupEncoding === 0x02) {
-                if (first) {
-                    return {
-                        ok: false,
-                        error: new DecodeError("CONSTRAINT_VIOLATION", "First fetch object cannot reference prior subgroupId", r.offset),
-                    };
-                }
-                subgroupId = prevSubgroupId + 1n;
-            }
-            else {
-                subgroupId = r.readVarInt();
-            }
-            let objectId = prevObjectId + 1n;
-            if (objectIdPresent) {
-                objectId = r.readVarInt();
-            }
-            else if (first) {
-                return {
-                    ok: false,
-                    error: new DecodeError("CONSTRAINT_VIOLATION", "First fetch object must include objectId", r.offset),
-                };
-            }
-            if (priorityPresent) {
-                prevPriority = r.readUint8();
-            }
-            let extensionData = new Uint8Array(0);
-            if (extensionsPresent) {
-                const extLen = Number(r.readVarInt());
-                extensionData = extLen > 0 ? r.readBytes(extLen) : new Uint8Array(0);
-            }
-            const payloadLength = Number(r.readVarInt());
-            let payload;
-            let status;
-            let payloadByteOffset;
-            if (payloadLength > 0) {
-                payloadByteOffset = r.offset;
-                payload = r.readBytes(payloadLength);
-            }
-            else {
-                status = r.readVarInt();
-                payloadByteOffset = r.offset;
-                payload = new Uint8Array(0);
-            }
-            const obj = {
-                type: "object",
-                byteOffset,
-                payloadByteOffset,
-                serializationFlags: flags,
-                groupId,
-                subgroupId,
-                objectId,
-                publisherPriority: prevPriority,
-                payloadLength,
-                extensionData,
-                payload,
-            };
-            if (status !== undefined)
-                obj.status = status;
-            objects.push(obj);
-            prevGroupId = groupId;
-            prevSubgroupId = subgroupId;
-            prevObjectId = objectId;
-            first = false;
-        }
-        return {
-            ok: true,
-            value: { type: "fetch", requestId, objects },
-            bytesRead: r.offset,
-        };
-    }
-    catch (e) {
-        if (e instanceof DecodeError)
-            return { ok: false, error: e };
-        throw e;
-    }
-}
-/**
- * Decode a data stream, dispatching by stream type.
- */
-export function decodeDataStream(streamType, bytes) {
-    switch (streamType) {
-        case "subgroup":
-            return decodeSubgroupStream(bytes);
-        case "datagram":
-            return decodeDatagram(bytes);
-        case "fetch":
-            return decodeFetchStream(bytes);
-        default: {
-            const _exhaustive = streamType;
-            throw new Error(`Unknown stream type: ${_exhaustive}`);
-        }
-    }
-}
-// ─── Data Stream Decoders ──────────────────────────────────────────────────────
-/**
- * Create a TransformStream that decodes a subgroup data stream.
- */
-export function createSubgroupStreamDecoder() {
-    let buffer = new Uint8Array(0);
-    let headerEmitted = false;
-    let prevObjectId = -1n;
-    let firstObject = true;
-    let _subgroupIsFirstObjId = false;
-    let _extensionsPresent = false;
-    return new TransformStream({
-        transform(chunk, controller) {
-            const newBuffer = new Uint8Array(buffer.length + chunk.length);
-            newBuffer.set(buffer, 0);
-            newBuffer.set(chunk, buffer.length);
-            buffer = newBuffer;
-            if (!headerEmitted) {
-                try {
-                    const r = new BufferReader(buffer);
-                    const streamType = Number(r.readVarInt());
-                    if (!((streamType >= 0x10 && streamType <= 0x1d) ||
-                        (streamType >= 0x30 && streamType <= 0x3d))) {
-                        controller.error(new DecodeError("CONSTRAINT_VIOLATION", `Expected subgroup stream type, got 0x${streamType.toString(16)}`, 0));
-                        return;
-                    }
-                    _extensionsPresent = (streamType & 0x01) !== 0;
-                    const hasSubgroupField = (streamType & 0x04) !== 0;
-                    _subgroupIsFirstObjId = (streamType & 0x02) !== 0 && !hasSubgroupField;
-                    const hasPriority = streamType < 0x30;
-                    const trackAlias = r.readVarInt();
-                    const groupId = r.readVarInt();
-                    let subgroupId = 0n;
-                    if (hasSubgroupField) {
-                        subgroupId = r.readVarInt();
-                    }
-                    let publisherPriority = 128;
-                    if (hasPriority) {
-                        publisherPriority = r.readUint8();
-                    }
-                    controller.enqueue({
-                        type: "subgroup_header",
-                        trackAlias,
-                        groupId,
-                        subgroupId,
-                        publisherPriority,
-                    });
-                    headerEmitted = true;
-                    buffer = buffer.slice(r.offset);
-                }
-                catch (e) {
-                    if (e instanceof DecodeError && e.code === "UNEXPECTED_END") {
-                        return;
-                    }
-                    controller.error(e);
-                    return;
-                }
-            }
-            // Parse objects with delta-encoded IDs
-            while (buffer.length > 0) {
-                try {
-                    const r = new BufferReader(buffer);
-                    const byteOffset = r.offset;
-                    const delta = r.readVarInt();
-                    let objectId;
-                    if (firstObject) {
-                        objectId = delta;
-                        firstObject = false;
-                    }
-                    else {
-                        objectId = prevObjectId + 1n + delta;
-                    }
-                    let extensionData = new Uint8Array(0);
-                    if (_extensionsPresent) {
-                        const extLen = Number(r.readVarInt());
-                        extensionData = extLen > 0 ? r.readBytes(extLen) : new Uint8Array(0);
-                    }
-                    const payloadLength = Number(r.readVarInt());
-                    const payloadByteOffset = r.offset;
-                    const payload = payloadLength > 0 ? r.readBytes(payloadLength) : new Uint8Array(0);
-                    controller.enqueue({ type: "object", byteOffset, payloadByteOffset, objectId, payloadLength, extensionData, payload });
-                    buffer = buffer.slice(r.offset);
-                    prevObjectId = objectId;
-                }
-                catch (e) {
-                    if (e instanceof DecodeError && e.code === "UNEXPECTED_END") {
-                        break;
-                    }
-                    controller.error(e);
-                    return;
-                }
-            }
-        },
-        flush(controller) {
-            if (buffer.length > 0) {
-                controller.error(new DecodeError("UNEXPECTED_END", "Stream ended with incomplete data", 0));
-            }
-        },
-    });
-}
-/**
- * Create a TransformStream that decodes a fetch data stream.
- */
-export function createFetchStreamDecoder() {
-    let buffer = new Uint8Array(0);
-    let headerEmitted = false;
-    return new TransformStream({
-        transform(chunk, controller) {
-            const newBuffer = new Uint8Array(buffer.length + chunk.length);
-            newBuffer.set(buffer, 0);
-            newBuffer.set(chunk, buffer.length);
-            buffer = newBuffer;
-            if (!headerEmitted) {
-                try {
-                    const r = new BufferReader(buffer);
-                    const streamType = r.readVarInt();
-                    if (streamType !== FETCH_STREAM_TYPE) {
-                        controller.error(new DecodeError("CONSTRAINT_VIOLATION", `Expected fetch stream type 0x05, got 0x${streamType.toString(16)}`, 0));
-                        return;
-                    }
-                    const requestId = r.readVarInt();
-                    controller.enqueue({ type: "fetch_header", requestId });
-                    headerEmitted = true;
-                    buffer = buffer.slice(r.offset);
-                }
-                catch (e) {
-                    if (e instanceof DecodeError && e.code === "UNEXPECTED_END") {
-                        return;
-                    }
-                    controller.error(e);
-                    return;
-                }
-            }
-            // Parse fetch objects with serialization flags
-            // Simplified: just read flags + explicit fields
-            while (buffer.length > 0) {
-                try {
-                    const r = new BufferReader(buffer);
-                    const flags = r.readUint8();
-                    const objectIdPresent = (flags & 0x04) !== 0;
-                    const groupIdPresent = (flags & 0x08) !== 0;
-                    const priorityPresent = (flags & 0x10) !== 0;
-                    const extensionsPresent = (flags & 0x20) !== 0;
-                    const subgroupEncoding = flags & 0x03;
-                    if (groupIdPresent)
-                        r.readVarInt(); // groupId — consumed
-                    if (subgroupEncoding === 0x03)
-                        r.readVarInt(); // subgroupId — consumed
-                    let objectId = 0n;
-                    if (objectIdPresent)
-                        objectId = r.readVarInt();
-                    if (priorityPresent)
-                        r.readUint8(); // priority — consumed
-                    let extensionData = new Uint8Array(0);
-                    if (extensionsPresent) {
-                        const extLen = Number(r.readVarInt());
-                        extensionData = extLen > 0 ? r.readBytes(extLen) : new Uint8Array(0);
-                    }
-                    const payloadLength = Number(r.readVarInt());
-                    const payloadByteOffset = r.offset;
-                    const payload = payloadLength > 0 ? r.readBytes(payloadLength) : new Uint8Array(0);
-                    controller.enqueue({ type: "object", objectId, payloadLength, extensionData, payload, byteOffset: 0, payloadByteOffset });
-                    buffer = buffer.slice(r.offset);
-                }
-                catch (e) {
-                    if (e instanceof DecodeError && e.code === "UNEXPECTED_END") {
-                        break;
-                    }
-                    controller.error(e);
-                    return;
-                }
-            }
-        },
-        flush(controller) {
-            if (buffer.length > 0) {
-                controller.error(new DecodeError("UNEXPECTED_END", "Stream ended with incomplete data", 0));
-            }
-        },
-    });
-}
-/**
- * Create a unified auto-detecting data stream decoder.
- */
-export function createDataStreamDecoder() {
-    let buffer = new Uint8Array(0);
-    let inner = null;
-    const _innerWriter = null;
-    const _innerReader = null;
-    return new TransformStream({
-        transform(chunk, controller) {
-            const newBuffer = new Uint8Array(buffer.length + chunk.length);
-            newBuffer.set(buffer, 0);
-            newBuffer.set(chunk, buffer.length);
-            buffer = newBuffer;
-            if (inner === null) {
-                // Need at least one byte to determine type
-                if (buffer.length === 0)
-                    return;
-                const firstByte = buffer[0];
-                if ((firstByte >= 0x10 && firstByte <= 0x1d) || (firstByte >= 0x30 && firstByte <= 0x3d)) {
-                    // Subgroup — delegate to subgroup decoder
-                    // We need to feed the full buffer including the type byte
-                    const decoder = createSubgroupStreamDecoder();
-                    inner = decoder;
-                }
-                else if (firstByte === 0x05) {
-                    // Fetch
-                    const decoder = createFetchStreamDecoder();
-                    inner = decoder;
-                }
-                else {
-                    controller.error(new DecodeError("CONSTRAINT_VIOLATION", `Unknown data stream type: 0x${firstByte.toString(16)}`, 0));
-                    return;
-                }
-                // For simplicity, process inline instead of piping
-                // Just re-parse from buffer using the appropriate one-shot decoder
-            }
-            // Since inner TransformStream piping is complex, use a simpler approach:
-            // Accumulate and attempt decode when flush is called
-            // For the streaming case, we just buffer everything
-        },
-        flush(controller) {
-            if (buffer.length === 0)
-                return;
-            const firstByte = buffer[0];
-            let result;
-            if ((firstByte >= 0x10 && firstByte <= 0x1d) || (firstByte >= 0x30 && firstByte <= 0x3d)) {
-                result = decodeSubgroupStream(buffer);
-            }
-            else if (firstByte === 0x05) {
-                result = decodeFetchStream(buffer);
-            }
-            else {
-                controller.error(new DecodeError("CONSTRAINT_VIOLATION", `Unknown data stream type: 0x${firstByte.toString(16)}`, 0));
-                return;
-            }
-            if (!result.ok) {
-                controller.error(result.error);
-                return;
-            }
-            const stream = result.value;
-            if (stream.type === "subgroup") {
-                controller.enqueue({
-                    type: "subgroup_header",
-                    trackAlias: stream.trackAlias,
-                    groupId: stream.groupId,
-                    subgroupId: stream.subgroupId,
-                    publisherPriority: stream.publisherPriority,
-                });
-                for (const obj of stream.objects) {
-                    controller.enqueue(obj);
-                }
-            }
-            else if (stream.type === "fetch") {
-                controller.enqueue({
-                    type: "fetch_header",
-                    requestId: stream.requestId,
-                });
-                for (const obj of stream.objects) {
-                    controller.enqueue(obj);
-                }
-            }
-        },
-    });
-}
-//# sourceMappingURL=data-streams.js.map