@100mslive/react-native-hms 1.12.2 → 2.0.0-alpha.1

package/src/specs/HMSHLSPlayerNativeComponent.ts

@@ -0,0 +1,203 @@
+/**
+ * Fabric component spec for `<HMSHLSPlayer />`.
+ *
+ * Renders an HLS stream from the live room (host-published or recorded).
+ * Today's implementation lives in `ios/HMSHLSPlayerManager.swift` (paper)
+ * and `android/.../HMSHLSPlayerManager.kt` + `HMSHLSPlayer.kt` (paper).
+ * Phase 1 adds Fabric counterparts.
+ *
+ * This is the most surface-heavy component in the SDK:
+ *   - 3 props (`url`, `enableStats`, `enableControls`)
+ *   - 4 events (playback state, stats, request-response, captions)
+ *   - 13 imperative commands
+ *
+ * Like {@link HMSViewNativeComponent}, Fabric requires explicit prop and
+ * event payload shapes. For Phase 1 we use minimal shapes that capture
+ * essential fields (e.g. `requestId` for response events) and leave the
+ * rest loose. Phase 2 tightens.
+ */
+
+import type * as React from 'react';
+import type { ViewProps, HostComponent } from 'react-native';
+import type {
+  DirectEventHandler,
+  Double,
+  Int32,
+  WithDefault,
+} from 'react-native/Libraries/Types/CodegenTypes';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import codegenNativeCommands from 'react-native/Libraries/Utilities/codegenNativeCommands';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Event payload shapes
+// ─────────────────────────────────────────────────────────────────────────
+
+/**
+ * Playback state-change event payload.
+ * Today's emitter in `HMSHLSPlayer.kt` / iOS counterpart sends an
+ * `eventType` plus a state-specific data object. Phase 2 will type the
+ * `data` field per state; Phase 1 carries it as a string blob.
+ */
+type OnHmsHlsPlaybackEventPayload = Readonly<{
+  event: string;
+  data: string;
+}>;
+
+/**
+ * Stats event payload (RTC-shape stats: bitrate, dropped frames, etc.).
+ * Carried as a stringified JSON blob for Phase 1; Phase 2 types it.
+ */
+type OnHmsHlsStatsEventPayload = Readonly<{
+  event: string;
+  data: string;
+}>;
+
+/**
+ * Response event for the request-style commands (`areClosedCaptionSupported`,
+ * `isClosedCaptionEnabled`, `getPlayerDurationDetails`). The JS-side
+ * matches the response to the in-flight Promise via `requestId`.
+ */
+type OnDataReturnedPayload = Readonly<{
+  requestId: Int32;
+  result?: string;
+  error?: string;
+}>;
+
+/**
+ * Closed-captions cue payload. Native-side fires a cue object with start
+ * time, end time, payload string, etc. Phase 1 keeps it as a stringified
+ * blob; Phase 2 will type it.
+ */
+type OnHlsPlayerCuesEventPayload = Readonly<{
+  event: string;
+  data: string;
+}>;
+
+// ─────────────────────────────────────────────────────────────────────────
+// Props
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface NativeProps extends ViewProps {
+  /** HLS stream URL to play. */
+  url?: string;
+
+  /** Emit periodic stats events via `onHmsHlsStatsEvent`. */
+  enableStats?: WithDefault<boolean, false>;
+
+  /** Show the native player's built-in controls UI overlay. */
+  enableControls?: WithDefault<boolean, false>;
+
+  /** Playback state changes (started/paused/buffering/ended/...). */
+  onHmsHlsPlaybackEvent?: DirectEventHandler<OnHmsHlsPlaybackEventPayload>;
+
+  /** Periodic stats (only fired when `enableStats=true`). */
+  onHmsHlsStatsEvent?: DirectEventHandler<OnHmsHlsStatsEventPayload>;
+
+  /** Response for request-style commands; matched by `requestId`. */
+  onDataReturned?: DirectEventHandler<OnDataReturnedPayload>;
+
+  /** Closed-captions cue events. */
+  onHlsPlayerCuesEvent?: DirectEventHandler<OnHlsPlayerCuesEventPayload>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Imperative commands (13)
+//
+// `requestId`-bearing commands deliver their response via the
+// `onDataReturned` event (see {@link OnDataReturnedPayload}). The JS
+// wrapper in `src/components/HMSHLSPlayer/HMSHLSPlayer.tsx` currently
+// allocates the requestId and resolves a promise on response; Phase 1
+// keeps that pattern.
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface NativeCommands {
+  /** Start playing. Pass `''` (empty string) to reuse the URL prop. */
+  play: (viewRef: React.ElementRef<HostComponent<NativeProps>>, url: string) => void;
+
+  /** Stop playback (releases the player). */
+  stop: (viewRef: React.ElementRef<HostComponent<NativeProps>>) => void;
+
+  /** Pause playback (player remains allocated). */
+  pause: (viewRef: React.ElementRef<HostComponent<NativeProps>>) => void;
+
+  /** Resume from paused state. */
+  resume: (viewRef: React.ElementRef<HostComponent<NativeProps>>) => void;
+
+  /** Jump to the live edge (DVR HLS only). */
+  seekToLivePosition: (viewRef: React.ElementRef<HostComponent<NativeProps>>) => void;
+
+  /** Seek `seconds` ahead from current position. */
+  seekForward: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    seconds: Double
+  ) => void;
+
+  /** Seek `seconds` back from current position. */
+  seekBackward: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    seconds: Double
+  ) => void;
+
+  /** Set volume `0–100` (integer). */
+  setVolume: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    level: Int32
+  ) => void;
+
+  /**
+   * Query whether the stream supports closed captions. Response via
+   * `onDataReturned` matched by `requestId`.
+   */
+  areClosedCaptionSupported: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    requestId: Int32
+  ) => void;
+
+  /**
+   * Query whether closed captions are currently enabled. Response via
+   * `onDataReturned` matched by `requestId`.
+   */
+  isClosedCaptionEnabled: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    requestId: Int32
+  ) => void;
+
+  /** Enable closed captions display. */
+  enableClosedCaption: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>
+  ) => void;
+
+  /** Disable closed captions display. */
+  disableClosedCaption: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>
+  ) => void;
+
+  /**
+   * Get current player duration details (currentTime, duration, live).
+   * Response via `onDataReturned` matched by `requestId`.
+   */
+  getPlayerDurationDetails: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    requestId: Int32
+  ) => void;
+}
+
+export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: [
+    'play',
+    'stop',
+    'pause',
+    'resume',
+    'seekToLivePosition',
+    'seekForward',
+    'seekBackward',
+    'setVolume',
+    'areClosedCaptionSupported',
+    'isClosedCaptionEnabled',
+    'enableClosedCaption',
+    'disableClosedCaption',
+    'getPlayerDurationDetails',
+  ],
+});
+
+export default codegenNativeComponent<NativeProps>('HMSHLSPlayer');

package/src/specs/HMSViewNativeComponent.ts

@@ -0,0 +1,119 @@
+/**
+ * Fabric component spec for `<HMSView />` — the native video tile.
+ *
+ * Used to render an `HMSVideoTrack` inside a React Native view tree.
+ * Today's implementation lives in `ios/HMSView.swift` (paper) and
+ * `android/.../HMSSDKViewManager.kt` + `HMSView.kt` (paper). Phase 1
+ * adds Fabric counterparts (`ios/HMSViewComponentView.mm`,
+ * `android/.../HMSSDKViewManager.kt` reworked to implement the generated
+ * `HMSViewManagerInterface`).
+ *
+ * Note: Fabric component specs require explicit prop and event payload
+ * shapes — Codegen does NOT accept `Object` for view props/events the
+ * way it does for TurboModule method payloads. The shapes below are
+ * narrow and well-known, so this isn't the same scaling problem as the
+ * TurboModule's 99-method surface.
+ *
+ * Surface authored: 4 props + 1 imperative command (`capture`) +
+ * 2 events (`onChange` for resolution updates, `onDataReturned` for
+ * capture command responses).
+ */
+
+import type * as React from 'react';
+import type { ViewProps, HostComponent } from 'react-native';
+import type {
+  DirectEventHandler,
+  Int32,
+  WithDefault,
+} from 'react-native/Libraries/Types/CodegenTypes';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import codegenNativeCommands from 'react-native/Libraries/Utilities/codegenNativeCommands';
+
+/**
+ * Bag of identifiers passed to the native view to wire it up to a track.
+ * Mirrors the shape constructed in `src/classes/HmsView.tsx`.
+ */
+type DataProp = Readonly<{
+  trackId: string;
+  id: string;
+  mirror: boolean;
+  scaleType: string;
+}>;
+
+/**
+ * Emitted when the video stream's resolution changes (e.g. simulcast
+ * layer switch). Native fires `topChange`; the JS-side dispatches as
+ * `onChange`. Used to drive Android view-sizing in `HmsView.tsx`.
+ */
+type OnChangeEvent = Readonly<{
+  event: string;
+  data: Readonly<{
+    height: Int32;
+    width: Int32;
+  }>;
+}>;
+
+/**
+ * Emitted in response to the `capture` imperative command. Carries the
+ * requestId from JS and either a base64 result or an error tuple.
+ */
+type OnDataReturnedEvent = Readonly<{
+  requestId: Int32;
+  result?: string;
+  error?: string;
+}>;
+
+export interface NativeProps extends ViewProps {
+  /** Track identifier bag. See {@link DataProp}. */
+  data?: DataProp;
+
+  /**
+   * Enable automatic simulcast layer switching based on network
+   * conditions. iOS-side default in `HMSView.swift` is true.
+   */
+  autoSimulcast?: WithDefault<boolean, true>;
+
+  /**
+   * How the video fits within the view. Values defined in
+   * `src/classes/HMSVideoViewMode.ts` (ASPECT_FIT, ASPECT_FILL,
+   * ASPECT_BALANCED).
+   */
+  scaleType?: WithDefault<string, 'ASPECT_FILL'>;
+
+  /**
+   * Render the video above the regular view hierarchy.
+   * Platform: Android only — iOS view manager does not implement this.
+   */
+  setZOrderMediaOverlay?: WithDefault<boolean, false>;
+
+  /**
+   * Resolution-change events. Renamed from `onChange` to avoid colliding with
+   * RN's built-in `topChange` internal event (registered as bubbling on every
+   * RCTView), which triggers "Event cannot be both direct and bubbling".
+   */
+  onResolutionChange?: DirectEventHandler<OnChangeEvent>;
+
+  /** Capture command response (success or error). */
+  onDataReturned?: DirectEventHandler<OnDataReturnedEvent>;
+}
+
+/**
+ * Imperative commands callable on a `<HMSView />` ref.
+ */
+export interface NativeCommands {
+  /**
+   * Capture a snapshot of the current video frame. The result (or
+   * error) is delivered asynchronously via the `onDataReturned` event,
+   * matched to this call by `requestId`.
+   */
+  capture: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    requestId: Int32
+  ) => void;
+}
+
+export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['capture'],
+});
+
+export default codegenNativeComponent<NativeProps>('HMSView');

package/src/specs/NativeHMSManager.ts

@@ -0,0 +1,307 @@
+/**
+ * @100mslive/react-native-hms — TurboModule spec for HMSManager.
+ *
+ * This file is the source of truth for the JS↔native contract under
+ * React Native's New Architecture. At build time, RN's Codegen reads
+ * this spec and produces:
+ *
+ *   - iOS:     ios/build/.../NativeHMSManagerSpec.h (Obj-C++ protocol)
+ *   - Android: android/build/.../NativeHMSManagerSpec.java (abstract class)
+ *   - JS:      typed wrappers + JSI fast-path bindings
+ *
+ * Phase 1 of the New Architecture migration uses **Object-typed** payloads
+ * (every dictionary in/out is just `Object`) to preserve today's runtime
+ * behavior without designing 99 typed payload schemas upfront. Phase 2 will
+ * tighten types per API surface area (room/peer/track core first, then
+ * chat, polls, recording, etc.).
+ *
+ * Method count: 99 iOS (96 async + 3 sync), 98 Android (93 async + 5 sync).
+ * Event count: 28 unique events (24 cross-platform + 4 platform-specific).
+ *
+ * Cross-platform asymmetries are noted inline. See
+ * NEW_ARCHITECTURE_MIGRATION.md / 100ms-rn-new-arch-migration-plan.md.md
+ * for the full migration plan.
+ */
+
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+import type { Int32 } from 'react-native/Libraries/Types/CodegenTypes';
+
+export interface Spec extends TurboModule {
+  // ─────────────────────────────────────────────────────────────────────
+  // 0. NativeEventEmitter convention methods
+  //
+  // RN's NativeEventEmitter on the JS side calls these on the native module
+  // when listeners are added/removed. Required by the eventing infrastructure
+  // even though our impl uses them as no-ops (we route events via a separate
+  // DeviceEventManagerModule.RCTDeviceEventEmitter).
+  // ─────────────────────────────────────────────────────────────────────
+
+  addListener(eventName: string): void;
+  removeListeners(count: Int32): void;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 1. Lifecycle
+  // ─────────────────────────────────────────────────────────────────────
+
+  build(data: Object): Promise<Object>;
+  destroy(data: Object): Promise<Object>;
+  preview(credentials: Object): void; // fire-and-forget on iOS
+  previewForRole(data: Object): Promise<Object>;
+  cancelPreview(data: Object): Promise<Object>;
+  join(credentials: Object): void; // fire-and-forget on iOS
+  leave(data: Object): Promise<Object>;
+  endRoom(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 2. Track operations
+  // ─────────────────────────────────────────────────────────────────────
+
+  setLocalMute(data: Object): void; // fire-and-forget (impl is sync)
+  setLocalVideoMute(data: Object): void; // fire-and-forget (impl is sync)
+  switchCamera(data: Object): void; // fire-and-forget
+  isMute(data: Object): Promise<Object>;
+  changeTrackState(data: Object): Promise<Object>;
+  changeTrackStateForRoles(data: Object): Promise<Object>;
+  setVolume(data: Object): Promise<Object>;
+  remoteMuteAllAudio(data: Object): Promise<Object>;
+  setPlaybackAllowed(data: Object): Promise<Object>;
+  isPlaybackAllowed(data: Object): Promise<Object>;
+  setPlaybackForAllAudio(mute: Object): Promise<Object>;
+  getRemoteVideoTrackFromTrackId(data: Object): Promise<Object>;
+  getRemoteAudioTrackFromTrackId(data: Object): Promise<Object>;
+  getVideoTrackLayer(data: Object): Promise<Object>;
+  getVideoTrackLayerDefinition(data: Object): Promise<Object>;
+  setVideoTrackLayer(data: Object): Promise<Object>;
+  captureImageAtMaxSupportedResolution(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 3. Peer operations
+  // ─────────────────────────────────────────────────────────────────────
+
+  getLocalPeer(data: Object): Promise<Object>;
+  getRemotePeers(data: Object): Promise<Object>;
+  getRoles(data: Object): Promise<Object>;
+  getRoom(data: Object): Promise<Object>;
+  changeName(data: Object): Promise<Object>;
+  changeMetadata(data: Object): Promise<Object>;
+  changeRole(data: Object): Promise<Object>;
+  changeRoleOfPeer(data: Object): Promise<Object>;
+  changeRoleOfPeersWithRoles(data: Object): Promise<Object>;
+  acceptRoleChange(data: Object): Promise<Object>;
+  removePeer(data: Object): Promise<Object>;
+  raiseLocalPeerHand(data: Object): Promise<Object>;
+  lowerLocalPeerHand(data: Object): Promise<Object>;
+  lowerRemotePeerHand(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 4. Peer list iterator (large-room support)
+  // ─────────────────────────────────────────────────────────────────────
+
+  // getPeerListIterator is sync — see "Synchronous methods" section below.
+  peerListIteratorHasNext(data: Object): Promise<Object>;
+  peerListIteratorNext(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 5. Messaging
+  // ─────────────────────────────────────────────────────────────────────
+
+  sendBroadcastMessage(data: Object): Promise<Object>;
+  sendGroupMessage(data: Object): Promise<Object>;
+  sendDirectMessage(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 6. RTMP / Recording / HLS streaming
+  // ─────────────────────────────────────────────────────────────────────
+
+  startRTMPOrRecording(data: Object): Promise<Object>;
+  stopRtmpAndRecording(data: Object): Promise<Object>;
+  startHLSStreaming(data: Object): Promise<Object>;
+  stopHLSStreaming(data: Object): Promise<Object>;
+  sendHLSTimedMetadata(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 7. Screen share
+  // ─────────────────────────────────────────────────────────────────────
+
+  startScreenshare(data: Object): Promise<Object>;
+  stopScreenshare(data: Object): Promise<Object>;
+  isScreenShared(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 8. Audio share — iOS API
+  // Platform: iOS only. Android uses the startAudioshare/stopAudioshare
+  // pair below.
+  // ─────────────────────────────────────────────────────────────────────
+
+  playAudioShare(data: Object): Promise<Object>; // iOS only
+  pauseAudioShare(data: Object): Promise<Object>; // iOS only
+  resumeAudioShare(data: Object): Promise<Object>; // iOS only
+  stopAudioShare(data: Object): Promise<Object>; // iOS only
+  setAudioShareVolume(data: Object): Promise<Object>; // iOS only
+  audioShareCurrentTime(data: Object): Promise<Object>; // iOS only
+  audioShareDuration(data: Object): Promise<Object>; // iOS only
+  audioShareIsPlaying(data: Object): Promise<Object>; // iOS only
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 9. Audio share — Android API
+  // Platform: Android only. iOS uses the playAudioShare/... family above.
+  // ─────────────────────────────────────────────────────────────────────
+
+  startAudioshare(data: Object): Promise<Object>; // Android only — note lowercase 's'
+  stopAudioshare(data: Object): Promise<Object>; // Android only — note lowercase 's'
+  isAudioShared(data: Object): Promise<Object>; // Android only
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 10. Audio output / devices
+  // ─────────────────────────────────────────────────────────────────────
+
+  switchAudioOutput(data: Object): Promise<Object>;
+  switchAudioOutputUsingIOSUI(data: Object): Promise<Object>; // iOS only
+  getAudioDevicesList(data: Object): Promise<Object>; // Android only
+  getAudioOutputRouteType(data: Object): Promise<Object>; // Android only
+  setAudioDeviceChangeListener(data: Object): void; // Android only
+  setAudioMode(data: Object): Promise<Object>; // Android only
+  setAudioMixingMode(data: Object): Promise<Object>; // Android only
+  getAudioMixingMode(data: Object): Promise<Object>; // Android only
+  getVolume(data: Object): Promise<Object>; // Android only
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 11. Picture-in-Picture
+  // ─────────────────────────────────────────────────────────────────────
+
+  // handlePipActions is the only multi-argument method on the bridge. The
+  // first argument is the action name (string), the second is the payload.
+  handlePipActions(action: string, data: Object): Promise<Object>;
+  setupPIP(data: Object): Promise<Object>; // iOS only
+  stopPIP(data: Object): Promise<Object>; // iOS only
+  disposePIP(data: Object): Promise<Object>; // iOS only
+  isPIPActive(data: Object): Promise<Object>; // iOS only
+  changeIOSPIPVideoTrack(data: Object): Promise<Object>; // iOS only
+  setActiveSpeakerInIOSPIP(data: Object): Promise<Object>; // iOS only
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 12. Network quality
+  // ─────────────────────────────────────────────────────────────────────
+
+  enableNetworkQualityUpdates(data: Object): void;
+  disableNetworkQualityUpdates(data: Object): void;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 13. Session store / metadata
+  // ─────────────────────────────────────────────────────────────────────
+
+  getSessionMetadataForKey(data: Object): Promise<Object>;
+  setSessionMetadataForKey(data: Object): Promise<Object>;
+  addKeyChangeListener(data: Object): Promise<Object>;
+  removeKeyChangeListener(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 14. Polls / Quiz
+  // ─────────────────────────────────────────────────────────────────────
+
+  quickStartPoll(data: Object): Promise<Object>;
+  addResponseOnPollQuestion(data: Object): Promise<Object>;
+  stopPoll(data: Object): Promise<Object>;
+  fetchLeaderboard(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 15. Whiteboard
+  // ─────────────────────────────────────────────────────────────────────
+
+  startWhiteboard(data: Object): Promise<Object>;
+  stopWhiteboard(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 16. Transcripts
+  // ─────────────────────────────────────────────────────────────────────
+
+  handleRealTimeTranscription(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 17. Noise cancellation
+  // ─────────────────────────────────────────────────────────────────────
+
+  enableNoiseCancellationPlugin(data: Object): Promise<Object>;
+  disableNoiseCancellationPlugin(data: Object): Promise<Object>;
+  isNoiseCancellationPluginEnabled(data: Object): Promise<Object>;
+  isNoiseCancellationPluginAvailable(data: Object): Promise<Object>;
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 18. Video plugin (virtual background, filters)
+  // Platform: iOS only. Android delegates to the separate
+  // @100mslive/react-native-video-plugin package.
+  // ─────────────────────────────────────────────────────────────────────
+
+  enableVideoPlugin(data: Object): Promise<Object>; // iOS only
+  disableVideoPlugin(data: Object): Promise<Object>; // iOS only
+  changeVirtualBackground(data: Object): Promise<Object>; // iOS only
+  setVideoFilterParameter(data: Object): Promise<Object>; // iOS only
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 19. Misc / system / config
+  // ─────────────────────────────────────────────────────────────────────
+
+  enableEvent(data: Object): Promise<Object>;
+  disableEvent(data: Object): Promise<Object>;
+  restrictData(data: Object): Promise<Object>;
+  getAuthTokenByRoomCode(data: Object): Promise<Object>;
+  getRoomLayout(data: Object): Promise<Object>;
+  setAlwaysScreenOn(data: Object): Promise<Object>;
+  hideSystemBars(): void; // Android only
+  showSystemBars(): void; // Android only
+  setPermissionsAccepted(data: Object): Promise<Object>; // Android only
+  checkNotifications(): Promise<Object>; // Android only
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 20. Synchronous methods
+  // These bypass the Promise queue and run on the JS thread directly.
+  // Codegen syntax: non-Promise return type signals sync.
+  // ─────────────────────────────────────────────────────────────────────
+
+  // Cross-platform sync methods (iOS + Android)
+  getPeerProperty(data: Object): Object;
+  getRoomProperty(data: Object): Object;
+  getPeerListIterator(data: Object): Object;
+
+  // Android-only sync methods
+  setSoftInputMode(inputMode: number): number; // Android only
+  getSoftInputMode(): number; // Android only
+
+  // ─────────────────────────────────────────────────────────────────────
+  // 21. Events — DEFERRED TO PHASE 2
+  //
+  // RN 0.77 (our current peer-dep floor) does NOT export the typed
+  // `EventEmitter<TPayload>` symbol from
+  // `react-native/Libraries/Types/CodegenTypes`; that's a 0.82+ feature.
+  //
+  // For Phase 1, events continue to flow through legacy `RCTEventEmitter`
+  // (iOS) / `DeviceEventEmitter` (Android) exactly as they do today —
+  // unchanged at runtime. They are NOT declared in this spec.
+  //
+  // When we bump the RN peer-dep floor to 0.82+ (likely as part of the
+  // Phase 4 legacy-paper drop), Phase 2 will add typed event
+  // declarations here. The 28-event inventory has been catalogued
+  // separately in the migration plan doc — no information is lost by
+  // not declaring them here today.
+  //
+  // The 28 events to add later (24 cross-platform + 4 platform-specific):
+  //   onPreview, onJoin, onRoomUpdate, onPeerUpdate (string value '3'),
+  //   onPeerListUpdated, onTrackUpdate, onRoleChangeRequest,
+  //   onChangeTrackStateRequest, onRemovedFromRoom, onError, onMessage,
+  //   onSpeaker, onReconnecting, onReconnected, onRtcStats,
+  //   onLocalAudioStats, onLocalVideoStats, onRemoteAudioStats,
+  //   onRemoteVideoStats, onSessionStoreAvailable,
+  //   onSessionStoreChanged, onTranscripts, onPollUpdate,
+  //   onWhiteboardUpdate, onAudioDeviceChanged (Android),
+  //   onPermissionsRequested (Android), onPipModeChanged,
+  //   onPipRoomLeave (Android).
+  // ─────────────────────────────────────────────────────────────────────
+}
+
+// DO NOT DELETE this default export even if it appears unused at JS runtime.
+// React Native's Codegen statically parses this exact call shape at build time
+// to extract the module name ('HMSManager') and emit the matching native
+// abstract class (NativeHMSManagerSpec). Removing it fails Codegen with
+// `UnusedModuleInterfaceParserError`.
+export default TurboModuleRegistry.getEnforcing<Spec>('HMSManager');