@tomgiee/tsdp 1.0.0

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

@@ -0,0 +1,193 @@
+/**
+ * Primitive types and enums for SDP (RFC 8866)
+ *
+ * This module defines branded primitive types to ensure type safety at compile time
+ * and enums for various SDP field values.
+ */
+/**
+ * Position in the input text for error reporting
+ */
+export interface Position {
+    /** Character offset from start of input */
+    readonly offset: number;
+    /** Line number (1-indexed) */
+    readonly line: number;
+    /** Column number (1-indexed) */
+    readonly column: number;
+}
+/**
+ * Branded type to prevent mixing different string types
+ * Provides compile-time safety with no runtime overhead
+ */
+type Brand<T, B> = T & {
+    readonly __brand: B;
+};
+/** SDP version number (currently always 0) */
+export type Version = Brand<number, 'Version'>;
+/** Session name (required field) */
+export type SessionName = Brand<string, 'SessionName'>;
+/** Username for origin field */
+export type Username = Brand<string, 'Username'>;
+/** Session ID (NTP timestamp) */
+export type SessionId = Brand<string, 'SessionId'>;
+/** Session version number (NTP timestamp) */
+export type SessionVersion = Brand<string, 'SessionVersion'>;
+/** Session or media information text */
+export type Information = Brand<string, 'Information'>;
+/** URI reference */
+export type URI = Brand<string, 'URI'>;
+/** Email address (with optional display name) */
+export type Email = Brand<string, 'Email'>;
+/** Phone number (with optional display name) */
+export type Phone = Brand<string, 'Phone'>;
+/** Encryption key (OBSOLETE per RFC 8866) */
+export type Key = Brand<string, 'Key'>;
+/** Bandwidth type (CT, AS, or extension) */
+export type BandwidthType = Brand<string, 'BandwidthType'>;
+/** Transport protocol (RTP/AVP, RTP/SAVP, udp, etc.) */
+export type Protocol = Brand<string, 'Protocol'>;
+/** Media format (payload type or media subtype) */
+export type Format = Brand<string, 'Format'>;
+/** Attribute name */
+export type AttributeName = Brand<string, 'AttributeName'>;
+/** Attribute value */
+export type AttributeValue = Brand<string, 'AttributeValue'>;
+/** Token (sequence of token-chars: ALPHA/DIGIT/special) */
+export type Token = Brand<string, 'Token'>;
+/** Byte string (sequence of bytes 0x01-0x09, 0x0B-0x0C, 0x0E-0xFF) */
+export type ByteString = Brand<string, 'ByteString'>;
+/** Non-whitespace string (sequence of non-whitespace chars) */
+export type NonWSString = Brand<string, 'NonWSString'>;
+/**
+ * Network type (RFC 8866 Section 5.2)
+ * Currently only 'IN' (Internet) is defined, but extensible via IANA registration
+ */
+export type NetType = 'IN' | string;
+/**
+ * Address type (RFC 8866 Section 5.2)
+ * IP4, IP6, or extension types via IANA registration
+ */
+export type AddrType = 'IP4' | 'IP6' | string;
+/**
+ * Media type (RFC 8866 Section 5.14)
+ * Defines the type of media in a media description
+ */
+export type MediaType = 'audio' | 'video' | 'text' | 'application' | 'message' | 'image' | string;
+/**
+ * NTP timestamp (seconds since January 1, 1900 UTC)
+ * Special value 0 means "unbounded" or "permanent"
+ *
+ * RFC 8866 uses NTP time (epoch 1900) not Unix time (epoch 1970)
+ */
+export type NtpTime = Brand<number, 'NtpTime'>;
+/**
+ * Time unit for typed time values
+ */
+export type TimeUnit = 'days' | 'hours' | 'minutes' | 'seconds';
+/**
+ * Typed time with unit suffix (d/h/m/s)
+ * Examples: "7d" (7 days), "3h" (3 hours), "120m" (120 minutes), "3600" (3600 seconds)
+ */
+export interface TypedTime {
+    readonly value: number;
+    readonly unit: TimeUnit;
+}
+/**
+ * Check if a string contains only digits (0-9)
+ *
+ * Per RFC 8866 Section 9 (Grammar):
+ * - sess-id = 1*DIGIT
+ * - sess-version = 1*DIGIT
+ *
+ * @param value - String to validate
+ * @returns true if string contains one or more digits only
+ */
+export declare function isNumericString(value: string): boolean;
+/**
+ * Create a Version (currently must be 0)
+ */
+export declare function createVersion(value: number): Version;
+/**
+ * Create a SessionName from a string
+ */
+export declare function createSessionName(value: string): SessionName;
+/**
+ * Create a Username from a string
+ */
+export declare function createUsername(value: string): Username;
+/**
+ * Create a SessionId from a string
+ */
+export declare function createSessionId(value: string): SessionId;
+/**
+ * Create a SessionVersion from a string
+ */
+export declare function createSessionVersion(value: string): SessionVersion;
+/**
+ * Create an Information string
+ */
+export declare function createInformation(value: string): Information;
+/**
+ * Create a URI
+ */
+export declare function createURI(value: string): URI;
+/**
+ * Create an Email
+ */
+export declare function createEmail(value: string): Email;
+/**
+ * Create a Phone
+ */
+export declare function createPhone(value: string): Phone;
+/**
+ * Create a Key (OBSOLETE but must support for compatibility)
+ */
+export declare function createKey(value: string): Key;
+/**
+ * Create a BandwidthType
+ */
+export declare function createBandwidthType(value: string): BandwidthType;
+/**
+ * Create a MediaType
+ */
+export declare function createMediaType(value: string): MediaType;
+/**
+ * Create a Protocol
+ */
+export declare function createProtocol(value: string): Protocol;
+/**
+ * Create a Format
+ */
+export declare function createFormat(value: string): Format;
+/**
+ * Create an AttributeName
+ */
+export declare function createAttributeName(value: string): AttributeName;
+/**
+ * Create an AttributeValue
+ */
+export declare function createAttributeValue(value: string): AttributeValue;
+/**
+ * Create a Token
+ */
+export declare function createToken(value: string): Token;
+/**
+ * Create a ByteString
+ */
+export declare function createByteString(value: string): ByteString;
+/**
+ * Create a NonWSString
+ */
+export declare function createNonWSString(value: string): NonWSString;
+/**
+ * Create an NtpTime
+ */
+export declare function createNtpTime(value: number): NtpTime;
+/**
+ * Create a TypedTime
+ *
+ * Note: Value can be negative for timezone offsets
+ */
+export declare function createTypedTime(value: number, unit: TimeUnit): TypedTime;
+export {};
+//# sourceMappingURL=primitives.d.ts.map

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

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

package/dist/src/types/primitives.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Primitive types and enums for SDP (RFC 8866)
+ *
+ * This module defines branded primitive types to ensure type safety at compile time
+ * and enums for various SDP field values.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNumericString = isNumericString;
+exports.createVersion = createVersion;
+exports.createSessionName = createSessionName;
+exports.createUsername = createUsername;
+exports.createSessionId = createSessionId;
+exports.createSessionVersion = createSessionVersion;
+exports.createInformation = createInformation;
+exports.createURI = createURI;
+exports.createEmail = createEmail;
+exports.createPhone = createPhone;
+exports.createKey = createKey;
+exports.createBandwidthType = createBandwidthType;
+exports.createMediaType = createMediaType;
+exports.createProtocol = createProtocol;
+exports.createFormat = createFormat;
+exports.createAttributeName = createAttributeName;
+exports.createAttributeValue = createAttributeValue;
+exports.createToken = createToken;
+exports.createByteString = createByteString;
+exports.createNonWSString = createNonWSString;
+exports.createNtpTime = createNtpTime;
+exports.createTypedTime = createTypedTime;
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Regular expression for numeric strings per RFC 8866 grammar
+ * sess-id = 1*DIGIT
+ * sess-version = 1*DIGIT
+ */
+const NUMERIC_STRING_REGEX = /^[0-9]+$/;
+/**
+ * Check if a string contains only digits (0-9)
+ *
+ * Per RFC 8866 Section 9 (Grammar):
+ * - sess-id = 1*DIGIT
+ * - sess-version = 1*DIGIT
+ *
+ * @param value - String to validate
+ * @returns true if string contains one or more digits only
+ */
+function isNumericString(value) {
+    return value.length > 0 && NUMERIC_STRING_REGEX.test(value);
+}
+// ============================================================================
+// Helper Functions for Creating Branded Types
+// ============================================================================
+/**
+ * Create a Version (currently must be 0)
+ */
+function createVersion(value) {
+    if (value !== 0) {
+        throw new Error(`Invalid SDP version: ${value}. Currently only version 0 is defined.`);
+    }
+    return value;
+}
+/**
+ * Create a SessionName from a string
+ */
+function createSessionName(value) {
+    if (value.length === 0) {
+        throw new Error('Session name cannot be empty');
+    }
+    return value;
+}
+/**
+ * Create a Username from a string
+ */
+function createUsername(value) {
+    if (value.length === 0) {
+        throw new Error('Username cannot be empty');
+    }
+    return value;
+}
+/**
+ * Create a SessionId from a string
+ */
+function createSessionId(value) {
+    return value;
+}
+/**
+ * Create a SessionVersion from a string
+ */
+function createSessionVersion(value) {
+    return value;
+}
+/**
+ * Create an Information string
+ */
+function createInformation(value) {
+    return value;
+}
+/**
+ * Create a URI
+ */
+function createURI(value) {
+    return value;
+}
+/**
+ * Create an Email
+ */
+function createEmail(value) {
+    return value;
+}
+/**
+ * Create a Phone
+ */
+function createPhone(value) {
+    return value;
+}
+/**
+ * Create a Key (OBSOLETE but must support for compatibility)
+ */
+function createKey(value) {
+    return value;
+}
+/**
+ * Create a BandwidthType
+ */
+function createBandwidthType(value) {
+    return value;
+}
+/**
+ * Create a MediaType
+ */
+function createMediaType(value) {
+    return value;
+}
+/**
+ * Create a Protocol
+ */
+function createProtocol(value) {
+    return value;
+}
+/**
+ * Create a Format
+ */
+function createFormat(value) {
+    return value;
+}
+/**
+ * Create an AttributeName
+ */
+function createAttributeName(value) {
+    return value;
+}
+/**
+ * Create an AttributeValue
+ */
+function createAttributeValue(value) {
+    return value;
+}
+/**
+ * Create a Token
+ */
+function createToken(value) {
+    return value;
+}
+/**
+ * Create a ByteString
+ */
+function createByteString(value) {
+    return value;
+}
+/**
+ * Create a NonWSString
+ */
+function createNonWSString(value) {
+    return value;
+}
+/**
+ * Create an NtpTime
+ */
+function createNtpTime(value) {
+    if (value < 0) {
+        throw new Error('NTP time cannot be negative');
+    }
+    return value;
+}
+/**
+ * Create a TypedTime
+ *
+ * Note: Value can be negative for timezone offsets
+ */
+function createTypedTime(value, unit) {
+    return { value, unit };
+}

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

@@ -0,0 +1,122 @@
+/**
+ * Session Description type for SDP (RFC 8866)
+ *
+ * This is the main type representing a complete SDP session description.
+ */
+import { Version, SessionName, Information, URI, Email, Phone, Key } from './primitives';
+import { Origin, Connection, Bandwidth } from './fields';
+import { TimeDescription } from './time';
+import { Attribute } from './attributes';
+import { MediaDescription } from './media';
+/**
+ * SessionDescription (RFC 8866)
+ *
+ * A complete SDP session description following the exact field ordering
+ * required by RFC 8866 Section 5.0.
+ *
+ * Field Ordering (MUST be in this order):
+ * 1. v= (version) [required]
+ * 2. o= (origin) [required]
+ * 3. s= (session name) [required]
+ * 4. i= (session information) [optional]
+ * 5. u= (URI) [optional]
+ * 6. e= (email) [optional, multiple]
+ * 7. p= (phone) [optional, multiple]
+ * 8. c= (connection) [optional]
+ * 9. b= (bandwidth) [optional, multiple]
+ * 10. Time descriptions [required, one or more]
+ * 11. k= (encryption key) [optional, OBSOLETE]
+ * 12. a= (attributes) [optional, multiple]
+ * 13. Media descriptions [optional, zero or more]
+ */
+export interface SessionDescription {
+    /**
+     * Protocol version (currently 0)
+     */
+    readonly version: Version;
+    /**
+     * Origin of the session
+     * Contains username, session ID, version, network type, address type, and address
+     */
+    readonly origin: Origin;
+    /**
+     * Session name (required, use " " if no meaningful name)
+     */
+    readonly sessionName: SessionName;
+    /**
+     * Session information/title (optional)
+     */
+    readonly sessionInformation?: Information;
+    /**
+     * URI for more information about the session (optional)
+     */
+    readonly uri?: URI;
+    /**
+     * Email addresses for contact (optional, multiple allowed)
+     */
+    readonly emails: readonly Email[];
+    /**
+     * Phone numbers for contact (optional, multiple allowed)
+     */
+    readonly phones: readonly Phone[];
+    /**
+     * Connection information for the session (optional if present in all media)
+     * If omitted, each media description MUST have connection information
+     */
+    readonly connection?: Connection;
+    /**
+     * Bandwidth information for the session (optional, multiple allowed)
+     */
+    readonly bandwidths: readonly Bandwidth[];
+    /**
+     * Time descriptions for the session (required, at least one)
+     * Each describes start/stop times and optional repeat times
+     */
+    readonly timeDescriptions: readonly TimeDescription[];
+    /**
+     * Encryption key (OBSOLETE per RFC 8866, but must support for compatibility)
+     */
+    readonly key?: Key;
+    /**
+     * Session-level attributes (optional, multiple allowed)
+     */
+    readonly attributes: readonly Attribute[];
+    /**
+     * Media descriptions (optional, zero or more)
+     * Each describes a media stream (audio, video, etc.)
+     */
+    readonly mediaDescriptions: readonly MediaDescription[];
+}
+/**
+ * Create a SessionDescription
+ *
+ * Enforces RFC 8866 requirements:
+ * - Version, origin, sessionName are required
+ * - At least one time description is required
+ */
+export declare function createSessionDescription(options: {
+    version: Version;
+    origin: Origin;
+    sessionName: SessionName;
+    sessionInformation?: Information;
+    uri?: URI;
+    emails?: Email[];
+    phones?: Phone[];
+    connection?: Connection;
+    bandwidths?: Bandwidth[];
+    timeDescriptions: TimeDescription[];
+    key?: Key;
+    attributes?: Attribute[];
+    mediaDescriptions?: MediaDescription[];
+}): SessionDescription;
+/**
+ * Create a minimal valid SessionDescription
+ *
+ * Creates a session with only the required fields:
+ * - Version 0
+ * - Origin
+ * - Session name
+ * - One time description (0 to 0 = permanent/unbounded)
+ */
+export declare function createMinimalSessionDescription(origin: Origin, sessionName: SessionName): SessionDescription;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/types/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAW,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAM3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAE1C;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAE1C;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACzD;AAMD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB,kBAAkB,CAAC,EAAE,WAAW,CAAC;IACjC,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACxC,GAAG,kBAAkB,CAqCrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,GACvB,kBAAkB,CAoBpB"}

package/dist/src/types/session.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Session Description type for SDP (RFC 8866)
+ *
+ * This is the main type representing a complete SDP session description.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessionDescription = createSessionDescription;
+exports.createMinimalSessionDescription = createMinimalSessionDescription;
+// ============================================================================
+// Helper Functions for Creating Session Descriptions
+// ============================================================================
+/**
+ * Create a SessionDescription
+ *
+ * Enforces RFC 8866 requirements:
+ * - Version, origin, sessionName are required
+ * - At least one time description is required
+ */
+function createSessionDescription(options) {
+    var _a, _b, _c, _d, _e;
+    // Validate required fields
+    if (options.timeDescriptions.length === 0) {
+        throw new Error('At least one time description is required');
+    }
+    // Validate connection requirement
+    // Connection MUST be present at session level OR in every media description
+    const hasSessionConnection = options.connection !== undefined;
+    const mediaDescriptions = (_a = options.mediaDescriptions) !== null && _a !== void 0 ? _a : [];
+    if (!hasSessionConnection && mediaDescriptions.length > 0) {
+        const allMediaHaveConnection = mediaDescriptions.every((md) => md.connections.length > 0);
+        if (!allMediaHaveConnection) {
+            throw new Error('Connection information required: must be present at session level or in every media description');
+        }
+    }
+    return {
+        version: options.version,
+        origin: options.origin,
+        sessionName: options.sessionName,
+        sessionInformation: options.sessionInformation,
+        uri: options.uri,
+        emails: (_b = options.emails) !== null && _b !== void 0 ? _b : [],
+        phones: (_c = options.phones) !== null && _c !== void 0 ? _c : [],
+        connection: options.connection,
+        bandwidths: (_d = options.bandwidths) !== null && _d !== void 0 ? _d : [],
+        timeDescriptions: options.timeDescriptions,
+        key: options.key,
+        attributes: (_e = options.attributes) !== null && _e !== void 0 ? _e : [],
+        mediaDescriptions: mediaDescriptions,
+    };
+}
+/**
+ * Create a minimal valid SessionDescription
+ *
+ * Creates a session with only the required fields:
+ * - Version 0
+ * - Origin
+ * - Session name
+ * - One time description (0 to 0 = permanent/unbounded)
+ */
+function createMinimalSessionDescription(origin, sessionName) {
+    return {
+        version: 0,
+        origin,
+        sessionName,
+        emails: [],
+        phones: [],
+        bandwidths: [],
+        timeDescriptions: [
+            {
+                timing: {
+                    startTime: 0,
+                    stopTime: 0,
+                },
+                repeats: [],
+            },
+        ],
+        attributes: [],
+        mediaDescriptions: [],
+    };
+}