whepts 1.0.2 → 1.0.3

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Skill(superpowers:brainstorming)",
+      "Skill(superpowers:executing-plans)",
+      "Bash(npm run build:*)"
+    ]
+  }
+}

package/AGENTS.md

@@ -0,0 +1,92 @@
+# AGENTS.md - WhepTS Player
+
+## Build/Lint Commands
+
+- `npm run build` - Production build with minification
+- `npm run build:debug` - Debug build with source maps
+- `npm run lint` - Run ESLint to check code quality
+- `npm run lint:fix` - Auto-fix ESLint issues
+
+**Note**: No test framework is currently configured.
+
+## Code Style Guidelines
+
+### Imports
+
+- Use `~/` alias for imports from `src/` (e.g., `import X from '~/utils/observer'`)
+- Import types explicitly using `import type { T } from './module'`
+- Group external dependencies first, then internal imports
+
+### Formatting
+
+- ESLint uses `@antfu/eslint-config` with formatters enabled
+- Run `npm run lint:fix` before committing
+- No manual formatting required - let ESLint handle it
+
+### Types
+
+- Strict mode enabled in `tsconfig.json`
+- Use `interface` for object shapes, `type` for unions/aliases
+- Mark optional properties with `?` (e.g., `onError?: (err: WebRTCError) => void`)
+- Use TypeScript strictly - no `any` types
+
+### Naming Conventions
+
+- **Classes**: PascalCase (e.g., `WebRTCWhep`, `VisibilityObserver`)
+- **Interfaces**: PascalCase (e.g., `Conf`, `ErrorType`)
+- **Functions/Methods**: camelCase (e.g., `setupPeerConnection`, `handleError`)
+- **Constants**: UPPER_SNAKE_CASE (e.g., `ErrorTypes`)
+- **Private members**: prefix with `private` keyword
+
+### Error Handling
+
+- Use custom `WebRTCError` class for all errors (defined in `src/errors.ts`)
+- Error types: `SIGNAL_ERROR`, `STATE_ERROR`, `NETWORK_ERROR`, `MEDIA_ERROR`, `OTHER_ERROR`
+- Pattern: `throw new WebRTCError(ErrorTypes.NETWORK_ERROR, 'message')`
+- Call `this.handleError(err)` for centralized error management
+
+### Comments
+
+- Use JSDoc for public APIs and class constructors (in English)
+- Keep implementation comments concise in Chinese as established
+- Example:
+  ```typescript
+  /**
+   * Create a WebRTCWhep.
+   * @param {Conf} conf - Configuration.
+   */
+  constructor(conf: Conf)
+  ```
+
+### File Organization
+
+- Core logic in `src/` directory
+- Utilities in `src/utils/` (e.g., `observer.ts`, `flow-check.ts`, `sdp.ts`)
+- Error types in `src/errors.ts`
+- Export main class from `src/index.ts`
+
+### State Management
+
+- Use union literal types for state (e.g., `'getting_codecs' | 'running' | 'restarting' | 'closed' | 'failed'`)
+- Always check state before operations that depend on it
+- Use getters for derived properties (e.g., `get isRunning()`)
+
+### WebRTC Specifics
+
+- Always use `unified-plan` SDP semantics
+- Handle ICE candidates with queuing when session URL not ready
+- Support non-advertised codecs (PCMA, multiopus, L16)
+- Use `IntersectionObserver` for visibility-based playback control
+
+## Tech Stack
+
+- TypeScript 5.9 with strict mode
+- Rollup for bundling (ES module output)
+- ESLint with @antfu/eslint-config
+- pnpm as package manager
+
+## Before Committing
+
+1. Run `npm run lint` and fix all issues
+2. Build with `npm run build` to verify production build works
+3. No test framework - manually verify WebRTC functionality

package/dist/core/codec.d.ts

@@ -0,0 +1,11 @@
+import type { State } from '~/types';
+export interface CodecDetectorCallbacks {
+    onCodecsDetected: (codecs: string[]) => void;
+    onError: (err: Error) => void;
+}
+export declare class CodecDetector {
+    private getState;
+    private callbacks;
+    constructor(getState: () => State, callbacks: CodecDetectorCallbacks);
+    detect(): void;
+}

package/dist/core/connection.d.ts

@@ -0,0 +1,24 @@
+import type { ParsedOffer } from '../utils/sdp';
+import type { State } from '~/types';
+import { WebRTCError } from '~/errors';
+export interface ConnectionManagerCallbacks {
+    onCandidate: (candidate: RTCIceCandidate) => void;
+    onTrack: (evt: RTCTrackEvent) => void;
+    onError: (err: WebRTCError) => void;
+}
+export declare class ConnectionManager {
+    private getState;
+    private callbacks;
+    private nonAdvertisedCodecs;
+    private pc?;
+    private offerData?;
+    constructor(getState: () => State, callbacks: ConnectionManagerCallbacks, nonAdvertisedCodecs?: string[]);
+    setupPeerConnection(iceServers: RTCIceServer[]): Promise<string>;
+    setAnswer(answer: string): Promise<void>;
+    getPeerConnection(): RTCPeerConnection | undefined;
+    getOfferData(): ParsedOffer | undefined;
+    close(): void;
+    private onLocalCandidate;
+    private onConnectionState;
+    private onIceConnectionState;
+}

package/dist/core/http.d.ts

@@ -0,0 +1,16 @@
+import type { ParsedOffer } from '../utils/sdp';
+import type { Conf, State } from '~/types';
+import { WebRTCError } from '~/errors';
+export declare class HttpClient {
+    private config;
+    private getState;
+    private onError;
+    constructor(config: Conf, getState: () => State, onError: (err: Error | WebRTCError) => void);
+    private authHeader;
+    requestICEServers(): Promise<RTCIceServer[]>;
+    sendOffer(offer: string): Promise<{
+        sessionUrl?: string;
+        answer: string;
+    }>;
+    sendLocalCandidates(sessionUrl: string, offerData: ParsedOffer, candidates: RTCIceCandidate[]): void;
+}

package/dist/core/track.d.ts

@@ -0,0 +1,12 @@
+export declare class TrackManager {
+    private container;
+    private stream?;
+    private observer?;
+    constructor(container: HTMLMediaElement);
+    onTrack(evt: RTCTrackEvent): void;
+    private stopObserver;
+    get paused(): boolean;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
+import type { Conf, State } from './types';
 import { ErrorTypes, WebRTCError } from './errors';
-import WebRTCWhep, { Conf } from './whep';
-export { Conf, ErrorTypes, WebRTCError };
+import WebRTCWhep from './whep';
+export { Conf, ErrorTypes, State, WebRTCError };
 export default WebRTCWhep;

package/dist/index.js

@@ -1 +1 @@
-const e={SIGNAL_ERROR:"SignalError",STATE_ERROR:"StateError",NETWORK_ERROR:"NetworkError",MEDIA_ERROR:"MediaError",OTHER_ERROR:"OtherError"};class t extends Error{constructor(e,t,s){super(t,s),this.type=e}}class s{start(e,t){e&&(this.stop(),this.observer=new IntersectionObserver(([e])=>t(e.isIntersecting),{threshold:.5}),this.observer.observe(e))}stop(){this.observer&&(this.observer.disconnect(),this.observer=void 0)}}class r{constructor(e){this.lastBytesReceived=0,this.checkInterval=e.interval,this.onError=e.onError}setPeerConnection(e){this.pc=e}start(){this.stop(),this.checkTimer=setInterval(()=>this.checkFlowState(),this.checkInterval)}stop(){this.checkTimer&&(clearInterval(this.checkTimer),this.checkTimer=void 0)}async checkFlowState(){if(!this.pc)return;const s=await this.pc.getStats();let r=0;s.forEach(e=>{const t=e;"inbound-rtp"===e.type&&"video"===t.kind&&(r=t.bytesReceived||0)}),r!==this.lastBytesReceived||"connected"!==this.pc.connectionState?this.lastBytesReceived=r:this.onError(new t(e.NETWORK_ERROR,"data stream interruption"))}}class n{static parseOffer(e){const t={iceUfrag:"",icePwd:"",medias:[]};for(const s of e.split("\r\n"))s.startsWith("m=")?t.medias.push(s.slice(2)):""===t.iceUfrag&&s.startsWith("a=ice-ufrag:")?t.iceUfrag=s.slice(12):""===t.icePwd&&s.startsWith("a=ice-pwd:")&&(t.icePwd=s.slice(10));return t}static reservePayloadType(e){for(let t=30;t<=127;t++)if((t<=63||t>=96)&&!e.includes(t.toString())){const s=t.toString();return e.push(s),s}throw new Error("unable to find a free payload type")}static enableStereoPcmau(e,t){const s=t.split("\r\n");let r=n.reservePayloadType(e);return s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} PCMU/8000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),r=n.reservePayloadType(e),s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} PCMA/8000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),s.join("\r\n")}static enableMultichannelOpus(e,t){const s=t.split("\r\n");let r=n.reservePayloadType(e);return s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} multiopus/48000/3`),s.splice(s.length-1,0,`a=fmtp:${r} channel_mapping=0,2,1;num_streams=2;coupled_streams=1`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),r=n.reservePayloadType(e),s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} multiopus/48000/4`),s.splice(s.length-1,0,`a=fmtp:${r} channel_mapping=0,1,2,3;num_streams=2;coupled_streams=2`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),r=n.reservePayloadType(e),s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} multiopus/48000/5`),s.splice(s.length-1,0,`a=fmtp:${r} channel_mapping=0,4,1,2,3;num_streams=3;coupled_streams=2`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),r=n.reservePayloadType(e),s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} multiopus/48000/6`),s.splice(s.length-1,0,`a=fmtp:${r} channel_mapping=0,4,1,2,3,5;num_streams=4;coupled_streams=2`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),r=n.reservePayloadType(e),s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} multiopus/48000/7`),s.splice(s.length-1,0,`a=fmtp:${r} channel_mapping=0,4,1,2,3,5,6;num_streams=4;coupled_streams=4`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),r=n.reservePayloadType(e),s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} multiopus/48000/8`),s.splice(s.length-1,0,`a=fmtp:${r} channel_mapping=0,6,1,4,5,2,3,7;num_streams=5;coupled_streams=4`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),s.join("\r\n")}static enableL16(e,t){const s=t.split("\r\n");let r=n.reservePayloadType(e);return s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} L16/8000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),r=n.reservePayloadType(e),s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} L16/16000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),r=n.reservePayloadType(e),s[0]+=` ${r}`,s.splice(s.length-1,0,`a=rtpmap:${r} L16/48000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${r} transport-cc`),s.join("\r\n")}static enableStereoOpus(e){let t="";const s=e.split("\r\n");for(let e=0;e<s.length;e++)if(s[e].startsWith("a=rtpmap:")&&s[e].toLowerCase().includes("opus/")){t=s[e].slice(9).split(" ")[0];break}if(""===t)return e;for(let e=0;e<s.length;e++)s[e].startsWith(`a=fmtp:${t} `)&&(s[e].includes("stereo")||(s[e]+=";stereo=1"),s[e].includes("sprop-stereo")||(s[e]+=";sprop-stereo=1"));return s.join("\r\n")}static editOffer(e,t){const s=e.split("m="),r=s.slice(1).map(e=>e.split("\r\n")[0].split(" ").slice(3)).reduce((e,t)=>[...e,...t],[]);for(let e=1;e<s.length;e++)if(s[e].startsWith("audio")){s[e]=n.enableStereoOpus(s[e]),t.includes("pcma/8000/2")&&(s[e]=n.enableStereoPcmau(r,s[e])),t.includes("multiopus/48000/6")&&(s[e]=n.enableMultichannelOpus(r,s[e])),t.includes("L16/48000/2")&&(s[e]=n.enableL16(r,s[e]));break}return s.join("m=")}static generateSdpFragment(e,t){const s={};for(const e of t){const t=e.sdpMLineIndex;t&&(void 0===s[t]&&(s[t]=[]),s[t].push(e))}let r=`a=ice-ufrag:${e.iceUfrag}\r\na=ice-pwd:${e.icePwd}\r\n`,n=0;for(const t of e.medias){if(void 0!==s[n]){r+=`m=${t}\r\na=mid:${n}\r\n`;for(const e of s[n])r+=`a=${e.candidate}\r\n`}n++}return r}}class i{static async supportsNonAdvertisedCodec(e,t){return new Promise(s=>{const r=new RTCPeerConnection({iceServers:[]}),n="audio";let a="";r.addTransceiver(n,{direction:"recvonly"}),r.createOffer().then(s=>{if(!s.sdp)throw new Error("SDP not present");if(s.sdp.includes(` ${e}`))throw new Error("already present");const o=s.sdp.split(`m=${n}`),c=o.slice(1).map(e=>e.split("\r\n")[0].split(" ").slice(3)).reduce((e,t)=>[...e,...t],[]);a=i.reservePayloadType(c);const h=o[1].split("\r\n");return h[0]+=` ${a}`,h.splice(h.length-1,0,`a=rtpmap:${a} ${e}`),void 0!==t&&h.splice(h.length-1,0,`a=fmtp:${a} ${t}`),o[1]=h.join("\r\n"),s.sdp=o.join(`m=${n}`),r.setLocalDescription(s)}).then(()=>r.setRemoteDescription(new RTCSessionDescription({type:"answer",sdp:`v=0\r\no=- 6539324223450680508 0 IN IP4 0.0.0.0\r\ns=-\r\nt=0 0\r\na=fingerprint:sha-256 0D:9F:78:15:42:B5:4B:E6:E2:94:3E:5B:37:78:E1:4B:54:59:A3:36:3A:E5:05:EB:27:EE:8F:D2:2D:41:29:25\r\nm=${n} 9 UDP/TLS/RTP/SAVPF ${a}\r\nc=IN IP4 0.0.0.0\r\na=ice-pwd:7c3bf4770007e7432ee4ea4d697db675\r\na=ice-ufrag:29e036dc\r\na=sendonly\r\na=rtcp-mux\r\na=rtpmap:${a} ${e}\r\n${void 0!==t?`a=fmtp:${a} ${t}\r\n`:""}`}))).then(()=>s(!0)).catch(()=>s(!1)).finally(()=>r.close())})}static unquoteCredential(e){return JSON.parse(`"${e}"`)}static linkToIceServers(s){return s?s.split(", ").map(s=>{const r=s.match(/^<(.+?)>; rel="ice-server"(; username="(.*?)"; credential="(.*?)"; credential-type="password")?/i);if(!r)throw new t(e.SIGNAL_ERROR,"Invalid ICE server link format");const n={urls:[r[1]]};return r[3]&&(n.username=i.unquoteCredential(r[3]),n.credential=i.unquoteCredential(r[4]),n.credentialType="password"),n}):[]}static reservePayloadType(e){for(let t=30;t<=127;t++)if((t<=63||t>=96)&&!e.includes(t.toString())){const s=t.toString();return e.push(s),s}throw new Error("unable to find a free payload type")}}class a{constructor(e){this.retryPause=2e3,this.queuedCandidates=[],this.nonAdvertisedCodecs=[],this.conf=e,this.state="getting_codecs",this.observer=new s,this.flowCheck=new r({interval:5e3,onError:e=>this.handleError(e)}),this.getNonAdvertisedCodecs()}get isRunning(){return"running"===this.state}close(){this.state="closed",this.pc?.close(),this.observer.stop(),this.flowCheck.stop(),this.restartTimeout&&clearTimeout(this.restartTimeout)}handleError(s){this.flowCheck.stop(),"getting_codecs"===this.state||s instanceof t&&s.type===e.SIGNAL_ERROR?this.state="failed":"running"===this.state&&(this.pc?.close(),this.pc=void 0,this.offerData=void 0,this.queuedCandidates=[],this.sessionUrl&&(fetch(this.sessionUrl,{method:"DELETE"}),this.sessionUrl=void 0),this.state="restarting",this.restartTimeout=setTimeout(()=>{this.restartTimeout=void 0,this.state="running",this.start()},this.retryPause),s.message=`${s.message}, retrying in some seconds`),this.conf.onError&&(s instanceof t?this.conf.onError(s):this.conf.onError(new t(e.OTHER_ERROR,s.message)))}getNonAdvertisedCodecs(){Promise.all([["pcma/8000/2"],["multiopus/48000/6","channel_mapping=0,4,1,2,3,5;num_streams=4;coupled_streams=2"],["L16/48000/2"]].map(e=>i.supportsNonAdvertisedCodec(e[0],e[1]).then(t=>!!t&&e[0]))).then(e=>e.filter(e=>!1!==e)).then(s=>{if("getting_codecs"!==this.state)throw new t(e.STATE_ERROR,"closed");this.nonAdvertisedCodecs=s,this.state="running",this.start()}).catch(e=>this.handleError(e))}start(){this.requestICEServers().then(e=>this.setupPeerConnection(e)).then(e=>this.sendOffer(e)).then(e=>this.setAnswer(e)).catch(e=>this.handleError(e))}authHeader(){if(this.conf.user&&""!==this.conf.user){return{Authorization:`Basic ${btoa(`${this.conf.user}:${this.conf.pass}`)}`}}return this.conf.token&&""!==this.conf.token?{Authorization:`Bearer ${this.conf.token}`}:{}}async requestICEServers(){return this.conf.iceServers&&this.conf.iceServers.length>0?this.conf.iceServers:fetch(this.conf.url,{method:"OPTIONS",headers:{...this.authHeader()}}).then(e=>i.linkToIceServers(e.headers.get("Link")))}async setupPeerConnection(s){if("running"!==this.state)throw new t(e.STATE_ERROR,"closed");const r=new RTCPeerConnection({iceServers:s,sdpSemantics:"unified-plan"});this.pc=r,this.flowCheck.setPeerConnection(r);const i="recvonly";return r.addTransceiver("video",{direction:i}),r.addTransceiver("audio",{direction:i}),r.onicecandidate=e=>this.onLocalCandidate(e),r.onconnectionstatechange=()=>this.onConnectionState(),r.ontrack=e=>this.onTrack(e),r.createOffer().then(s=>{if(!s.sdp)throw new t(e.SIGNAL_ERROR,"Failed to create offer SDP");return s.sdp=n.editOffer(s.sdp,this.nonAdvertisedCodecs),this.offerData=n.parseOffer(s.sdp),r.setLocalDescription(s).then(()=>s.sdp)})}sendOffer(s){if("running"!==this.state)throw new t(e.STATE_ERROR,"closed");return fetch(this.conf.url,{method:"POST",headers:{...this.authHeader(),"Content-Type":"application/sdp"},body:s}).then(s=>{switch(s.status){case 201:break;case 404:throw new t(e.NETWORK_ERROR,"stream not found");case 406:throw new t(e.NETWORK_ERROR,"stream not supported");case 400:return s.json().then(s=>{throw new t(e.NETWORK_ERROR,s.error)});default:throw new t(e.NETWORK_ERROR,`bad status code ${s.status}`)}const r=s.headers.get("Location");return r&&(this.sessionUrl=new URL(r,this.conf.url).toString()),s.text()})}setAnswer(s){if("running"!==this.state)throw new t(e.STATE_ERROR,"closed");return this.pc.setRemoteDescription(new RTCSessionDescription({type:"answer",sdp:s})).then(()=>{"running"===this.state&&0!==this.queuedCandidates.length&&(this.sendLocalCandidates(this.queuedCandidates),this.queuedCandidates=[])})}onLocalCandidate(e){"running"===this.state&&e.candidate&&(this.sessionUrl?this.sendLocalCandidates([e.candidate]):this.queuedCandidates.push(e.candidate))}sendLocalCandidates(s){this.sessionUrl&&this.offerData&&fetch(this.sessionUrl,{method:"PATCH",headers:{"Content-Type":"application/trickle-ice-sdpfrag","If-Match":"*"},body:n.generateSdpFragment(this.offerData,s)}).then(s=>{switch(s.status){case 204:break;case 404:throw new t(e.NETWORK_ERROR,"stream not found");default:throw new t(e.NETWORK_ERROR,`bad status code ${s.status}`)}}).catch(e=>this.handleError(e))}onConnectionState(){"running"===this.state&&this.pc&&("failed"===this.pc.connectionState||"closed"===this.pc.connectionState?this.handleError(new t(e.OTHER_ERROR,"peer connection closed")):"connected"===this.pc.connectionState&&this.flowCheck.start())}onTrack(e){this.stream=e.streams[0],this.observer.start(this.conf.container,e=>{e?this.resume():this.pause()})}get paused(){return null===this.conf.container.srcObject}pause(){this.conf.container.srcObject=null}resume(){this.stream&&this.paused&&(this.conf.container.srcObject=this.stream)}}export{e as ErrorTypes,t as WebRTCError,a as default};
+const e={SIGNAL_ERROR:"SignalError",STATE_ERROR:"StateError",NETWORK_ERROR:"NetworkError",MEDIA_ERROR:"MediaError",OTHER_ERROR:"OtherError"};class t extends Error{constructor(e,t,s){super(t,s),this.type=e}}class s{static async supportsNonAdvertisedCodec(e,t){return new Promise(n=>{const r=new RTCPeerConnection({iceServers:[]}),i="audio";let a="";r.addTransceiver(i,{direction:"recvonly"}),r.createOffer().then(n=>{if(!n.sdp)throw new Error("SDP not present");if(n.sdp.includes(` ${e}`))throw new Error("already present");const c=n.sdp.split(`m=${i}`),o=c.slice(1).map(e=>e.split("\r\n")[0].split(" ").slice(3)).reduce((e,t)=>[...e,...t],[]);a=s.reservePayloadType(o);const h=c[1].split("\r\n");return h[0]+=` ${a}`,h.splice(h.length-1,0,`a=rtpmap:${a} ${e}`),void 0!==t&&h.splice(h.length-1,0,`a=fmtp:${a} ${t}`),c[1]=h.join("\r\n"),n.sdp=c.join(`m=${i}`),r.setLocalDescription(n)}).then(()=>r.setRemoteDescription(new RTCSessionDescription({type:"answer",sdp:`v=0\r\no=- 6539324223450680508 0 IN IP4 0.0.0.0\r\ns=-\r\nt=0 0\r\na=fingerprint:sha-256 0D:9F:78:15:42:B5:4B:E6:E2:94:3E:5B:37:78:E1:4B:54:59:A3:36:3A:E5:05:EB:27:EE:8F:D2:2D:41:29:25\r\nm=${i} 9 UDP/TLS/RTP/SAVPF ${a}\r\nc=IN IP4 0.0.0.0\r\na=ice-pwd:7c3bf4770007e7432ee4ea4d697db675\r\na=ice-ufrag:29e036dc\r\na=sendonly\r\na=rtcp-mux\r\na=rtpmap:${a} ${e}\r\n${void 0!==t?`a=fmtp:${a} ${t}\r\n`:""}`}))).then(()=>n(!0)).catch(()=>n(!1)).finally(()=>r.close())})}static unquoteCredential(e){return JSON.parse(`"${e}"`)}static linkToIceServers(n){return n?n.split(", ").map(n=>{const r=n.match(/^<(.+?)>; rel="ice-server"(; username="(.*?)"; credential="(.*?)"; credential-type="password")?/i);if(!r)throw new t(e.SIGNAL_ERROR,"Invalid ICE server link format");const i={urls:[r[1]]};return r[3]&&(i.username=s.unquoteCredential(r[3]),i.credential=s.unquoteCredential(r[4]),i.credentialType="password"),i}):[]}static reservePayloadType(e){for(let t=30;t<=127;t++)if((t<=63||t>=96)&&!e.includes(t.toString())){const s=t.toString();return e.push(s),s}throw new Error("unable to find a free payload type")}}class n{constructor(e,t){this.getState=e,this.callbacks=t}detect(){Promise.all([["pcma/8000/2"],["multiopus/48000/6","channel_mapping=0,4,1,2,3,5;num_streams=4;coupled_streams=2"],["L16/48000/2"]].map(e=>s.supportsNonAdvertisedCodec(e[0],e[1]).then(t=>!!t&&e[0]))).then(e=>e.filter(e=>!1!==e)).then(s=>{if("getting_codecs"!==this.getState())throw new t(e.STATE_ERROR,"closed");this.callbacks.onCodecsDetected(s)}).catch(e=>this.callbacks.onError(e))}}class r{static parseOffer(e){const t={iceUfrag:"",icePwd:"",medias:[]};for(const s of e.split("\r\n"))s.startsWith("m=")?t.medias.push(s.slice(2)):""===t.iceUfrag&&s.startsWith("a=ice-ufrag:")?t.iceUfrag=s.slice(12):""===t.icePwd&&s.startsWith("a=ice-pwd:")&&(t.icePwd=s.slice(10));return t}static reservePayloadType(e){for(let t=30;t<=127;t++)if((t<=63||t>=96)&&!e.includes(t.toString())){const s=t.toString();return e.push(s),s}throw new Error("unable to find a free payload type")}static enableStereoPcmau(e,t){const s=t.split("\r\n");let n=r.reservePayloadType(e);return s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} PCMU/8000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),n=r.reservePayloadType(e),s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} PCMA/8000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),s.join("\r\n")}static enableMultichannelOpus(e,t){const s=t.split("\r\n");let n=r.reservePayloadType(e);return s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} multiopus/48000/3`),s.splice(s.length-1,0,`a=fmtp:${n} channel_mapping=0,2,1;num_streams=2;coupled_streams=1`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),n=r.reservePayloadType(e),s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} multiopus/48000/4`),s.splice(s.length-1,0,`a=fmtp:${n} channel_mapping=0,1,2,3;num_streams=2;coupled_streams=2`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),n=r.reservePayloadType(e),s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} multiopus/48000/5`),s.splice(s.length-1,0,`a=fmtp:${n} channel_mapping=0,4,1,2,3;num_streams=3;coupled_streams=2`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),n=r.reservePayloadType(e),s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} multiopus/48000/6`),s.splice(s.length-1,0,`a=fmtp:${n} channel_mapping=0,4,1,2,3,5;num_streams=4;coupled_streams=2`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),n=r.reservePayloadType(e),s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} multiopus/48000/7`),s.splice(s.length-1,0,`a=fmtp:${n} channel_mapping=0,4,1,2,3,5,6;num_streams=4;coupled_streams=4`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),n=r.reservePayloadType(e),s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} multiopus/48000/8`),s.splice(s.length-1,0,`a=fmtp:${n} channel_mapping=0,6,1,4,5,2,3,7;num_streams=5;coupled_streams=4`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),s.join("\r\n")}static enableL16(e,t){const s=t.split("\r\n");let n=r.reservePayloadType(e);return s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} L16/8000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),n=r.reservePayloadType(e),s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} L16/16000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),n=r.reservePayloadType(e),s[0]+=` ${n}`,s.splice(s.length-1,0,`a=rtpmap:${n} L16/48000/2`),s.splice(s.length-1,0,`a=rtcp-fb:${n} transport-cc`),s.join("\r\n")}static enableStereoOpus(e){let t="";const s=e.split("\r\n");for(let e=0;e<s.length;e++)if(s[e].startsWith("a=rtpmap:")&&s[e].toLowerCase().includes("opus/")){t=s[e].slice(9).split(" ")[0];break}if(""===t)return e;for(let e=0;e<s.length;e++)s[e].startsWith(`a=fmtp:${t} `)&&(s[e].includes("stereo")||(s[e]+=";stereo=1"),s[e].includes("sprop-stereo")||(s[e]+=";sprop-stereo=1"));return s.join("\r\n")}static editOffer(e,t){const s=e.split("m="),n=s.slice(1).map(e=>e.split("\r\n")[0].split(" ").slice(3)).reduce((e,t)=>[...e,...t],[]);for(let e=1;e<s.length;e++)if(s[e].startsWith("audio")){s[e]=r.enableStereoOpus(s[e]),t.includes("pcma/8000/2")&&(s[e]=r.enableStereoPcmau(n,s[e])),t.includes("multiopus/48000/6")&&(s[e]=r.enableMultichannelOpus(n,s[e])),t.includes("L16/48000/2")&&(s[e]=r.enableL16(n,s[e]));break}return s.join("m=")}static generateSdpFragment(e,t){const s={};for(const e of t){const t=e.sdpMLineIndex;t&&(void 0===s[t]&&(s[t]=[]),s[t].push(e))}let n=`a=ice-ufrag:${e.iceUfrag}\r\na=ice-pwd:${e.icePwd}\r\n`,r=0;for(const t of e.medias){if(void 0!==s[r]){n+=`m=${t}\r\na=mid:${r}\r\n`;for(const e of s[r])n+=`a=${e.candidate}\r\n`}r++}return n}}class i{constructor(e,t,s=[]){this.getState=e,this.callbacks=t,this.nonAdvertisedCodecs=s}async setupPeerConnection(s){if("running"!==this.getState())throw new t(e.STATE_ERROR,"closed");const n=new RTCPeerConnection({iceServers:s,sdpSemantics:"unified-plan"});this.pc=n;const i="recvonly";return n.addTransceiver("video",{direction:i}),n.addTransceiver("audio",{direction:i}),n.onicecandidate=e=>this.onLocalCandidate(e),n.onconnectionstatechange=()=>this.onConnectionState(),n.oniceconnectionstatechange=()=>this.onIceConnectionState(),n.ontrack=e=>this.callbacks.onTrack(e),n.createOffer().then(s=>{if(!s.sdp)throw new t(e.SIGNAL_ERROR,"Failed to create offer SDP");return s.sdp=r.editOffer(s.sdp,this.nonAdvertisedCodecs),this.offerData=r.parseOffer(s.sdp),n.setLocalDescription(s).then(()=>s.sdp)})}async setAnswer(s){if("running"!==this.getState())throw new t(e.STATE_ERROR,"closed");return this.pc.setRemoteDescription(new RTCSessionDescription({type:"answer",sdp:s}))}getPeerConnection(){return this.pc}getOfferData(){return this.offerData}close(){this.pc?.close(),this.pc=void 0,this.offerData=void 0}onLocalCandidate(e){"running"===this.getState()&&e.candidate&&this.callbacks.onCandidate(e.candidate)}onConnectionState(){"running"===this.getState()&&this.pc&&("failed"!==this.pc.connectionState&&"closed"!==this.pc.connectionState||this.callbacks.onError(new t(e.OTHER_ERROR,"peer connection closed")))}onIceConnectionState(){"running"===this.getState()&&this.pc&&"failed"===this.pc.iceConnectionState&&this.pc.restartIce()}}class a{constructor(e,t,s){this.config=e,this.getState=t,this.onError=s}authHeader(){if(this.config.user&&""!==this.config.user){return{Authorization:`Basic ${btoa(`${this.config.user}:${this.config.pass}`)}`}}return this.config.token&&""!==this.config.token?{Authorization:`Bearer ${this.config.token}`}:{}}async requestICEServers(){return this.config.iceServers&&this.config.iceServers.length>0?this.config.iceServers:fetch(this.config.url,{method:"OPTIONS",headers:{...this.authHeader()}}).then(e=>s.linkToIceServers(e.headers.get("Link")))}async sendOffer(s){if("running"!==this.getState())throw new t(e.STATE_ERROR,"closed");return fetch(this.config.url,{method:"POST",headers:{...this.authHeader(),"Content-Type":"application/sdp"},body:s}).then(s=>{switch(s.status){case 201:break;case 404:throw new t(e.NETWORK_ERROR,"stream not found");case 406:throw new t(e.NETWORK_ERROR,"stream not supported");case 400:return s.json().then(s=>{throw new t(e.NETWORK_ERROR,s.error)});default:throw new t(e.NETWORK_ERROR,`bad status code ${s.status}`)}const n=s.headers.get("Location"),r=n?new URL(n,this.config.url).toString():void 0;return s.text().then(e=>({sessionUrl:r,answer:e}))})}sendLocalCandidates(s,n,i){fetch(s,{method:"PATCH",headers:{"Content-Type":"application/trickle-ice-sdpfrag","If-Match":"*"},body:r.generateSdpFragment(n,i)}).then(s=>{switch(s.status){case 204:break;case 404:throw new t(e.NETWORK_ERROR,"stream not found");default:throw new t(e.NETWORK_ERROR,`bad status code ${s.status}`)}}).catch(e=>this.onError(e))}}class c{constructor(e){this.container=e}onTrack(e){this.stream=e.streams[0],this.stopObserver(),this.observer=new IntersectionObserver(([e])=>{e.isIntersecting?this.resume():this.pause()},{threshold:.5}),this.observer.observe(this.container)}stopObserver(){this.observer&&(this.observer.disconnect(),this.observer=void 0)}get paused(){return null===this.container.srcObject}pause(){this.container.srcObject=null}resume(){this.stream&&this.paused&&(this.container.srcObject=this.stream)}stop(){this.stopObserver(),this.stream=void 0}}class o{constructor(e){this.lastBytesReceived=0,this.checkInterval=e.interval,this.onError=e.onError}setPeerConnection(e){this.pc=e}start(){this.stop(),this.checkTimer=setInterval(()=>this.checkFlowState(),this.checkInterval)}stop(){this.checkTimer&&(clearInterval(this.checkTimer),this.checkTimer=void 0)}async checkFlowState(){if(!this.pc)return;const s=await this.pc.getStats();let n=0;s.forEach(e=>{const t=e;"inbound-rtp"===e.type&&"video"===t.kind&&(n=t.bytesReceived||0)}),n!==this.lastBytesReceived||"connected"!==this.pc.connectionState?this.lastBytesReceived=n:this.onError(new t(e.NETWORK_ERROR,"data stream interruption"))}}class h{constructor(e){this.retryPause=2e3,this.queuedCandidates=[],this.nonAdvertisedCodecs=[],this.conf=e,this.state="getting_codecs",this.flowCheck=new o({interval:5e3,onError:e=>this.handleError(e)}),this.httpClient=new a(this.conf,()=>this.state,e=>this.handleError(e)),this.connectionManager=new i(()=>this.state,{onCandidate:e=>this.handleCandidate(e),onTrack:e=>{this.trackManager.onTrack(e),this.flowCheck.start()},onError:e=>this.handleError(e)},this.nonAdvertisedCodecs),this.trackManager=new c(this.conf.container),this.codecDetector=new n(()=>this.state,{onCodecsDetected:e=>this.handleCodecsDetected(e),onError:e=>this.handleError(e)}),this.codecDetector.detect()}get isRunning(){return"running"===this.state}close(){this.state="closed",this.connectionManager.close(),this.trackManager.stop(),this.flowCheck.stop(),this.restartTimeout&&clearTimeout(this.restartTimeout)}handleError(s){this.flowCheck.stop(),"getting_codecs"===this.state||s instanceof t&&s.type===e.SIGNAL_ERROR?this.state="failed":"running"===this.state&&(this.connectionManager.close(),this.queuedCandidates=[],this.sessionUrl&&(fetch(this.sessionUrl,{method:"DELETE"}),this.sessionUrl=void 0),this.state="restarting",this.restartTimeout=setTimeout(()=>{this.restartTimeout=void 0,this.state="running",this.start()},this.retryPause),s.message=`${s.message}, retrying in some seconds`),this.conf.onError&&(s instanceof t?this.conf.onError(s):this.conf.onError(new t(e.OTHER_ERROR,s.message)))}handleCodecsDetected(e){this.nonAdvertisedCodecs=e,this.state="running",this.start()}start(){this.httpClient.requestICEServers().then(e=>this.connectionManager.setupPeerConnection(e)).then(e=>this.httpClient.sendOffer(e)).then(({sessionUrl:e,answer:t})=>this.handleOfferResponse(e,t)).catch(e=>this.handleError(e))}handleOfferResponse(e,t){return e&&(this.sessionUrl=e),this.connectionManager.setAnswer(t).then(()=>{if("running"===this.state&&0!==this.queuedCandidates.length){const e=this.connectionManager.getOfferData();e&&this.sessionUrl&&(this.httpClient.sendLocalCandidates(this.sessionUrl,e,this.queuedCandidates),this.queuedCandidates=[])}})}handleCandidate(e){if(this.sessionUrl){const t=this.connectionManager.getOfferData();t&&this.httpClient.sendLocalCandidates(this.sessionUrl,t,[e])}else this.queuedCandidates.push(e)}get paused(){return this.trackManager.paused}pause(){this.trackManager.pause()}resume(){this.trackManager.resume()}}export{e as ErrorTypes,t as WebRTCError,h as default};

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+import type { WebRTCError } from './errors';
+/**
+ * Configuration interface for WebRTCWhep.
+ */
+export interface Conf {
+    /** Absolute URL of the WHEP endpoint */
+    url: string;
+    /** Media player container */
+    container: HTMLMediaElement;
+    /** Username for authentication */
+    user?: string;
+    /** Password for authentication */
+    pass?: string;
+    /** Token for authentication */
+    token?: string;
+    /** ice server list */
+    iceServers?: RTCIceServer[];
+    /** Called when there's an error */
+    onError?: (err: WebRTCError) => void;
+}
+/**
+ * State type for WebRTCWhep.
+ */
+export type State = 'getting_codecs' | 'running' | 'restarting' | 'closed' | 'failed';
+/** Extend RTCConfiguration to include experimental properties */
+declare global {
+    interface RTCConfiguration {
+        sdpSemantics?: 'plan-b' | 'unified-plan';
+    }
+    interface RTCIceServer {
+        credentialType?: 'password';
+    }
+}

package/dist/whep.d.ts

@@ -1,117 +1,27 @@
-import { WebRTCError } from './errors';
-/**
- * Configuration interface for WebRTCWhep.
- */
-export interface Conf {
-    /** Absolute URL of the WHEP endpoint */
-    url: string;
-    /** Media player container */
-    container: HTMLMediaElement;
-    /** Username for authentication */
-    user?: string;
-    /** Password for authentication */
-    pass?: string;
-    /** Token for authentication */
-    token?: string;
-    /** ice server list */
-    iceServers?: RTCIceServer[];
-    /** Called when there's an error */
-    onError?: (err: WebRTCError) => void;
-}
-/** Extend RTCConfiguration to include experimental properties */
-declare global {
-    interface RTCConfiguration {
-        sdpSemantics?: 'plan-b' | 'unified-plan';
-    }
-    interface RTCIceServer {
-        credentialType?: 'password';
-    }
-}
+import type { Conf } from './types';
 /** WebRTC/WHEP reader. */
 export default class WebRTCWhep {
     private retryPause;
     private conf;
     private state;
     private restartTimeout?;
-    private pc?;
-    private offerData?;
     private sessionUrl?;
     private queuedCandidates;
     private nonAdvertisedCodecs;
-    private observer;
-    private stream?;
     private flowCheck;
-    /**
-     * Create a WebRTCWhep.
-     * @param {Conf} conf - Configuration.
-     */
+    private httpClient;
+    private connectionManager;
+    private trackManager;
+    private codecDetector;
     constructor(conf: Conf);
-    /**
-     * 媒体是否正常
-     */
     get isRunning(): boolean;
-    /**
-     * Close the reader and all its resources.
-     */
     close(): void;
-    /**
-     * Handle errors.
-     */
     private handleError;
-    /**
-     * Get non-advertised codecs.
-     */
-    private getNonAdvertisedCodecs;
-    /**
-     * Start the WebRTC session.
-     */
+    private handleCodecsDetected;
     private start;
-    /**
-     * Generate an authorization header.
-     */
-    private authHeader;
-    /**
-     * Request ICE servers from the endpoint.
-     */
-    private requestICEServers;
-    /**
-     * Setup a peer connection.
-     */
-    private setupPeerConnection;
-    /**
-     * Send an offer to the endpoint.
-     */
-    private sendOffer;
-    /**
-     * Set a remote answer.
-     */
-    private setAnswer;
-    /**
-     * Handle local ICE candidates.
-     */
-    private onLocalCandidate;
-    /**
-     * Send local ICE candidates to the endpoint.
-     */
-    private sendLocalCandidates;
-    /**
-     * Handle peer connection state changes.
-     */
-    private onConnectionState;
-    /**
-     * Handle incoming tracks.
-     */
-    private onTrack;
-    /**
-     * 流是否为空
-     */
+    private handleOfferResponse;
+    private handleCandidate;
     get paused(): boolean;
-    /**
-     * 暂停播放
-     */
     pause(): void;
-    /**
-     * 恢复播放
-     */
     resume(): void;
 }

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "whepts",
   "type": "module",
-  "version": "1.0.2",
-  "packageManager": "pnpm@10.26.2",
+  "version": "1.0.3",
   "description": "基于 mediamtx 的 WebRTC WHEP 播放器，支持 ZLM 和 Mediamtx 的播放地址",
   "author": "mapleafgo",
   "license": "MIT",
@@ -26,12 +25,6 @@
   ],
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "rollup --config --environment NODE_ENV:production",
-    "build:debug": "rollup --config",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix"
-  },
   "devDependencies": {
     "@antfu/eslint-config": "^6.7.3",
     "@rollup/plugin-commonjs": "^29.0.0",
@@ -45,5 +38,11 @@
     "rollup-plugin-delete": "^3.0.2",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "rollup --config --environment NODE_ENV:production",
+    "build:debug": "rollup --config",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix"
   }
-}
+}

package/src/core/codec.ts

@@ -0,0 +1,33 @@
+import type { State } from '~/types'
+import { ErrorTypes, WebRTCError } from '~/errors'
+import { WebRtcUtils } from '../utils/webrtc'
+
+export interface CodecDetectorCallbacks {
+  onCodecsDetected: (codecs: string[]) => void
+  onError: (err: Error) => void
+}
+
+export class CodecDetector {
+  constructor(
+    private getState: () => State,
+    private callbacks: CodecDetectorCallbacks,
+  ) {}
+
+  detect(): void {
+    Promise.all(
+      [
+        ['pcma/8000/2'],
+        ['multiopus/48000/6', 'channel_mapping=0,4,1,2,3,5;num_streams=4;coupled_streams=2'],
+        ['L16/48000/2'],
+      ].map(c => WebRtcUtils.supportsNonAdvertisedCodec(c[0], c[1]).then(r => (r ? c[0] : false))),
+    )
+      .then(c => c.filter(e => e !== false))
+      .then((codecs) => {
+        if (this.getState() !== 'getting_codecs')
+          throw new WebRTCError(ErrorTypes.STATE_ERROR, 'closed')
+
+        this.callbacks.onCodecsDetected(codecs as string[])
+      })
+      .catch(err => this.callbacks.onError(err))
+  }
+}

package/src/core/connection.ts

@@ -0,0 +1,103 @@
+import type { ParsedOffer } from '../utils/sdp'
+import type { State } from '~/types'
+import { ErrorTypes, WebRTCError } from '~/errors'
+import { SdpUtils } from '../utils/sdp'
+
+export interface ConnectionManagerCallbacks {
+  onCandidate: (candidate: RTCIceCandidate) => void
+  onTrack: (evt: RTCTrackEvent) => void
+  onError: (err: WebRTCError) => void
+}
+
+export class ConnectionManager {
+  private pc?: RTCPeerConnection
+  private offerData?: ParsedOffer
+
+  constructor(
+    private getState: () => State,
+    private callbacks: ConnectionManagerCallbacks,
+    private nonAdvertisedCodecs: string[] = [],
+  ) {}
+
+  async setupPeerConnection(iceServers: RTCIceServer[]): Promise<string> {
+    if (this.getState() !== 'running')
+      throw new WebRTCError(ErrorTypes.STATE_ERROR, 'closed')
+
+    const pc = new RTCPeerConnection({
+      iceServers,
+      sdpSemantics: 'unified-plan',
+    })
+    this.pc = pc
+
+    const direction: RTCRtpTransceiverDirection = 'recvonly'
+    pc.addTransceiver('video', { direction })
+    pc.addTransceiver('audio', { direction })
+
+    pc.onicecandidate = (evt: RTCPeerConnectionIceEvent) => this.onLocalCandidate(evt)
+    pc.onconnectionstatechange = () => this.onConnectionState()
+    pc.oniceconnectionstatechange = () => this.onIceConnectionState()
+    pc.ontrack = (evt: RTCTrackEvent) => this.callbacks.onTrack(evt)
+
+    return pc.createOffer().then((offer) => {
+      if (!offer.sdp)
+        throw new WebRTCError(ErrorTypes.SIGNAL_ERROR, 'Failed to create offer SDP')
+
+      offer.sdp = SdpUtils.editOffer(offer.sdp, this.nonAdvertisedCodecs)
+      this.offerData = SdpUtils.parseOffer(offer.sdp)
+
+      return pc.setLocalDescription(offer).then(() => offer.sdp!)
+    })
+  }
+
+  async setAnswer(answer: string): Promise<void> {
+    if (this.getState() !== 'running')
+      throw new WebRTCError(ErrorTypes.STATE_ERROR, 'closed')
+
+    return this.pc!.setRemoteDescription(
+      new RTCSessionDescription({
+        type: 'answer',
+        sdp: answer,
+      }),
+    )
+  }
+
+  getPeerConnection(): RTCPeerConnection | undefined {
+    return this.pc
+  }
+
+  getOfferData(): ParsedOffer | undefined {
+    return this.offerData
+  }
+
+  close(): void {
+    this.pc?.close()
+    this.pc = undefined
+    this.offerData = undefined
+  }
+
+  private onLocalCandidate(evt: RTCPeerConnectionIceEvent): void {
+    if (this.getState() !== 'running')
+      return
+
+    if (evt.candidate)
+      this.callbacks.onCandidate(evt.candidate)
+  }
+
+  private onConnectionState(): void {
+    if (this.getState() !== 'running' || !this.pc)
+      return
+
+    if (this.pc.connectionState === 'failed' || this.pc.connectionState === 'closed')
+      this.callbacks.onError(new WebRTCError(ErrorTypes.OTHER_ERROR, 'peer connection closed'))
+  }
+
+  private onIceConnectionState(): void {
+    if (this.getState() !== 'running' || !this.pc)
+      return
+
+    if (this.pc.iceConnectionState === 'failed') {
+      console.warn('ICE connection failed')
+      this.pc.restartIce()
+    }
+  }
+}

package/src/core/http.ts

@@ -0,0 +1,93 @@
+import type { ParsedOffer } from '../utils/sdp'
+import type { Conf, State } from '~/types'
+import { ErrorTypes, WebRTCError } from '~/errors'
+import { SdpUtils } from '../utils/sdp'
+import { WebRtcUtils } from '../utils/webrtc'
+
+export class HttpClient {
+  constructor(
+    private config: Conf,
+    private getState: () => State,
+    private onError: (err: Error | WebRTCError) => void,
+  ) {}
+
+  private authHeader(): Record<string, string> {
+    if (this.config.user && this.config.user !== '') {
+      const credentials = btoa(`${this.config.user}:${this.config.pass}`)
+      return { Authorization: `Basic ${credentials}` }
+    }
+    if (this.config.token && this.config.token !== '') {
+      return { Authorization: `Bearer ${this.config.token}` }
+    }
+    return {}
+  }
+
+  async requestICEServers(): Promise<RTCIceServer[]> {
+    if (this.config.iceServers && this.config.iceServers.length > 0)
+      return this.config.iceServers
+
+    return fetch(this.config.url, {
+      method: 'OPTIONS',
+      headers: {
+        ...this.authHeader(),
+      },
+    }).then(res => WebRtcUtils.linkToIceServers(res.headers.get('Link')))
+  }
+
+  async sendOffer(offer: string): Promise<{ sessionUrl?: string, answer: string }> {
+    if (this.getState() !== 'running')
+      throw new WebRTCError(ErrorTypes.STATE_ERROR, 'closed')
+
+    return fetch(this.config.url, {
+      method: 'POST',
+      headers: {
+        ...this.authHeader(),
+        'Content-Type': 'application/sdp',
+      },
+      body: offer,
+    }).then((res) => {
+      switch (res.status) {
+        case 201:
+          break
+        case 404:
+          throw new WebRTCError(ErrorTypes.NETWORK_ERROR, 'stream not found')
+        case 406:
+          throw new WebRTCError(ErrorTypes.NETWORK_ERROR, 'stream not supported')
+        case 400:
+          return res.json().then((e: { error: string }) => {
+            throw new WebRTCError(ErrorTypes.NETWORK_ERROR, e.error)
+          })
+        default:
+          throw new WebRTCError(ErrorTypes.NETWORK_ERROR, `bad status code ${res.status}`)
+      }
+
+      const location = res.headers.get('Location')
+      const sessionUrl = location
+        ? new URL(location, this.config.url).toString()
+        : undefined
+      return res.text().then(answer => ({ sessionUrl, answer }))
+    })
+  }
+
+  sendLocalCandidates(sessionUrl: string, offerData: ParsedOffer, candidates: RTCIceCandidate[]): void {
+    fetch(sessionUrl, {
+      method: 'PATCH',
+      headers: {
+        'Content-Type': 'application/trickle-ice-sdpfrag',
+        'If-Match': '*',
+      },
+      body: SdpUtils.generateSdpFragment(offerData, candidates),
+    })
+      .then((res) => {
+        switch (res.status) {
+          case 204:
+            break
+          case 404:
+            throw new WebRTCError(ErrorTypes.NETWORK_ERROR, 'stream not found')
+          default:
+            throw new WebRTCError(ErrorTypes.NETWORK_ERROR, `bad status code ${res.status}`)
+        }
+      })
+      .catch(err => this.onError(err))
+  }
+}