whepts 1.0.3 → 1.1.0

package/README.md

@@ -17,6 +17,7 @@ WebRTC WHEP (WebRTC HTTP Egress Protocol) 是一种用于从 WebRTC 服务器获
 - 支持事件监听和错误处理
 - 可配置的连接参数
 - 自动断流检测与重连
+- 支持动态更新播放地址（用于故障切换）
 - 支持多种音视频编解码器
 - 支持仅可视区域播放控制
 - 在 Chrome 上根据硬件支持 G711 和 H265 编解码器
@@ -44,14 +45,24 @@ import WebRTCWhep from 'whepts'
 const config = {
   url: 'https://your-server:port/index/api/whep?app={app}&stream={stream}', // WHEP 服务器地址
   container: document.getElementById('video') as HTMLMediaElement, // 视频播放容器
-  onError: (error) => {
-    console.error('播放错误:', error)
-  }
 }
 
 // 创建播放器实例
 const player = new WebRTCWhep(config)
 
+// 监听事件
+player.on('state:change', ({ from, to }) => {
+  console.log(`状态变化: ${from} → ${to}`)
+})
+
+player.on('error', (error) => {
+  console.error('播放错误:', error.message, error.type)
+})
+
+player.on('track', (evt) => {
+  console.log('接收到媒体轨道:', evt.track.kind)
+})
+
 // 播放器会自动开始播放
 ```
 
@@ -71,15 +82,37 @@ const config = {
     {
       urls: ['stun:stun.l.google.com:19302']
     }
-  ],
-  onError: (error) => {
-    console.error('播放错误:', error)
-  }
+  ]
 }
 
 // 创建播放器实例
 const player = new WebRTCWhep(config)
 
+// 监听所有事件
+player.on('state:change', ({ from, to }) => {
+  console.log(`状态: ${from} → ${to}`)
+})
+
+player.on('candidate', (candidate) => {
+  console.log('ICE 候选:', candidate.candidate)
+})
+
+player.on('track', (evt) => {
+  console.log('媒体轨道:', evt.track.kind)
+})
+
+player.on('error', (error) => {
+  console.error('错误:', error.message, error.type)
+})
+
+player.on('close', () => {
+  console.log('连接已关闭')
+})
+
+player.on('restart', () => {
+  console.log('正在重连...')
+})
+
 // 检查流状态
 console.log('流状态:', player.isRunning)
 
@@ -90,7 +123,35 @@ player.pause()
 player.resume()
 
 // 关闭播放器
-// player.close();
+player.close()
+```
+
+### 更新播放地址
+
+当播放失败时，可以使用 `updateUrl()` 方法切换到新的播放地址：
+
+```typescript
+import WebRTCWhep from 'whepts'
+
+const player = new WebRTCWhep({
+  url: 'https://your-server:port/stream.whep',
+  container: document.getElementById('video') as HTMLMediaElement,
+})
+
+// 监听错误事件
+player.on('error', async (error) => {
+  console.error('播放错误:', error.message)
+
+  // 从服务器获取新的播放地址
+  const newUrl = await fetchNewStreamUrl()
+
+  // 使用新地址重新开始播放
+  player.updateUrl(newUrl)
+})
+
+// 或者手动更新地址
+const newStreamUrl = 'https://another-server:port/stream.whep'
+player.updateUrl(newStreamUrl)
 ```
 
 ## 支持的播放地址格式
@@ -124,10 +185,52 @@ WebRTCWhep(conf)
   - `pass`: 认证密码（可选）
   - `token`: 认证令牌（可选）
   - `iceServers`: ICE 服务器配置（可选）
-  - `onError`: 错误回调函数（可选）
+
+#### 事件
+
+```typescript
+// 状态变化事件
+player.on('state:change', ({ from, to }) => {
+  console.log(`状态: ${from} → ${to}`)
+})
+
+// ICE 候选事件
+player.on('candidate', (candidate) => {
+  console.log('ICE 候选:', candidate.candidate)
+})
+
+// 媒体轨道事件
+player.on('track', (evt) => {
+  console.log('媒体轨道:', evt.track.kind)
+})
+
+// 错误事件
+player.on('error', (error) => {
+  console.error('错误:', error.message, error.type)
+})
+
+// 连接关闭事件
+player.on('close', () => {
+  console.log('连接已关闭')
+})
+
+// 重连事件
+player.on('restart', () => {
+  console.log('正在重连...')
+})
+```
+
+**事件类型：**
+- `state:change`: 状态变化，包含 `from` 和 `to` 状态
+- `candidate`: ICE 候选
+- `track`: 媒体轨道
+- `error`: 错误
+- `close`: 连接关闭
+- `restart`: 开始重连
 
 #### 属性
 
+- `state`: 当前状态 (`getting_codecs` | `running` | `restarting` | `closed` | `failed`)
 - `isRunning`: 流是否正在运行
 - `paused`: 播放器是否已暂停
 
@@ -136,6 +239,8 @@ WebRTCWhep(conf)
 - `close()`: 关闭播放器和所有资源
 - `pause()`: 暂停播放
 - `resume()`: 恢复播放
+- `updateUrl(url)`: 更新播放地址并重新开始播放（用于播放失败时切换到新的 URL）
+- `on(event, listener)`: 注册事件监听器
 
 #### 错误类型
 
@@ -170,6 +275,8 @@ src/
 
 - TypeScript
 - WebRTC API
+- eventemitter3 - 事件发射器
+- nanostores - 状态管理
 - 相关构建工具 (Rollup, ESLint)
 
 ## 许可证

package/dist/core/codec.d.ts

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

package/dist/core/connection.d.ts

@@ -1,18 +1,16 @@
+import type EventEmitter from 'eventemitter3';
 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 interface ConnectionManagerOptions {
+    getState: () => State;
+    emitter: EventEmitter;
+    getNonAdvertisedCodecs: () => string[];
 }
 export declare class ConnectionManager {
-    private getState;
-    private callbacks;
-    private nonAdvertisedCodecs;
+    private options;
     private pc?;
     private offerData?;
-    constructor(getState: () => State, callbacks: ConnectionManagerCallbacks, nonAdvertisedCodecs?: string[]);
+    constructor(options: ConnectionManagerOptions);
     setupPeerConnection(iceServers: RTCIceServer[]): Promise<string>;
     setAnswer(answer: string): Promise<void>;
     getPeerConnection(): RTCPeerConnection | undefined;

package/dist/core/http.d.ts

@@ -1,11 +1,14 @@
+import type EventEmitter from 'eventemitter3';
 import type { ParsedOffer } from '../utils/sdp';
 import type { Conf, State } from '~/types';
-import { WebRTCError } from '~/errors';
+export interface HttpClientOptions {
+    conf: Conf;
+    getState: () => State;
+    emitter: EventEmitter;
+}
 export declare class HttpClient {
-    private config;
-    private getState;
-    private onError;
-    constructor(config: Conf, getState: () => State, onError: (err: Error | WebRTCError) => void);
+    private options;
+    constructor(options: HttpClientOptions);
     private authHeader;
     requestICEServers(): Promise<RTCIceServer[]>;
     sendOffer(offer: string): Promise<{

package/dist/errors.d.ts

@@ -8,7 +8,9 @@ export type ErrorType = string;
 export declare const ErrorTypes: {
     SIGNAL_ERROR: string;
     STATE_ERROR: string;
-    NETWORK_ERROR: string;
+    REQUEST_ERROR: string;
+    NOT_FOUND_ERROR: string;
+    CONNECT_ERROR: string;
     MEDIA_ERROR: string;
     OTHER_ERROR: string;
 };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import type { Conf, State } from './types';
+import type { WhepEvents } from './whep';
 import { ErrorTypes, WebRTCError } from './errors';
 import WebRTCWhep from './whep';
-export { Conf, ErrorTypes, State, WebRTCError };
+export { Conf, ErrorTypes, State, WebRTCError, WhepEvents };
 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{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};
+import e from"eventemitter3";import{atom as t}from"nanostores";const s={SIGNAL_ERROR:"SignalError",STATE_ERROR:"StateError",REQUEST_ERROR:"RequestError",NOT_FOUND_ERROR:"NotFoundError",CONNECT_ERROR:"ConnectError",MEDIA_ERROR:"MediaError",OTHER_ERROR:"OtherError"};class n extends Error{constructor(e,t,s){super(t,s),this.type=e}}class r{static async supportsNonAdvertisedCodec(e,t){return new Promise(s=>{const n=new RTCPeerConnection({iceServers:[]}),i="audio";let o="";n.addTransceiver(i,{direction:"recvonly"}),n.createOffer().then(s=>{if(!s.sdp)throw new Error("SDP not present");if(s.sdp.includes(` ${e}`))throw new Error("already present");const a=s.sdp.split(`m=${i}`),c=a.slice(1).map(e=>e.split("\r\n")[0].split(" ").slice(3)).reduce((e,t)=>[...e,...t],[]);o=r.reservePayloadType(c);const h=a[1].split("\r\n");return h[0]+=` ${o}`,h.splice(h.length-1,0,`a=rtpmap:${o} ${e}`),void 0!==t&&h.splice(h.length-1,0,`a=fmtp:${o} ${t}`),a[1]=h.join("\r\n"),s.sdp=a.join(`m=${i}`),n.setLocalDescription(s)}).then(()=>n.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 ${o}\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:${o} ${e}\r\n${void 0!==t?`a=fmtp:${o} ${t}\r\n`:""}`}))).then(()=>s(!0)).catch(()=>s(!1)).finally(()=>n.close())})}static unquoteCredential(e){return JSON.parse(`"${e}"`)}static linkToIceServers(e){return e?e.split(", ").map(e=>{const t=e.match(/^<(.+?)>; rel="ice-server"(; username="(.*?)"; credential="(.*?)"; credential-type="password")?/i);if(!t)throw new n(s.SIGNAL_ERROR,"Invalid ICE server link format");const i={urls:[t[1]]};return t[3]&&(i.username=r.unquoteCredential(t[3]),i.credential=r.unquoteCredential(t[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 i{constructor(e){this.options=e}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=>r.supportsNonAdvertisedCodec(e[0],e[1]).then(t=>!!t&&e[0]))).then(e=>e.filter(e=>!1!==e)).then(e=>{if("getting_codecs"!==this.options.getState())throw new n(s.STATE_ERROR,"closed");this.options.emitter.emit("codecs:detected",e)}).catch(e=>this.options.emitter.emit("error",e))}}class o{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=o.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=o.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=o.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=o.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=o.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=o.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=o.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=o.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=o.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=o.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=o.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]=o.enableStereoOpus(s[e]),t.includes("pcma/8000/2")&&(s[e]=o.enableStereoPcmau(n,s[e])),t.includes("multiopus/48000/6")&&(s[e]=o.enableMultichannelOpus(n,s[e])),t.includes("L16/48000/2")&&(s[e]=o.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 a{constructor(e){this.options=e}async setupPeerConnection(e){if("running"!==this.options.getState())throw new n(s.STATE_ERROR,"closed");const t=new RTCPeerConnection({iceServers:e,sdpSemantics:"unified-plan"});this.pc=t;const r="recvonly";return t.addTransceiver("video",{direction:r}),t.addTransceiver("audio",{direction:r}),t.onicecandidate=e=>this.onLocalCandidate(e),t.onconnectionstatechange=()=>this.onConnectionState(),t.oniceconnectionstatechange=()=>this.onIceConnectionState(),t.ontrack=e=>this.options.emitter.emit("track",e),t.createOffer().then(e=>{if(!e.sdp)throw new n(s.SIGNAL_ERROR,"Failed to create offer SDP");return e.sdp=o.editOffer(e.sdp,this.options.getNonAdvertisedCodecs()),this.offerData=o.parseOffer(e.sdp),t.setLocalDescription(e).then(()=>e.sdp)})}async setAnswer(e){if("running"!==this.options.getState())throw new n(s.STATE_ERROR,"closed");return this.pc.setRemoteDescription(new RTCSessionDescription({type:"answer",sdp:e}))}getPeerConnection(){return this.pc}getOfferData(){return this.offerData}close(){this.pc?.close(),this.pc=void 0,this.offerData=void 0}onLocalCandidate(e){"running"===this.options.getState()&&e.candidate&&this.options.emitter.emit("candidate",e.candidate)}onConnectionState(){"running"===this.options.getState()&&this.pc&&("failed"!==this.pc.connectionState&&"closed"!==this.pc.connectionState||this.options.emitter.emit("error",new n(s.OTHER_ERROR,"peer connection closed")))}onIceConnectionState(){"running"===this.options.getState()&&this.pc&&"failed"===this.pc.iceConnectionState&&this.pc.restartIce()}}class c{constructor(e){this.options=e}authHeader(){if(this.options.conf.user&&""!==this.options.conf.user){return{Authorization:`Basic ${btoa(`${this.options.conf.user}:${this.options.conf.pass}`)}`}}return this.options.conf.token&&""!==this.options.conf.token?{Authorization:`Bearer ${this.options.conf.token}`}:{}}async requestICEServers(){return this.options.conf.iceServers&&this.options.conf.iceServers.length>0?this.options.conf.iceServers:fetch(this.options.conf.url,{method:"OPTIONS",headers:{...this.authHeader()}}).then(e=>r.linkToIceServers(e.headers.get("Link")))}async sendOffer(e){if("running"!==this.options.getState())throw new n(s.STATE_ERROR,"closed");return fetch(this.options.conf.url,{method:"POST",headers:{...this.authHeader(),"Content-Type":"application/sdp"},body:e}).then(e=>{switch(e.status){case 201:break;case 404:case 406:throw new n(s.NOT_FOUND_ERROR,"stream not found");case 400:return e.json().then(e=>{throw new n(s.REQUEST_ERROR,e.error)});default:throw new n(s.REQUEST_ERROR,`bad status code ${e.status}`)}const t=e.headers.get("Location"),r=t?new URL(t,this.options.conf.url).toString():void 0;return e.text().then(e=>({sessionUrl:r,answer:e}))})}sendLocalCandidates(e,t,r){fetch(e,{method:"PATCH",headers:{"Content-Type":"application/trickle-ice-sdpfrag","If-Match":"*"},body:o.generateSdpFragment(t,r)}).then(e=>{switch(e.status){case 204:break;case 404:throw new n(s.NOT_FOUND_ERROR,"stream not found");default:throw new n(s.REQUEST_ERROR,`bad status code ${e.status}`)}}).catch(e=>this.options.emitter.emit("error",e))}}class h{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 p{constructor(e){this.options=e,this.lastBytesReceived=0,this.consecutiveNoProgress=0,this.startTime=0,this.isStable=!1,this.baseInterval=e.interval,this.stableInterval=e.stableInterval||2*e.interval,this.maxNoProgress=e.maxNoProgress||3,this.stabilizationTime=e.stabilizationTime||3e4}setPeerConnection(e){this.pc=e}start(){this.close(),this.startTime=Date.now(),this.isStable=!1,this.consecutiveNoProgress=0,this.scheduleNextCheck()}close(){this.checkTimer&&(clearTimeout(this.checkTimer),this.checkTimer=void 0),this.pc=void 0}scheduleNextCheck(){const e=this.getNextCheckInterval();this.checkTimer=setTimeout(()=>{this.checkFlowState().then(()=>{this.pc&&"connected"===this.pc.connectionState&&this.scheduleNextCheck()})},e)}getNextCheckInterval(){const e=Date.now()-this.startTime;return this.isStable=e>this.stabilizationTime,this.isStable?this.stableInterval:this.baseInterval}async checkFlowState(){if(!this.pc)return;if("connected"!==this.pc.connectionState)return;const e=await this.pc.getStats();let t=0;if(e.forEach(e=>{const s=e;"inbound-rtp"===e.type&&"video"===s.kind&&(t=s.bytesReceived||0)}),t===this.lastBytesReceived){if(this.consecutiveNoProgress++,this.consecutiveNoProgress>=this.maxNoProgress)return this.options.emitter.emit("error",new n(s.CONNECT_ERROR,"data stream interruption")),void(this.consecutiveNoProgress=0)}else this.consecutiveNoProgress=0;this.lastBytesReceived=t}}class l extends e{constructor(e){super(),this.retryPause=2e3,this.stateStore=t("getting_codecs"),this.queuedCandidates=[],this.nonAdvertisedCodecs=[],this.conf=e,this.stateStore.subscribe((e,t)=>{this.emit("state:change",{from:t,to:e})}),this.trackManager=new h(this.conf.container),this.flowCheck=new p({interval:5e3,emitter:this}),this.httpClient=new c({conf:this.conf,getState:()=>this.stateStore.get(),emitter:this}),this.connectionManager=new a({getState:()=>this.stateStore.get(),emitter:this,getNonAdvertisedCodecs:()=>this.nonAdvertisedCodecs}),this.codecDetector=new i({getState:()=>this.stateStore.get(),emitter:this}),this.on("codecs:detected",e=>{this.handleCodecsDetected(e)}),this.on("candidate",e=>this.handleCandidate(e)),this.on("track",e=>{this.trackManager.onTrack(e),this.flowCheck.start()}),this.codecDetector.detect()}get state(){return this.stateStore.get()}get isRunning(){return"running"===this.state}close(){this.stateStore.set("closed"),this.connectionManager.close(),this.trackManager.stop(),this.flowCheck.close(),this.restartTimeout&&clearTimeout(this.restartTimeout),this.emit("close")}cleanupSession(){this.connectionManager.close(),this.flowCheck.close(),this.queuedCandidates=[],this.sessionUrl&&(fetch(this.sessionUrl,{method:"DELETE"}).catch(()=>{}),this.sessionUrl=void 0)}handleError(e){this.flowCheck.close(),"getting_codecs"===this.stateStore.get()||e instanceof n&&[s.SIGNAL_ERROR,s.NOT_FOUND_ERROR,s.REQUEST_ERROR].includes(e.type)?this.stateStore.set("failed"):"running"===this.stateStore.get()&&(this.cleanupSession(),this.stateStore.set("restarting"),this.emit("restart"),this.restartTimeout=setTimeout(()=>{this.restartTimeout=void 0,this.stateStore.set("running"),this.start()},this.retryPause),e.message=`${e.message}, retrying in some seconds`),e instanceof n?this.emit("error",e):this.emit("error",new n(s.OTHER_ERROR,e.message))}handleCodecsDetected(e){this.nonAdvertisedCodecs=e,this.stateStore.set("running"),this.start()}start(){this.httpClient.requestICEServers().then(e=>this.connectionManager.setupPeerConnection(e)).then(e=>{const t=this.connectionManager.getPeerConnection();return t&&this.flowCheck.setPeerConnection(t),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.stateStore.get()&&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()}updateUrl(e){"closed"!==this.stateStore.get()?(this.conf.url=e,this.restartTimeout&&(clearTimeout(this.restartTimeout),this.restartTimeout=void 0),this.cleanupSession(),this.stateStore.set("running"),this.start()):this.emit("error",new n(s.OTHER_ERROR,"Cannot update URL: instance is closed"))}}export{s as ErrorTypes,n as WebRTCError,l as default};

package/dist/types.d.ts

@@ -15,8 +15,21 @@ export interface Conf {
     token?: string;
     /** ice server list */
     iceServers?: RTCIceServer[];
-    /** Called when there's an error */
-    onError?: (err: WebRTCError) => void;
+}
+/**
+ * Event types emitted by WebRTCWhep
+ */
+export interface WhepEvents {
+    'codecs:detected': (codecs: string[]) => void;
+    'state:change': (payload: {
+        from: State;
+        to: State;
+    }) => void;
+    'candidate': (candidate: RTCIceCandidate) => void;
+    'track': (evt: RTCTrackEvent) => void;
+    'error': (err: WebRTCError) => void;
+    'close': () => void;
+    'restart': () => void;
 }
 /**
  * State type for WebRTCWhep.

package/dist/utils/flow-check.d.ts

@@ -1,27 +1,50 @@
-import { WebRTCError } from '~/errors';
-export interface FlowCheckParams {
+import type EventEmitter from 'eventemitter3';
+export interface FlowCheckOptions {
     interval: number;
-    onError: (err: WebRTCError) => void;
+    stableInterval?: number;
+    maxNoProgress?: number;
+    stabilizationTime?: number;
+    emitter: EventEmitter;
 }
 /**
  * Flow checking logic (断流检测)
+ *
+ * 性能优化：自适应轮询机制
+ * - 初始阶段（stabilizationTime）：高频检查（interval）
+ * - 稳定阶段：降低频率（stableInterval，默认为 interval 的 2 倍）
+ * - 使用 setTimeout 而非 setInterval，便于动态调整间隔
+ * - 连续多次（maxNoProgress）无进展才判定断流，避免误判
  */
 export declare class FlowCheck {
-    private checkInterval;
+    private options;
+    private baseInterval;
+    private stableInterval;
+    private maxNoProgress;
+    private stabilizationTime;
     private lastBytesReceived;
     private checkTimer?;
     private pc?;
-    private onError;
-    constructor(params: FlowCheckParams);
+    private consecutiveNoProgress;
+    private startTime;
+    private isStable;
+    constructor(options: FlowCheckOptions);
     setPeerConnection(pc: RTCPeerConnection): void;
     /**
      * 启动断流检测
      */
     start(): void;
     /**
-     * 停止断流检测
+     * 停止断流检测并清理资源
      */
-    stop(): void;
+    close(): void;
+    /**
+     * 调度下一次检查
+     */
+    private scheduleNextCheck;
+    /**
+     * 计算下次检查间隔
+     */
+    private getNextCheckInterval;
     /**
      * 检测流状态（通过接收字节数判断是否断流）
      */

package/dist/whep.d.ts

@@ -1,9 +1,11 @@
-import type { Conf } from './types';
+import type { Conf, State, WhepEvents } from './types';
+import EventEmitter from 'eventemitter3';
+export { type WhepEvents };
 /** WebRTC/WHEP reader. */
-export default class WebRTCWhep {
+export default class WebRTCWhep extends EventEmitter<WhepEvents> {
     private retryPause;
     private conf;
-    private state;
+    private stateStore;
     private restartTimeout?;
     private sessionUrl?;
     private queuedCandidates;
@@ -14,8 +16,10 @@ export default class WebRTCWhep {
     private trackManager;
     private codecDetector;
     constructor(conf: Conf);
+    get state(): State;
     get isRunning(): boolean;
     close(): void;
+    private cleanupSession;
     private handleError;
     private handleCodecsDetected;
     private start;
@@ -24,4 +28,20 @@ export default class WebRTCWhep {
     get paused(): boolean;
     pause(): void;
     resume(): void;
+    /**
+     * Update the WHEP endpoint URL and restart playback.
+     * Useful when the current URL fails and you need to switch to a new URL.
+     *
+     * @param url - The new WHEP endpoint URL
+     *
+     * @example
+     * ```ts
+     * player.on('error', () => {
+     *   // Get new URL from your server
+     *   const newUrl = await getNewStreamUrl()
+     *   player.updateUrl(newUrl)
+     * })
+     * ```
+     */
+    updateUrl(url: string): void;
 }

package/eslint.config.ts

@@ -2,10 +2,12 @@ import antfu from '@antfu/eslint-config'
 
 export default antfu(
   {
+    type: 'lib',
     formatters: true,
     pnpm: true,
-  },
-  {
+    ignores: [
+      '**/*.md',
+    ],
     rules: {
       'n/prefer-global/process': ['error', 'always'],
     },

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "whepts",
   "type": "module",
-  "version": "1.0.3",
+  "version": "1.1.0",
+  "packageManager": "pnpm@10.28.2",
   "description": "基于 mediamtx 的 WebRTC WHEP 播放器，支持 ZLM 和 Mediamtx 的播放地址",
   "author": "mapleafgo",
   "license": "MIT",
@@ -25,24 +26,28 @@
   ],
   "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"
+  },
+  "dependencies": {
+    "eventemitter3": "^5.0.4",
+    "nanostores": "^1.1.0"
+  },
   "devDependencies": {
     "@antfu/eslint-config": "^6.7.3",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-eslint": "^9.2.0",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.0.10",
     "eslint": "^9.39.2",
-    "eslint-plugin-format": "^1.1.0",
-    "rollup": "^4.54.0",
+    "eslint-plugin-format": "^1.3.1",
+    "rollup": "^4.56.0",
     "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/rollup.config.ts

@@ -15,7 +15,10 @@ export default {
       sourcemap: !isProduction,
     },
   ],
-  external: [],
+  external: [
+    'eventemitter3',
+    'nanostores',
+  ],
   plugins: [
     del({ targets: 'dist' }),
     commonjs(),

package/.claude/settings.local.json

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

package/.vscode/settings.json

@@ -1,38 +0,0 @@
-{
-  // Disable the default formatter
-  "prettier.enable": false,
-  "editor.formatOnSave": false,
-
-  // Auto fix
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit",
-    "source.organizeImports": "never"
-  },
-
-  // Silent the stylistic rules in you IDE, but still auto fix them
-  "eslint.rules.customizations": [
-    { "rule": "style/*", "severity": "off" },
-    { "rule": "*-indent", "severity": "off" },
-    { "rule": "*-spacing", "severity": "off" },
-    { "rule": "*-spaces", "severity": "off" },
-    { "rule": "*-order", "severity": "off" },
-    { "rule": "*-dangle", "severity": "off" },
-    { "rule": "*-newline", "severity": "off" },
-    { "rule": "*quotes", "severity": "off" },
-    { "rule": "*semi", "severity": "off" }
-  ],
-
-  // The following is optional.
-  // It's better to put under project setting `.vscode/settings.json`
-  // to avoid conflicts with working with different eslint configs
-  // that does not support all formats.
-  "eslint.validate": [
-    "javascript",
-    "typescript",
-    "html",
-    "markdown",
-    "json",
-    "jsonc",
-    "yaml"
-  ]
-}