@takosjp/yurucommu-api 3.2.1 → 3.4.0

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./lib/api.js";
 export * from "./lib/transport.js";
+export * from "./lib/rtc-client.js";
+export * from "./lib/realtime-client.js";
 export * from "./social-server.js";
 export * from "./types/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1355,6 +1355,707 @@ async function reportContent(input) {
   });
   await assertOk(res, "Failed to submit report");
 }
+// src/lib/rtc-client.ts
+var CANDIDATE_FLUSH_MS = 200;
+
+class CallClient {
+  options;
+  ws = null;
+  wantConnected = false;
+  backoff = 500;
+  reconnectTimer = null;
+  listeners = new Map;
+  call = null;
+  localStream = null;
+  state = "idle";
+  constructor(options = {}) {
+    this.options = options;
+  }
+  on(event, listener) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = new Set;
+      this.listeners.set(event, set);
+    }
+    set.add(listener);
+    return () => set?.delete(listener);
+  }
+  emit(event, ...args) {
+    for (const l of this.listeners.get(event) ?? []) {
+      l(...args);
+    }
+  }
+  setState(state) {
+    if (this.state === state)
+      return;
+    this.state = state;
+    this.emit("state", state);
+  }
+  getState() {
+    return this.state;
+  }
+  origin() {
+    return this.options.origin ?? (typeof location !== "undefined" ? location.origin : "");
+  }
+  socketUrl() {
+    const o = this.origin();
+    return `${o.replace(/^http/, "ws")}/api/rtc/socket`;
+  }
+  connect() {
+    this.wantConnected = true;
+    this.openSocket();
+  }
+  disconnect() {
+    this.wantConnected = false;
+    if (this.reconnectTimer)
+      clearTimeout(this.reconnectTimer);
+    this.reconnectTimer = null;
+    this.ws?.close();
+    this.ws = null;
+  }
+  openSocket() {
+    if (this.ws && this.ws.readyState <= WebSocket.OPEN)
+      return;
+    let socket;
+    try {
+      socket = new WebSocket(this.socketUrl());
+    } catch (err) {
+      this.emit("error", "socket_open_failed", String(err));
+      this.scheduleReconnect();
+      return;
+    }
+    this.ws = socket;
+    socket.onopen = () => {
+      this.backoff = 500;
+      this.send({ t: "hello" });
+      if (this.call)
+        this.send({ t: "resume", callId: this.call.callId });
+    };
+    socket.onmessage = (ev) => {
+      this.onFrame(ev.data);
+    };
+    socket.onclose = () => {
+      if (this.ws === socket)
+        this.ws = null;
+      if (this.wantConnected)
+        this.scheduleReconnect();
+    };
+    socket.onerror = () => {
+      socket.close();
+    };
+  }
+  scheduleReconnect() {
+    if (!this.wantConnected || this.reconnectTimer)
+      return;
+    const max = this.options.maxBackoffMs ?? 15000;
+    const delay = Math.min(this.backoff, max);
+    this.backoff = Math.min(this.backoff * 2, max);
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null;
+      this.openSocket();
+    }, delay);
+  }
+  send(frame) {
+    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+      this.ws.send(JSON.stringify(frame));
+    }
+  }
+  async startCall(peer, media) {
+    if (this.call)
+      throw new Error("already in a call");
+    const res = await fetch(`${this.origin()}/api/rtc/calls`, {
+      method: "POST",
+      credentials: "include",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ to: peer, media })
+    });
+    if (!res.ok) {
+      const code = res.status === 403 ? "blocked" : "start_failed";
+      this.emit("error", code);
+      throw new Error(code);
+    }
+    const data = await res.json();
+    this.call = this.newCall(data.callId, peer, media, "caller", data.iceServers);
+    this.setState("calling");
+    this.connect();
+    this.send({ t: "invite", callId: data.callId, to: peer, media });
+    await this.setupMedia(this.call);
+    await this.makeOffer(this.call);
+  }
+  async accept() {
+    const call = this.call;
+    if (!call || call.role !== "callee")
+      return;
+    this.setState("connecting");
+    this.send({ t: "accept", callId: call.callId });
+    await this.setupMedia(call);
+    if (call.pc && call.remoteDescriptionSet) {
+      const answer = await call.pc.createAnswer();
+      await call.pc.setLocalDescription(answer);
+      this.send({ t: "answer", callId: call.callId, sdp: answer.sdp ?? "" });
+    }
+  }
+  reject(reason = "declined") {
+    const call = this.call;
+    if (!call)
+      return;
+    this.send({ t: "reject", callId: call.callId, reason });
+    this.teardown("ended");
+  }
+  hangup(reason = "hangup") {
+    const call = this.call;
+    if (!call)
+      return;
+    this.send({ t: "hangup", callId: call.callId, reason });
+    this.teardown("ended");
+  }
+  setMuted(muted) {
+    for (const track of this.localStream?.getAudioTracks() ?? []) {
+      track.enabled = !muted;
+    }
+    this.emit("muted", muted);
+  }
+  setCameraEnabled(enabled) {
+    for (const track of this.localStream?.getVideoTracks() ?? []) {
+      track.enabled = enabled;
+    }
+    this.emit("cameraoff", !enabled);
+  }
+  async onFrame(raw) {
+    if (typeof raw !== "string")
+      return;
+    let frame;
+    try {
+      frame = JSON.parse(raw);
+    } catch {
+      return;
+    }
+    switch (frame.t) {
+      case "ready":
+      case "pong":
+        return;
+      case "ringing":
+        this.onRinging(frame);
+        return;
+      case "ice-servers":
+        if (this.call && this.call.callId === frame.callId) {
+          this.call.iceServers = frame.iceServers;
+        }
+        return;
+      case "offer":
+        await this.onRemoteOffer(frame);
+        return;
+      case "answer":
+        await this.onRemoteAnswer(frame);
+        return;
+      case "candidates":
+        await this.onRemoteCandidates(frame);
+        return;
+      case "peer-accepted":
+        if (this.state === "calling")
+          this.setState("connecting");
+        return;
+      case "peer-rejected":
+        this.emit("error", "declined", frame.reason);
+        this.teardown("ended");
+        return;
+      case "peer-hangup":
+        this.teardown("ended");
+        return;
+      case "call-state":
+        this.onCallState(frame);
+        return;
+      case "error":
+        this.emit("error", frame.code, frame.message);
+        if (frame.code === "peer_unreachable")
+          this.teardown("ended");
+        return;
+    }
+  }
+  onRinging(frame) {
+    if (this.call) {
+      this.send({ t: "reject", callId: frame.callId, reason: "busy" });
+      return;
+    }
+    this.call = this.newCall(frame.callId, frame.from, frame.media, "callee", []);
+    this.setState("incoming");
+    this.emit("incoming", {
+      callId: frame.callId,
+      from: frame.from,
+      media: frame.media
+    });
+  }
+  onCallState(frame) {
+    if (!this.call || this.call.callId !== frame.callId)
+      return;
+    if (frame.state === "missed" || frame.state === "cancelled" || frame.state === "rejected" || frame.state === "failed" || frame.state === "ended") {
+      this.teardown("ended");
+    }
+  }
+  async onRemoteOffer(frame) {
+    let call = this.call;
+    if (!call || call.callId !== frame.callId) {
+      call = this.newCall(frame.callId, "unknown", frame.media ?? { audio: true, video: false }, "callee", []);
+      this.call = call;
+      this.setState("incoming");
+    }
+    if (!call.pc)
+      this.buildPeerConnection(call);
+    await call.pc?.setRemoteDescription({ type: "offer", sdp: frame.sdp });
+    call.remoteDescriptionSet = true;
+    await this.drainRemoteCandidates(call);
+  }
+  async onRemoteAnswer(frame) {
+    const call = this.call;
+    if (!call || call.callId !== frame.callId || !call.pc)
+      return;
+    await call.pc.setRemoteDescription({ type: "answer", sdp: frame.sdp });
+    call.remoteDescriptionSet = true;
+    await this.drainRemoteCandidates(call);
+  }
+  async onRemoteCandidates(frame) {
+    const call = this.call;
+    if (!call || call.callId !== frame.callId)
+      return;
+    for (const cand of frame.candidates) {
+      if (call.pc && call.remoteDescriptionSet) {
+        try {
+          await call.pc.addIceCandidate(cand);
+        } catch {}
+      } else {
+        call.pendingRemoteCandidates.push(cand);
+      }
+    }
+  }
+  async drainRemoteCandidates(call) {
+    if (!call.pc)
+      return;
+    const pending = call.pendingRemoteCandidates.splice(0);
+    for (const cand of pending) {
+      try {
+        await call.pc.addIceCandidate(cand);
+      } catch {}
+    }
+  }
+  async setupMedia(call) {
+    if (!this.localStream) {
+      try {
+        this.localStream = await navigator.mediaDevices.getUserMedia({
+          audio: call.media.audio,
+          video: call.media.video
+        });
+      } catch (err) {
+        this.emit("error", "media_denied", String(err));
+        this.hangup("media_denied");
+        return;
+      }
+      this.emit("localstream", this.localStream);
+    }
+    if (!call.pc)
+      this.buildPeerConnection(call);
+    for (const track of this.localStream.getTracks()) {
+      call.pc?.addTrack(track, this.localStream);
+    }
+  }
+  buildPeerConnection(call) {
+    const pc = new RTCPeerConnection({
+      iceServers: call.iceServers.map((s) => ({
+        urls: s.urls,
+        username: s.username,
+        credential: s.credential
+      }))
+    });
+    pc.onicecandidate = (ev) => {
+      if (ev.candidate)
+        this.bufferCandidate(call, ev.candidate.toJSON());
+      else
+        this.flushCandidates(call);
+    };
+    pc.ontrack = (ev) => {
+      this.emit("remotestream", ev.streams[0] ?? null);
+    };
+    pc.onconnectionstatechange = () => {
+      if (pc.connectionState === "connected")
+        this.setState("connected");
+      else if (pc.connectionState === "failed" || pc.connectionState === "closed") {
+        this.teardown("ended");
+      }
+    };
+    call.pc = pc;
+  }
+  async makeOffer(call) {
+    if (!call.pc)
+      this.buildPeerConnection(call);
+    const offer = await call.pc.createOffer();
+    await call.pc.setLocalDescription(offer);
+    this.send({ t: "offer", callId: call.callId, sdp: offer.sdp ?? "" });
+  }
+  bufferCandidate(call, cand) {
+    call.candidateBuffer.push(cand);
+    if (call.flushTimer)
+      return;
+    call.flushTimer = setTimeout(() => this.flushCandidates(call), CANDIDATE_FLUSH_MS);
+  }
+  flushCandidates(call) {
+    if (call.flushTimer) {
+      clearTimeout(call.flushTimer);
+      call.flushTimer = null;
+    }
+    if (call.candidateBuffer.length === 0)
+      return;
+    const candidates = call.candidateBuffer.splice(0).map((c) => ({
+      candidate: c.candidate ?? "",
+      sdpMid: c.sdpMid ?? null,
+      sdpMLineIndex: c.sdpMLineIndex ?? null,
+      usernameFragment: c.usernameFragment ?? null
+    }));
+    this.send({ t: "candidates", callId: call.callId, candidates });
+  }
+  newCall(callId, peer, media, role, iceServers) {
+    return {
+      callId,
+      peer,
+      media,
+      role,
+      pc: null,
+      iceServers,
+      pendingRemoteCandidates: [],
+      candidateBuffer: [],
+      flushTimer: null,
+      remoteDescriptionSet: false
+    };
+  }
+  teardown(finalState) {
+    const call = this.call;
+    if (call) {
+      if (call.flushTimer)
+        clearTimeout(call.flushTimer);
+      call.pc?.getSenders().forEach((s) => s.track?.stop());
+      try {
+        call.pc?.close();
+      } catch {}
+    }
+    if (this.localStream) {
+      this.localStream.getTracks().forEach((t) => t.stop());
+      this.localStream = null;
+      this.emit("localstream", null);
+    }
+    this.emit("remotestream", null);
+    this.call = null;
+    this.setState(finalState);
+    if (finalState === "ended") {
+      setTimeout(() => {
+        if (!this.call)
+          this.setState("idle");
+      }, 400);
+    }
+  }
+}
+// src/types/realtime.ts
+function parseRealtimeClientFrame(raw) {
+  if (!raw || typeof raw !== "object")
+    return null;
+  const frame = raw;
+  if (frame.t === "ping" || frame.t === "pong")
+    return { t: frame.t };
+  if (frame.t === "hello") {
+    const lastEventId = typeof frame.lastEventId === "number" && Number.isFinite(frame.lastEventId) && frame.lastEventId >= 0 ? Math.floor(frame.lastEventId) : undefined;
+    return { t: "hello", lastEventId };
+  }
+  return null;
+}
+function parseRealtimeServerFrame(raw) {
+  if (!raw || typeof raw !== "object")
+    return null;
+  const frame = raw;
+  if (frame.t === "ping" || frame.t === "pong" || frame.t === "resync") {
+    return { t: frame.t };
+  }
+  if (frame.t === "hello_ok" && typeof frame.lastEventId === "number") {
+    return { t: "hello_ok", lastEventId: frame.lastEventId };
+  }
+  if (frame.t === "event" && frame.event && typeof frame.event === "object") {
+    const event = frame.event;
+    if (typeof event.id === "number" && typeof event.type === "string") {
+      return {
+        t: "event",
+        event: {
+          id: event.id,
+          type: event.type,
+          data: event.data && typeof event.data === "object" ? event.data : {}
+        }
+      };
+    }
+  }
+  return null;
+}
+
+// src/lib/realtime-client.ts
+var BACKOFF_BASE_MS = 1000;
+var BACKOFF_CAP_MS = 30000;
+var PING_INTERVAL_MS = 25000;
+var IDLE_TIMEOUT_MS = 60000;
+function resolveSocketUrl(actorApId, ticket) {
+  if (typeof location === "undefined")
+    return null;
+  const transport = getYurucommuApiTransport();
+  const resolved = transport.resolveUrl("/api/realtime/socket");
+  let url;
+  try {
+    url = new URL(resolved, location.origin);
+  } catch {
+    return null;
+  }
+  url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
+  url.searchParams.set("actor", actorApId);
+  url.searchParams.set("ticket", ticket);
+  return url.toString();
+}
+function createRealtimeClient() {
+  const handlers = new Map;
+  const resyncHandlers = new Set;
+  const statusHandlers = new Set;
+  let currentStatus = "idle";
+  let socket = null;
+  let started = false;
+  let attempts = 0;
+  let lastEventId;
+  let lastFrameAt = 0;
+  let pingTimer = null;
+  let reconnectTimer = null;
+  let generation = 0;
+  function setStatus(next) {
+    if (currentStatus === next)
+      return;
+    currentStatus = next;
+    for (const handler of statusHandlers) {
+      try {
+        handler(next);
+      } catch {}
+    }
+  }
+  function dispatch(event) {
+    for (const key of [event.type, "*"]) {
+      const set = handlers.get(key);
+      if (!set)
+        continue;
+      for (const handler of set) {
+        try {
+          handler(event);
+        } catch {}
+      }
+    }
+  }
+  function dispatchResync() {
+    for (const handler of resyncHandlers) {
+      try {
+        handler();
+      } catch {}
+    }
+  }
+  function clearTimers() {
+    if (pingTimer !== null) {
+      clearInterval(pingTimer);
+      pingTimer = null;
+    }
+    if (reconnectTimer !== null) {
+      clearTimeout(reconnectTimer);
+      reconnectTimer = null;
+    }
+  }
+  function closeSocket() {
+    if (!socket)
+      return;
+    const s = socket;
+    socket = null;
+    try {
+      s.close();
+    } catch {}
+  }
+  function scheduleReconnect() {
+    if (!started)
+      return;
+    setStatus("reconnecting");
+    attempts += 1;
+    const backoff = Math.min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * 2 ** Math.min(attempts - 1, 5));
+    const jitter = backoff * (0.5 + Math.random() * 0.5);
+    reconnectTimer = setTimeout(() => {
+      reconnectTimer = null;
+      connect();
+    }, jitter);
+  }
+  async function connect() {
+    if (!started || typeof WebSocket === "undefined")
+      return;
+    const myGeneration = ++generation;
+    setStatus(attempts === 0 ? "connecting" : "reconnecting");
+    let available;
+    try {
+      const res = await apiFetch("/api/realtime/config");
+      if (!res.ok)
+        throw new Error(`config ${res.status}`);
+      const body = await res.json();
+      available = body.available === true;
+    } catch {
+      if (!started || myGeneration !== generation)
+        return;
+      scheduleReconnect();
+      return;
+    }
+    if (!started || myGeneration !== generation)
+      return;
+    if (!available) {
+      setStatus("unavailable");
+      return;
+    }
+    let ticket;
+    let actorApId;
+    try {
+      const res = await apiPost("/api/realtime/ticket");
+      if (res.status === 401) {
+        setStatus("unavailable");
+        return;
+      }
+      if (!res.ok)
+        throw new Error(`ticket ${res.status}`);
+      const body = await res.json();
+      if (!body.ticket || !body.actor_ap_id)
+        throw new Error("bad ticket");
+      ticket = body.ticket;
+      actorApId = body.actor_ap_id;
+    } catch {
+      if (!started || myGeneration !== generation)
+        return;
+      scheduleReconnect();
+      return;
+    }
+    if (!started || myGeneration !== generation)
+      return;
+    const url = resolveSocketUrl(actorApId, ticket);
+    if (!url) {
+      setStatus("unavailable");
+      return;
+    }
+    let ws;
+    try {
+      ws = new WebSocket(url);
+    } catch {
+      scheduleReconnect();
+      return;
+    }
+    socket = ws;
+    lastFrameAt = Date.now();
+    ws.onopen = () => {
+      if (socket !== ws)
+        return;
+      ws.send(JSON.stringify({ t: "hello", lastEventId }));
+    };
+    ws.onmessage = (message) => {
+      if (socket !== ws)
+        return;
+      lastFrameAt = Date.now();
+      let parsed;
+      try {
+        parsed = JSON.parse(String(message.data));
+      } catch {
+        return;
+      }
+      const frame = parseRealtimeServerFrame(parsed);
+      if (!frame)
+        return;
+      switch (frame.t) {
+        case "hello_ok":
+          attempts = 0;
+          if (lastEventId === undefined)
+            lastEventId = frame.lastEventId;
+          else
+            lastEventId = Math.max(lastEventId, frame.lastEventId);
+          setStatus("connected");
+          return;
+        case "event":
+          lastEventId = Math.max(lastEventId ?? 0, frame.event.id);
+          dispatch(frame.event);
+          return;
+        case "resync":
+          dispatchResync();
+          return;
+        case "ping":
+          ws.send(JSON.stringify({ t: "pong" }));
+          return;
+        case "pong":
+          return;
+      }
+    };
+    const onGone = () => {
+      if (socket !== ws)
+        return;
+      socket = null;
+      scheduleReconnect();
+    };
+    ws.onclose = onGone;
+    ws.onerror = onGone;
+    if (pingTimer === null) {
+      pingTimer = setInterval(() => {
+        if (!socket || socket.readyState !== WebSocket.OPEN)
+          return;
+        if (Date.now() - lastFrameAt > IDLE_TIMEOUT_MS) {
+          closeSocket();
+          scheduleReconnect();
+          return;
+        }
+        try {
+          socket.send(JSON.stringify({ t: "ping" }));
+        } catch {}
+      }, PING_INTERVAL_MS);
+    }
+  }
+  return {
+    start() {
+      if (started)
+        return;
+      started = true;
+      attempts = 0;
+      connect();
+    },
+    stop() {
+      started = false;
+      generation += 1;
+      clearTimers();
+      closeSocket();
+      lastEventId = undefined;
+      setStatus("idle");
+    },
+    status() {
+      return currentStatus;
+    },
+    isConnected() {
+      return currentStatus === "connected";
+    },
+    on(type, handler) {
+      let set = handlers.get(type);
+      if (!set) {
+        set = new Set;
+        handlers.set(type, set);
+      }
+      set.add(handler);
+      return () => {
+        set.delete(handler);
+      };
+    },
+    onResync(handler) {
+      resyncHandlers.add(handler);
+      return () => {
+        resyncHandlers.delete(handler);
+      };
+    },
+    onStatus(handler) {
+      statusHandlers.add(handler);
+      return () => {
+        statusHandlers.delete(handler);
+      };
+    }
+  };
+}
 // src/social-server.ts
 async function fetchCurrentActor() {
   const res = await apiFetch("/api/auth/me");
@@ -1369,6 +2070,101 @@ async function fetchSocialServerDiscovery() {
   await assertOk(res, "Failed to load social server discovery");
   return await res.json();
 }
+// src/types/call.ts
+var RTC_SIGNAL_ENVELOPE_VERSION = 1;
+var TERMINAL_CALL_STATES = [
+  "ended",
+  "rejected",
+  "missed",
+  "failed",
+  "cancelled"
+];
+function isTerminalCallState(state) {
+  return TERMINAL_CALL_STATES.includes(state);
+}
+var SIGNAL_TYPES = [
+  "offer",
+  "answer",
+  "candidate",
+  "accept",
+  "reject",
+  "hangup",
+  "cancel"
+];
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isCallMediaKind(value) {
+  return isPlainObject(value) && typeof value.audio === "boolean" && typeof value.video === "boolean";
+}
+function parseCandidates(value) {
+  if (value === undefined)
+    return;
+  if (!Array.isArray(value))
+    return;
+  const out = [];
+  for (const raw of value) {
+    if (!isPlainObject(raw) || typeof raw.candidate !== "string")
+      continue;
+    out.push({
+      candidate: raw.candidate,
+      sdpMid: typeof raw.sdpMid === "string" ? raw.sdpMid : null,
+      sdpMLineIndex: typeof raw.sdpMLineIndex === "number" ? raw.sdpMLineIndex : null,
+      usernameFragment: typeof raw.usernameFragment === "string" ? raw.usernameFragment : null
+    });
+  }
+  return out;
+}
+function parseSfuFocus(value) {
+  if (value === undefined)
+    return;
+  if (value === null)
+    return null;
+  if (!isPlainObject(value))
+    return;
+  if (typeof value.kind !== "string" || typeof value.url !== "string") {
+    return;
+  }
+  return {
+    kind: value.kind,
+    url: value.url,
+    token: typeof value.token === "string" ? value.token : undefined,
+    room: typeof value.room === "string" ? value.room : undefined
+  };
+}
+function parseRtcSignalEnvelope(input) {
+  if (!isPlainObject(input))
+    return null;
+  if (input.v !== RTC_SIGNAL_ENVELOPE_VERSION)
+    return null;
+  const { callId, from, to, type, ts, ttlMs } = input;
+  if (typeof callId !== "string" || callId.length === 0 || callId.length > 200 || typeof from !== "string" || from.length === 0 || typeof to !== "string" || to.length === 0 || typeof type !== "string" || !SIGNAL_TYPES.includes(type) || typeof ts !== "number" || !Number.isFinite(ts) || typeof ttlMs !== "number" || !Number.isFinite(ttlMs) || ttlMs < 0) {
+    return null;
+  }
+  const sdp = typeof input.sdp === "string" ? input.sdp : undefined;
+  if (sdp !== undefined && sdp.length > 1e5)
+    return null;
+  return {
+    v: RTC_SIGNAL_ENVELOPE_VERSION,
+    callId,
+    from,
+    to,
+    type,
+    media: isCallMediaKind(input.media) ? input.media : undefined,
+    sdp,
+    candidates: parseCandidates(input.candidates),
+    sfuFocus: parseSfuFocus(input.sfuFocus),
+    reason: typeof input.reason === "string" ? input.reason.slice(0, 200) : undefined,
+    ts,
+    ttlMs
+  };
+}
+function isEnvelopeFresh(envelope, now) {
+  const skewToleranceMs = 30000;
+  if (envelope.ts - now > skewToleranceMs)
+    return false;
+  return now - envelope.ts <= envelope.ttlMs;
+}
 export {
   voteOnStory,
   validateFile,
@@ -1412,6 +2208,9 @@ export {
   rejectCommunityJoinRequest,
   registerNotificationPusher,
   refreshBrowserNotificationPush,
+  parseRtcSignalEnvelope,
+  parseRealtimeServerFrame,
+  parseRealtimeClientFrame,
   normalizeStory,
   normalizePost,
   normalizeNotification,
@@ -1433,6 +2232,8 @@ export {
   likePost,
   leaveCommunity,
   joinCommunity,
+  isTerminalCallState,
+  isEnvelopeFresh,
   getYurucommuApiTransport,
   getStoryViewers,
   getBrowserNotificationPushState,
@@ -1484,6 +2285,7 @@ export {
   deleteCommunityMessage,
   deleteAccount,
   createStory,
+  createRealtimeClient,
   createPost,
   createNote,
   createCommunityInvite,
@@ -1508,6 +2310,9 @@ export {
   allowedMimeTypes,
   acceptFollowRequest,
   acceptCommunityJoinRequest,
+  TERMINAL_CALL_STATES,
+  RTC_SIGNAL_ENVELOPE_VERSION,
   FileValidationError,
+  CallClient,
   ApiError
 };

package/dist/lib/realtime-client.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Realtime stream client — the ONE WebSocket a product keeps open per signed-in
+ * user. Replaces the short-interval polling loops (talk messages 4s, typing 4s,
+ * contacts 20s, unread badges 20-30s): the server pushes `RealtimeEvent`s and
+ * the client fans them out to `on(type, handler)` subscribers.
+ *
+ * Transport: mints a one-time ticket over the normal authenticated fetch path
+ * (`POST /api/realtime/ticket` — works with both cookie and bearer transports;
+ * the browser WebSocket API cannot send an Authorization header), then connects
+ * to `wss://…/api/realtime/socket?actor=…&ticket=…`.
+ *
+ * Lifecycle: `start()` probes `GET /api/realtime/config`. When the server has
+ * no realtime runtime (`available:false` — e.g. a Bun self-host without
+ * Durable Objects) the client settles in status "unavailable" and the product
+ * enables its LOW-FREQUENCY fallback polling instead. Transient failures
+ * (network, worker restart) reconnect with exponential backoff and replay the
+ * missed gap via `hello{lastEventId}`; a `resync` answer means the gap
+ * outlived the server buffer and subscribers should re-fetch via REST.
+ */
+import type { RealtimeEvent, RealtimeEventType } from "../types/realtime.js";
+export type RealtimeStatus = "idle" | "connecting" | "connected" | "reconnecting" | "unavailable";
+export type RealtimeEventHandler = (event: RealtimeEvent) => void;
+export type RealtimeResyncHandler = () => void;
+export type RealtimeStatusHandler = (status: RealtimeStatus) => void;
+export interface RealtimeClient {
+    start(): void;
+    stop(): void;
+    status(): RealtimeStatus;
+    /** True while the live socket is up — products gate fallback polling on it. */
+    isConnected(): boolean;
+    on(type: RealtimeEventType | "*", handler: RealtimeEventHandler): () => void;
+    /** Fired on reconnect gaps the server could not replay: re-fetch via REST. */
+    onResync(handler: RealtimeResyncHandler): () => void;
+    onStatus(handler: RealtimeStatusHandler): () => void;
+}
+export declare function createRealtimeClient(): RealtimeClient;
+//# sourceMappingURL=realtime-client.d.ts.map

package/dist/lib/realtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-client.d.ts","sourceRoot":"","sources":["../../src/lib/realtime-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,MAAM,MAAM,cAAc,GACxB,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,aAAa,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAClE,MAAM,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC;AAC/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,cAAc,CAAC;IACzB,+EAA+E;IAC/E,WAAW,IAAI,OAAO,CAAC;IACvB,EAAE,CAAC,IAAI,EAAE,iBAAiB,GAAG,GAAG,EAAE,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IAC7E,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAC;CACtD;AA6BD,wBAAgB,oBAAoB,IAAI,cAAc,CAoQrD"}

package/dist/lib/rtc-client.d.ts

@@ -0,0 +1,84 @@
+/**
+ * CallClient — framework-agnostic browser WebRTC engine for the call feature.
+ *
+ * Owns the WebSocket to the per-user signaling hub (`/api/rtc/socket`), the
+ * `RTCPeerConnection` lifecycle, `getUserMedia`, half-trickle ICE, and the call
+ * state machine as the browser sees it. Both products (yurucommu / yurumeet)
+ * wrap this with their own reactive state layer (SolidJS signals / jotai) — no
+ * WebRTC logic is duplicated per product, and the wire protocol is single-
+ * sourced with the backend via `./types/call.ts`.
+ *
+ * 1:1 only for now: the caller offers, the callee answers, media is P2P over the
+ * server-provided ICE (STUN/TURN) servers. Camera on/off toggles the existing
+ * video track (no mid-call renegotiation, so no glare at the PC level).
+ */
+import type { CallMediaKind } from "../types/call.js";
+export type CallUiState = "idle" | "calling" | "incoming" | "connecting" | "connected" | "ended";
+export interface IncomingCallInfo {
+    callId: string;
+    from: string;
+    media: CallMediaKind;
+}
+export interface CallClientEvents {
+    state: (state: CallUiState) => void;
+    incoming: (info: IncomingCallInfo) => void;
+    localstream: (stream: MediaStream | null) => void;
+    remotestream: (stream: MediaStream | null) => void;
+    muted: (muted: boolean) => void;
+    cameraoff: (off: boolean) => void;
+    error: (code: string, message?: string) => void;
+}
+export interface CallClientOptions {
+    /** Origin the app is served from (defaults to the page origin). */
+    origin?: string;
+    /** WebSocket reconnect backoff ceiling (ms). */
+    maxBackoffMs?: number;
+}
+export declare class CallClient {
+    private readonly options;
+    private ws;
+    private wantConnected;
+    private backoff;
+    private reconnectTimer;
+    private readonly listeners;
+    private call;
+    private localStream;
+    private state;
+    constructor(options?: CallClientOptions);
+    on<K extends keyof CallClientEvents>(event: K, listener: CallClientEvents[K]): () => void;
+    private emit;
+    private setState;
+    getState(): CallUiState;
+    private origin;
+    private socketUrl;
+    connect(): void;
+    disconnect(): void;
+    private openSocket;
+    private scheduleReconnect;
+    private send;
+    /** Place an outgoing call. Fetches a callId + ICE, then rings the peer. */
+    startCall(peer: string, media: CallMediaKind): Promise<void>;
+    /** Accept the current incoming call. */
+    accept(): Promise<void>;
+    /** Decline the current incoming call. */
+    reject(reason?: string): void;
+    /** Hang up / cancel the active call. */
+    hangup(reason?: string): void;
+    setMuted(muted: boolean): void;
+    setCameraEnabled(enabled: boolean): void;
+    private onFrame;
+    private onRinging;
+    private onCallState;
+    private onRemoteOffer;
+    private onRemoteAnswer;
+    private onRemoteCandidates;
+    private drainRemoteCandidates;
+    private setupMedia;
+    private buildPeerConnection;
+    private makeOffer;
+    private bufferCandidate;
+    private flushCandidates;
+    private newCall;
+    private teardown;
+}
+//# sourceMappingURL=rtc-client.d.ts.map

package/dist/lib/rtc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-client.d.ts","sourceRoot":"","sources":["../../src/lib/rtc-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,aAAa,EAId,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,SAAS,GACT,UAAU,GACV,YAAY,GACZ,WAAW,GACX,OAAO,CAAC;AAEZ,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC3C,WAAW,EAAE,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,YAAY,EAAE,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAChC,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAmBD,qBAAa,UAAU;IAUT,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAO;IACtB,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;IAC9E,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,KAAK,CAAuB;gBAEP,OAAO,GAAE,iBAAsB;IAG5D,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACjC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,MAAM,IAAI;IAUb,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,QAAQ;IAMhB,QAAQ,IAAI,WAAW;IAKvB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,SAAS;IAKjB,OAAO,IAAI,IAAI;IAKf,UAAU,IAAI,IAAI;IAQlB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,IAAI;IAQZ,2EAA2E;IACrE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BlE,wCAAwC;IAClC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAc7B,yCAAyC;IACzC,MAAM,CAAC,MAAM,SAAa,GAAG,IAAI;IAOjC,wCAAwC;IACxC,MAAM,CAAC,MAAM,SAAW,GAAG,IAAI;IAO/B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAO9B,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;YAQ1B,OAAO;IAiDrB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,WAAW;YAeL,aAAa;YAsBb,cAAc;YAUd,kBAAkB;YAkBlB,qBAAqB;YAarB,UAAU;IAoBxB,OAAO,CAAC,mBAAmB;YA2Bb,SAAS;IAOvB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,QAAQ;CA0BjB"}

package/dist/types/call.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Call signaling wire contract (voice + video).
+ *
+ * SINGLE SOURCE OF TRUTH shared by:
+ *   - the backend cross-instance signaling ingest (`/ap/rtc/signal`) + the
+ *     Signaling Durable Object (server-to-server + browser fan-out), and
+ *   - the browser `CallClient` (`../lib/rtc-client.ts`).
+ *
+ * Kept deliberately DOM-structural (no `RTCIceCandidateInit` / `RTCIceServer`
+ * imports) so the same file type-checks in the server context (which never runs
+ * the browser WebRTC APIs) and the browser bundle. The `CallClient` maps these
+ * structural shapes to/from the real DOM `RTCSessionDescriptionInit` /
+ * `RTCIceCandidateInit` / `RTCIceServer`, which are structurally compatible.
+ *
+ * Design: signaling travels over federation (server-to-server, HTTP-Signature
+ * authenticated) as `RtcSignalEnvelopeV1`; media is P2P WebRTC + STUN/TURN for
+ * 1:1 (`sfuFocus: null`) and a pluggable WHIP/WHEP SFU focus for group calls.
+ */
+export declare const RTC_SIGNAL_ENVELOPE_VERSION: 1;
+/** Which media tracks a call carries. `video:false` => audio-only call. */
+export interface CallMediaKind {
+    audio: boolean;
+    video: boolean;
+}
+/** Cross-instance signaling message kinds (Matrix-VoIP inspired). */
+export type RtcSignalType = "offer" | "answer" | "candidate" | "accept" | "reject" | "hangup" | "cancel";
+/**
+ * Selected SFU focus for a group call. `null`/absent means pure P2P (1:1).
+ * `kind` names the adapter (`whip` / `livekit` / `cloudflare-realtime` / ...);
+ * the client talks WHIP/WHEP so the SFU backend stays vendor-neutral.
+ */
+export interface SfuFocus {
+    kind: string;
+    /** WHIP (publish) / WHEP (subscribe) endpoint base, or SFU signaling URL. */
+    url: string;
+    /** Short-lived join token when the adapter requires one. */
+    token?: string;
+    room?: string;
+}
+/** Structural mirror of `RTCIceCandidateInit` (no DOM dependency). */
+export interface CallIceCandidate {
+    candidate: string;
+    sdpMid?: string | null;
+    sdpMLineIndex?: number | null;
+    usernameFragment?: string | null;
+}
+/** Structural mirror of `RTCIceServer` (no DOM dependency). */
+export interface IceServerConfig {
+    urls: string | string[];
+    username?: string;
+    credential?: string;
+}
+/**
+ * Server-to-server signaling envelope. Delivered by the sending instance to the
+ * recipient instance's `/ap/rtc/signal` endpoint, signed with the sender actor's
+ * HTTP Signature key (keyId-owner === `from`). `callId` doubles as the anti-
+ * replay nonce; `ts`/`ttlMs` bound its freshness (the DO drops stale frames).
+ */
+export interface RtcSignalEnvelopeV1 {
+    v: typeof RTC_SIGNAL_ENVELOPE_VERSION;
+    callId: string;
+    from: string;
+    to: string;
+    type: RtcSignalType;
+    media?: CallMediaKind;
+    /** SDP for `offer` / `answer`. */
+    sdp?: string;
+    /** Half-trickle ICE bundle for `offer` / `answer` / `candidate`. */
+    candidates?: CallIceCandidate[];
+    sfuFocus?: SfuFocus | null;
+    /** Free-text end/reject reason (`busy`, `declined`, `timeout`, ...). */
+    reason?: string;
+    ts: number;
+    ttlMs: number;
+}
+/** Lifecycle of a single call, mirrored client-side and in `call_sessions`. */
+export type CallState = "idle" | "ringing" | "connecting" | "connected" | "ended" | "rejected" | "missed" | "failed" | "cancelled";
+export type CallDirection = "incoming" | "outgoing";
+/** Terminal states — a call in one of these is over and not resumable. */
+export declare const TERMINAL_CALL_STATES: readonly CallState[];
+export declare function isTerminalCallState(state: CallState): boolean;
+/** Frames the browser sends up to its own instance's Signaling DO. */
+export type ClientToHubFrame = {
+    t: "hello";
+} | {
+    t: "invite";
+    callId: string;
+    to: string;
+    media: CallMediaKind;
+} | {
+    t: "offer";
+    callId: string;
+    sdp: string;
+} | {
+    t: "answer";
+    callId: string;
+    sdp: string;
+} | {
+    t: "candidates";
+    callId: string;
+    candidates: CallIceCandidate[];
+} | {
+    t: "accept";
+    callId: string;
+} | {
+    t: "reject";
+    callId: string;
+    reason?: string;
+} | {
+    t: "hangup";
+    callId: string;
+    reason?: string;
+} | {
+    t: "resume";
+    callId: string;
+} | {
+    t: "ping";
+};
+/** Frames the Signaling DO pushes down to the browser. */
+export type HubToClientFrame = {
+    t: "ready";
+} | {
+    t: "ringing";
+    callId: string;
+    from: string;
+    media: CallMediaKind;
+} | {
+    t: "offer";
+    callId: string;
+    sdp: string;
+    media?: CallMediaKind;
+} | {
+    t: "answer";
+    callId: string;
+    sdp: string;
+} | {
+    t: "candidates";
+    callId: string;
+    candidates: CallIceCandidate[];
+} | {
+    t: "peer-accepted";
+    callId: string;
+} | {
+    t: "peer-rejected";
+    callId: string;
+    reason?: string;
+} | {
+    t: "peer-hangup";
+    callId: string;
+    reason?: string;
+} | {
+    t: "ice-servers";
+    callId: string;
+    iceServers: IceServerConfig[];
+    sfuFocus?: SfuFocus | null;
+} | {
+    t: "call-state";
+    callId: string;
+    state: CallState;
+} | {
+    t: "pong";
+} | {
+    t: "error";
+    code: string;
+    message?: string;
+};
+export interface StartCallRequest {
+    to: string;
+    media: CallMediaKind;
+}
+export interface StartCallResponse {
+    callId: string;
+    iceServers: IceServerConfig[];
+    sfuFocus?: SfuFocus | null;
+}
+export interface IceServersResponse {
+    iceServers: IceServerConfig[];
+}
+export interface CallSessionSummary {
+    id: string;
+    peer: string;
+    direction: CallDirection;
+    state: CallState;
+    media: CallMediaKind;
+    createdAt: string;
+    connectedAt?: string | null;
+    endedAt?: string | null;
+    endReason?: string | null;
+}
+/**
+ * Parse + validate an inbound cross-instance signaling envelope. Returns the
+ * normalized envelope or `null` when the shape is invalid. Callers additionally
+ * enforce that the HTTP-Signature signer equals `from` and that the recipient
+ * (`to`) is a local actor.
+ */
+export declare function parseRtcSignalEnvelope(input: unknown): RtcSignalEnvelopeV1 | null;
+/** True when the envelope is still within its freshness window. */
+export declare function isEnvelopeFresh(envelope: RtcSignalEnvelopeV1, now: number): boolean;
+//# sourceMappingURL=call.d.ts.map

package/dist/types/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/types/call.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -1,3 +1,5 @@
+export * from "./call.js";
+export * from "./realtime.js";
 export interface Actor {
     ap_id: string;
     username: string;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/realtime.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Realtime stream wire contract (browser <-> per-user RealtimeStreamDO).
+ *
+ * One authenticated WebSocket per user carries every live update the client
+ * used to poll for: talk messages, typing, read receipts, contact-list
+ * changes, new notifications, and the authoritative unread counters. The
+ * server pushes `RealtimeEvent` envelopes; the client sends only the small
+ * control frames below (writes stay on the REST API).
+ *
+ * Event ids are a per-user monotonic sequence assigned by the Durable Object.
+ * A reconnecting client offers its last seen id in `hello`; the DO replays the
+ * gap from its ring buffer, or answers `resync` when the gap is older than the
+ * buffer so the client re-fetches via the normal REST reads.
+ */
+export type RealtimeEventType = "talk.message" | "talk.typing" | "talk.read" | "talk.contacts_changed" | "notification.new" | "unread";
+export interface RealtimeEvent {
+    /** Per-user monotonic sequence number (assigned by the stream DO). */
+    id: number;
+    type: RealtimeEventType;
+    data: Record<string, unknown>;
+}
+/** `talk.message` payload. `other_ap_id` is from the RECEIVING user's view. */
+export interface TalkMessageEventData {
+    kind: "dm" | "community";
+    /** DM: the counterpart actor (per-recipient). */
+    other_ap_id?: string;
+    /** Community chat: the community actor. */
+    community_ap_id?: string;
+    conversation_id?: string;
+    message: {
+        id: string;
+        sender: {
+            ap_id: string;
+            username: string;
+            preferred_username: string | null;
+            name: string | null;
+            icon_url: string | null;
+        };
+        content: string | null;
+        attachments?: unknown[];
+        created_at: string | null;
+    };
+}
+export interface TalkTypingEventData {
+    other_ap_id: string;
+    is_typing: boolean;
+    typed_at: string;
+}
+export interface TalkReadEventData {
+    other_ap_id: string;
+    conversation_id: string;
+    last_read_at: string;
+}
+/** Authoritative unread counters (server-computed; never client-derived). */
+export interface UnreadEventData {
+    dm: number;
+    community: number;
+    talk_total: number;
+    notifications: number;
+}
+export type RealtimeClientFrame = {
+    t: "hello";
+    lastEventId?: number;
+} | {
+    t: "ping";
+} | {
+    t: "pong";
+};
+export type RealtimeServerFrame = {
+    t: "hello_ok";
+    lastEventId: number;
+} | {
+    t: "event";
+    event: RealtimeEvent;
+}
+/** The requested replay gap is older than the buffer: re-fetch via REST. */
+ | {
+    t: "resync";
+} | {
+    t: "ping";
+} | {
+    t: "pong";
+};
+export declare function parseRealtimeClientFrame(raw: unknown): RealtimeClientFrame | null;
+export declare function parseRealtimeServerFrame(raw: unknown): RealtimeServerFrame | null;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/types/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/types/realtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,aAAa,GACb,WAAW,GACX,uBAAuB,GACvB,kBAAkB,GAClB,QAAQ,CAAC;AAEb,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE;YACN,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;YACjB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;YAClC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;YACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;SACzB,CAAC;QACF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;QACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,MAAM,mBAAmB,GAC7B;IAAE,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvE,MAAM,MAAM,mBAAmB,GAC3B;IAAE,CAAC,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE;AACtC,4EAA4E;GAC1E;IAAE,CAAC,EAAE,QAAQ,CAAA;CAAE,GACf;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACb;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElB,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX,mBAAmB,GAAG,IAAI,CAc5B;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX,mBAAmB,GAAG,IAAI,CA8B5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takosjp/yurucommu-api",
-  "version": "3.2.1",
+  "version": "3.4.0",
   "description": "Typed client SDK and public API contract for yurucommu-server clients.",
   "license": "AGPL-3.0-only",
   "type": "module",