@tomgiee/tsdp 1.0.0

package/dist/src/parser/field-parser.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Field parsers for SDP (RFC 8866)
+ *
+ * Parsers for individual SDP field types (v=, o=, s=, i=, u=, e=, p=, c=, b=, k=)
+ */
+import { Scanner } from './scanner';
+import { Version, SessionName, Information, URI, Email, Phone, Key } from '../types/primitives';
+import { Origin, Connection, Bandwidth } from '../types/fields';
+/**
+ * Parse version field
+ *
+ * Format: v=0
+ *
+ * @param scanner - Scanner instance
+ * @returns Version (currently always 0)
+ * @throws ParseError if version is not 0
+ */
+export declare function parseVersionField(scanner: Scanner): Version;
+/**
+ * Parse origin field
+ *
+ * Format: o=<username> SP <sess-id> SP <sess-version> SP <nettype> SP <addrtype> SP <unicast-address>
+ *
+ * @param scanner - Scanner instance
+ * @returns Origin object
+ * @throws ParseError if invalid format
+ */
+export declare function parseOriginField(scanner: Scanner): Origin;
+/**
+ * Parse session name field
+ *
+ * Format: s=<session name>
+ *
+ * Session name can be a single space (" ") if there is no meaningful name.
+ *
+ * @param scanner - Scanner instance
+ * @returns SessionName
+ * @throws ParseError if empty
+ */
+export declare function parseSessionNameField(scanner: Scanner): SessionName;
+/**
+ * Parse information field
+ *
+ * Format: i=<session information>
+ *
+ * @param scanner - Scanner instance
+ * @returns Information string
+ */
+export declare function parseInformationField(scanner: Scanner): Information;
+/**
+ * Parse URI field
+ *
+ * Format: u=<uri>
+ *
+ * @param scanner - Scanner instance
+ * @returns URI string
+ */
+export declare function parseUriField(scanner: Scanner): URI;
+/**
+ * Parse email field
+ *
+ * Format: e=<email-address> or e=<display-name> <email-address>
+ *
+ * @param scanner - Scanner instance
+ * @returns Email string
+ */
+export declare function parseEmailField(scanner: Scanner): Email;
+/**
+ * Parse phone field
+ *
+ * Format: p=<phone-number> or p=<display-name> <phone-number>
+ *
+ * @param scanner - Scanner instance
+ * @returns Phone string
+ */
+export declare function parsePhoneField(scanner: Scanner): Phone;
+/**
+ * Parse connection field
+ *
+ * Format: c=<nettype> SP <addrtype> SP <connection-address>
+ *
+ * connection-address can be:
+ * - unicast-address
+ * - multicast-address (with optional TTL and number of addresses)
+ *
+ * @param scanner - Scanner instance
+ * @returns Connection object
+ * @throws ParseError if invalid format
+ */
+export declare function parseConnectionField(scanner: Scanner): Connection;
+/**
+ * Parse bandwidth field
+ *
+ * Format: b=<bwtype>:<bandwidth>
+ *
+ * bwtype can be:
+ * - CT (Conference Total)
+ * - AS (Application Specific)
+ * - Or any registered extension type
+ *
+ * bandwidth is in kilobits per second
+ *
+ * @param scanner - Scanner instance
+ * @returns Bandwidth object
+ * @throws ParseError if invalid format
+ */
+export declare function parseBandwidthField(scanner: Scanner): Bandwidth;
+/**
+ * Parse key field (OBSOLETE per RFC 8866)
+ *
+ * Format: k=<method>:<encryption-key>
+ * Or: k=<method> (if no key data)
+ *
+ * Common methods:
+ * - clear:<encryption-key> - key is included untransformed
+ * - base64:<encoded-encryption-key> - key is base64 encoded
+ * - uri:<uri-to-obtain-key> - URI where key can be obtained
+ * - prompt - no key included, user will be prompted
+ *
+ * @param scanner - Scanner instance
+ * @returns Key string
+ */
+export declare function parseKeyField(scanner: Scanner): Key;
+//# sourceMappingURL=field-parser.d.ts.map

package/dist/src/parser/field-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-parser.d.ts","sourceRoot":"","sources":["../../../src/parser/field-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,OAAO,EACL,OAAO,EACP,WAAW,EAMX,WAAW,EACX,GAAG,EACH,KAAK,EACL,KAAK,EACL,GAAG,EAGJ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAmD,MAAM,iBAAiB,CAAC;AA0BjH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAa3D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAmCzD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAenE;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGnE;AAMD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAEnD;AAMD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAEvD;AAMD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAEvD;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAiBjE;AAyHD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAqB/D;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAGnD"}

package/dist/src/parser/field-parser.js

@@ -0,0 +1,335 @@
+"use strict";
+/**
+ * Field parsers for SDP (RFC 8866)
+ *
+ * Parsers for individual SDP field types (v=, o=, s=, i=, u=, e=, p=, c=, b=, k=)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVersionField = parseVersionField;
+exports.parseOriginField = parseOriginField;
+exports.parseSessionNameField = parseSessionNameField;
+exports.parseInformationField = parseInformationField;
+exports.parseUriField = parseUriField;
+exports.parseEmailField = parseEmailField;
+exports.parsePhoneField = parsePhoneField;
+exports.parseConnectionField = parseConnectionField;
+exports.parseBandwidthField = parseBandwidthField;
+exports.parseKeyField = parseKeyField;
+const primitive_parser_1 = require("./primitive-parser");
+const errors_1 = require("../types/errors");
+const primitives_1 = require("../types/primitives");
+const fields_1 = require("../types/fields");
+const network_1 = require("../types/network");
+const address_parser_1 = require("../utils/address-parser");
+const address_parser_2 = require("../utils/address-parser");
+// ============================================================================
+// Version Field Parser (v=)
+// ============================================================================
+/**
+ * Parse version field
+ *
+ * Format: v=0
+ *
+ * @param scanner - Scanner instance
+ * @returns Version (currently always 0)
+ * @throws ParseError if version is not 0
+ */
+function parseVersionField(scanner) {
+    const start = scanner.getPosition();
+    const version = (0, primitive_parser_1.parseInteger)(scanner);
+    if (version !== 0) {
+        throw new errors_1.ParseError(`Unsupported SDP version: ${version} (expected 0)`, start.line, start.column);
+    }
+    return (0, primitives_1.createVersion)(version);
+}
+// ============================================================================
+// Origin Field Parser (o=)
+// ============================================================================
+/**
+ * Parse origin field
+ *
+ * Format: o=<username> SP <sess-id> SP <sess-version> SP <nettype> SP <addrtype> SP <unicast-address>
+ *
+ * @param scanner - Scanner instance
+ * @returns Origin object
+ * @throws ParseError if invalid format
+ */
+function parseOriginField(scanner) {
+    const start = scanner.getPosition();
+    // Parse username (non-whitespace string)
+    const username = (0, primitive_parser_1.parseNonWSString)(scanner);
+    scanner.expectSpace();
+    // Parse session ID (non-whitespace string)
+    const sessId = (0, primitive_parser_1.parseNonWSString)(scanner);
+    scanner.expectSpace();
+    // Parse session version (non-whitespace string)
+    const sessVersion = (0, primitive_parser_1.parseNonWSString)(scanner);
+    scanner.expectSpace();
+    // Parse network type (token)
+    const netType = (0, primitive_parser_1.parseToken)(scanner);
+    scanner.expectSpace();
+    // Parse address type (token)
+    const addrType = (0, primitive_parser_1.parseToken)(scanner);
+    scanner.expectSpace();
+    // Parse unicast address (depends on addrType)
+    const unicastAddress = (0, address_parser_1.parseUnicastAddress)(scanner.readUntil(/[\r\n]/), addrType);
+    return (0, fields_1.createOrigin)(username, sessId, sessVersion, netType, addrType, unicastAddress);
+}
+// ============================================================================
+// Session Name Field Parser (s=)
+// ============================================================================
+/**
+ * Parse session name field
+ *
+ * Format: s=<session name>
+ *
+ * Session name can be a single space (" ") if there is no meaningful name.
+ *
+ * @param scanner - Scanner instance
+ * @returns SessionName
+ * @throws ParseError if empty
+ */
+function parseSessionNameField(scanner) {
+    const start = scanner.getPosition();
+    // Read until end of line
+    const name = scanner.readUntil(/[\r\n]/);
+    if (name.length === 0) {
+        throw new errors_1.ParseError('Session name cannot be empty', start.line, start.column);
+    }
+    return name;
+}
+// ============================================================================
+// Information Field Parser (i=)
+// ============================================================================
+/**
+ * Parse information field
+ *
+ * Format: i=<session information>
+ *
+ * @param scanner - Scanner instance
+ * @returns Information string
+ */
+function parseInformationField(scanner) {
+    // Read until end of line (can be empty)
+    return scanner.readUntil(/[\r\n]/);
+}
+// ============================================================================
+// URI Field Parser (u=)
+// ============================================================================
+/**
+ * Parse URI field
+ *
+ * Format: u=<uri>
+ *
+ * @param scanner - Scanner instance
+ * @returns URI string
+ */
+function parseUriField(scanner) {
+    return (0, primitive_parser_1.parseURI)(scanner);
+}
+// ============================================================================
+// Email Field Parser (e=)
+// ============================================================================
+/**
+ * Parse email field
+ *
+ * Format: e=<email-address> or e=<display-name> <email-address>
+ *
+ * @param scanner - Scanner instance
+ * @returns Email string
+ */
+function parseEmailField(scanner) {
+    return (0, primitive_parser_1.parseEmail)(scanner);
+}
+// ============================================================================
+// Phone Field Parser (p=)
+// ============================================================================
+/**
+ * Parse phone field
+ *
+ * Format: p=<phone-number> or p=<display-name> <phone-number>
+ *
+ * @param scanner - Scanner instance
+ * @returns Phone string
+ */
+function parsePhoneField(scanner) {
+    return (0, primitive_parser_1.parsePhone)(scanner);
+}
+// ============================================================================
+// Connection Field Parser (c=)
+// ============================================================================
+/**
+ * Parse connection field
+ *
+ * Format: c=<nettype> SP <addrtype> SP <connection-address>
+ *
+ * connection-address can be:
+ * - unicast-address
+ * - multicast-address (with optional TTL and number of addresses)
+ *
+ * @param scanner - Scanner instance
+ * @returns Connection object
+ * @throws ParseError if invalid format
+ */
+function parseConnectionField(scanner) {
+    const start = scanner.getPosition();
+    // Parse network type (token)
+    const netType = (0, primitive_parser_1.parseToken)(scanner);
+    scanner.expectSpace();
+    // Parse address type (token)
+    const addrType = (0, primitive_parser_1.parseToken)(scanner);
+    scanner.expectSpace();
+    // Parse connection address
+    const connectionAddress = parseConnectionAddress(scanner, addrType);
+    return (0, fields_1.createConnection)(netType, addrType, connectionAddress);
+}
+/**
+ * Parse connection address (unicast or multicast)
+ *
+ * Multicast format:
+ * - IPv4: <base-multicast-address>/<ttl>[/<number of addresses>]
+ * - IPv6: <base-multicast-address>[/<number of addresses>]
+ * - FQDN: <base-multicast-address>[/<ttl>][/<number of addresses>]
+ *
+ * RFC 8866 Section 5.7: When TTL or number of addresses are present,
+ * the address MUST be a multicast address.
+ *
+ * @param scanner - Scanner instance
+ * @param addrType - Address type (IP4, IP6, etc.)
+ * @returns ConnectionAddress (unicast or multicast)
+ */
+function parseConnectionAddress(scanner, addrType) {
+    const start = scanner.getPosition();
+    // Read the address part (until / or end of line)
+    const addressPart = scanner.readUntil(/[\/\r\n]/);
+    if (addressPart.length === 0) {
+        throw new errors_1.ParseError('Expected connection address', start.line, start.column);
+    }
+    // Check if there's a / indicating multicast parameters
+    if (scanner.peek() !== '/') {
+        // Unicast address
+        return (0, address_parser_1.parseUnicastAddress)(addressPart, addrType);
+    }
+    // Multicast address - parse TTL and/or number of addresses
+    scanner.advance(); // consume '/'
+    const firstParam = (0, primitive_parser_1.parseInteger)(scanner);
+    let ttl;
+    let numAddresses;
+    // Check for second parameter
+    if (scanner.peek() === '/') {
+        scanner.advance(); // consume second '/'
+        const secondParam = (0, primitive_parser_1.parseInteger)(scanner);
+        // For IPv4: first is TTL, second is numAddresses
+        // For FQDN: first is TTL, second is numAddresses
+        // For IPv6: TTL is forbidden, so first is numAddresses
+        if (addrType === 'IP6') {
+            throw new errors_1.ParseError('IPv6 multicast addresses cannot have TTL parameter', start.line, start.column);
+        }
+        ttl = firstParam;
+        numAddresses = secondParam;
+    }
+    else {
+        // Only one parameter
+        if (addrType === 'IP4') {
+            // For IPv4, TTL is required
+            ttl = firstParam;
+        }
+        else if (addrType === 'IP6') {
+            // For IPv6, it's number of addresses
+            numAddresses = firstParam;
+        }
+        else {
+            // For FQDN or other, assume it's TTL
+            ttl = firstParam;
+        }
+    }
+    // Create appropriate multicast address based on address type
+    // RFC 8866 Section 5.7: Validate that address is actually multicast when parameters are present
+    if (addrType === 'IP4') {
+        // For IP4, could be IPv4 address or FQDN
+        if ((0, address_parser_2.isIP4Address)(addressPart)) {
+            // Validate that IPv4 address is in multicast range (224.0.0.0 - 239.255.255.255)
+            if (!(0, address_parser_2.isIP4MulticastAddress)(addressPart)) {
+                throw new errors_1.ParseError(`IPv4 address '${addressPart}' with TTL/numAddresses must be a multicast address (224.0.0.0 - 239.255.255.255)`, start.line, start.column);
+            }
+            return (0, network_1.createIP4MulticastAddress)((0, network_1.createIP4Address)(addressPart), ttl, numAddresses);
+        }
+        else {
+            // Assume FQDN - cannot validate multicast range for FQDNs
+            return (0, network_1.createFQDNMulticastAddress)((0, network_1.createFQDN)(addressPart), ttl, numAddresses);
+        }
+    }
+    else if (addrType === 'IP6') {
+        // For IP6, could be IPv6 address or FQDN
+        if ((0, address_parser_2.isIP6Address)(addressPart)) {
+            // Validate that IPv6 address is multicast (starts with FF)
+            if (!(0, address_parser_2.isIP6MulticastAddress)(addressPart)) {
+                throw new errors_1.ParseError(`IPv6 address '${addressPart}' with numAddresses must be a multicast address (must start with FF)`, start.line, start.column);
+            }
+            return (0, network_1.createIP6MulticastAddress)((0, network_1.createIP6Address)(addressPart), numAddresses);
+        }
+        else {
+            // Assume FQDN - cannot validate multicast range for FQDNs
+            return (0, network_1.createFQDNMulticastAddress)((0, network_1.createFQDN)(addressPart), ttl, numAddresses);
+        }
+    }
+    else {
+        // Extension address type
+        return (0, network_1.createFQDNMulticastAddress)((0, network_1.createFQDN)(addressPart), ttl, numAddresses);
+    }
+}
+// ============================================================================
+// Bandwidth Field Parser (b=)
+// ============================================================================
+/**
+ * Parse bandwidth field
+ *
+ * Format: b=<bwtype>:<bandwidth>
+ *
+ * bwtype can be:
+ * - CT (Conference Total)
+ * - AS (Application Specific)
+ * - Or any registered extension type
+ *
+ * bandwidth is in kilobits per second
+ *
+ * @param scanner - Scanner instance
+ * @returns Bandwidth object
+ * @throws ParseError if invalid format
+ */
+function parseBandwidthField(scanner) {
+    const start = scanner.getPosition();
+    // Parse bandwidth type (token before ':')
+    const bwtype = (0, primitive_parser_1.parseToken)(scanner);
+    // Expect ':'
+    const ch = scanner.peek();
+    if (ch !== ':') {
+        throw new errors_1.ParseError(`Expected ':' after bandwidth type, found "${ch}"`, start.line, start.column);
+    }
+    scanner.advance();
+    // Parse bandwidth value (integer)
+    const bandwidth = (0, primitive_parser_1.parseInteger)(scanner);
+    return (0, fields_1.createBandwidth)(bwtype, bandwidth);
+}
+// ============================================================================
+// Key Field Parser (k=)
+// ============================================================================
+/**
+ * Parse key field (OBSOLETE per RFC 8866)
+ *
+ * Format: k=<method>:<encryption-key>
+ * Or: k=<method> (if no key data)
+ *
+ * Common methods:
+ * - clear:<encryption-key> - key is included untransformed
+ * - base64:<encoded-encryption-key> - key is base64 encoded
+ * - uri:<uri-to-obtain-key> - URI where key can be obtained
+ * - prompt - no key included, user will be prompted
+ *
+ * @param scanner - Scanner instance
+ * @returns Key string
+ */
+function parseKeyField(scanner) {
+    // Read entire line
+    return scanner.readUntil(/[\r\n]/);
+}

package/dist/src/parser/media-parser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Media description parser for SDP (RFC 8866)
+ *
+ * Parses media descriptions (m= and associated fields)
+ */
+import { Scanner } from './scanner';
+import { Media, MediaDescription } from '../types/media';
+/**
+ * Parse media field
+ *
+ * Format: m=<media> <port> <proto> <fmt> ...
+ *
+ * Examples:
+ * - m=audio 49170 RTP/AVP 0 8 101
+ * - m=video 51372 RTP/AVP 99
+ * - m=audio 49170/2 RTP/AVP 0 (port range for hierarchical encoding)
+ *
+ * @param scanner - Scanner instance
+ * @returns Media object
+ * @throws ParseError if invalid format
+ */
+export declare function parseMediaField(scanner: Scanner): Media;
+/**
+ * Parse media description
+ *
+ * A media description consists of:
+ * - One media field (m=) [required]
+ * - Optional information field (i=)
+ * - Zero or more connection fields (c=)
+ * - Zero or more bandwidth fields (b=)
+ * - Optional encryption key field (k=)
+ * - Zero or more attribute fields (a=)
+ *
+ * The media field has already been identified, but not yet parsed.
+ *
+ * @param scanner - Scanner positioned at the start of media field value (after "m=")
+ * @param additionalLines - Additional lines that might belong to this media description
+ * @returns MediaDescription object
+ * @throws ParseError if invalid format
+ */
+export declare function parseMediaDescription(mediaFieldScanner: Scanner, additionalLines: {
+    type: string;
+    value: string;
+}[]): MediaDescription;
+//# sourceMappingURL=media-parser.d.ts.map

package/dist/src/parser/media-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-parser.d.ts","sourceRoot":"","sources":["../../../src/parser/media-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,EACL,KAAK,EACL,gBAAgB,EAMjB,MAAM,gBAAgB,CAAC;AAWxB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CA6FvD;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,OAAO,EAC1B,eAAe,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GACjD,gBAAgB,CAmElB"}

package/dist/src/parser/media-parser.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Media description parser for SDP (RFC 8866)
+ *
+ * Parses media descriptions (m= and associated fields)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMediaField = parseMediaField;
+exports.parseMediaDescription = parseMediaDescription;
+const scanner_1 = require("./scanner");
+const primitive_parser_1 = require("./primitive-parser");
+const field_parser_1 = require("./field-parser");
+const attribute_parser_1 = require("./attribute-parser");
+const errors_1 = require("../types/errors");
+const media_1 = require("../types/media");
+const primitives_1 = require("../types/primitives");
+// ============================================================================
+// Media Field Parser (m=)
+// ============================================================================
+/**
+ * Parse media field
+ *
+ * Format: m=<media> <port> <proto> <fmt> ...
+ *
+ * Examples:
+ * - m=audio 49170 RTP/AVP 0 8 101
+ * - m=video 51372 RTP/AVP 99
+ * - m=audio 49170/2 RTP/AVP 0 (port range for hierarchical encoding)
+ *
+ * @param scanner - Scanner instance
+ * @returns Media object
+ * @throws ParseError if invalid format
+ */
+function parseMediaField(scanner) {
+    const start = scanner.getPosition();
+    // Parse media type (token)
+    const mediaTypeStr = (0, primitive_parser_1.parseToken)(scanner);
+    const mediaType = (0, primitives_1.createMediaType)(mediaTypeStr);
+    // Parse port or port range
+    scanner.skipWhitespace();
+    const portStart = scanner.getPosition();
+    // Read until whitespace (to capture '/' for port ranges)
+    const portStr = scanner.readWhile(ch => ch !== ' ' && ch !== '\t' && ch !== '\r' && ch !== '\n');
+    if (portStr.length === 0) {
+        throw new errors_1.ParseError('Expected port number', portStart.line, portStart.column);
+    }
+    let port;
+    // Check if port is a range (contains '/')
+    if (portStr.includes('/')) {
+        const parts = portStr.split('/');
+        if (parts.length !== 2) {
+            throw new errors_1.ParseError(`Invalid port range format: expected "<port>/<count>", got "${portStr}"`, portStart.line, portStart.column);
+        }
+        const base = parseInt(parts[0], 10);
+        const count = parseInt(parts[1], 10);
+        if (isNaN(base) || isNaN(count)) {
+            throw new errors_1.ParseError(`Invalid port range: "${portStr}"`, portStart.line, portStart.column);
+        }
+        port = (0, media_1.createPortRange)(base, count);
+    }
+    else {
+        // Simple port
+        const portNum = parseInt(portStr, 10);
+        if (isNaN(portNum)) {
+            throw new errors_1.ParseError(`Invalid port number: "${portStr}"`, portStart.line, portStart.column);
+        }
+        port = (0, media_1.createSimplePort)(portNum);
+    }
+    // Parse protocol (read until whitespace, protocols can contain '/' like RTP/AVP)
+    scanner.skipWhitespace();
+    const protoStart = scanner.getPosition();
+    const protoStr = scanner.readWhile(ch => ch !== ' ' && ch !== '\t' && ch !== '\r' && ch !== '\n');
+    if (protoStr.length === 0) {
+        throw new errors_1.ParseError('Expected protocol', protoStart.line, protoStart.column);
+    }
+    const proto = (0, primitives_1.createProtocol)(protoStr);
+    // Parse formats (one or more)
+    const formats = [];
+    scanner.skipWhitespace();
+    while (!scanner.isEOF() && scanner.peek() !== '\r' && scanner.peek() !== '\n') {
+        const formatStr = (0, primitive_parser_1.parseToken)(scanner);
+        formats.push((0, primitives_1.createFormat)(formatStr));
+        scanner.skipWhitespace();
+    }
+    if (formats.length === 0) {
+        throw new errors_1.ParseError('at least one media format is required', start.line, start.column);
+    }
+    return (0, media_1.createMedia)(mediaType, port, proto, formats);
+}
+// ============================================================================
+// Media Description Parser
+// ============================================================================
+/**
+ * Parse media description
+ *
+ * A media description consists of:
+ * - One media field (m=) [required]
+ * - Optional information field (i=)
+ * - Zero or more connection fields (c=)
+ * - Zero or more bandwidth fields (b=)
+ * - Optional encryption key field (k=)
+ * - Zero or more attribute fields (a=)
+ *
+ * The media field has already been identified, but not yet parsed.
+ *
+ * @param scanner - Scanner positioned at the start of media field value (after "m=")
+ * @param additionalLines - Additional lines that might belong to this media description
+ * @returns MediaDescription object
+ * @throws ParseError if invalid format
+ */
+function parseMediaDescription(mediaFieldScanner, additionalLines) {
+    // Parse the media field (m=)
+    const media = parseMediaField(mediaFieldScanner);
+    // Parse optional fields
+    let information;
+    const connections = [];
+    const bandwidths = [];
+    let key;
+    const attributes = [];
+    for (const line of additionalLines) {
+        const scanner = new scanner_1.Scanner(line.value);
+        switch (line.type) {
+            case 'i':
+                if (information !== undefined) {
+                    throw new errors_1.ParseError('Duplicate information field in media description', 0, 0);
+                }
+                information = (0, field_parser_1.parseInformationField)(scanner);
+                break;
+            case 'c':
+                connections.push((0, field_parser_1.parseConnectionField)(scanner));
+                break;
+            case 'b':
+                bandwidths.push((0, field_parser_1.parseBandwidthField)(scanner));
+                break;
+            case 'k':
+                if (key !== undefined) {
+                    throw new errors_1.ParseError('Duplicate key field in media description', 0, 0);
+                }
+                key = (0, field_parser_1.parseKeyField)(scanner);
+                break;
+            case 'a':
+                attributes.push((0, attribute_parser_1.parseAttributeField)(scanner));
+                break;
+            default:
+                // Unknown field type - this shouldn't happen if called correctly
+                // Media description ends when we encounter another m= or end of input
+                throw new errors_1.ParseError(`Unexpected field type in media description: ${line.type}=`, 0, 0);
+        }
+    }
+    return (0, media_1.createMediaDescription)(media, {
+        information,
+        connections,
+        bandwidths,
+        key,
+        attributes,
+    });
+}