@liveblocks/react 0.17.11-debug2 → 0.18.0-beta1

package/.built-by-link-script

@@ -1 +1 @@
-7a145c07616c7ce057d49178c31d7436fb2ab297
+82a138d642402a9a15f754de8f42105c6724d0b0

package/index.d.ts

@@ -1,27 +1,43 @@
-import { Client, JsonObject, LsonObject, BaseUserMeta, Json, Room, BroadcastOptions, History, Others, User, LiveObject, Lson, LiveList, LiveMap } from '@liveblocks/client';
-export { Json, JsonObject } from '@liveblocks/client';
 import * as React from 'react';
-import { Resolve, RoomInitializers } from '@liveblocks/client/internal';
+import { ReactElement, ReactNode } from 'react';
+import { JsonObject, LsonObject, LiveObject, BaseUserMeta, Json, Client, Room, BroadcastOptions, History, Others, User } from '@liveblocks/client';
+export { Json, JsonObject, shallow } from '@liveblocks/client';
+import { ToImmutable, Resolve, RoomInitializers } from '@liveblocks/client/internal';
 
-declare type LiveblocksProviderProps = {
-    children: React.ReactNode;
-    client: Client;
+declare type Props = {
+    fallback: NonNullable<ReactNode> | null;
+    children: () => ReactNode | undefined;
 };
 /**
- * Makes the Liveblocks client available in the component hierarchy below.
+ * Almost like a normal <Suspense> component, except that for server-side
+ * renders, the fallback will be used.
+ *
+ * The child props will have to be provided in a function, i.e. change:
+ *
+ *   <Suspense fallback={<Loading />}>
+ *     <MyRealComponent a={1} />
+ *   </Suspense>
+ *
+ * To:
+ *
+ *   <ClientSideSuspense fallback={<Loading />}>
+ *     {() => <MyRealComponent a={1} />}
+ *   </ClientSideSuspense>
  *
- * @deprecated LiveblocksProvider is no longer needed in your component tree if
- * you set up your Liveblocks context using `createRoomContext()`. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for
- * details.
  */
-declare function LiveblocksProvider(props: LiveblocksProviderProps): JSX.Element;
+declare function ClientSideSuspense(props: Props): ReactElement;
+
 /**
- * Returns the Client of the nearest LiveblocksProvider above in the React
- * component tree.
+ * For any function type, returns a similar function type, but without the
+ * first argument.
  */
-declare function useClient(): Client;
-
+declare type OmitFirstArg<F> = F extends (first: any, ...rest: infer A) => infer R ? (...args: A) => R : never;
+declare type MutationContext<TPresence extends JsonObject, TStorage extends LsonObject> = {
+    root: LiveObject<TStorage>;
+    setMyPresence: (patch: Partial<TPresence>, options?: {
+        addToHistory: boolean;
+    }) => void;
+};
 declare type RoomProviderProps<TPresence extends JsonObject, TStorage extends LsonObject> = Resolve<{
     /**
      * The id of the room you want to connect to
@@ -131,6 +147,33 @@ declare type RoomContextBundle<TPresence extends JsonObject, TStorage extends Ls
      * const object = useObject("obj");
      */
     useObject<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey] | null;
+    /**
+     * Returns your entire Liveblocks Storage as an immutable data structure.
+     *
+     * @example
+     * const root = useStorage();
+     */
+    useStorage(): ToImmutable<TStorage> | null;
+    /**
+     * Extract arbitrary data from the Liveblocks Storage state, using an
+     * arbitrary selector function.
+     *
+     * The selector function will get re-evaluated any time something changes in
+     * Storage. The value returned by your selector function will also be the
+     * value returned by the hook.
+     *
+     * The `root` value that gets passed to your selector function is
+     * a immutable/readonly version of your Liveblocks storage root.
+     *
+     * The component that uses this hook will automatically re-render if the
+     * returned value changes.
+     *
+     * By default `useStorage()` uses strict `===` to check for equality. Take
+     * extra care when returning a computed object or list, for example when you
+     * return the result of a .map() or .filter() call from the selector. In
+     * those cases, you'll probably want to use a `shallow` comparison check.
+     */
+    useStorage<T>(selector: (root: ToImmutable<TStorage>) => T, isEqual?: (a: T, b: T) => boolean): T | null;
     /**
      * Returns the presence of the current user of the current room, and a function to update it.
      * It is different from the setState function returned by the useState hook from React.
@@ -145,263 +188,195 @@ declare type RoomContextBundle<TPresence extends JsonObject, TStorage extends Ls
      */
     useMyPresence(): [
         TPresence,
-        (overrides: Partial<TPresence>, options?: {
+        (patch: Partial<TPresence>, options?: {
             addToHistory: boolean;
         }) => void
     ];
     /**
-     * Returns an object that lets you get information about all the the users currently connected in the room.
+     * Returns an object that lets you get information about all the users
+     * currently connected in the room.
      *
      * @example
      * const others = useOthers();
      *
      * // Example to map all cursors in JSX
-     * {
-     *   others.map((user) => {
-     *     if (user.presence?.cursor == null) {
-     *       return null;
-     *     }
-     *     return <Cursor key={user.connectionId} cursor={user.presence.cursor} />
-     *   })
-     * }
+     * return (
+     *   <>
+     *     {others.map((user) => {
+     *        if (user.presence.cursor == null) {
+     *          return null;
+     *        }
+     *        return <Cursor key={user.connectionId} cursor={user.presence.cursor} />
+     *      })}
+     *   </>
+     * )
      */
     useOthers(): Others<TPresence, TUserMeta>;
     /**
-     * Returns the Room of the nearest RoomProvider above in the React component
-     * tree.
-     */
-    useRoom(): Room<TPresence, TStorage, TUserMeta, TRoomEvent>;
-    /**
-     * Gets the current user once it is connected to the room.
+     * Extract arbitrary data based on all the users currently connected in the
+     * room (except yourself).
+     *
+     * The selector function will get re-evaluated any time a user enters or
+     * leaves the room, as well as whenever their presence data changes.
+     *
+     * The component that uses this hook will automatically re-render if your
+     * selector function returns a different value from its previous run.
+     *
+     * By default `useOthers()` uses strict `===` to check for equality. Take
+     * extra care when returning a computed object or list, for example when you
+     * return the result of a .map() or .filter() call from the selector. In
+     * those cases, you'll probably want to use a `shallow` comparison check.
      *
      * @example
-     * const user = useSelf();
+     * const avatars = useOthers(users => users.map(u => u.info.avatar), shallow);
+     * const cursors = useOthers(users => users.map(u => u.presence.cursor), shallow);
+     * const someoneIsTyping = useOthers(users => users.some(u => u.presence.isTyping));
+     *
      */
-    useSelf(): User<TPresence, TUserMeta> | null;
+    useOthers<T>(selector: (others: Others<TPresence, TUserMeta>) => T, isEqual?: (a: T, b: T) => boolean): T;
     /**
-     * Returns the LiveObject instance that is the root of your entire Liveblocks
-     * Storage.
+     * Related to useOthers(), but optimized for selecting only "subsets" of
+     * others. This is useful for performance reasons in particular, because
+     * selecting only a subset of users also means limiting the number of
+     * re-renders that will be triggered.
+     *
+     * Note that there are two ways to use this hook, and depending on how you
+     * call it, the return value will be slightly different.
      *
      * @example
-     * const [root] = useStorageRoot();
-     */
-    useStorageRoot(): [root: LiveObject<TStorage> | null];
-    /**
-     * @deprecated In the next major version, we're changing the meaning of `useStorage()`.
-     * Please use `useStorageRoot()` instead for the current behavior.
+     * const ids = useOtherIds();
+     * //    ^^^ number[]
      */
-    useStorage(): [root: LiveObject<TStorage> | null];
+    useOtherIds(): readonly number[];
     /**
-     * useUpdateMyPresence is similar to useMyPresence but it only returns the function to update the current user presence.
-     * If you don't use the current user presence in your component, but you need to update it (e.g. live cursor), it's better to use useUpdateMyPresence to avoid unnecessary renders.
+     * Related to useOthers(), but optimized for selecting only "subsets" of
+     * others. This is useful for performance reasons in particular, because
+     * selecting only a subset of users also means limiting the number of
+     * re-renders that will be triggered.
+     *
+     * Note that there are two ways to use this hook, and depending on how you
+     * call it, the return value will be slightly different.
      *
      * @example
-     * const updateMyPresence = useUpdateMyPresence();
-     * updateMyPresence({ x: 0 });
-     * updateMyPresence({ y: 0 });
+     * const avatars = useOtherIds(user => user.info.avatar);
+     * //    ^^^^^^^
+     * //    { connectionId: number; data: string }[]
      *
-     * // At the next render, the presence of the current user will be equal to "{ x: 0, y: 0 }"
+     * The selector function you pass to useOtherIds() is called an "item
+     * selector", and operates on a single user at a time. If you provide an
+     * (optional) comparison function, it will also work on the _item_ level.
+     *
+     * For example, to select multiple properties:
+     *
+     * @example
+     * const avatarsAndCursors = useOtherIds(
+     *   user => [u.info.avatar, u.presence.cursor],
+     *   shallow,  // ❗️
+     * );
      */
-    useUpdateMyPresence(): (overrides: Partial<TPresence>, options?: {
-        addToHistory: boolean;
-    }) => void;
+    useOtherIds<T>(itemSelector: (other: User<TPresence, TUserMeta>) => T, isEqual?: (a: T, b: T) => boolean): readonly {
+        readonly connectionId: number;
+        readonly data: T;
+    }[];
     /**
-     * Returns the LiveList associated with the provided key.
-     * The hook triggers a re-render if the LiveList is updated, however it does not triggers a re-render if a nested CRDT is updated.
+     * Given a connection ID (as obtained by using `useOtherIds()`), you can call
+     * this selector deep down in your component stack to only have the component
+     * re-render if properties for this particular connection change.
      *
-     * @param key The storage key associated with the LiveList
-     * @returns null while the storage is loading, otherwise, returns the LiveList associated to the storage
+     * @example
+     * // Returns full user and re-renders whenever anything on the user changes
+     * const secondUser = useOther(2);
+     */
+    useOther(connectionId: number): User<TPresence, TUserMeta>;
+    /**
+     * Given a connection ID (as obtained by using `useOtherIds()`), you can call
+     * this selector deep down in your component stack to only have the component
+     * re-render if properties for this particular connection change.
      *
      * @example
-     * const animals = useList("animals");  // e.g. [] or ["🦁", "🐍", "🦍"]
+     * // Returns only the selected values re-renders whenever that selection changes)
+     * const { x, y } = useOther(2, user => user.presence.cursor);
      */
-    useList_deprecated<TValue extends Lson>(key: string): LiveList<TValue> | null;
+    useOther<T>(connectionId: number, selector: (other: User<TPresence, TUserMeta>) => T, isEqual?: (a: T, b: T) => boolean): T;
     /**
-     * @deprecated We no longer recommend initializing the
-     * items from the useList() hook. For details, see https://bit.ly/3Niy5aP.
+     * Returns the Room of the nearest RoomProvider above in the React component
+     * tree.
      */
-    useList_deprecated<TValue extends Lson>(key: string, items: TValue[]): LiveList<TValue> | null;
+    useRoom(): Room<TPresence, TStorage, TUserMeta, TRoomEvent>;
     /**
-     * Returns the LiveMap associated with the provided key. If the LiveMap does not exist, a new empty LiveMap will be created.
-     * The hook triggers a re-render if the LiveMap is updated, however it does not triggers a re-render if a nested CRDT is updated.
-     *
-     * @param key The storage key associated with the LiveMap
-     * @returns null while the storage is loading, otherwise, returns the LiveMap associated to the storage
+     * Gets the current user once it is connected to the room.
      *
      * @example
-     * const shapesById = useMap("shapes");
+     * const me = useSelf();
+     * const { x, y } = me.presence.cursor;
      */
-    useMap_deprecated<TKey extends string, TValue extends Lson>(key: string): LiveMap<TKey, TValue> | null;
+    useSelf(): User<TPresence, TUserMeta> | null;
     /**
-     * @deprecated We no longer recommend initializing the
-     * entries from the useMap() hook. For details, see https://bit.ly/3Niy5aP.
+     * Extract arbitrary data based on the current user.
+     *
+     * The selector function will get re-evaluated any time your presence data
+     * changes.
+     *
+     * The component that uses this hook will automatically re-render if your
+     * selector function returns a different value from its previous run.
+     *
+     * By default `useSelf()` uses strict `===` to check for equality. Take extra
+     * care when returning a computed object or list, for example when you return
+     * the result of a .map() or .filter() call from the selector. In those
+     * cases, you'll probably want to use a `shallow` comparison check.
+     *
+     * Will return `null` while Liveblocks isn't connected to a room yet.
+     *
+     * @example
+     * const cursor = useSelf(me => me.presence.cursor);
+     * if (cursor !== null) {
+     *   const { x, y } = cursor;
+     * }
+     *
      */
-    useMap_deprecated<TKey extends string, TValue extends Lson>(key: string, entries: readonly (readonly [TKey, TValue])[] | null): LiveMap<TKey, TValue> | null;
+    useSelf<T>(selector: (me: User<TPresence, TUserMeta>) => T, isEqual?: (a: T, b: T) => boolean): T | null;
     /**
-     * Returns the LiveObject associated with the provided key.
-     * The hook triggers a re-render if the LiveObject is updated, however it does not triggers a re-render if a nested CRDT is updated.
-     *
-     * @param key The storage key associated with the LiveObject
-     * @returns null while the storage is loading, otherwise, returns the LveObject associated to the storage
+     * Returns the mutable (!) Storage root. This hook exists for
+     * backward-compatible reasons.
      *
      * @example
-     * const object = useObject("obj");
+     * const [root] = useStorageRoot();
      */
-    useObject_deprecated<TData extends LsonObject>(key: string): LiveObject<TData> | null;
+    useStorageRoot(): [root: LiveObject<TStorage> | null];
     /**
-     * @deprecated We no longer recommend initializing the fields from the
-     * useObject() hook. For details, see https://bit.ly/3Niy5aP.
+     * useUpdateMyPresence is similar to useMyPresence but it only returns the function to update the current user presence.
+     * If you don't use the current user presence in your component, but you need to update it (e.g. live cursor), it's better to use useUpdateMyPresence to avoid unnecessary renders.
+     *
+     * @example
+     * const updateMyPresence = useUpdateMyPresence();
+     * updateMyPresence({ x: 0 });
+     * updateMyPresence({ y: 0 });
+     *
+     * // At the next render, the presence of the current user will be equal to "{ x: 0, y: 0 }"
      */
-    useObject_deprecated<TData extends LsonObject>(key: string, initialData: TData): LiveObject<TData> | null;
+    useUpdateMyPresence(): (patch: Partial<TPresence>, options?: {
+        addToHistory: boolean;
+    }) => void;
+    useMutation<F extends (context: MutationContext<TPresence, TStorage>, ...args: any[]) => any>(callback: F, deps?: unknown[]): OmitFirstArg<F>;
+    suspense: {
+        useStorage(): ToImmutable<TStorage>;
+        useStorage<T>(selector: (root: ToImmutable<TStorage>) => T, isEqual?: (a: T, b: T) => boolean): T;
+        useSelf(): User<TPresence, TUserMeta>;
+        useSelf<T>(selector: (me: User<TPresence, TUserMeta>) => T, isEqual?: (a: T, b: T) => boolean): T;
+        useOthers(): Others<TPresence, TUserMeta>;
+        useOthers<T>(selector: (others: Others<TPresence, TUserMeta>) => T, isEqual?: (a: T, b: T) => boolean): T;
+        useOtherIds(): readonly number[];
+        useOtherIds<T>(itemSelector: (other: User<TPresence, TUserMeta>) => T, isEqual?: (a: T, b: T) => boolean): readonly {
+            readonly connectionId: number;
+            readonly data: T;
+        }[];
+        useOther(connectionId: number): User<TPresence, TUserMeta>;
+        useOther<T>(connectionId: number, selector: (other: User<TPresence, TUserMeta>) => T, isEqual?: (a: T, b: T) => boolean): T;
+        useList<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey];
+        useMap<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey];
+        useObject<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey];
+    };
 };
 declare function createRoomContext<TPresence extends JsonObject, TStorage extends LsonObject = LsonObject, TUserMeta extends BaseUserMeta = BaseUserMeta, TRoomEvent extends Json = never>(client: Client): RoomContextBundle<TPresence, TStorage, TUserMeta, TRoomEvent>;
 
-/**
- * NOTE:
- * This file is AUTOGENERATED!
- *
- * Do not update it manually.
- */
-
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `RoomProvider` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function RoomProvider<TPresence extends JsonObject, TStorage extends LsonObject>(props: RoomProviderProps<TPresence, TStorage>): JSX.Element;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useBatch` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useBatch(): (callback: () => void) => void;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useBroadcastEvent` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useBroadcastEvent<TRoomEvent extends Json>(): (event: TRoomEvent, options?: BroadcastOptions) => void;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useErrorListener` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useErrorListener(callback: (err: Error) => void): void;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useEventListener` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useEventListener<TRoomEvent extends Json>(callback: (eventData: {
-    connectionId: number;
-    event: TRoomEvent;
-}) => void): void;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useHistory` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useHistory(): History;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useMyPresence` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useMyPresence<TPresence extends JsonObject>(): [
-    TPresence,
-    (overrides: Partial<TPresence>, options?: {
-        addToHistory: boolean;
-    }) => void
-];
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useOthers` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useOthers<TPresence extends JsonObject, TUserMeta extends BaseUserMeta>(): Others<TPresence, TUserMeta>;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useRedo` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useRedo(): () => void;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useRoom` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useRoom<TPresence extends JsonObject, TStorage extends LsonObject, TUserMeta extends BaseUserMeta, TRoomEvent extends Json>(): Room<TPresence, TStorage, TUserMeta, TRoomEvent>;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useSelf` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useSelf<TPresence extends JsonObject, TUserMeta extends BaseUserMeta>(): User<TPresence, TUserMeta> | null;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useStorageRoot` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useStorageRoot<TStorage extends LsonObject>(): [
-    root: LiveObject<TStorage> | null
-];
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useStorage` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useStorage<TStorage extends LsonObject>(): [
-    root: LiveObject<TStorage> | null
-];
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useUndo` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useUndo(): () => void;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useUpdateMyPresence` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useUpdateMyPresence<TPresence extends JsonObject>(): (overrides: Partial<TPresence>, options?: {
-    addToHistory: boolean;
-}) => void;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useList` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useList<TValue extends Lson>(key: string): LiveList<TValue> | null;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useList` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useList<TValue extends Lson>(key: string, items: TValue[]): LiveList<TValue> | null;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useMap` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useMap<TKey extends string, TValue extends Lson>(key: string): LiveMap<TKey, TValue> | null;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useMap` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useMap<TKey extends string, TValue extends Lson>(key: string, entries: readonly (readonly [TKey, TValue])[] | null): LiveMap<TKey, TValue> | null;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useObject` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useObject<TData extends LsonObject>(key: string): LiveObject<TData> | null;
-/**
- * @deprecated Please use `createRoomContext()` instead of importing
- * `useObject` from `@liveblocks/react` directly. See
- * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
- */
-declare function useObject<TData extends LsonObject>(key: string, initialData: TData): LiveObject<TData> | null;
-
-export { LiveblocksProvider, RoomProvider, createRoomContext, useBatch, useBroadcastEvent, useClient, useErrorListener, useEventListener, useHistory, useList, useMap, useMyPresence, useObject, useOthers, useRedo, useRoom, useSelf, useStorage, useStorageRoot, useUndo, useUpdateMyPresence };
+export { ClientSideSuspense, MutationContext, createRoomContext };