@minicode-dev/chat 0.1.10 → 0.1.12

package/index.d.ts

@@ -122,7 +122,7 @@ export interface ChatCustomEmoji {
 }
 
 export type ChatEffectId = 'nudge' | 'pig-disco' | 'confetti';
-export interface ChatEffectEvent { effectId: ChatEffectId; id: string; sentAt: number; }
+export interface ChatEffectEvent { effectId: ChatEffectId; id: string; sentAt: number; /** Countdown deadline, at most 24 hours after sentAt. */ endsAt?: number; sound?: boolean; }
 export interface ChatEffectDefinition {
   id: ChatEffectId;
   label: string;
@@ -151,7 +151,7 @@ export interface ChatEffectsConfig {
 export const EFFECT_CATALOG: readonly ChatEffectDefinition[];
 export function getChatEffect(id: string): ChatEffectDefinition | undefined;
 export const EFFECT_PREFIX: string;
-export function encodeEffect(event: { effectId: ChatEffectId; id?: string; sentAt?: number }): string;
+export function encodeEffect(event: { effectId: ChatEffectId; id?: string; sentAt?: number; endsAt?: number; sound?: boolean }): string;
 export function decodeEffect(text: unknown): ChatEffectEvent | null;
 
 export interface ChatStorageAdapter {
@@ -526,14 +526,29 @@ export interface PeerSignaling {
   dispose?(): void;
 }
 export type PeerLinkPhase = 'idle' | 'listening' | 'calling' | 'negotiating' | 'connected' | 'restarting' | 'reconnecting' | 'failed';
+export interface ManualTurnOptions {
+  /** Remaining validity in seconds; omit when the provider response has no known expiry. */
+  ttlSeconds?: number;
+  /** Default all. Use relay only to diagnose TURN connectivity. */
+  iceTransportPolicy?: RTCIceTransportPolicy;
+}
+export interface ManualTurnState {
+  status: 'idle' | 'waiting_peer' | 'sharing' | 'applying' | 'synchronized' | 'failed';
+  shared: boolean; received: boolean; expiresAt: number | null; error: string | null;
+}
 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;
+  route: { local: string | null; remote: string | null; protocol: string | null; relayProtocol?: 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; sendFailures: number; retransmits: number; duplicates: number; ignored: number; invalid: number; tooLarge: number; maxLength: number };
   events: { sent: number; received: number };
+  turnConfigured?: boolean; manualTurn?: ManualTurnState;
+  candidates?: { local: number; remote: number; accepted: number; rejected: number; localRelay: number; remoteRelay: number };
+  iceErrors?: { code: number; stage: 'gathering' | 'remote_candidate' }[];
+  channels?: { move: string; events: string };
+  startedAt?: number | null; connectedAt?: number | null; elapsedMs?: number;
 }
 export interface PeerLink {
   tabId: string;
@@ -542,13 +557,18 @@ export interface PeerLink {
   sendMove(payload: unknown): boolean;
   sendEvent(payload: unknown): boolean;
   restartIce(): void;
+  /** Shares temporary ICE credentials with the bound peer. Requires HTTPS/Web Crypto. */
+  configureTurn(input: string | { iceServers: RTCIceServer[]; expiresAt?: number | string | null; expiresIn?: number; ttl?: number } | { result: { iceServers: RTCIceServer[] } }, options?: ManualTurnOptions): Promise<{ expiresAt: number | null }>;
+  /** Requests recovery through the configured authority without creating competing calls. */
+  requestReconnect(): void;
+  clearManualTurn(): 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;
+  iceServers?: RTCIceServer[]; iceTransportPolicy?: RTCIceTransportPolicy; autoReconnect?: boolean; listen?: boolean; configurationAuthority?: boolean;
   RTCPeerConnectionImpl?: typeof RTCPeerConnection;
   onChange?: (state: PeerLinkState) => void; onMove?: (payload: any, meta: { seq: number }) => void;
   onEvent?: (payload: any) => void; log?: (line: string) => void;

package/package.json

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