Skip to content
Roomful is in public beta — install with the @beta tag. Share feedback →

Interface: RoomfulYjsProvider

@roomful/core


@roomful/core / RoomfulYjsProvider

Defined in: packages/core/src/types.ts:575

Exposes the Yjs document and provider used by CRDT state synchronization.

readonly awareness: Awareness

Defined in: packages/core/src/types.ts:584

Exposes the Yjs awareness instance.


readonly doc: Doc

Defined in: packages/core/src/types.ts:579

Exposes the shared Yjs document.


readonly status: RoomfulYjsProviderStatus

Defined in: packages/core/src/types.ts:594

Reports the provider connection status.


readonly synced: boolean

Defined in: packages/core/src/types.ts:589

Indicates whether the provider has completed an initial sync.

connect(): Promise<void>

Defined in: packages/core/src/types.ts:601

Opens the provider connection.

Promise<void>

A promise that resolves when the provider has started connecting.


destroy(): Promise<void>

Defined in: packages/core/src/types.ts:615

Destroys the provider and releases resources.

Promise<void>

A promise that resolves when teardown finishes.


disconnect(): Promise<void>

Defined in: packages/core/src/types.ts:608

Closes the provider connection.

Promise<void>

A promise that resolves when disconnect teardown finishes.


off<TEvent>(event, cb): void

Defined in: packages/core/src/types.ts:638

Removes a provider lifecycle listener.

TEvent extends keyof RoomfulYjsProviderEventMap

The provider event name being removed.

TEvent

The provider event name to unsubscribe from.

RoomfulYjsProviderEventHandler<TEvent>

The callback to remove.

void

Nothing.


on<TEvent>(event, cb): Unsubscribe

Defined in: packages/core/src/types.ts:625

Subscribes to provider lifecycle events.

TEvent extends keyof RoomfulYjsProviderEventMap

The provider event name to subscribe to.

TEvent

The provider event name to observe.

RoomfulYjsProviderEventHandler<TEvent>

The callback invoked with the matching payload.

Unsubscribe

A function that removes the listener.