Skip to content

Interface: RoomfulProviderProps\<TPresence\>

@roomful/solid


@roomful/solid / RoomfulProviderProps

Interface: RoomfulProviderProps<TPresence>

Section titled “Interface: RoomfulProviderProps<TPresence>”

Defined in: solid/src/index.ts:91

Configures the Solid provider.

  • RoomOptions<TPresence>

TPresence extends PresenceData = PresenceData

The room presence shape inferred from presence.

optional children: Element

Defined in: solid/src/index.ts:102

Renders the provider subtree.


optional debug: boolean | DebugOptions

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

Enables broad debug logging or fine-grained debug flags.

RoomOptions.debug


optional encryption: EncryptionOptions

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

Enables payload encryption.

RoomOptions.encryption


optional ephemeral: number | boolean

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

Marks the room as ephemeral — no durable storage (state, comments, locks), and optionally disconnects after ttlMs. Pass true for no-persistence only, or a number for TTL in ms.

RoomOptions.ephemeral


optional maxPeers: number

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

Caps the number of peers allowed in the room.

RoomOptions.maxPeers


optional onConnect: () => void

Defined in: solid/src/index.ts:107

Runs after the room connects.

void


optional onDisconnect: (payload) => void

Defined in: solid/src/index.ts:112

Runs after the room disconnects.

string

void


optional onError: (error) => void

Defined in: solid/src/index.ts:117

Runs when the room emits an operational error.

RoomfulError

void


optional presence: Partial<TPresence>

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

Seeds the initial local presence payload.

RoomOptions.presence


optional reconnect: boolean | ReconnectOptions

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

Enables reconnect behavior or custom reconnect timing.

RoomOptions.reconnect


optional relayAuth: RelayAuthToken

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

Supplies relay authentication as a token or async token factory.

RoomOptions.relayAuth


optional relayUrl: string

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

Overrides the relay URL used for signaling and fallback transports.

RoomOptions.relayUrl


roomId: string

Defined in: solid/src/index.ts:97

Identifies the room to create or join.


optional stunUrls: string[]

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

Supplies custom STUN server URLs for WebRTC sessions.

RoomOptions.stunUrls


optional transport: TransportMode

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

Selects the preferred transport strategy.

RoomOptions.transport


optional webrtc: WebRTCOptions

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

Configures WebRTC-specific behavior.

RoomOptions.webrtc


optional websocket: WebSocketOptions

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

Configures WebSocket-specific behavior.

RoomOptions.websocket