@stream-io/video-client 1.59.1 → 1.61.0

package/src/store/__tests__/CallState.test.ts

@@ -24,6 +24,7 @@ import {
   CallAcceptedEvent,
   CallEndedEvent,
   CallUpdatedEvent,
+  type GetCallRingStateResponse,
   MemberResponse,
   OwnCapability,
 } from '../../gen/coordinator';
@@ -1474,4 +1475,62 @@ describe('CallState', () => {
       expect(state['closedCaptionsTasks'].size).toBe(0);
     });
   });
+
+  describe('updateFromRingState', () => {
+    const ringState = fromPartial<GetCallRingStateResponse>({
+      session_id: 'session-1',
+      accepted_by: { bob: '2026-08-24T10:00:04Z' },
+      rejected_by: { carol: '2026-08-24T10:00:09Z' },
+      missed_by: { dave: '2026-08-24T10:00:35Z' },
+    });
+
+    const withSession = (id: string) => {
+      const state = new CallState();
+      state['sessionSubject'].next(
+        fromPartial({
+          id,
+          accepted_by: {},
+          rejected_by: {},
+          missed_by: {},
+          participants: [fromPartial({ user_session_id: 'p1' })],
+        }),
+      );
+      return state;
+    };
+
+    it('merges the ring maps into the current session', () => {
+      const state = withSession('session-1');
+      state.updateFromRingState(ringState);
+
+      expect(state.session?.accepted_by).toEqual(ringState.accepted_by);
+      expect(state.session?.rejected_by).toEqual(ringState.rejected_by);
+      expect(state.session?.missed_by).toEqual(ringState.missed_by);
+    });
+
+    it('leaves the session roster untouched', () => {
+      const state = withSession('session-1');
+      state.updateFromRingState(ringState);
+
+      expect(state.session?.participants).toHaveLength(1);
+    });
+
+    it('ignores a ring state that belongs to another session', () => {
+      const state = withSession('session-2');
+      state.updateFromRingState(ringState);
+
+      expect(state.session?.accepted_by).toEqual({});
+    });
+
+    it('applies the end timestamps', () => {
+      const state = withSession('session-1');
+      state.updateFromRingState({
+        ...ringState,
+        session_ended_at: '2026-08-24T10:01:00Z',
+        call_ended_at: '2026-08-24T10:01:00Z',
+      });
+
+      expect(state.session?.ended_at).toBe('2026-08-24T10:01:00Z');
+      expect(state.endedAt).toEqual(new Date('2026-08-24T10:01:00Z'));
+    });
+  });
 });

package/src/types.ts

@@ -458,7 +458,17 @@ type StreamRNVideoSDKEndCallReason =
   | 'unknown';
 
 type StreamRNVideoSDKCallingX = {
-  joinCall: (call: Call, activeCalls: Call[]) => Promise<void>;
+  /**
+   * @param isCancelled - polled around the bridge's waits: registration is
+   *   skipped, or undone, when it returns true. Supplied by the join attempt
+   *   because the call's own state cannot distinguish a fresh join starting
+   *   from `LEFT` from an abandoned one that reached `LEFT` while waiting.
+   */
+  joinCall: (
+    call: Call,
+    activeCalls: Call[],
+    isCancelled?: () => boolean,
+  ) => Promise<void>;
   endCall: (
     call: Call,
     reason?: StreamRNVideoSDKEndCallReason,
@@ -468,8 +478,34 @@ type StreamRNVideoSDKCallingX = {
   unwireAudioEngineSubscription: () => void;
 };
 
+/**
+ * React Native's preparation and cleanup for a ringing call's join.
+ *
+ * A ringing call is joined by the SDK rather than by app code, so there is no
+ * point at which the app holds the call and can still set it up. These are that
+ * point, and the matching release.
+ */
+type StreamRNVideoSDKRingingCallLifecycle = {
+  /**
+   * Runs the app's pre-join setup and resolves once it is done, bounded by a
+   * deadline. Rejecting fails the join closed rather than joining with nothing
+   * installed.
+   */
+  beforeJoin: (call: Call) => Promise<void>;
+
+  /**
+   * The join failed terminally. Ends the ringing flow and releases what the
+   * setup installed. Never rejects, so the original join error survives.
+   */
+  onJoinFailed: (call: Call) => Promise<void>;
+
+  /** The call has ended; release whatever the pre-join hook installed. */
+  onLeave: (call: Call) => void;
+};
+
 export type StreamRNVideoSDKGlobals = {
   callingX: StreamRNVideoSDKCallingX;
+  ringingCallLifecycle: StreamRNVideoSDKRingingCallLifecycle;
   callManager: {
     /**
      * Sets up the in call manager.