@tomgiee/tsdp 1.0.0

package/dist/src/types/media.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Media description types for SDP (RFC 8866)
+ *
+ * Defines types for media descriptions including media types, ports, protocols, and formats.
+ */
+import { Information, Key, MediaType, Protocol, Format } from './primitives';
+import { Connection } from './fields';
+import { Bandwidth } from './fields';
+import { Attribute } from './attributes';
+/**
+ * Media Description (RFC 8866 Section 5.14)
+ *
+ * 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=) [OBSOLETE]
+ * - Zero or more attribute fields (a=)
+ */
+export interface MediaDescription {
+    /**
+     * Media field (required)
+     */
+    readonly media: Media;
+    /**
+     * Media title/information (optional)
+     */
+    readonly information?: Information;
+    /**
+     * Connection data for this media (optional if present at session level)
+     * May be multiple for hierarchical encoding schemes
+     */
+    readonly connections: readonly Connection[];
+    /**
+     * Bandwidth information for this media (optional, multiple allowed)
+     */
+    readonly bandwidths: readonly Bandwidth[];
+    /**
+     * Encryption key (OBSOLETE per RFC 8866, but must support for compatibility)
+     */
+    readonly key?: Key;
+    /**
+     * Media-level attributes (optional, multiple allowed)
+     */
+    readonly attributes: readonly Attribute[];
+}
+/**
+ * Media field (RFC 8866 Section 5.14)
+ *
+ * Format: m=<media> <port> <proto> <fmt> ...
+ *
+ * The media field describes the type and transport address for a media stream.
+ */
+export interface Media {
+    /**
+     * Media type (audio, video, text, application, message, image)
+     */
+    readonly type: MediaType;
+    /**
+     * Transport port
+     * Can be a single port or a port range
+     */
+    readonly port: Port;
+    /**
+     * Transport protocol
+     * Examples: "RTP/AVP", "RTP/SAVP", "udp", "RTP/SAVPF"
+     */
+    readonly proto: Protocol;
+    /**
+     * Media formats
+     * For RTP: payload type numbers
+     * For other protocols: format descriptions
+     */
+    readonly formats: readonly Format[];
+}
+/**
+ * Simple port - single port number
+ */
+export interface SimplePort {
+    readonly kind: 'simple';
+    readonly value: number;
+}
+/**
+ * Port range - base port and number of ports
+ * Format: <base>/<count>
+ * Used for hierarchical RTP sessions
+ */
+export interface PortRange {
+    readonly kind: 'range';
+    readonly base: number;
+    readonly count: number;
+}
+/**
+ * Port - either simple or range
+ */
+export type Port = SimplePort | PortRange;
+/**
+ * Create a Media field
+ */
+export declare function createMedia(type: MediaType, port: Port, proto: Protocol, formats: Format[]): Media;
+/**
+ * Create a simple port
+ */
+export declare function createSimplePort(value: number): SimplePort;
+/**
+ * Create a port range
+ */
+export declare function createPortRange(base: number, count: number): PortRange;
+/**
+ * Create a MediaDescription
+ */
+export declare function createMediaDescription(media: Media, options?: {
+    information?: Information;
+    connections?: Connection[];
+    bandwidths?: Bandwidth[];
+    key?: Key;
+    attributes?: Attribute[];
+}): MediaDescription;
+/**
+ * Check if port is a simple port
+ */
+export declare function isSimplePort(port: Port): port is SimplePort;
+/**
+ * Check if port is a port range
+ */
+export declare function isPortRange(port: Port): port is PortRange;
+/**
+ * Get the port number from a Port (simple port value or range base)
+ *
+ * This is a convenience function to extract the main port number
+ * from either a SimplePort or PortRange.
+ *
+ * @param port - The port (simple or range)
+ * @returns The port number (value for simple, base for range)
+ */
+export declare function getPortNumber(port: Port): number;
+/**
+ * Get an array of all port numbers covered by a Port
+ *
+ * For a SimplePort, returns a single-element array.
+ * For a PortRange, returns all ports from base to base + count - 1.
+ *
+ * @param port - The port (simple or range)
+ * @returns Array of port numbers
+ */
+export declare function getPortNumbers(port: Port): number[];
+//# sourceMappingURL=media.d.ts.map

package/dist/src/types/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/types/media.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAMzC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAEnC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;CAC3C;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC;AAM1C;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EAAE,GAChB,KAAK,CAUP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQ1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAetE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B,GACA,gBAAgB,CASlB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,UAAU,CAE3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,SAAS,CAEzD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAWnD"}

package/dist/src/types/media.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * Media description types for SDP (RFC 8866)
+ *
+ * Defines types for media descriptions including media types, ports, protocols, and formats.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMedia = createMedia;
+exports.createSimplePort = createSimplePort;
+exports.createPortRange = createPortRange;
+exports.createMediaDescription = createMediaDescription;
+exports.isSimplePort = isSimplePort;
+exports.isPortRange = isPortRange;
+exports.getPortNumber = getPortNumber;
+exports.getPortNumbers = getPortNumbers;
+// ============================================================================
+// Helper Functions for Creating Media Types
+// ============================================================================
+/**
+ * Create a Media field
+ */
+function createMedia(type, port, proto, formats) {
+    if (formats.length === 0) {
+        throw new Error('At least one format is required');
+    }
+    return {
+        type,
+        port,
+        proto,
+        formats,
+    };
+}
+/**
+ * Create a simple port
+ */
+function createSimplePort(value) {
+    if (value < 0 || value > 65535) {
+        throw new Error('Port must be between 0 and 65535');
+    }
+    return {
+        kind: 'simple',
+        value,
+    };
+}
+/**
+ * Create a port range
+ */
+function createPortRange(base, count) {
+    if (base < 0 || base > 65535) {
+        throw new Error('Base port must be between 0 and 65535');
+    }
+    if (count < 1) {
+        throw new Error('Port count must be at least 1');
+    }
+    if (base + count > 65536) {
+        throw new Error('Port range exceeds maximum port number');
+    }
+    return {
+        kind: 'range',
+        base,
+        count,
+    };
+}
+/**
+ * Create a MediaDescription
+ */
+function createMediaDescription(media, options) {
+    var _a, _b, _c;
+    return {
+        media,
+        information: options === null || options === void 0 ? void 0 : options.information,
+        connections: (_a = options === null || options === void 0 ? void 0 : options.connections) !== null && _a !== void 0 ? _a : [],
+        bandwidths: (_b = options === null || options === void 0 ? void 0 : options.bandwidths) !== null && _b !== void 0 ? _b : [],
+        key: options === null || options === void 0 ? void 0 : options.key,
+        attributes: (_c = options === null || options === void 0 ? void 0 : options.attributes) !== null && _c !== void 0 ? _c : [],
+    };
+}
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if port is a simple port
+ */
+function isSimplePort(port) {
+    return port.kind === 'simple';
+}
+/**
+ * Check if port is a port range
+ */
+function isPortRange(port) {
+    return port.kind === 'range';
+}
+// ============================================================================
+// Port Utility Functions
+// ============================================================================
+/**
+ * Get the port number from a Port (simple port value or range base)
+ *
+ * This is a convenience function to extract the main port number
+ * from either a SimplePort or PortRange.
+ *
+ * @param port - The port (simple or range)
+ * @returns The port number (value for simple, base for range)
+ */
+function getPortNumber(port) {
+    switch (port.kind) {
+        case 'simple':
+            return port.value;
+        case 'range':
+            return port.base;
+        default: {
+            const _exhaustive = port;
+            return _exhaustive;
+        }
+    }
+}
+/**
+ * Get an array of all port numbers covered by a Port
+ *
+ * For a SimplePort, returns a single-element array.
+ * For a PortRange, returns all ports from base to base + count - 1.
+ *
+ * @param port - The port (simple or range)
+ * @returns Array of port numbers
+ */
+function getPortNumbers(port) {
+    switch (port.kind) {
+        case 'simple':
+            return [port.value];
+        case 'range':
+            return Array.from({ length: port.count }, (_, i) => port.base + i);
+        default: {
+            const _exhaustive = port;
+            return _exhaustive;
+        }
+    }
+}

package/dist/src/types/network.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Network address types for SDP (RFC 8866)
+ *
+ * This module defines types for IP4/IP6 addresses, FQDNs, and multicast addresses.
+ * Uses branded types to prevent mixing incompatible address types at compile time.
+ */
+type Brand<T, B> = T & {
+    readonly __brand: B;
+};
+/**
+ * IPv4 address (dotted decimal: a.b.c.d)
+ * Each octet is 0-255
+ * Examples: "192.168.1.1", "198.51.100.1"
+ */
+export type IP4Address = Brand<string, 'IP4Address'>;
+/**
+ * IPv6 address (RFC 5952 canonical format)
+ * Supports all 8 compression forms
+ * Examples: "2001:db8::1", "fe80::1", "::1"
+ */
+export type IP6Address = Brand<string, 'IP6Address'>;
+/**
+ * Fully Qualified Domain Name
+ * RFC 1035 compliant domain name
+ * Examples: "example.com", "sip.example.org"
+ */
+export type FQDN = Brand<string, 'FQDN'>;
+/**
+ * Extension address type (for future/custom address types)
+ * Used when addrtype is not IP4 or IP6
+ */
+export type ExtensionAddress = Brand<string, 'ExtensionAddress'>;
+/**
+ * Unicast address - can be IPv4, IPv6, FQDN, or extension
+ * Used for origin field and unicast connection addresses
+ */
+export type UnicastAddress = IP4Address | IP6Address | FQDN | ExtensionAddress;
+/**
+ * IPv4 multicast address (224.0.0.0 - 239.255.255.255)
+ * Requires TTL, optionally includes number of addresses for hierarchical encoding
+ */
+export interface IP4MulticastAddress {
+    readonly kind: 'ip4-multicast';
+    readonly address: IP4Address;
+    /** Time-to-live (0-255), required for IPv4 multicast */
+    readonly ttl: number;
+    /** Number of addresses for hierarchical encoding (optional) */
+    readonly numAddresses?: number;
+}
+/**
+ * IPv6 multicast address (starts with FF)
+ * Does NOT include TTL (forbidden for IPv6)
+ * Optionally includes number of addresses for hierarchical encoding
+ */
+export interface IP6MulticastAddress {
+    readonly kind: 'ip6-multicast';
+    readonly address: IP6Address;
+    /** Number of addresses for hierarchical encoding (optional) */
+    readonly numAddresses?: number;
+}
+/**
+ * FQDN multicast address
+ * Domain name that resolves to a multicast address
+ * May include TTL and number of addresses
+ */
+export interface FQDNMulticastAddress {
+    readonly kind: 'fqdn-multicast';
+    readonly address: FQDN;
+    /** Time-to-live (optional for FQDN) */
+    readonly ttl?: number;
+    /** Number of addresses for hierarchical encoding (optional) */
+    readonly numAddresses?: number;
+}
+/**
+ * Multicast address - IPv4, IPv6, or FQDN based
+ * Discriminated union for type-safe handling
+ */
+export type MulticastAddress = IP4MulticastAddress | IP6MulticastAddress | FQDNMulticastAddress;
+/**
+ * Connection address - can be unicast or multicast
+ * Used in connection field (c=)
+ */
+export type ConnectionAddress = UnicastAddress | MulticastAddress;
+/**
+ * Create an IP4Address from a string
+ * Note: Validation should be done by address-parser utility
+ */
+export declare function createIP4Address(value: string): IP4Address;
+/**
+ * Create an IP6Address from a string
+ * Note: Validation should be done by address-parser utility
+ */
+export declare function createIP6Address(value: string): IP6Address;
+/**
+ * Create an FQDN from a string
+ * Note: Validation should be done by address-parser utility
+ */
+export declare function createFQDN(value: string): FQDN;
+/**
+ * Create an ExtensionAddress from a string
+ */
+export declare function createExtensionAddress(value: string): ExtensionAddress;
+/**
+ * Create an IPv4 multicast address
+ */
+export declare function createIP4MulticastAddress(address: IP4Address, ttl: number, numAddresses?: number): IP4MulticastAddress;
+/**
+ * Create an IPv6 multicast address
+ */
+export declare function createIP6MulticastAddress(address: IP6Address, numAddresses?: number): IP6MulticastAddress;
+/**
+ * Create an FQDN multicast address
+ */
+export declare function createFQDNMulticastAddress(address: FQDN, ttl?: number, numAddresses?: number): FQDNMulticastAddress;
+/**
+ * Check if an address is a multicast address
+ */
+export declare function isMulticastAddress(addr: ConnectionAddress): addr is MulticastAddress;
+/**
+ * Check if an address is a unicast address
+ */
+export declare function isUnicastAddress(addr: ConnectionAddress): addr is UnicastAddress;
+/**
+ * Check if a multicast address is IPv4
+ */
+export declare function isIP4MulticastAddress(addr: MulticastAddress): addr is IP4MulticastAddress;
+/**
+ * Check if a multicast address is IPv6
+ */
+export declare function isIP6MulticastAddress(addr: MulticastAddress): addr is IP6MulticastAddress;
+/**
+ * Check if a multicast address is FQDN-based
+ */
+export declare function isFQDNMulticastAddress(addr: MulticastAddress): addr is FQDNMulticastAddress;
+export {};
+//# sourceMappingURL=network.d.ts.map

package/dist/src/types/network.d.ts.map

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

package/dist/src/types/network.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Network address types for SDP (RFC 8866)
+ *
+ * This module defines types for IP4/IP6 addresses, FQDNs, and multicast addresses.
+ * Uses branded types to prevent mixing incompatible address types at compile time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIP4Address = createIP4Address;
+exports.createIP6Address = createIP6Address;
+exports.createFQDN = createFQDN;
+exports.createExtensionAddress = createExtensionAddress;
+exports.createIP4MulticastAddress = createIP4MulticastAddress;
+exports.createIP6MulticastAddress = createIP6MulticastAddress;
+exports.createFQDNMulticastAddress = createFQDNMulticastAddress;
+exports.isMulticastAddress = isMulticastAddress;
+exports.isUnicastAddress = isUnicastAddress;
+exports.isIP4MulticastAddress = isIP4MulticastAddress;
+exports.isIP6MulticastAddress = isIP6MulticastAddress;
+exports.isFQDNMulticastAddress = isFQDNMulticastAddress;
+// ============================================================================
+// Helper Functions for Creating Network Types
+// ============================================================================
+/**
+ * Create an IP4Address from a string
+ * Note: Validation should be done by address-parser utility
+ */
+function createIP4Address(value) {
+    return value;
+}
+/**
+ * Create an IP6Address from a string
+ * Note: Validation should be done by address-parser utility
+ */
+function createIP6Address(value) {
+    return value;
+}
+/**
+ * Create an FQDN from a string
+ * Note: Validation should be done by address-parser utility
+ */
+function createFQDN(value) {
+    return value;
+}
+/**
+ * Create an ExtensionAddress from a string
+ */
+function createExtensionAddress(value) {
+    return value;
+}
+/**
+ * Create an IPv4 multicast address
+ */
+function createIP4MulticastAddress(address, ttl, numAddresses) {
+    if (ttl < 0 || ttl > 255) {
+        throw new Error(`Invalid TTL: ${ttl}. Must be 0-255`);
+    }
+    if (numAddresses !== undefined && numAddresses < 1) {
+        throw new Error(`Invalid numAddresses: ${numAddresses}. Must be >= 1`);
+    }
+    return {
+        kind: 'ip4-multicast',
+        address,
+        ttl,
+        numAddresses
+    };
+}
+/**
+ * Create an IPv6 multicast address
+ */
+function createIP6MulticastAddress(address, numAddresses) {
+    if (numAddresses !== undefined && numAddresses < 1) {
+        throw new Error(`Invalid numAddresses: ${numAddresses}. Must be >= 1`);
+    }
+    return {
+        kind: 'ip6-multicast',
+        address,
+        numAddresses
+    };
+}
+/**
+ * Create an FQDN multicast address
+ */
+function createFQDNMulticastAddress(address, ttl, numAddresses) {
+    if (ttl !== undefined && (ttl < 0 || ttl > 255)) {
+        throw new Error(`Invalid TTL: ${ttl}. Must be 0-255`);
+    }
+    if (numAddresses !== undefined && numAddresses < 1) {
+        throw new Error(`Invalid numAddresses: ${numAddresses}. Must be >= 1`);
+    }
+    return {
+        kind: 'fqdn-multicast',
+        address,
+        ttl,
+        numAddresses
+    };
+}
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if an address is a multicast address
+ */
+function isMulticastAddress(addr) {
+    return typeof addr === 'object' && 'kind' in addr;
+}
+/**
+ * Check if an address is a unicast address
+ */
+function isUnicastAddress(addr) {
+    return typeof addr === 'string';
+}
+/**
+ * Check if a multicast address is IPv4
+ */
+function isIP4MulticastAddress(addr) {
+    return addr.kind === 'ip4-multicast';
+}
+/**
+ * Check if a multicast address is IPv6
+ */
+function isIP6MulticastAddress(addr) {
+    return addr.kind === 'ip6-multicast';
+}
+/**
+ * Check if a multicast address is FQDN-based
+ */
+function isFQDNMulticastAddress(addr) {
+    return addr.kind === 'fqdn-multicast';
+}