Interface: RoomfulOptions\<TPresence\>

@roomful/svelte

---

@roomful/svelte / RoomfulOptions

Interface: RoomfulOptions<TPresence>

Defined in: packages/svelte/src/index.ts:807

Configures the Svelte adapter.

Extends

• RoomOptions<TPresence>

Type Parameters

TPresence

TPresence extends PresenceData = PresenceData

The room presence shape inferred from presence.

Properties

activity?

optional activity: ActivityOptions

Defined in: packages/svelte/src/index.ts:813

Configures the activity feed (entry cap).

---

agentApprovals?

optional agentApprovals: AgentApprovalOptions

Defined in: packages/svelte/src/index.ts:818

Configures the agent-approval workflow (who may decide proposals).

---

comments?

optional comments: CommentsOptions

Defined in: packages/svelte/src/index.ts:823

Configures the comments store’s storage backend.

---

debug?

optional debug: boolean | DebugOptions

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

Enables broad debug logging or fine-grained debug flags.

Inherited from

RoomOptions.debug

---

encryption?

optional encryption: EncryptionOptions

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

Enables payload encryption.

Inherited from

RoomOptions.encryption

---

ephemeral?

optional ephemeral: number | boolean

Defined in: packages/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.

Inherited from

RoomOptions.ephemeral

---

history?

optional history: HistoryOptions

Defined in: packages/svelte/src/index.ts:828

Configures the history store (timeline cap and capture debounce).

---

maxPeers?

optional maxPeers: number

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

Caps the number of peers allowed in the room.

Inherited from

RoomOptions.maxPeers

---

onConnect()?

optional onConnect: () => void

Defined in: packages/svelte/src/index.ts:833

Runs after the room connects.

Returns

void

---

onDisconnect()?

optional onDisconnect: (payload) => void

Defined in: packages/svelte/src/index.ts:838

Runs after the room disconnects.

Parameters

payload

reason?

string

Returns

void

---

onError()?

optional onError: (error) => void

Defined in: packages/svelte/src/index.ts:843

Runs when the room emits an operational error.

Parameters

error

RoomfulError

Returns

void

---

presence?

optional presence: Partial<TPresence>

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

Seeds the initial local presence payload.

Inherited from

RoomOptions.presence

---

reconnect?

optional reconnect: boolean | ReconnectOptions

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

Enables reconnect behavior or custom reconnect timing.

Inherited from

RoomOptions.reconnect

---

relayAuth?

optional relayAuth: RelayAuthToken

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

Supplies relay authentication as a token or async token factory.

Inherited from

RoomOptions.relayAuth

---

relayUrl?

optional relayUrl: string

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

Overrides the relay URL used for signaling and fallback transports.

Inherited from

RoomOptions.relayUrl

---

stunUrls?

optional stunUrls: string[]

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

Supplies custom STUN server URLs for WebRTC sessions.

Inherited from

RoomOptions.stunUrls

---

transport?

optional transport: TransportMode

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

Selects the preferred transport strategy.

Inherited from

RoomOptions.transport

---

webrtc?

optional webrtc: WebRTCOptions

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

Configures WebRTC-specific behavior.

Inherited from

RoomOptions.webrtc

---

websocket?

optional websocket: WebSocketOptions

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

Configures WebSocket-specific behavior.

Inherited from

RoomOptions.websocket