Skip to content

armgit / Piik

Public Imported from GitHub
0

Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

36.6 KB
Raw Blame
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { QUALITY_PROFILES } from "../src/client/media/quality.ts";
import { SfuPublisher } from "../src/client/sfu/publisher.ts";
import { SfuSubscriber } from "../src/client/sfu/subscriber.ts";
import { ViewerSfuRoute } from "../src/client/media/viewer-sfu-route.ts";
import * as senderTracks from "../src/client/media/sender-video-track";
import {
  clientMessageSchema,
  type ClientMessage,
  type SfuSignalMessage,
} from "../src/shared/protocol.ts";

class FakeTrack extends EventTarget {
  readonly id = crypto.randomUUID();
  enabled = true;
  contentHint = "";
  readyState = "live";
  readonly clones: FakeTrack[] = [];
  readonly stop = vi.fn(() => {
    this.readyState = "ended";
  });
  readonly getSettings = vi.fn(() => ({
    width: 1920,
    height: 1080,
    frameRate: 30,
  }));
  readonly applyConstraints = vi.fn(
    async (_constraints: MediaTrackConstraints) => undefined,
  );
  getConstraints() { return {}; }
  readonly clone = vi.fn(() => {
    const next = new FakeTrack(this.kind);
    this.clones.push(next);
    return next;
  });
  constructor(readonly kind: "audio" | "video") {
    super();
  }
}

class FakeStream {
  constructor(private tracks: FakeTrack[] = []) {}
  getTracks(): FakeTrack[] {
    return [...this.tracks];
  }
  getVideoTracks(): FakeTrack[] {
    return this.tracks.filter((track) => track.kind === "video");
  }
  getAudioTracks(): FakeTrack[] {
    return this.tracks.filter((track) => track.kind === "audio");
  }
  addTrack(track: FakeTrack): void {
    this.tracks.push(track);
  }
  removeTrack(track: FakeTrack): void {
    this.tracks = this.tracks.filter((current) => current !== track);
  }
}

class FakeSender {
  readonly getParameters = vi.fn(() => structuredClone(this.parameters));
  readonly setParameters = vi.fn(async (parameters: RTCRtpSendParameters) => {
    this.parameters = structuredClone(parameters);
  });
  readonly replaceTrack = vi.fn(async (track: FakeTrack | null) => {
    this.track = track;
  });
  readonly getStats = vi.fn(async () => new Map());
  parameters: RTCRtpSendParameters;
  constructor(
    public track: FakeTrack | null,
    encodings: RTCRtpEncodingParameters[],
  ) {
    this.parameters = {
      encodings,
      codecs: [],
      headerExtensions: [],
      rtcp: {},
      transactionId: "test",
    };
  }
  static getCapabilities(kind: string) {
    return {
      codecs:
        kind === "audio"
          ? [{ mimeType: "audio/opus", clockRate: 48000, channels: 2 }]
          : [
              { mimeType: "video/VP8", clockRate: 90000 },
              {
                mimeType: "video/H264",
                clockRate: 90000,
                sdpFmtpLine: "packetization-mode=1;profile-level-id=42e01f",
              },
              { mimeType: "video/VP9", clockRate: 90000 },
            ],
    };
  }
}

class FakePc extends EventTarget {
  static instances: FakePc[] = [];
  onicecandidate: ((event: { candidate: unknown }) => void) | null = null;
  onconnectionstatechange: (() => void) | null = null;
  ontrack: ((event: unknown) => void) | null = null;
  connectionState: RTCPeerConnectionState = "new";
  signalingState: RTCSignalingState = "stable";
  localDescription: RTCSessionDescriptionInit | null = null;
  remoteDescription: RTCSessionDescriptionInit | null = null;
  readonly transceivers: Array<{
    sender: FakeSender;
    setCodecPreferences: ReturnType<typeof vi.fn>;
  }> = [];
  report = new Map();
  readonly getStats = vi.fn(async () => this.report);
  readonly close = vi.fn(() => {
    this.connectionState = "closed";
  });
  readonly createOffer = vi.fn(async (_options?: RTCOfferOptions) => ({
    type: "offer" as const,
    sdp: "offer",
  }));
  readonly createAnswer = vi.fn(async () => ({
    type: "answer" as const,
    sdp: "answer",
  }));
  readonly setLocalDescription = vi.fn(
    async (description: RTCSessionDescriptionInit) => {
      this.localDescription = description;
      this.signalingState =
        description.type === "offer" ? "have-local-offer" : "stable";
      this.onicecandidate?.({
        candidate: {
          protocol: "udp",
          candidate: "candidate:1 1 UDP 1 127.0.0.1 4000 typ host",
          toJSON: () => ({
            candidate: "candidate:1 1 UDP 1 127.0.0.1 4000 typ host",
          }),
        },
      });
    },
  );
  readonly setRemoteDescription = vi.fn(
    async (description: RTCSessionDescriptionInit) => {
      this.remoteDescription = description;
      this.signalingState =
        description.type === "offer" ? "have-remote-offer" : "stable";
    },
  );
  readonly addIceCandidate = vi.fn(
    async (_candidate: RTCIceCandidateInit) => undefined,
  );
  constructor(readonly configuration: RTCConfiguration) {
    super();
    FakePc.instances.push(this);
  }
  addTransceiver(track: FakeTrack | string, options: RTCRtpTransceiverInit) {
    const transceiver = {
      sender: new FakeSender(
        typeof track === "string" ? null : track,
        options.sendEncodings ?? [{}],
      ),
      setCodecPreferences: vi.fn(),
    };
    this.transceivers.push(transceiver);
    return transceiver;
  }
  state(state: RTCPeerConnectionState): void {
    this.connectionState = state;
    this.onconnectionstatechange?.();
    this.dispatchEvent(new Event("connectionstatechange"));
  }
}

const config = {
  revision: 4,
  publicationGeneration: "publication_12345678",
  connectionId: "connection_12345678",
};
const signal = (payload: Partial<SfuSignalMessage>): SfuSignalMessage => ({
  type: "sfu-signal",
  ...config,
  kind: "description",
  ...payload,
});
const cleanups: Array<() => Promise<void>> = [];
const stream = (...tracks: FakeTrack[]): MediaStream =>
  new FakeStream(tracks) as unknown as MediaStream;

beforeEach(() => {
  vi.useFakeTimers();
  FakePc.instances = [];
  vi.stubGlobal("MediaStream", FakeStream);
  vi.stubGlobal("RTCPeerConnection", FakePc);
  vi.stubGlobal("RTCRtpSender", FakeSender);
});
afterEach(async () => {
  for (const cleanup of cleanups.splice(0)) await cleanup();
  vi.useRealTimers();
  vi.restoreAllMocks();
  vi.unstubAllGlobals();
});

async function publisher(audio = true) {
  const send = vi.fn((_message: SfuSignalMessage) => true);
  const onDisconnected = vi.fn();
  const video = new FakeTrack("video");
  const sound = new FakeTrack("audio");
  const publisher = new SfuPublisher({ send, onDisconnected });
  cleanups.push(() => publisher.disconnect());
  await publisher.connect(config);
  await publisher.activate(
    stream(video, ...(audio ? [sound] : [])),
    QUALITY_PROFILES["1080p30"],
    "h264",
  );
  return {
    publisher,
    send,
    onDisconnected,
    video,
    sound,
    pc: FakePc.instances[0]!,
  };
}

function feedVideoStats(
  pc: FakePc,
  trackId: string,
  framesEncoded: number,
): void {
  pc.report.clear();
  pc.report.set("outbound-video", {
    id: "outbound-video",
    type: "outbound-rtp",
    kind: "video",
    timestamp: 1_000,
    ssrc: 10,
    framesEncoded,
    mediaSourceId: "media-source-video",
  });
  pc.report.set("media-source-video", {
    id: "media-source-video",
    type: "media-source",
    kind: "video",
    timestamp: 1_000,
    trackIdentifier: trackId,
  });
}

describe("embedded SFU browser transport", () => {
  it.each([100_000, 200_000, 50_000_000])("keeps every simulcast output within the %i bps source ceiling", async (maxBitrate) => {
    const send = vi.fn(() => true);
    const host = new SfuPublisher({ send, onDisconnected: vi.fn() });
    cleanups.push(() => host.disconnect());
    await host.connect(config);
    expect(await host.activate(stream(new FakeTrack("video")),
      { ...QUALITY_PROFILES["1080p30"], maxBitrate, maxFramerate: 5 }, "h264")).toBe(true);
    const encodings = FakePc.instances[0]!.transceivers[0]!.sender.getParameters().encodings;
    expect(encodings).toHaveLength(2);
    expect(encodings[1]!.maxBitrate).toBe(maxBitrate);
    for (const encoding of encodings) {
      expect(encoding.maxBitrate).toBeGreaterThan(0);
      expect(encoding.maxBitrate).toBeLessThanOrEqual(maxBitrate);
      expect(encoding.maxFramerate).toBe(5);
    }
  });

  it("uses capture dimensions for simulcast before a generated sender has its first frame", async () => {
    class Generator extends FakeTrack {
      writable = new WritableStream<VideoFrame>();
      constructor() { super("video"); this.getSettings.mockReturnValue({} as never); }
    }
    let frames!: ReadableStreamDefaultController<VideoFrame>;
    vi.stubGlobal("MediaStreamTrackGenerator", Generator);
    vi.stubGlobal("MediaStreamTrackProcessor", class {
      readable = new ReadableStream<VideoFrame>({ start(controller) { frames = controller; } });
    });
    const video = new FakeTrack("video"), send = vi.fn(() => true), onDisconnected = vi.fn();
    video.getSettings.mockReturnValue({ ...video.getSettings(), displaySurface: "browser" } as never);
    const host = new SfuPublisher({ send, onDisconnected });
    cleanups.push(() => host.disconnect());
    await host.connect(config);
    expect(await host.activate(stream(video), QUALITY_PROFILES["1080p30"], "h264")).toBe(true);
    const sender = FakePc.instances[0]!.transceivers[0]!.sender;
    expect(sender.track!.getSettings()).toEqual({});
    expect(sender.parameters.encodings.map(e => e.scaleResolutionDownBy)).toEqual([2, 1]);
    expect(send).toHaveBeenCalledWith(expect.objectContaining({ media: expect.objectContaining({ layers: [
      expect.objectContaining({ width: 960, height: 540 }), expect.objectContaining({ width: 1920, height: 1080 }),
    ] }) }));
    frames.error(new Error("display frame input failed"));
    for (let i = 0; i < 30; i++) await Promise.resolve();
    expect(onDisconnected).toHaveBeenCalledOnce();
    expect(video.stop).not.toHaveBeenCalled();
    expect(video.clones[0]!.readyState).toBe("ended");
  });

  it.each(["current", "replaced", "pending", "configuring"])("handles a %s frame input ending without affecting the source", async (phase) => {
    const endings: Array<{ track: FakeTrack; end: () => void }> = [];
    vi.spyOn(senderTracks, "cloneSenderVideoTrack").mockImplementation((source, onEnded) => {
      const track = source.clone() as unknown as FakeTrack;
      endings.push({ track, end() { track.stop(); onEnded(track as unknown as MediaStreamTrack); } });
      return track as unknown as MediaStreamTrack;
    });
    const { publisher: host, pc, onDisconnected, video } = await publisher();
    if (phase === "current") endings[0]!.end();
    else {
      const next = new FakeTrack("video");
      if (phase === "pending") pc.transceivers[1]!.sender.replaceTrack.mockImplementationOnce(async () => endings[1]!.end());
      if (phase === "configuring") pc.transceivers[0]!.sender.setParameters.mockImplementationOnce(async () => endings[1]!.end());
      expect(await host.replaceStream(stream(next))).toBe(phase === "replaced");
      if (phase === "replaced") endings[0]!.end();
      expect(pc.transceivers[0]!.sender.track).toBe(endings[phase === "replaced" ? 1 : 0]!.track);
      expect(next.stop).not.toHaveBeenCalled();
    }
    expect(onDisconnected).toHaveBeenCalledTimes(phase === "current" ? 1 : 0);
    expect(video.stop).not.toHaveBeenCalled();
  });

  it.each(["queued", "active"])("preserves publication after a %s candidate rejection", async (phase) => {
    const { publisher: host, pc, onDisconnected, video } = await publisher();
    const rejected = signal({ kind: "candidate", candidate: { candidate: "candidate:1 1 UDP 1 127.0.0.1 4100 typ host" } });
    const valid = signal({ kind: "candidate", candidate: { candidate: "candidate:2 1 UDP 1 127.0.0.1 4101 typ host" } });
    pc.addIceCandidate.mockRejectedValueOnce(new DOMException("Rejected candidate", "OperationError"));
    if (phase === "queued") {
      await host.acceptSignal(rejected);
      await host.acceptSignal(valid);
    }
    await host.acceptSignal(signal({ description: { type: "answer", sdp: "answer" } }));
    pc.state("connected");
    if (phase === "active") {
      await host.acceptSignal(rejected);
      await host.acceptSignal(valid);
    }
    expect(pc.addIceCandidate).toHaveBeenCalledWith(valid.candidate);
    expect(onDisconnected).not.toHaveBeenCalled();
    expect(pc.close).not.toHaveBeenCalled();
    expect(video.clones[0]!.readyState).toBe("live");
  });

  it("publishes one bounded simulcast PC, offers before ICE and admits only the selected codec", async () => {
    const { publisher: host, pc, send, video } = await publisher();
    expect(pc.configuration).toEqual({ iceServers: [] });
    expect(pc.transceivers).toHaveLength(2);
    expect(pc.transceivers[0]!.sender.track).toBe(video.clones[0]);
    const offer = send.mock.calls[0]![0];
    expect(offer.kind).toBe("description");
    expect(offer.media).toEqual({
      codec: "h264",
      layers: [
        { rid: "q", width: 960, height: 540, bitrate: 1_250_000 },
        { rid: "h", width: 1920, height: 1080, bitrate: 5_000_000 },
      ],
      audio: true,
      audioBitrate: 128_000,
    });
    expect(send.mock.calls[1]![0].kind).toBe("candidate");
    expect(clientMessageSchema.safeParse(offer).success).toBe(true);
    expect(pc.transceivers[0]!.setCodecPreferences.mock.calls[0]![0]).toEqual([
      expect.objectContaining({ mimeType: "video/H264" }),
    ]);
    await host.acceptSignal(
      signal({ description: { type: "answer", sdp: "answer" } }),
    );
    expect(pc.remoteDescription?.type).toBe("answer");
  });

  it("queues remote ICE and rejects retired connection/publication identities", async () => {
    const { publisher: host, pc } = await publisher();
    const candidate = {
      candidate: "candidate:1 1 UDP 1 127.0.0.1 4100 typ host",
    };
    await host.acceptSignal(signal({ kind: "candidate", candidate }));
    expect(pc.addIceCandidate).not.toHaveBeenCalled();
    await host.acceptSignal(
      signal({
        connectionId: "retired_12345678",
        description: { type: "answer", sdp: "stale" },
      }),
    );
    await host.acceptSignal(
      signal({
        publicationGeneration: "retired_12345678",
        description: { type: "answer", sdp: "stale" },
      }),
    );
    expect(pc.setRemoteDescription).not.toHaveBeenCalled();
    await host.acceptSignal(
      signal({ description: { type: "answer", sdp: "answer" } }),
    );
    expect(pc.addIceCandidate).toHaveBeenCalledWith(candidate);
  });

  it("updates all existing encodings and audio without changing the PC or codec", async () => {
    const { publisher: host, pc, send } = await publisher();
    const profile = {
      ...QUALITY_PROFILES["720p30"],
      maxAudioBitrate: 192000 as const,
    };
    expect(await host.updateProfile(profile)).toBe(true);
    expect(pc.transceivers[0]!.sender.parameters.encodings).toEqual([
      expect.objectContaining({
        rid: "q",
        maxBitrate: 750_000,
        scaleResolutionDownBy: 3,
      }),
      expect.objectContaining({
        rid: "h",
        maxBitrate: 3_000_000,
        scaleResolutionDownBy: 1.5,
      }),
    ]);
    expect(pc.transceivers[1]!.sender.parameters.encodings[0]!.maxBitrate).toBe(192_000);
    expect(send.mock.calls.at(-1)![0]).toMatchObject({
      kind: "media",
      media: { codec: "h264", audioBitrate: 192_000 },
    });
    expect(FakePc.instances).toHaveLength(1);
    expect(pc.createOffer).toHaveBeenCalledOnce();
  });

  it.each([false, true])("keeps established SFU video through audio-only addition and removal (initial audio=%s)", async (audio) => {
    const { publisher: host, pc, video, send } = await publisher(audio);
    const sender = pc.transceivers[0]!.sender;
    const ownedVideo = video.clones[0]!;
    feedVideoStats(pc, ownedVideo.id, 6);
    await vi.advanceTimersByTimeAsync(2_000);
    expect(sender.parameters.degradationPreference).toBe("balanced");
    const parameters = sender.setParameters.mock.calls.length;
    const constraints = ownedVideo.applyConstraints.mock.calls.length;
    const voice = new FakeTrack("audio");
    for (const tracks of [[voice], []]) {
      expect(await host.replaceStream(stream(video, ...tracks))).toBe(true);
      expect(sender.track).toBe(ownedVideo);
      expect(sender.replaceTrack).not.toHaveBeenCalled();
      expect(sender.setParameters).toHaveBeenCalledTimes(parameters);
      expect(ownedVideo.applyConstraints).toHaveBeenCalledTimes(constraints);
      expect(ownedVideo.stop).not.toHaveBeenCalled();
      expect(sender.parameters.degradationPreference).toBe("balanced");
      expect(send).toHaveBeenLastCalledWith(expect.objectContaining({ kind: "media", media: expect.objectContaining({ audio: tracks.length > 0 }) }));
    }
    expect(video.clones).toHaveLength(1);
    expect(pc.createOffer).toHaveBeenCalledOnce();
    expect(voice.clones[0]!.stop).toHaveBeenCalledOnce();
    await host.disconnect();
    expect(ownedVideo.stop).toHaveBeenCalledOnce();
    expect(video.stop).not.toHaveBeenCalled();
  });

  it("rolls back a rejected audio-only update without mutating the video", async () => {
    const { publisher: host, pc, video, sound, send } = await publisher();
    const videoSender = pc.transceivers[0]!.sender;
    const audioSender = pc.transceivers[1]!.sender;
    const ownedVideo = video.clones[0]!;
    const previousAudio = sound.clones[0]!;
    feedVideoStats(pc, ownedVideo.id, 6);
    await vi.advanceTimersByTimeAsync(2_000);
    const parameters = videoSender.setParameters.mock.calls.length;
    const voice = new FakeTrack("audio");
    send.mockReturnValueOnce(false);
    expect(await host.replaceStream(stream(video, voice))).toBe(false);
    expect(videoSender.track).toBe(ownedVideo);
    expect(videoSender.replaceTrack).not.toHaveBeenCalled();
    expect(videoSender.setParameters).toHaveBeenCalledTimes(parameters);
    expect(ownedVideo.stop).not.toHaveBeenCalled();
    expect(audioSender.track).toBe(previousAudio);
    expect(previousAudio.stop).not.toHaveBeenCalled();
    expect(voice.clones[0]!.stop).toHaveBeenCalledOnce();
    expect(videoSender.parameters.degradationPreference).toBe("balanced");
  });

  it("reuses the audio transceiver when source audio appears and retires clones only", async () => {
    const { publisher: host, pc, video, send } = await publisher(false);
    const nextVideo = new FakeTrack("video");
    const nextAudio = new FakeTrack("audio");
    host.setPaused(true);
    expect(await host.replaceStream(stream(nextVideo, nextAudio))).toBe(true);
    expect(video.clones[0]!.stop).toHaveBeenCalledOnce();
    expect(video.stop).not.toHaveBeenCalled();
    expect(pc.transceivers).toHaveLength(2);
    expect(nextVideo.clones[0]!.enabled).toBe(false);
    expect(nextAudio.clones[0]!.enabled).toBe(false);
    expect(send.mock.calls.at(-1)![0]).toMatchObject({
      kind: "media",
      media: { audio: true },
    });
    await host.disconnect();
    expect(nextVideo.clones[0]!.stop).toHaveBeenCalledOnce();
    expect(nextAudio.clones[0]!.stop).toHaveBeenCalledOnce();
    expect(nextVideo.stop).not.toHaveBeenCalled();
    expect(nextAudio.stop).not.toHaveBeenCalled();
    expect(pc.close).toHaveBeenCalledOnce();
  });

  it.each([0, 250])("counts new publication frames from a valid baseline of %s", async (baseline) => {
    const { publisher: host, pc, video } = await publisher();
    const sender = pc.transceivers[0]!.sender;
    expect(sender.parameters.degradationPreference).toBe(
      "maintain-resolution",
    );
    feedVideoStats(pc, video.clones[0]!.id, 6);
    await vi.advanceTimersByTimeAsync(2_000);
    expect(sender.parameters.degradationPreference).toBe("balanced");

    const nextVideo = new FakeTrack("video");
    expect(await host.replaceStream(stream(nextVideo))).toBe(true);
    expect(sender.parameters.degradationPreference).toBe(
      "maintain-resolution",
    );

    // The old source, an empty report, and an absent counter are all unknown.
    await vi.advanceTimersByTimeAsync(2_000);
    pc.report.clear();
    await vi.advanceTimersByTimeAsync(2_000);
    feedVideoStats(pc, nextVideo.clones[0]!.id, 0);
    delete pc.report.get("outbound-video").framesEncoded;
    await vi.advanceTimersByTimeAsync(2_000);

    feedVideoStats(pc, nextVideo.clones[0]!.id, baseline);
    await vi.advanceTimersByTimeAsync(2_000);
    expect(sender.parameters.degradationPreference).toBe(
      "maintain-resolution",
    );
    feedVideoStats(pc, nextVideo.clones[0]!.id, baseline + 4);
    await vi.advanceTimersByTimeAsync(2_000);
    expect(sender.parameters.degradationPreference).toBe(
      "maintain-resolution",
    );
    feedVideoStats(pc, nextVideo.clones[0]!.id, baseline + 5);
    await vi.advanceTimersByTimeAsync(2_000);
    expect(sender.parameters.degradationPreference).toBe("balanced");
  });

  it("applies the latest committed profile when startup recovery lands", async () => {
    const { publisher: host, pc, video } = await publisher();
    const sender = pc.transceivers[0]!.sender;
    const clone = video.clones[0]!;
    let releaseConstraints!: () => void;
    clone.applyConstraints.mockImplementationOnce(
      () =>
        new Promise<undefined>((resolve) => {
          releaseConstraints = () => resolve(undefined);
        }),
    );
    const update = host.updateProfile(QUALITY_PROFILES["720p30"]);
    await vi.advanceTimersByTimeAsync(0);
    feedVideoStats(pc, clone.id, 6);
    await vi.advanceTimersByTimeAsync(2_000);
    releaseConstraints();
    expect(await update).toBe(true);
    await vi.advanceTimersByTimeAsync(0);

    // The user's 720p30 change must survive the queued startup recovery; a
    // stats-time snapshot must not re-apply the previous 1080p30 profile.
    expect(sender.parameters.degradationPreference).toBe("balanced");
    expect(sender.parameters.encodings[1]).toMatchObject({
      maxBitrate: 3_000_000,
    });
  });

  it("rolls back a failed source replacement and releases its unused clone", async () => {
    const { publisher: host, pc, video, send } = await publisher();
    const videoSender = pc.transceivers[0]!.sender;
    feedVideoStats(pc, video.clones[0]!.id, 6);
    await vi.advanceTimersByTimeAsync(2_000);
    send.mockReturnValueOnce(false);
    const replacement = new FakeTrack("video");
    expect(await host.replaceStream(stream(replacement))).toBe(false);
    expect(pc.transceivers[0]!.sender.track).toBe(video.clones[0]);
    expect(video.clones[0]!.stop).not.toHaveBeenCalled();
    expect(replacement.clones[0]!.stop).toHaveBeenCalledOnce();
    expect(videoSender.parameters.degradationPreference).toBe("balanced");
    expect(pc.close).not.toHaveBeenCalled();
    const replacements = videoSender.replaceTrack.mock.calls.length;
    expect(await host.replaceStream(stream(video, new FakeTrack("audio")))).toBe(true);
    expect(videoSender.replaceTrack).toHaveBeenCalledTimes(replacements);
    expect(video.clones).toHaveLength(1);
  });

  it("preserves media during a signaling outage and updates only the route fence", async () => {
    const { publisher: host, pc, send, onDisconnected } = await publisher();
    await host.acceptSignal(
      signal({ description: { type: "answer", sdp: "answer" } }),
    );
    pc.state("connected");
    send.mockReturnValue(false);
    expect(await host.updateProfile(QUALITY_PROFILES["720p30"])).toBe(false);
    expect(pc.close).not.toHaveBeenCalled();
    expect(onDisconnected).not.toHaveBeenCalled();
    send.mockReturnValue(true);
    host.updateConfig({ ...config, revision: 9 });
    expect(await host.updateProfile(QUALITY_PROFILES["720p30"])).toBe(true);
    const updated = send.mock.calls.at(-1)![0];
    expect(updated.revision).toBe(9);
    expect(clientMessageSchema.safeParse(updated).success).toBe(true);
  });

  it("answers the server offer and commits only decoded video, preserving media during ICE restart", async () => {
    const send = vi.fn(() => true);
    const onFirstDecodedFrame = vi.fn(() => true);
    const onStream = vi.fn();
    const onDisconnected = vi.fn();
    const subscriber = new SfuSubscriber({
      send,
      onStream,
      onFirstDecodedFrame,
      onDisconnected,
    });
    cleanups.push(() => subscriber.disconnect());
    await subscriber.connect(config);
    subscriber.activate();
    subscriber.armDecodedFrameProof();
    const pc = FakePc.instances[0]!;
    await subscriber.acceptSignal(
      signal({ description: { type: "offer", sdp: "offer" } }),
    );
    let framesDecoded = 0;
    const video = new FakeTrack("video");
    pc.ontrack?.({
      track: video,
      receiver: {
        getStats: async () =>
          new Map([
            [
              "video",
              {
                id: "video",
                type: "inbound-rtp",
                kind: "video",
                framesDecoded,
              },
            ],
          ]),
      },
    });
    pc.state("connected");
    await vi.advanceTimersByTimeAsync(100);
    expect(onFirstDecodedFrame).not.toHaveBeenCalled();
    framesDecoded = 1;
    await vi.advanceTimersByTimeAsync(100);
    expect(onFirstDecodedFrame).toHaveBeenCalledOnce();
    expect(onStream).toHaveBeenCalledOnce();
    expect(subscriber.reconnect()).toBe(true);
    expect(send).toHaveBeenLastCalledWith(
      expect.objectContaining({
        kind: "subscribe",
        connectionId: config.connectionId,
      }),
    );
    expect(pc.close).not.toHaveBeenCalled();
    expect(onDisconnected).not.toHaveBeenCalled();
    await subscriber.disconnect();
    expect(onStream).toHaveBeenLastCalledWith(null);
  });

  it("waits for the exact SFU transport when decoded proof or commit arrives during disconnection", async () => {
    const messages: ClientMessage[] = [];
    const onSfuStream = vi.fn(), activatePeer = vi.fn(() => true);
    const route = new ViewerSfuRoute("viewer_12345678", {
      activatePeer, onSfuStream,
      send: message => { messages.push(message); return true; },
    });
    cleanups.push(() => route.disconnect());
    route.accept({ revision: 3, phase: "active", assignment: {
      upstream: { kind: "peer", peerId: "healthy_parent" }, childPeerIds: [], sfuPublicationGeneration: null,
    } });
    await vi.advanceTimersByTimeAsync(0);
    const assignment = { upstream: { kind: "sfu" as const }, childPeerIds: [], sfuPublicationGeneration: config.publicationGeneration };
    route.accept({ revision: config.revision, phase: "prepare", assignment, candidate: {
      childPeerId: "viewer_12345678", connectionId: config.connectionId, transport: "sfu", qualityProbe: false,
    } });
    await route.acceptConfig({ type: "sfu-config", ...config });
    const pc = FakePc.instances[0]!;
    await route.acceptSignal(signal({ description: { type: "offer", sdp: "offer" } }));
    let completeStats!: (report: Map<string, object>) => void;
    const report = new Promise<Map<string, object>>(resolve => { completeStats = resolve; });
    pc.ontrack?.({ track: new FakeTrack("video"), receiver: { getStats: () => report } });
    pc.state("connected");
    pc.state("disconnected");
    completeStats(new Map([["video", { id: "video", type: "inbound-rtp", kind: "video", framesDecoded: 1 }]]));
    await vi.advanceTimersByTimeAsync(0);
    expect(messages.filter(message => message.type === "route-ready")).toEqual([]);
    expect(onSfuStream).not.toHaveBeenCalled();

    pc.state("connected");
    await vi.advanceTimersByTimeAsync(100);
    expect(messages.filter(message => message.type === "route-ready")).toEqual([
      { type: "route-ready", revision: config.revision, phase: "prepare" },
    ]);
    pc.state("disconnected");
    route.accept({ revision: config.revision, phase: "active", assignment });
    await vi.advanceTimersByTimeAsync(0);
    expect(onSfuStream).not.toHaveBeenCalled();
    pc.state("connected");
    await vi.advanceTimersByTimeAsync(0);
    expect(onSfuStream).toHaveBeenCalledOnce();
    expect(FakePc.instances).toHaveLength(1);
    expect(pc.close).not.toHaveBeenCalled();
  });

  it("keeps a healthy subscription when a manual restart cannot be sent", async () => {
    const send = vi.fn(() => true);
    const onState = vi.fn(), onDisconnected = vi.fn();
    const subscriber = new SfuSubscriber({ send, onStream: vi.fn(), onState, onDisconnected });
    cleanups.push(() => subscriber.disconnect());
    await subscriber.connect(config);
    subscriber.activate();
    const pc = FakePc.instances[0]!;
    pc.state("connected");
    onState.mockClear();
    send.mockReturnValue(false);

    expect(subscriber.reconnect()).toBe(false);
    subscriber.resync();
    expect(pc.close).not.toHaveBeenCalled();
    expect(onDisconnected).not.toHaveBeenCalled();
    expect(onState).not.toHaveBeenCalled();

    send.mockReturnValue(true);
    expect(subscriber.reconnect()).toBe(true);
    expect(onState).toHaveBeenCalledExactlyOnceWith("reconnecting");
  });

  it("reports Browser video rejection through the existing SFU failure owner", async () => {
    const send = vi.fn(() => true), onDisconnected = vi.fn();
    const subscriber = new SfuSubscriber({ send, onStream: vi.fn(), onDisconnected });
    cleanups.push(() => subscriber.disconnect());
    await subscriber.connect(config);
    const pc = FakePc.instances[0]!;
    pc.createAnswer.mockResolvedValueOnce({ type: "answer", sdp: "m=video 0 UDP/TLS/RTP/SAVPF 120\r\n" });
    await subscriber.acceptSignal(signal({ description: { type: "offer",
      sdp: "m=video 9 UDP/TLS/RTP/SAVPF 96\r\na=sendonly\r\n" } }));
    expect(onDisconnected).toHaveBeenCalledExactlyOnceWith("VIDEO_REJECTED");
    expect(pc.close).toHaveBeenCalledOnce();
    expect(send).not.toHaveBeenCalled();
  });

  it.each([
    [false, false], [true, false], [false, true], [true, true],
  ])("retires an unfinished ICE restart on reauthentication (send=%s, answer=%s)", async (sent, answered) => {
    const send = vi.fn(() => sent);
    const onDisconnected = vi.fn();
    const subscriber = new SfuSubscriber({ send, onStream: vi.fn(), onDisconnected });
    cleanups.push(() => subscriber.disconnect());
    await subscriber.connect(config);
    subscriber.activate();
    const pc = FakePc.instances[0]!;
    pc.state("connected");
    subscriber.resync();
    expect(pc.close).not.toHaveBeenCalled();
    pc.state("disconnected");
    subscriber.updateConfig({ ...config, revision: 9 });
    expect(send).toHaveBeenCalledOnce();
    if (answered) await subscriber.acceptSignal(
      signal({ description: { type: "offer", sdp: "restart offer" } }),
    );
    expect(pc.close).not.toHaveBeenCalled();
    subscriber.resync();
    subscriber.resync();
    expect(pc.close).toHaveBeenCalledOnce();
    expect(onDisconnected).toHaveBeenCalledOnce();
  });

  it("bounds pending remote ICE without retiring the publication and flushes retained candidates", async () => {
    const { publisher: host, pc, onDisconnected } = await publisher();
    for (let index = 0; index < 65; index++) {
      await host.acceptSignal(
        signal({
          kind: "candidate",
          candidate: { candidate: `candidate:${index}` },
        }),
      );
    }
    expect(pc.close).not.toHaveBeenCalled();
    expect(onDisconnected).not.toHaveBeenCalled();
    await host.acceptSignal(signal({ description: { type: "answer", sdp: "answer" } }));
    expect(pc.addIceCandidate.mock.calls.map(([candidate]) => candidate.candidate))
      .toEqual(Array.from({ length: 64 }, (_, index) => `candidate:${index}`));
    pc.state("failed");
    expect(pc.close).toHaveBeenCalledOnce();
    expect(onDisconnected).toHaveBeenCalledOnce();
  });

  it("bounds local ICE during signaling loss and flushes retained candidates on return", async () => {
    const { publisher: host, pc, send, onDisconnected } = await publisher();
    pc.state("connected");
    send.mockReturnValue(false);
    for (let index = 0; index < 65; index++) {
      const value = { candidate: `candidate:${index}` };
      pc.onicecandidate?.({ candidate: { ...value, protocol: "udp", toJSON: () => value } });
    }
    expect(pc.close).not.toHaveBeenCalled();
    expect(onDisconnected).not.toHaveBeenCalled();
    send.mockClear().mockReturnValue(true);
    host.updateConfig({ ...config, revision: 5 });
    expect(send.mock.calls.map(([message]) => message.candidate?.candidate))
      .toEqual(Array.from({ length: 64 }, (_, index) => `candidate:${index}`));
    pc.state("failed");
    expect(pc.close).toHaveBeenCalledOnce();
    expect(onDisconnected).toHaveBeenCalledOnce();
  });

  it("changes audio ceilings without touching video capture or sender parameters", async () => {
    const { publisher: host, pc, video } = await publisher();
    const constraints = video.clones[0]!.applyConstraints.mock.calls.length;
    const parameters =
      pc.transceivers[0]!.sender.setParameters.mock.calls.length;
    expect(
      await host.updateProfile({
        ...QUALITY_PROFILES["1080p30"],
        maxAudioBitrate: 64000,
      }),
    ).toBe(true);
    expect(video.clones[0]!.applyConstraints).toHaveBeenCalledTimes(
      constraints,
    );
    expect(pc.transceivers[0]!.sender.setParameters).toHaveBeenCalledTimes(
      parameters,
    );
    expect(pc.transceivers[1]!.sender.parameters.encodings[0]!.maxBitrate).toBe(64_000);
  });

  it.each(["replaceTrack", "setParameters"] as const)("closes every owned clone while %s remains pending without stopping the sources", async (operation) => {
    const { publisher: host, pc, video, sound } = await publisher();
    let release!: () => void;
    const blocked = new Promise<void>((resolve) => {
      release = resolve;
    });
    pc.transceivers[0]!.sender[operation].mockImplementationOnce(
      async () => blocked,
    );
    const replacement = new FakeTrack("video");
    const replacing = host.replaceStream(stream(replacement));
    await vi.advanceTimersByTimeAsync(0);
    host.setPaused(true);
    expect(replacement.clones[0]!.enabled).toBe(false);
    await host.disconnect();
    expect(await replacing).toBe(false);
    for (const track of [
      video.clones[0]!,
      sound.clones[0]!,
      replacement.clones[0]!,
    ])
      expect(track.stop).toHaveBeenCalledOnce();
    for (const source of [video, sound, replacement])
      expect(source.stop).not.toHaveBeenCalled();
    expect(pc.close).toHaveBeenCalledOnce();
    const audioCalls = pc.transceivers[1]!.sender.replaceTrack.mock.calls.length;
    release();
    await vi.advanceTimersByTimeAsync(0);
    expect(pc.transceivers[1]!.sender.replaceTrack).toHaveBeenCalledTimes(audioCalls);
  });

  it("fails closed when restoring a replaced sender fails", async () => {
    const { publisher: host, pc, onDisconnected, video } = await publisher();
    pc.transceivers[0]!.sender.replaceTrack.mockRejectedValue(
      new Error("sender failed"),
    );
    const replacement = new FakeTrack("video");
    expect(await host.replaceStream(stream(replacement))).toBe(false);
    expect(onDisconnected).toHaveBeenCalledOnce();
    expect(pc.close).toHaveBeenCalledOnce();
    expect(video.clones[0]!.stop).toHaveBeenCalledOnce();
    expect(replacement.clones[0]!.stop).toHaveBeenCalledOnce();
  });

  it("uses the fenced SFU demand prefix without live profiles reactivating upper layers", async () => {
    const { publisher: host, pc } = await publisher();
    await host.acceptSignal(signal({ kind: "layers", activeCount: 1 }));
    expect(
      pc.transceivers[0]!.sender.parameters.encodings.map(
        (encoding) => encoding.active,
      ),
    ).toEqual([true, false]);
    await host.updateProfile(QUALITY_PROFILES["720p30"]);
    expect(
      pc.transceivers[0]!.sender.parameters.encodings.map(
        (encoding) => encoding.active,
      ),
    ).toEqual([true, false]);
    await host.acceptSignal(
      signal({
        kind: "layers",
        activeCount: 0,
        connectionId: "retired_connection",
      }),
    );
    expect(
      pc.transceivers[0]!.sender.parameters.encodings.map(
        (encoding) => encoding.active,
      ),
    ).toEqual([true, false]);
    await host.acceptSignal(signal({ kind: "layers", activeCount: 0 }));
    expect(
      pc.transceivers[0]!.sender.parameters.encodings.map(
        (encoding) => encoding.active,
      ),
    ).toEqual([false, false]);
    await host.acceptSignal(signal({ kind: "layers", activeCount: 2 }));
    expect(
      pc.transceivers[0]!.sender.parameters.encodings.map(
        (encoding) => encoding.active,
      ),
    ).toEqual([true, true]);
    expect(FakePc.instances).toHaveLength(1);
  });

  it("resumes an unsent ICE-restart offer after signaling returns on the same connection", async () => {
    const { publisher: host, pc, send, onDisconnected } = await publisher();
    await host.acceptSignal(
      signal({ description: { type: "answer", sdp: "answer" } }),
    );
    send.mockReturnValue(false);
    pc.state("disconnected");
    await vi.advanceTimersByTimeAsync(0);
    expect(pc.createOffer).toHaveBeenLastCalledWith({ iceRestart: true });
    expect(pc.close).not.toHaveBeenCalled();
    send.mockClear();
    send.mockReturnValue(true);
    host.updateConfig({ ...config, revision: 5 });
    expect(send.mock.calls.map(([message]) => message.kind)).toEqual([
      "description",
      "candidate",
    ]);
    expect(send.mock.calls[0]![0].revision).toBe(5);
    expect(pc.close).not.toHaveBeenCalled();
    expect(onDisconnected).not.toHaveBeenCalled();
  });
});