@tomgiee/tsdp 1.0.0

package/dist/tests/unit/builder/media-builder.test.js

@@ -0,0 +1,524 @@
+"use strict";
+/**
+ * Tests for media-builder.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const media_builder_1 = require("../../../src/builder/media-builder");
+const errors_1 = require("../../../src/types/errors");
+describe('media-builder', () => {
+    describe('MediaBuilder', () => {
+        describe('required fields', () => {
+            it('should throw when type is missing', () => {
+                const builder = new media_builder_1.MediaBuilder()
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0']);
+                expect(() => builder.build()).toThrow(errors_1.BuilderError);
+                expect(() => builder.build()).toThrow('media type');
+            });
+            it('should throw when port is missing', () => {
+                const builder = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .protocol('RTP/AVP')
+                    .formats(['0']);
+                expect(() => builder.build()).toThrow(errors_1.BuilderError);
+                expect(() => builder.build()).toThrow('port');
+            });
+            it('should throw when protocol is missing', () => {
+                const builder = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .formats(['0']);
+                expect(() => builder.build()).toThrow(errors_1.BuilderError);
+                expect(() => builder.build()).toThrow('protocol');
+            });
+            it('should throw when formats is empty', () => {
+                const builder = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP');
+                expect(() => builder.build()).toThrow(errors_1.BuilderError);
+                expect(() => builder.build()).toThrow('formats');
+            });
+        });
+        describe('minimal media', () => {
+            it('should build minimal audio media', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .build();
+                expect(media.media.type).toBe('audio');
+                expect(media.media.port).toEqual({ kind: 'simple', value: 49170 });
+                expect(media.media.proto).toBe('RTP/AVP');
+                expect(media.media.formats).toEqual(['0']);
+            });
+            it('should build minimal video media', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('video')
+                    .port(51372)
+                    .protocol('RTP/AVP')
+                    .formats(['96'])
+                    .build();
+                expect(media.media.type).toBe('video');
+            });
+        });
+        describe('port options', () => {
+            it('should set simple port', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .build();
+                expect(media.media.port).toEqual({ kind: 'simple', value: 49170 });
+            });
+            it('should set port range', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .portRange(49170, 2)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .build();
+                expect(media.media.port).toEqual({ kind: 'range', base: 49170, count: 2 });
+            });
+            it('should set disabled port (0)', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .disabled()
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .build();
+                expect(media.media.port).toEqual({ kind: 'simple', value: 0 });
+            });
+        });
+        describe('formats', () => {
+            it('should set multiple formats at once', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0', '8', '96'])
+                    .build();
+                expect(media.media.formats).toEqual(['0', '8', '96']);
+            });
+            it('should add formats one by one', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .addFormat('0')
+                    .addFormat('8')
+                    .build();
+                expect(media.media.formats).toEqual(['0', '8']);
+            });
+        });
+        describe('information', () => {
+            it('should set media information', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .information('Audio stream')
+                    .build();
+                expect(media.information).toBe('Audio stream');
+            });
+        });
+        describe('connection', () => {
+            it('should add IPv4 connection', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .connection('192.168.1.100')
+                    .build();
+                expect(media.connections).toHaveLength(1);
+                expect(media.connections[0].addrType).toBe('IP4');
+            });
+            it('should add IPv6 connection', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .connection('2001:db8::1')
+                    .build();
+                expect(media.connections[0].addrType).toBe('IP6');
+            });
+            it('should add multiple connections', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .connection('192.168.1.100')
+                    .connection('192.168.1.101')
+                    .build();
+                expect(media.connections).toHaveLength(2);
+            });
+        });
+        describe('bandwidth', () => {
+            it('should add AS bandwidth with shorthand', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .bandwidth(128)
+                    .build();
+                expect(media.bandwidths).toHaveLength(1);
+                expect(media.bandwidths[0].type).toBe('AS');
+                expect(media.bandwidths[0].value).toBe(128);
+            });
+            it('should add bandwidth with explicit type', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .addBandwidth('CT', 256)
+                    .build();
+                expect(media.bandwidths[0].type).toBe('CT');
+            });
+        });
+        describe('key', () => {
+            it('should set encryption key', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .key('clear:testkey')
+                    .build();
+                expect(media.key).toBe('clear:testkey');
+            });
+        });
+        describe('direction attributes', () => {
+            it('should add sendrecv', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .sendrecv()
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'property', name: 'sendrecv' });
+            });
+            it('should add recvonly', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .recvonly()
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'property', name: 'recvonly' });
+            });
+            it('should add sendonly', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .sendonly()
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'property', name: 'sendonly' });
+            });
+            it('should add inactive', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .inactive()
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'property', name: 'inactive' });
+            });
+        });
+        describe('RTP attributes', () => {
+            it('should add rtpmap', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0', '8'])
+                    .rtpmap(0, 'PCMU', 8000)
+                    .rtpmap(8, 'PCMA', 8000)
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'rtpmap', value: '0 PCMU/8000' });
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'rtpmap', value: '8 PCMA/8000' });
+            });
+            it('should add rtpmap with encoding params', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['96'])
+                    .rtpmap(96, 'opus', 48000, 2)
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'rtpmap', value: '96 opus/48000/2' });
+            });
+            it('should add fmtp', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('video')
+                    .port(51372)
+                    .protocol('RTP/AVP')
+                    .formats(['96'])
+                    .fmtp(96, 'profile-level-id=42e01f')
+                    .build();
+                expect(media.attributes).toContainEqual({
+                    kind: 'value',
+                    name: 'fmtp',
+                    value: '96 profile-level-id=42e01f',
+                });
+            });
+            it('should add ptime', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .ptime(20)
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'ptime', value: '20' });
+            });
+            it('should add maxptime', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .maxptime(60)
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'maxptime', value: '60' });
+            });
+        });
+        describe('video attributes', () => {
+            it('should add framerate', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('video')
+                    .port(51372)
+                    .protocol('RTP/AVP')
+                    .formats(['96'])
+                    .framerate(30)
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'framerate', value: '30' });
+            });
+            it('should add quality', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('video')
+                    .port(51372)
+                    .protocol('RTP/AVP')
+                    .formats(['96'])
+                    .quality(5)
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'quality', value: '5' });
+            });
+            it('should throw for quality out of range', () => {
+                const builder = new media_builder_1.MediaBuilder()
+                    .type('video')
+                    .port(51372)
+                    .protocol('RTP/AVP')
+                    .formats(['96']);
+                expect(() => builder.quality(11)).toThrow(errors_1.BuilderError);
+                expect(() => builder.quality(-1)).toThrow(errors_1.BuilderError);
+            });
+        });
+        describe('WebRTC attributes', () => {
+            it('should add mid', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .mid('audio')
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'mid', value: 'audio' });
+            });
+            it('should add ice-ufrag', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .iceUfrag('a1b2c3d4')
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'ice-ufrag', value: 'a1b2c3d4' });
+            });
+            it('should add ice-pwd', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .icePwd('password123')
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'ice-pwd', value: 'password123' });
+            });
+            it('should add fingerprint', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .fingerprint('sha-256', 'AB:CD:EF:12:34')
+                    .build();
+                expect(media.attributes).toContainEqual({
+                    kind: 'value',
+                    name: 'fingerprint',
+                    value: 'sha-256 AB:CD:EF:12:34',
+                });
+            });
+            it('should add setup', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .setup('actpass')
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'setup', value: 'actpass' });
+            });
+            it('should add rtcp', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .rtcp(49171)
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'rtcp', value: '49171' });
+            });
+            it('should add rtcp with address', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .rtcp(49171, '192.168.1.100')
+                    .build();
+                expect(media.attributes).toContainEqual({
+                    kind: 'value',
+                    name: 'rtcp',
+                    value: '49171 IN IP4 192.168.1.100',
+                });
+            });
+            it('should add rtcp-mux', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .rtcpMux()
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'property', name: 'rtcp-mux' });
+            });
+            it('should add rtcp-rsize', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .rtcpRsize()
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'property', name: 'rtcp-rsize' });
+            });
+        });
+        describe('custom attributes', () => {
+            it('should add custom property attribute', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .addPropertyAttribute('custom-prop')
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'property', name: 'custom-prop' });
+            });
+            it('should add custom value attribute', () => {
+                const media = new media_builder_1.MediaBuilder()
+                    .type('audio')
+                    .port(49170)
+                    .protocol('RTP/AVP')
+                    .formats(['0'])
+                    .addValueAttribute('custom', 'value')
+                    .build();
+                expect(media.attributes).toContainEqual({ kind: 'value', name: 'custom', value: 'value' });
+            });
+        });
+    });
+    describe('factory functions', () => {
+        it('mediaBuilder should create a new MediaBuilder', () => {
+            const builder = (0, media_builder_1.mediaBuilder)();
+            expect(builder).toBeInstanceOf(media_builder_1.MediaBuilder);
+        });
+        it('audioBuilder should create pre-configured audio builder', () => {
+            const builder = (0, media_builder_1.audioBuilder)();
+            const media = builder
+                .port(49170)
+                .protocol('RTP/AVP')
+                .formats(['0'])
+                .build();
+            expect(media.media.type).toBe('audio');
+        });
+        it('videoBuilder should create pre-configured video builder', () => {
+            const builder = (0, media_builder_1.videoBuilder)();
+            const media = builder
+                .port(51372)
+                .protocol('RTP/AVP')
+                .formats(['96'])
+                .build();
+            expect(media.media.type).toBe('video');
+        });
+    });
+    describe('complete media example', () => {
+        it('should build complete audio media with all common attributes', () => {
+            const media = new media_builder_1.MediaBuilder()
+                .type('audio')
+                .port(49170)
+                .protocol('RTP/SAVPF')
+                .formats(['0', '8', '96'])
+                .connection('192.168.1.100')
+                .bandwidth(128)
+                .rtpmap(0, 'PCMU', 8000)
+                .rtpmap(8, 'PCMA', 8000)
+                .rtpmap(96, 'opus', 48000, 2)
+                .fmtp(96, 'minptime=10;useinbandfec=1')
+                .ptime(20)
+                .maxptime(60)
+                .mid('audio')
+                .sendrecv()
+                .rtcpMux()
+                .build();
+            expect(media.media.type).toBe('audio');
+            expect(media.media.formats).toHaveLength(3);
+            expect(media.connections).toHaveLength(1);
+            expect(media.bandwidths).toHaveLength(1);
+            expect(media.attributes.length).toBeGreaterThan(5);
+        });
+        it('should build complete video media with all common attributes', () => {
+            const media = new media_builder_1.MediaBuilder()
+                .type('video')
+                .port(51372)
+                .protocol('RTP/SAVPF')
+                .formats(['96', '97'])
+                .connection('192.168.1.100')
+                .bandwidth(1000)
+                .rtpmap(96, 'VP8', 90000)
+                .rtpmap(97, 'H264', 90000)
+                .fmtp(97, 'profile-level-id=42e01f;packetization-mode=1')
+                .framerate(30)
+                .mid('video')
+                .sendrecv()
+                .rtcpMux()
+                .rtcpRsize()
+                .build();
+            expect(media.media.type).toBe('video');
+            expect(media.media.formats).toHaveLength(2);
+            expect(media.attributes.length).toBeGreaterThan(5);
+        });
+    });
+});

package/dist/tests/unit/builder/session-builder.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for session-builder.ts
+ */
+export {};
+//# sourceMappingURL=session-builder.test.d.ts.map

package/dist/tests/unit/builder/session-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-builder.test.d.ts","sourceRoot":"","sources":["../../../../tests/unit/builder/session-builder.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}