@tomgiee/tsdp 1.0.0

package/dist/tests/unit/validator/session-validator.test.js

@@ -0,0 +1,447 @@
+"use strict";
+/**
+ * Tests for session-validator.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const session_validator_1 = require("../../../src/validator/session-validator");
+const session_1 = require("../../../src/types/session");
+const fields_1 = require("../../../src/types/fields");
+const time_1 = require("../../../src/types/time");
+const network_1 = require("../../../src/types/network");
+const attributes_1 = require("../../../src/types/attributes");
+describe('session-validator', () => {
+    describe('validateSessionDescription', () => {
+        describe('valid sessions', () => {
+            it('should validate minimal valid session', () => {
+                const session = (0, session_1.createSessionDescription)({
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '2890844526', '2890842807', 'IN', 'IP4', (0, network_1.createIP4Address)('10.47.16.5')),
+                    sessionName: 'Test Session',
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                });
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+                expect(result.errors).toHaveLength(0);
+            });
+            it('should validate session with connection', () => {
+                const session = (0, session_1.createSessionDescription)({
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    connection: (0, fields_1.createConnection)('IN', 'IP4', (0, network_1.createIP4MulticastAddress)((0, network_1.createIP4Address)('224.2.17.12'), 127)),
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                });
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+            it('should validate session with multiple time descriptions', () => {
+                const session = (0, session_1.createSessionDescription)({
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    timeDescriptions: [
+                        (0, time_1.createTimeDescription)((0, time_1.createTiming)(2873397496, 2873404696)),
+                        (0, time_1.createTimeDescription)((0, time_1.createTiming)(3034423619, 3042462419)),
+                    ],
+                });
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+            it('should validate session with bandwidth', () => {
+                const session = (0, session_1.createSessionDescription)({
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    bandwidths: [(0, fields_1.createBandwidth)('AS', 128)],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                });
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+            it('should validate session with single direction attribute', () => {
+                const session = (0, session_1.createSessionDescription)({
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [(0, attributes_1.createRecvonly)()],
+                });
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+        });
+        describe('invalid sessions', () => {
+            it('should reject empty session name', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: '',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.field === 'sessionName')).toBe(true);
+            });
+            it('should reject missing time descriptions', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.constraint === 'RFC8866:5.9')).toBe(true);
+            });
+            it('should reject start time > stop time', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [
+                        {
+                            timing: { startTime: 2000, stopTime: 1000 },
+                            repeats: [],
+                        },
+                    ],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.message.includes('start time'))).toBe(true);
+            });
+            it('should reject multiple direction attributes', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [(0, attributes_1.createRecvonly)(), (0, attributes_1.createSendrecv)()],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.constraint === 'RFC8866:6.7')).toBe(true);
+            });
+            it('should reject negative bandwidth', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [{ type: 'AS', value: -1 }],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => { var _a; return (_a = e.field) === null || _a === void 0 ? void 0 : _a.includes('bandwidth'); })).toBe(true);
+            });
+            it('should reject media-only attribute ptime at session level (RFC 8866 Section 6.4)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [(0, attributes_1.createValueAttribute)('ptime', '20')],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.message.includes('ptime') && e.message.includes('media level'))).toBe(true);
+            });
+            it('should reject media-only attribute rtpmap at session level (RFC 8866 Section 6.6)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [(0, attributes_1.createValueAttribute)('rtpmap', '0 PCMU/8000')],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.message.includes('rtpmap') && e.message.includes('media level'))).toBe(true);
+            });
+            it('should reject media-only attribute fmtp at session level (RFC 8866 Section 6.15)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [(0, attributes_1.createValueAttribute)('fmtp', '96 profile-level-id=42e01f')],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.message.includes('fmtp') && e.message.includes('media level'))).toBe(true);
+            });
+            it('should reject all media-only attributes at session level', () => {
+                // Test all media-only attributes: ptime, maxptime, rtpmap, fmtp, orient, framerate, quality
+                const mediaOnlyAttrs = ['ptime', 'maxptime', 'rtpmap', 'fmtp', 'orient', 'framerate', 'quality'];
+                for (const attrName of mediaOnlyAttrs) {
+                    const session = {
+                        version: 0,
+                        origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                        sessionName: 'Test',
+                        emails: [],
+                        phones: [],
+                        bandwidths: [],
+                        timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                        attributes: [(0, attributes_1.createValueAttribute)(attrName, 'test')],
+                        mediaDescriptions: [],
+                    };
+                    const result = (0, session_validator_1.validateSessionDescription)(session);
+                    expect(result.valid).toBe(false);
+                    expect(result.errors.some((e) => e.message.includes(attrName) && e.message.includes('media level'))).toBe(true);
+                }
+            });
+            it('should reject non-numeric session ID (RFC 8866 Section 5.2)', () => {
+                const session = {
+                    version: 0,
+                    origin: {
+                        username: 'jdoe',
+                        sessId: 'abc123', // Non-numeric session ID
+                        sessVersion: '456',
+                        netType: 'IN',
+                        addrType: 'IP4',
+                        unicastAddress: (0, network_1.createIP4Address)('10.0.0.1'),
+                    },
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.field === 'origin.sessId' &&
+                    e.message.includes('only digits'))).toBe(true);
+            });
+            it('should reject non-numeric session version (RFC 8866 Section 5.2)', () => {
+                const session = {
+                    version: 0,
+                    origin: {
+                        username: 'jdoe',
+                        sessId: '123',
+                        sessVersion: '456abc', // Non-numeric session version
+                        netType: 'IN',
+                        addrType: 'IP4',
+                        unicastAddress: (0, network_1.createIP4Address)('10.0.0.1'),
+                    },
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.field === 'origin.sessVersion' &&
+                    e.message.includes('only digits'))).toBe(true);
+            });
+            it('should reject session ID with special characters', () => {
+                const session = {
+                    version: 0,
+                    origin: {
+                        username: 'jdoe',
+                        sessId: '123-456', // Contains hyphen
+                        sessVersion: '789',
+                        netType: 'IN',
+                        addrType: 'IP4',
+                        unicastAddress: (0, network_1.createIP4Address)('10.0.0.1'),
+                    },
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.field === 'origin.sessId' &&
+                    e.message.includes('only digits'))).toBe(true);
+            });
+            it('should accept valid numeric session ID and version', () => {
+                const session = (0, session_1.createSessionDescription)({
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '2890844526', // Valid numeric session ID
+                    '2890842807', // Valid numeric session version
+                    'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                });
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+            it('should reject invalid email format (RFC 8866 Section 5.6)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: ['invalid-email'],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.field === 'emails[0]' &&
+                    e.constraint === 'RFC8866:5.6')).toBe(true);
+            });
+            it('should accept valid email formats (RFC 8866 Section 5.6)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [
+                        'j.doe@example.com',
+                        'j.doe@example.com (Jane Doe)',
+                        'Jane Doe <j.doe@example.com>',
+                    ],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+            it('should reject invalid phone format (RFC 8866 Section 5.6)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: ['invalid-phone'],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.field === 'phones[0]' &&
+                    e.constraint === 'RFC8866:5.6')).toBe(true);
+            });
+            it('should accept valid phone formats (RFC 8866 Section 5.6)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    emails: [],
+                    phones: [
+                        '+1 617 555-6011',
+                        '+1-617-555-6011 (Jane Doe)',
+                        'Jane Doe <+1 617 555-6011>',
+                    ],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+            it('should reject invalid URI format (RFC 8866 Section 5.5)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    uri: 'http://example.com/path with spaces',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(false);
+                expect(result.errors.some((e) => e.field === 'uri' &&
+                    e.constraint === 'RFC8866:5.5')).toBe(true);
+            });
+            it('should accept valid URI formats (RFC 8866 Section 5.5)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    uri: 'http://www.example.com/session',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+            it('should accept URI with query string and fragment (RFC 8866 Section 5.5)', () => {
+                const session = {
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    uri: 'https://conference.example.org/meeting?id=123#info',
+                    emails: [],
+                    phones: [],
+                    bandwidths: [],
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                    attributes: [],
+                    mediaDescriptions: [],
+                };
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+        });
+        describe('connection coverage', () => {
+            it('should allow session without media and no connection', () => {
+                const session = (0, session_1.createSessionDescription)({
+                    version: 0,
+                    origin: (0, fields_1.createOrigin)('jdoe', '123', '456', 'IN', 'IP4', (0, network_1.createIP4Address)('10.0.0.1')),
+                    sessionName: 'Test',
+                    timeDescriptions: [(0, time_1.createTimeDescription)((0, time_1.createTiming)(0, 0))],
+                });
+                const result = (0, session_validator_1.validateSessionDescription)(session);
+                expect(result.valid).toBe(true);
+            });
+        });
+    });
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://www.schemastore.org/package.json",
+  "name": "@tomgiee/tsdp",
+  "version": "1.0.0",
+  "description": "RFC 8866-compliant SDP parser, serializer, and validator for TypeScript",
+  "author": "Thomas Giesler <tgiesler@brassnode.net>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tomgie/tsdp.git"
+  },
+  "homepage": "https://github.com/tomgie/tsdp#readme",
+  "bugs": {
+    "url": "https://github.com/tomgie/tsdp/issues"
+  },
+  "keywords": [
+    "parser",
+    "typescript",
+    "serializer",
+    "sip",
+    "webrtc",
+    "sdp",
+    "voip",
+    "rfc8866"
+  ],
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.6",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.5.3"
+  }
+}