@minicode-dev/chat 0.1.7 → 0.1.8

package/index.d.ts

@@ -89,6 +89,8 @@ export interface ChatGamesFeatures {
   battleshipPreview?: boolean;
   /** Tanques de guerra 3D. Default false while the game is in preview. */
   tanks?: boolean;
+  /** Simultaneous WebRTC tank combat; disabled by default. */
+  tanksLive?: boolean;
 }
 
 export interface ChatFeatures {
@@ -166,7 +168,14 @@ export interface ChatCallbacks {
   onConnectionChange?: (status: TransportStatus) => void;
 }
 
+export interface ChatWebRtcConfig {
+  /** Host supplied STUN/TURN configuration. Obtain TURN credentials at runtime. */
+  iceServers?: RTCIceServer[];
+  iceTransportPolicy?: 'all' | 'relay';
+}
+
 export interface ChatConfig {
+  webrtc?: ChatWebRtcConfig;
   websocket?: {
     url?: string | (() => string | Promise<string>) | null;
     reconnect?: ReconnectOptions;
@@ -507,3 +516,55 @@ export function sendRelayMessage(socket: WebSocket | null, roomId: string, messa
 
 /** Lazily loads the Battleship 3D preview (three.js); use with React.lazy. */
 export function loadBattleshipPreview(): Promise<{ default: ComponentType<any> }>;
+
+// ---- WebRTC (chat-signaled peer links, TANQUES LIVE groundwork) ----
+
+export interface ChatSignalFrame { userId: string; roomId: string; text: string }
+export interface PeerSignaling {
+  send(text: string): Promise<unknown> | unknown;
+  subscribe(listener: (frame: ChatSignalFrame) => void): () => void;
+  dispose?(): void;
+}
+export type PeerLinkPhase = 'idle' | 'listening' | 'calling' | 'negotiating' | 'connected' | 'restarting' | 'reconnecting' | 'failed';
+export interface PeerLinkState {
+  phase: PeerLinkPhase; role: 'caller' | 'answerer' | null; sid: string | null; gen: number;
+  tabId: string; peerTab: string | null; ice: string; connection: string; signalingState: string; gathering: string;
+  route: { local: string | null; remote: string | null; protocol: string | null; relay: boolean; label: string } | null;
+  rtt: number | null; statsRtt: number | null; reconnects: number; restarts: number; error: string | null;
+  move: { sent: number; dropped: number; received: number; outOfOrder: number; lossPct: number; hzIn: number; hzOut: number };
+  signals: { sent: number; received: number; retransmits: number; duplicates: number; ignored: number; invalid: number; tooLarge: number; maxLength: number };
+  events: { sent: number; received: number };
+}
+export interface PeerLink {
+  tabId: string;
+  connect(): void;
+  setListening(value: boolean): void;
+  sendMove(payload: unknown): boolean;
+  sendEvent(payload: unknown): boolean;
+  restartIce(): void;
+  getState(): PeerLinkState;
+  hangup(): void;
+  destroy(): void;
+}
+export function createPeerLink(options: {
+  signaling: PeerSignaling; selfId: string; peerId: string; roomId?: string | null; tabId?: string;
+  iceServers?: RTCIceServer[]; iceTransportPolicy?: RTCIceTransportPolicy; autoReconnect?: boolean; listen?: boolean;
+  RTCPeerConnectionImpl?: typeof RTCPeerConnection;
+  onChange?: (state: PeerLinkState) => void; onMove?: (payload: any, meta: { seq: number }) => void;
+  onEvent?: (payload: any) => void; log?: (line: string) => void;
+}): PeerLink;
+export const DEFAULT_ICE_SERVERS: RTCIceServer[];
+export const rtcSignals: { emit(frame: ChatSignalFrame): void; subscribe(listener: (frame: ChatSignalFrame) => void): () => void };
+export function createChatSignaling(options: { send: (roomId: string, text: string) => Promise<unknown> | unknown; roomId: string }): PeerSignaling;
+export function withSignalFaults(signaling: PeerSignaling, getFaults?: () => { drop?: number; duplicate?: number; jitter?: number }): PeerSignaling & { pause(ms: number): void; dispose(): void };
+export const WEBRTC_PREFIX: 'LIRA_WEBRTC_V1:';
+export const MAX_SIGNAL_LENGTH: number;
+export function isWebrtcMessage(text: unknown): boolean;
+export function encodeSignal(signal: Record<string, unknown>): string | null;
+export function decodeSignal(text: string): Record<string, any> | null;
+/** Lazy lab UI; render inside <Suspense>. */
+export const WebRtcLab: ComponentType<{
+  selfId: string | null; selfName?: string; peers?: { id: string; name?: string }[]; defaultPeerId?: string;
+  createSignaling: (opts: { peerId: string; log: (line: string) => void }) => PeerSignaling | Promise<PeerSignaling>;
+  socketStatus?: string; disabledReason?: string; title?: string; children?: ReactNode; iceServers?: RTCIceServer[];
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minicode-dev/chat",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "private": false,
   "description": "LIRA real-time chat (WebSocket, media, games) as a React package.",
   "author": "Minicode",