whepts 1.0.1 → 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/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 错误类型
+ */
+export type ErrorType = string;
+/**
+ * 错误类型常量
+ */
+export declare const ErrorTypes: {
+    SIGNAL_ERROR: string;
+    STATE_ERROR: string;
+    NETWORK_ERROR: string;
+    MEDIA_ERROR: string;
+    OTHER_ERROR: string;
+};
+/**
+ * 错误
+ */
+export declare class WebRTCError extends Error {
+    type: ErrorType;
+    constructor(type: ErrorType, message: string, options?: ErrorOptions);
+}

package/dist/index.d.ts

@@ -1,196 +1,5 @@
-/**
- * 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';
-    }
-}
-/**
- * 错误类型
- */
-export type ErrorType = string;
-/**
- * 错误类型常量
- */
-export declare const ErrorTypes: {
-    SIGNAL_ERROR: string;
-    STATE_ERROR: string;
-    NETWORK_ERROR: string;
-    MEDIA_ERROR: string;
-    OTHER_ERROR: string;
-};
-/**
- * 错误
- */
-export declare class WebRTCError extends Error {
-    type: ErrorType;
-    constructor(type: ErrorType, message: string, options?: ErrorOptions);
-}
-/** 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 container;
-    private observer;
-    private stream?;
-    /**
-     * 断连重试参数
-     */
-    private checkInterval;
-    private lastBytesReceived;
-    private checkTimer?;
-    /**
-     * Create a WebRTCWhep.
-     * @param {Conf} conf - Configuration.
-     */
-    constructor(conf: Conf);
-    /**
-     * 媒体是否正常
-     */
-    get isRunning(): boolean;
-    /**
-     * Close the reader and all its resources.
-     */
-    close(): void;
-    /**
-     * Check if the browser supports a non-advertised codec.
-     */
-    private static supportsNonAdvertisedCodec;
-    /**
-     * Unquote a credential string.
-     */
-    private static unquoteCredential;
-    /**
-     * Convert Link header to iceServers array.
-     */
-    private static linkToIceServers;
-    /**
-     * Parse an offer SDP into iceUfrag, icePwd, and medias.
-     */
-    private static parseOffer;
-    /**
-     * Reserve a payload type.
-     */
-    private static reservePayloadType;
-    /**
-     * Enable stereo PCMA/PCMU codecs.
-     */
-    private static enableStereoPcmau;
-    /**
-     * Enable multichannel Opus codec.
-     */
-    private static enableMultichannelOpus;
-    /**
-     * Enable L16 codec.
-     */
-    private static enableL16;
-    /**
-     * Enable stereo Opus codec.
-     */
-    private static enableStereoOpus;
-    /**
-     * Edit an offer SDP to enable non-advertised codecs.
-     */
-    private static editOffer;
-    /**
-     * Generate an SDP fragment.
-     */
-    private static generateSdpFragment;
-    /**
-     * Handle errors.
-     */
-    private handleError;
-    /**
-     * Get non-advertised codecs.
-     */
-    private getNonAdvertisedCodecs;
-    /**
-     * Start the WebRTC session.
-     */
-    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;
-    /**
-     * 启动断流检测
-     */
-    private startFlowCheck;
-    /**
-     * 停止断流检测
-     */
-    private stopFlowCheck;
-    private checkFlowState;
-    /**
-     * Handle incoming tracks.
-     */
-    private onTrack;
-    /**
-     * 流是否为空
-     */
-    get paused(): boolean;
-    /**
-     * 暂停播放
-     */
-    pause(): void;
-    /**
-     * 恢复播放
-     */
-    resume(): void;
-}
+import type { Conf, State } from './types';
+import { ErrorTypes, WebRTCError } from './errors';
+import WebRTCWhep from './whep';
+export { Conf, ErrorTypes, State, WebRTCError };
+export default WebRTCWhep;

package/dist/index.js

@@ -1 +1 @@
-class e{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)}}const t={SIGNAL_ERROR:"SignalError",STATE_ERROR:"StateError",NETWORK_ERROR:"NetworkError",MEDIA_ERROR:"MediaError",OTHER_ERROR:"OtherError"};class s extends Error{constructor(e,t,s){super(t,s),this.type=e}}class r{constructor(t){this.retryPause=2e3,this.queuedCandidates=[],this.nonAdvertisedCodecs=[],this.checkInterval=5e3,this.lastBytesReceived=0,this.conf=t,this.state="getting_codecs",this.container=t.container,this.observer=new e,this.getNonAdvertisedCodecs()}get isRunning(){return"running"===this.state}close(){this.state="closed",this.pc?.close(),this.observer.stop(),this.stopFlowCheck(),this.restartTimeout&&clearTimeout(this.restartTimeout)}static async supportsNonAdvertisedCodec(e,n){return new Promise(i=>{const a=new RTCPeerConnection({iceServers:[]}),c="audio";let o="";a.addTransceiver(c,{direction:"recvonly"}),a.createOffer().then(i=>{if(!i.sdp)throw new s(t.SIGNAL_ERROR,"SDP not present");if(i.sdp.includes(` ${e}`))throw new s(t.SIGNAL_ERROR,"already present");const h=i.sdp.split(`m=${c}`),p=h.slice(1).map(e=>e.split("\r\n")[0].split(" ").slice(3)).reduce((e,t)=>[...e,...t],[]);o=r.reservePayloadType(p);const l=h[1].split("\r\n");return l[0]+=` ${o}`,l.splice(l.length-1,0,`a=rtpmap:${o} ${e}`),void 0!==n&&l.splice(l.length-1,0,`a=fmtp:${o} ${n}`),h[1]=l.join("\r\n"),i.sdp=h.join(`m=${c}`),a.setLocalDescription(i)}).then(()=>a.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=${c} 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!==n?`a=fmtp:${o} ${n}\r\n`:""}`}))).then(()=>i(!0)).catch(()=>i(!1)).finally(()=>a.close())})}static unquoteCredential(e){return JSON.parse(`"${e}"`)}static linkToIceServers(e){return e?e.split(", ").map(e=>{const n=e.match(/^<(.+?)>; rel="ice-server"(; username="(.*?)"; credential="(.*?)"; credential-type="password")?/i);if(!n)throw new s(t.SIGNAL_ERROR,"Invalid ICE server link format");const i={urls:[n[1]]};return n[3]&&(i.username=r.unquoteCredential(n[3]),i.credential=r.unquoteCredential(n[4]),i.credentialType="password"),i}):[]}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 s(t.SIGNAL_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 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}handleError(e){this.stopFlowCheck(),"getting_codecs"===this.state||e instanceof s&&e.type===t.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),e.message=`${e.message}, retrying in some seconds`),this.conf.onError&&(e instanceof s?this.conf.onError(e):this.conf.onError(new s(t.OTHER_ERROR,e.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=>r.supportsNonAdvertisedCodec(e[0],e[1]).then(t=>!!t&&e[0]))).then(e=>e.filter(e=>!1!==e)).then(e=>{if("getting_codecs"!==this.state)throw new s(t.STATE_ERROR,"closed");this.nonAdvertisedCodecs=e,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=>r.linkToIceServers(e.headers.get("Link")))}async setupPeerConnection(e){if("running"!==this.state)throw new s(t.STATE_ERROR,"closed");const n=new RTCPeerConnection({iceServers:e,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.ontrack=e=>this.onTrack(e),n.createOffer().then(e=>{if(!e.sdp)throw new s(t.SIGNAL_ERROR,"Failed to create offer SDP");return e.sdp=r.editOffer(e.sdp,this.nonAdvertisedCodecs),this.offerData=r.parseOffer(e.sdp),n.setLocalDescription(e).then(()=>e.sdp)})}sendOffer(e){if("running"!==this.state)throw new s(t.STATE_ERROR,"closed");return fetch(this.conf.url,{method:"POST",headers:{...this.authHeader(),"Content-Type":"application/sdp"},body:e}).then(e=>{switch(e.status){case 201:break;case 404:throw new s(t.NETWORK_ERROR,"stream not found");case 406:throw new s(t.NETWORK_ERROR,"stream not supported");case 400:return e.json().then(e=>{throw new s(t.NETWORK_ERROR,e.error)});default:throw new s(t.NETWORK_ERROR,`bad status code ${e.status}`)}const r=e.headers.get("Location");return r&&(this.sessionUrl=new URL(r,this.conf.url).toString()),e.text()})}setAnswer(e){if("running"!==this.state)throw new s(t.STATE_ERROR,"closed");return this.pc.setRemoteDescription(new RTCSessionDescription({type:"answer",sdp:e})).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(e){this.sessionUrl&&this.offerData&&fetch(this.sessionUrl,{method:"PATCH",headers:{"Content-Type":"application/trickle-ice-sdpfrag","If-Match":"*"},body:r.generateSdpFragment(this.offerData,e)}).then(e=>{switch(e.status){case 204:break;case 404:throw new s(t.NETWORK_ERROR,"stream not found");default:throw new s(t.NETWORK_ERROR,`bad status code ${e.status}`)}}).catch(e=>this.handleError(e))}onConnectionState(){"running"===this.state&&this.pc&&("failed"===this.pc.connectionState||"closed"===this.pc.connectionState?this.handleError(new s(t.OTHER_ERROR,"peer connection closed")):"connected"===this.pc.connectionState&&this.startFlowCheck())}startFlowCheck(){this.stopFlowCheck(),this.checkTimer=setInterval(()=>this.checkFlowState(),this.checkInterval)}stopFlowCheck(){this.checkTimer&&(clearInterval(this.checkTimer),this.checkTimer=void 0)}async checkFlowState(){if(!this.pc)return;const e=await this.pc.getStats();let r=0;e.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.handleError(new s(t.NETWORK_ERROR,"data stream interruption"))}onTrack(e){this.stream=e.streams[0],this.observer.start(this.container,e=>{e?this.resume():this.pause()})}get paused(){return null===this.container.srcObject}pause(){this.container.srcObject=null}resume(){this.stream&&this.paused&&(this.container.srcObject=this.stream)}}export{t as ErrorTypes,s as WebRTCError,r 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/utils/flow-check.d.ts

@@ -0,0 +1,29 @@
+import { WebRTCError } from '~/errors';
+export interface FlowCheckParams {
+    interval: number;
+    onError: (err: WebRTCError) => void;
+}
+/**
+ * Flow checking logic (断流检测)
+ */
+export declare class FlowCheck {
+    private checkInterval;
+    private lastBytesReceived;
+    private checkTimer?;
+    private pc?;
+    private onError;
+    constructor(params: FlowCheckParams);
+    setPeerConnection(pc: RTCPeerConnection): void;
+    /**
+     * 启动断流检测
+     */
+    start(): void;
+    /**
+     * 停止断流检测
+     */
+    stop(): void;
+    /**
+     * 检测流状态（通过接收字节数判断是否断流）
+     */
+    private checkFlowState;
+}

package/dist/utils/sdp.d.ts

@@ -0,0 +1,43 @@
+/** Type for parsed offer data */
+export interface ParsedOffer {
+    iceUfrag: string;
+    icePwd: string;
+    medias: string[];
+}
+/**
+ * SDP processing utilities
+ */
+export declare class SdpUtils {
+    /**
+     * Parse an offer SDP into iceUfrag, icePwd, and medias.
+     */
+    static parseOffer(sdp: string): ParsedOffer;
+    /**
+     * Reserve a payload type.
+     */
+    static reservePayloadType(payloadTypes: string[]): string;
+    /**
+     * Enable stereo PCMA/PCMU codecs.
+     */
+    static enableStereoPcmau(payloadTypes: string[], section: string): string;
+    /**
+     * Enable multichannel Opus codec.
+     */
+    static enableMultichannelOpus(payloadTypes: string[], section: string): string;
+    /**
+     * Enable L16 codec.
+     */
+    static enableL16(payloadTypes: string[], section: string): string;
+    /**
+     * Enable stereo Opus codec.
+     */
+    static enableStereoOpus(section: string): string;
+    /**
+     * Edit an offer SDP to enable non-advertised codecs.
+     */
+    static editOffer(sdp: string, nonAdvertisedCodecs: string[]): string;
+    /**
+     * Generate an SDP fragment.
+     */
+    static generateSdpFragment(od: ParsedOffer, candidates: RTCIceCandidate[]): string;
+}

package/dist/utils/webrtc.d.ts

@@ -0,0 +1,21 @@
+/**
+ * WebRTC utilities
+ */
+export declare class WebRtcUtils {
+    /**
+     * Check if the browser supports a non-advertised codec.
+     */
+    static supportsNonAdvertisedCodec(codec: string, fmtp?: string): Promise<boolean>;
+    /**
+     * Unquote a credential string.
+     */
+    static unquoteCredential(v: string): string;
+    /**
+     * Convert Link header to iceServers array.
+     */
+    static linkToIceServers(links: string | null): RTCIceServer[];
+    /**
+     * Reserve a payload type.
+     */
+    static reservePayloadType(payloadTypes: string[]): string;
+}

package/dist/whep.d.ts

@@ -0,0 +1,27 @@
+import type { Conf } from './types';
+/** WebRTC/WHEP reader. */
+export default class WebRTCWhep {
+    private retryPause;
+    private conf;
+    private state;
+    private restartTimeout?;
+    private sessionUrl?;
+    private queuedCandidates;
+    private nonAdvertisedCodecs;
+    private flowCheck;
+    private httpClient;
+    private connectionManager;
+    private trackManager;
+    private codecDetector;
+    constructor(conf: Conf);
+    get isRunning(): boolean;
+    close(): void;
+    private handleError;
+    private handleCodecsDetected;
+    private start;
+    private handleOfferResponse;
+    private handleCandidate;
+    get paused(): boolean;
+    pause(): void;
+    resume(): void;
+}

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "whepts",
   "type": "module",
-  "version": "1.0.1",
-  "packageManager": "pnpm@10.26.2",
-  "description": "",
+  "version": "1.0.3",
+  "description": "基于 mediamtx 的 WebRTC WHEP 播放器，支持 ZLM 和 Mediamtx 的播放地址",
   "author": "mapleafgo",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/mapleafgo/whepts.git"
+  },
   "keywords": [
     "webrtc",
     "whep",
@@ -22,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",
@@ -41,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"
   }
-}
+}