Interface: RoomfulProviderProps\<TPresence\>

@roomful/react

---

@roomful/react / RoomfulProviderProps

Interface: RoomfulProviderProps<TPresence>

Defined in: react/src/index.ts:59

Configures the React provider.

Extends

• RoomOptions<TPresence>

Type Parameters

TPresence

TPresence extends PresenceData = PresenceData

The room presence shape inferred from presence.

Properties

children?

optional children: ReactNode

Defined in: react/src/index.ts:70

Renders the provider subtree.

---

debug?

optional debug: boolean | DebugOptions

Defined in: core/dist/types.d.ts:392

Enables broad debug logging or fine-grained debug flags.

Inherited from

RoomOptions.debug

---

encryption?

optional encryption: EncryptionOptions

Defined in: core/dist/types.d.ts:388

Enables payload encryption.

Inherited from

RoomOptions.encryption

---

maxPeers?

optional maxPeers: number

Defined in: core/dist/types.d.ts:360

Caps the number of peers allowed in the room.

Inherited from

RoomOptions.maxPeers

---

onConnect()?

optional onConnect: () => void

Defined in: react/src/index.ts:75

Runs after the room connects.

Returns

void

---

onDisconnect()?

optional onDisconnect: (payload) => void

Defined in: react/src/index.ts:80

Runs after the room disconnects.

Parameters

payload

reason?

string

Returns

void

---

onError()?

optional onError: (error) => void

Defined in: react/src/index.ts:85

Runs when the room emits an operational error.

Parameters

error

RoomfulError

Returns

void

---

presence?

optional presence: Partial<TPresence>

Defined in: core/dist/types.d.ts:356

Seeds the initial local presence payload.

Inherited from

RoomOptions.presence

---

reconnect?

optional reconnect: boolean | ReconnectOptions

Defined in: core/dist/types.d.ts:376

Enables reconnect behavior or custom reconnect timing.

Inherited from

RoomOptions.reconnect

---

relayAuth?

optional relayAuth: RelayAuthToken

Defined in: core/dist/types.d.ts:372

Supplies relay authentication as a token or async token factory.

Inherited from

RoomOptions.relayAuth

---

relayUrl?

optional relayUrl: string

Defined in: core/dist/types.d.ts:368

Overrides the relay URL used for signaling and fallback transports.

Inherited from

RoomOptions.relayUrl

---

roomId

roomId: string

Defined in: react/src/index.ts:65

Identifies the room to create or join.

---

stunUrls?

optional stunUrls: string[]

Defined in: core/dist/types.d.ts:364

Supplies custom STUN server URLs for WebRTC sessions.

Inherited from

RoomOptions.stunUrls

---

transport?

optional transport: TransportMode

Defined in: core/dist/types.d.ts:352

Selects the preferred transport strategy.

Inherited from

RoomOptions.transport

---

webrtc?

optional webrtc: WebRTCOptions

Defined in: core/dist/types.d.ts:380

Configures WebRTC-specific behavior.

Inherited from

RoomOptions.webrtc

---

websocket?

optional websocket: WebSocketOptions

Defined in: core/dist/types.d.ts:384

Configures WebSocket-specific behavior.

Inherited from

RoomOptions.websocket