@microsoft/live-share-react 2.0.0-internal.17 → 2.0.0-internal.19

package/bin/live-hooks/useLiveEvent.js

@@ -1,108 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { LiveEventEvents, LiveEvent, LiveDataObjectInitializeState, } from "@microsoft/live-share";
-import React from "react";
-import { useDynamicDDS } from "../shared-hooks";
-import { ActionContainerNotJoinedError, ActionLiveDataObjectInitializedError, ActionLiveDataObjectUndefinedError, } from "../internal";
-import { useFluidObjectsContext } from "../providers";
-/**
- * React hook for using a Live Share `LiveEvent`.
- *
- * @remarks
- * Use this hook if you want to send transient JSON objects to everyone connected to the Fluid container,
- * such as when sending push notifications or reactions.
- * This hook can only be used in a child component of `<LiveShareProvider>` or `<AzureProvider>`.
- *
- * @template TEvent Optional typing for events sent & received. Default is `object` type.
- * @param uniqueKey the unique key for the `LiveEvent`. If one does not yet exist, a new one
- * will be created, otherwise it will use the existing one.
- * @param allowedRoles Optional. The meeting roles eligible to send events through this object.
- * @param onReceivedEvent Optional. Callback method to be called when a new notification is received.
- * @returns stateful `latestEvent` & `allEvents` list, `sendEvent` callback, and the `liveEvent` object.
- */
-export function useLiveEvent(uniqueKey, allowedRoles, onReceivedEvent) {
-    /**
-     * Stateful latest event (user facing) and its non-user-facing setter method.
-     */
-    const [latestEvent, setLatestReceived] = React.useState();
-    /**
-     * Reference for all received/sent events. The current value of this is user-facing. Because
-     * this is always set at the same time as latestEvent, it is effectively a stateful value.
-     */
-    const allEventsRef = React.useRef([]);
-    /**
-     * User facing: dynamically load the DDS for the given unique key.
-     */
-    const { dds: liveEvent } = useDynamicDDS(uniqueKey, (LiveEvent));
-    const { container } = useFluidObjectsContext();
-    /**
-     * User facing: callback to send event through `LiveEvent`
-     */
-    const sendEvent = React.useCallback((event) => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveEvent", "sendEvent");
-        }
-        if (liveEvent === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveEvent", "sendEvent");
-        }
-        if (!liveEvent.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveEvent", "sendEvent");
-        }
-        return yield liveEvent.send(event);
-    }), [container, liveEvent]);
-    /**
-     * Setup change listeners and start `LiveEvent` if needed
-     */
-    React.useEffect(() => {
-        if ((liveEvent === null || liveEvent === void 0 ? void 0 : liveEvent.isInitialized) === undefined)
-            return;
-        // Register event listener
-        const onEventReceived = (event, local, clientId, timestamp) => {
-            // If developer passed the optional onReceivedEvent callback, we
-            // call it.
-            onReceivedEvent === null || onReceivedEvent === void 0 ? void 0 : onReceivedEvent(event, local);
-            // Set the received event to our local state
-            const received = {
-                value: event,
-                local,
-                clientId,
-                timestamp,
-            };
-            allEventsRef.current = [...allEventsRef.current, received];
-            setLatestReceived(received);
-        };
-        // Reset the events list if it allEventRef.current is non-empty.
-        // This happens when the `id` a developer provides changes on the fly.
-        if (allEventsRef.current.length > 0) {
-            allEventsRef.current = [];
-            setLatestReceived(undefined);
-        }
-        liveEvent.on(LiveEventEvents.received, onEventReceived);
-        if (liveEvent.initializeState === LiveDataObjectInitializeState.needed) {
-            // Start live event
-            liveEvent.initialize(allowedRoles);
-        }
-        return () => {
-            // on unmount, remove event listeners
-            liveEvent === null || liveEvent === void 0 ? void 0 : liveEvent.off(LiveEventEvents.received, onEventReceived);
-        };
-    }, [liveEvent]);
-    return {
-        latestEvent,
-        allEvents: allEventsRef.current,
-        sendEvent,
-        liveEvent,
-    };
-}
-//# sourceMappingURL=useLiveEvent.js.map

package/bin/live-hooks/useLiveEvent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLiveEvent.js","sourceRoot":"","sources":["../../src/live-hooks/useLiveEvent.ts"],"names":[],"mappings":"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"}

package/bin/live-hooks/useLiveFollowMode.d.ts

@@ -1,24 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-import { UserMeetingRole } from "@microsoft/live-share";
-import { IUseLiveFollowModeResults } from "../types";
-/**
- * React hook for using a Live Share `LiveFollowMode`.
- *
- * @remarks
- * Use this hook if you want to add the ability to follow specific users or let a user present to everyone in the session.
- * Each user has their own `stateValue`, which is the value other users will reference when that user is presenting or being followed.
- * The `state` response includes the user's `value` that the local user is "following", whether it be their own or someone else's.
- * This hook can only be used in a child component of `<LiveShareProvider>` or `<AzureProvider>`.
- *
- * @template TData Optional typing for the custom user presence data object. Default is `object` type.
- *
- * @param uniqueKey The unique key for `LiveFollowMode`. If one does not yet exist, a new one will be created.
- * @param initialData The initial value for the local user's `stateValue`.
- * @param allowedRoles Optional. The user roles that are allowed to present to use `startPresenting()` or `stopPresenting()`.
- * @returns `IUseLiveFollowModeResults` results, which contains React stateful objects and callbacks.
- */
-export declare function useLiveFollowMode<TData = any>(uniqueKey: string, initialData: TData | (() => TData), allowedRoles?: UserMeetingRole[]): IUseLiveFollowModeResults<TData>;
-//# sourceMappingURL=useLiveFollowMode.d.ts.map

package/bin/live-hooks/useLiveFollowMode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLiveFollowMode.d.ts","sourceRoot":"","sources":["../../src/live-hooks/useLiveFollowMode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEH,eAAe,EAKlB,MAAM,uBAAuB,CAAC;AAS/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAG,GAAG,EACzC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,EAClC,YAAY,CAAC,EAAE,eAAe,EAAE,GACjC,yBAAyB,CAAC,KAAK,CAAC,CA2QlC"}

package/bin/live-hooks/useLiveFollowMode.js

@@ -1,211 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { LiveDataObjectInitializeState, LiveFollowMode, } from "@microsoft/live-share";
-import React from "react";
-import { useDynamicDDS } from "../shared-hooks";
-import { useFluidObjectsContext } from "../providers";
-import { ActionContainerNotJoinedError, ActionLiveDataObjectInitializedError, ActionLiveDataObjectUndefinedError, } from "../internal";
-/**
- * React hook for using a Live Share `LiveFollowMode`.
- *
- * @remarks
- * Use this hook if you want to add the ability to follow specific users or let a user present to everyone in the session.
- * Each user has their own `stateValue`, which is the value other users will reference when that user is presenting or being followed.
- * The `state` response includes the user's `value` that the local user is "following", whether it be their own or someone else's.
- * This hook can only be used in a child component of `<LiveShareProvider>` or `<AzureProvider>`.
- *
- * @template TData Optional typing for the custom user presence data object. Default is `object` type.
- *
- * @param uniqueKey The unique key for `LiveFollowMode`. If one does not yet exist, a new one will be created.
- * @param initialData The initial value for the local user's `stateValue`.
- * @param allowedRoles Optional. The user roles that are allowed to present to use `startPresenting()` or `stopPresenting()`.
- * @returns `IUseLiveFollowModeResults` results, which contains React stateful objects and callbacks.
- */
-export function useLiveFollowMode(uniqueKey, initialData, allowedRoles) {
-    /**
-     * Stateful follow state.
-     */
-    const [state, setState] = React.useState();
-    /**
-     * Stateful all user presence list and its non-user-facing setter method.
-     */
-    const [allUsers, setAllUsers] = React.useState([]);
-    /**
-     * User facing: dynamically load the DDS for the given unique key.
-     */
-    const { dds: liveFollowMode } = useDynamicDDS(uniqueKey, (LiveFollowMode));
-    /**
-     * User facing: list of non-local user's presence objects.
-     */
-    const otherUsers = allUsers.filter((user) => !user.isLocalUser);
-    /**
-     * User facing: local user's presence object.
-     */
-    const localUser = allUsers.find((user) => user.isLocalUser);
-    const { container } = useFluidObjectsContext();
-    /**
-     * User facing: callback to update the local user's custom data for their follow state.
-     */
-    const update = React.useCallback((stateValue) => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveFollowMode", "update");
-        }
-        if (liveFollowMode === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveFollowMode", "update");
-        }
-        if (!liveFollowMode.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveFollowMode", "update");
-        }
-        return yield liveFollowMode.update(stateValue);
-    }), [container, liveFollowMode]);
-    /**
-     * User facing: callback to start presenting.
-     */
-    const startPresenting = React.useCallback(() => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveFollowMode", "startPresenting");
-        }
-        if (liveFollowMode === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveFollowMode", "startPresenting");
-        }
-        if (!liveFollowMode.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveFollowMode", "startPresenting");
-        }
-        return yield liveFollowMode.startPresenting();
-    }), [container, liveFollowMode]);
-    /**
-     * User facing: callback to stop presenting.
-     */
-    const stopPresenting = React.useCallback(() => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveFollowMode", "stopPresenting");
-        }
-        if (liveFollowMode === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveFollowMode", "stopPresenting");
-        }
-        if (!liveFollowMode.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveFollowMode", "stopPresenting");
-        }
-        return yield liveFollowMode.stopPresenting();
-    }), [container, liveFollowMode]);
-    /**
-     * User facing: callback to suspend sync.
-     */
-    const beginSuspension = React.useCallback(() => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveFollowMode", "syncToPresenter");
-        }
-        if (liveFollowMode === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveFollowMode", "syncToPresenter");
-        }
-        if (!liveFollowMode.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveFollowMode", "syncToPresenter");
-        }
-        return yield liveFollowMode.beginSuspension();
-    }), [container, liveFollowMode]);
-    /**
-     * User facing: callback to end current suspension.
-     */
-    const endSuspension = React.useCallback(() => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveFollowMode", "syncToPresenter");
-        }
-        if (liveFollowMode === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveFollowMode", "syncToPresenter");
-        }
-        if (!liveFollowMode.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveFollowMode", "syncToPresenter");
-        }
-        return yield liveFollowMode.endSuspension();
-    }), [container, liveFollowMode]);
-    /**
-     * User facing: callback to follow a specific user.
-     */
-    const followUser = React.useCallback((userId) => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveFollowMode", "followUser");
-        }
-        if (liveFollowMode === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveFollowMode", "followUser");
-        }
-        if (!liveFollowMode.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveFollowMode", "followUser");
-        }
-        return yield liveFollowMode.followUser(userId);
-    }), [container, liveFollowMode]);
-    /**
-     * User facing: callback to stop following a user.
-     */
-    const stopFollowing = React.useCallback(() => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveFollowMode", "stopFollowing");
-        }
-        if (liveFollowMode === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveFollowMode", "stopFollowing");
-        }
-        if (!liveFollowMode.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveFollowMode", "stopFollowing");
-        }
-        return yield liveFollowMode.stopFollowing();
-    }), [container, liveFollowMode]);
-    /**
-     * Setup change listeners and start `LiveFollowMode` if needed
-     */
-    React.useEffect(() => {
-        if (liveFollowMode === undefined)
-            return;
-        const onPresenceChanged = () => {
-            const updatedLocalUsers = [];
-            liveFollowMode === null || liveFollowMode === void 0 ? void 0 : liveFollowMode.getUsers().forEach((user) => {
-                updatedLocalUsers.push(user);
-            });
-            setAllUsers(updatedLocalUsers);
-        };
-        liveFollowMode.on("presenceChanged", onPresenceChanged);
-        const onStateChanged = () => {
-            setState(liveFollowMode === null || liveFollowMode === void 0 ? void 0 : liveFollowMode.state);
-        };
-        liveFollowMode.on("stateChanged", onStateChanged);
-        if (liveFollowMode.initializeState ===
-            LiveDataObjectInitializeState.needed) {
-            liveFollowMode.initialize(isInitialDataCallback(initialData)
-                ? initialData()
-                : initialData, allowedRoles);
-        }
-        onPresenceChanged();
-        onStateChanged();
-        return () => {
-            liveFollowMode === null || liveFollowMode === void 0 ? void 0 : liveFollowMode.off("presenceChanged", onPresenceChanged);
-            liveFollowMode === null || liveFollowMode === void 0 ? void 0 : liveFollowMode.off("stateChanged", onStateChanged);
-        };
-    }, [liveFollowMode]);
-    return {
-        state,
-        localUser,
-        otherUsers,
-        allUsers,
-        liveFollowMode,
-        update,
-        startPresenting,
-        stopPresenting,
-        beginSuspension,
-        endSuspension,
-        followUser,
-        stopFollowing,
-    };
-}
-function isInitialDataCallback(value) {
-    return typeof value === "function";
-}
-//# sourceMappingURL=useLiveFollowMode.js.map

package/bin/live-hooks/useLiveFollowMode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLiveFollowMode.js","sourceRoot":"","sources":["../../src/live-hooks/useLiveFollowMode.ts"],"names":[],"mappings":"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"}

package/bin/live-hooks/useLivePresence.d.ts

@@ -1,26 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-import { PresenceState, UserMeetingRole } from "@microsoft/live-share";
-import { IUseLivePresenceResults } from "../types";
-/**
- * React hook for using a Live Share `LivePresence`.
- *
- * @remarks
- * Use this hook if you want to track presence for who is currently using this component, such as
- * who is online or who is viewing a specific document. With presence, you can sent along any custom
- * user data. This is useful for rendering a list of users, profile pictures, cursor positions, and more.
- * This hook can only be used in a child component of `<LiveShareProvider>` or `<AzureProvider>`.
- *
- * @template TData Optional typing for the custom user presence data object. Default is `object` type.
- * @param uniqueKey The unique key for `LivePresence`. If one does not yet exist, a new one will be created.
- * @param initialData Optional. Initial presence data object for the user. Can be value or a function to get the value.
- * @param initialPresenceState Optional. Initial status of the user's presence. Default is online.
- * @param allowedRoles Optional. the user roles that are allowed to mutate the synchronized state
- * will be created, otherwise it will use the existing one. Default value is ":<dds-default>"
- * @returns stateful `localUser`, `otherUsers` list, and `allUsers` list. Also returns a callback method
- * to update the local user's presence and the `LivePresence` Fluid object.
- */
-export declare function useLivePresence<TData extends object = object>(uniqueKey: string, initialData?: TData | (() => TData) | undefined, initialPresenceState?: PresenceState, allowedRoles?: UserMeetingRole[]): IUseLivePresenceResults<TData>;
-//# sourceMappingURL=useLivePresence.d.ts.map

package/bin/live-hooks/useLivePresence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLivePresence.d.ts","sourceRoot":"","sources":["../../src/live-hooks/useLivePresence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEH,aAAa,EAEb,eAAe,EAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,uBAAuB,EAA8B,MAAM,UAAU,CAAC;AAS/E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACzD,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,GAAG,SAAS,EAC/C,oBAAoB,GAAE,aAAoC,EAC1D,YAAY,CAAC,EAAE,eAAe,EAAE,GACjC,uBAAuB,CAAC,KAAK,CAAC,CAgGhC"}

package/bin/live-hooks/useLivePresence.js

@@ -1,106 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { PresenceState, LivePresence, LiveDataObjectInitializeState, } from "@microsoft/live-share";
-import React from "react";
-import { useDynamicDDS } from "../shared-hooks";
-import { useFluidObjectsContext } from "../providers";
-import { ActionContainerNotJoinedError, ActionLiveDataObjectInitializedError, ActionLiveDataObjectUndefinedError, } from "../internal";
-/**
- * React hook for using a Live Share `LivePresence`.
- *
- * @remarks
- * Use this hook if you want to track presence for who is currently using this component, such as
- * who is online or who is viewing a specific document. With presence, you can sent along any custom
- * user data. This is useful for rendering a list of users, profile pictures, cursor positions, and more.
- * This hook can only be used in a child component of `<LiveShareProvider>` or `<AzureProvider>`.
- *
- * @template TData Optional typing for the custom user presence data object. Default is `object` type.
- * @param uniqueKey The unique key for `LivePresence`. If one does not yet exist, a new one will be created.
- * @param initialData Optional. Initial presence data object for the user. Can be value or a function to get the value.
- * @param initialPresenceState Optional. Initial status of the user's presence. Default is online.
- * @param allowedRoles Optional. the user roles that are allowed to mutate the synchronized state
- * will be created, otherwise it will use the existing one. Default value is ":<dds-default>"
- * @returns stateful `localUser`, `otherUsers` list, and `allUsers` list. Also returns a callback method
- * to update the local user's presence and the `LivePresence` Fluid object.
- */
-export function useLivePresence(uniqueKey, initialData, initialPresenceState = PresenceState.online, allowedRoles) {
-    /**
-     * Stateful all user presence list and its non-user-facing setter method.
-     */
-    const [allUsers, setAllUsers] = React.useState([]);
-    /**
-     * User facing: dynamically load the DDS for the given unique key.
-     */
-    const { dds: livePresence } = useDynamicDDS(uniqueKey, (LivePresence));
-    /**
-     * User facing: list of non-local user's presence objects.
-     */
-    const otherUsers = allUsers.filter((user) => !user.isLocalUser);
-    /**
-     * User facing: local user's presence object.
-     */
-    const localUser = allUsers.find((user) => user.isLocalUser);
-    const { container } = useFluidObjectsContext();
-    /**
-     * User facing: callback to update the local user's presence.
-     */
-    const updatePresence = React.useCallback((data, state) => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("livePresence", "updatePresence");
-        }
-        if (livePresence === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("livePresence", "updatePresence");
-        }
-        if (!livePresence.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("livePresence", "updatePresence");
-        }
-        return yield livePresence.update(data, state);
-    }), [container, livePresence]);
-    /**
-     * Setup change listeners and start `LivePresence` if needed
-     */
-    React.useEffect(() => {
-        if (livePresence === undefined)
-            return;
-        const onPresenceChanged = () => {
-            const updatedLocalUsers = [];
-            livePresence === null || livePresence === void 0 ? void 0 : livePresence.getUsers().forEach((user) => {
-                updatedLocalUsers.push(user);
-            });
-            setAllUsers(updatedLocalUsers);
-        };
-        livePresence.on("presenceChanged", onPresenceChanged);
-        if (livePresence.initializeState ===
-            LiveDataObjectInitializeState.needed) {
-            livePresence.initialize(isInitialDataCallback(initialData)
-                ? initialData()
-                : initialData, initialPresenceState, allowedRoles);
-        }
-        onPresenceChanged();
-        return () => {
-            livePresence === null || livePresence === void 0 ? void 0 : livePresence.off("presenceChanged", onPresenceChanged);
-        };
-    }, [livePresence]);
-    return {
-        localUser,
-        otherUsers,
-        allUsers,
-        livePresence,
-        updatePresence,
-    };
-}
-function isInitialDataCallback(value) {
-    return typeof value === "function";
-}
-//# sourceMappingURL=useLivePresence.js.map

package/bin/live-hooks/useLivePresence.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLivePresence.js","sourceRoot":"","sources":["../../src/live-hooks/useLivePresence.ts"],"names":[],"mappings":"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"}

package/bin/live-hooks/useLiveState.d.ts

@@ -1,21 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-import { LiveState, UserMeetingRole } from "@microsoft/live-share";
-import { SetLiveStateAction } from "../types";
-/**
- * React hook for using a Live Share `LiveState`.
- *
- * @remarks
- * Use this hook if you want to synchronize app state that will reset when all users leave the session.
- * This hook can only be used in a child component of `<LiveShareProvider>` or `<AzureProvider>`.
- *
- * @param uniqueKey the unique key for the `LiveEvent`. If one does not yet exist, a new one will be created, otherwise it will use the existing one.
- * @param initialState Optional. the initial state value of type TState
- * @param allowedRoles Optional. the user roles that are allowed to mutate the synchronized state
- * @returns ordered values: first value is the synchronized state value and the second is a setter to change the state value.
- * The setter returns a void promise, which will throw if the user does not have the required roles to set.
- */
-export declare function useLiveState<TState = any>(uniqueKey: string, initialState: TState, allowedRoles?: UserMeetingRole[]): [TState, SetLiveStateAction<TState>, LiveState<TState> | undefined];
-//# sourceMappingURL=useLiveState.d.ts.map

package/bin/live-hooks/useLiveState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLiveState.d.ts","sourceRoot":"","sources":["../../src/live-hooks/useLiveState.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEH,SAAS,EACT,eAAe,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAU9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAG,GAAG,EACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,eAAe,EAAE,GACjC,CAAC,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAwErE"}

package/bin/live-hooks/useLiveState.js

@@ -1,83 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { LiveDataObjectInitializeState, LiveState, } from "@microsoft/live-share";
-import React from "react";
-import { useDynamicDDS } from "../shared-hooks";
-import { useFluidObjectsContext } from "../providers";
-import { ActionContainerNotJoinedError, ActionLiveDataObjectInitializedError, ActionLiveDataObjectUndefinedError, isPrevStateCallback, } from "../internal";
-/**
- * React hook for using a Live Share `LiveState`.
- *
- * @remarks
- * Use this hook if you want to synchronize app state that will reset when all users leave the session.
- * This hook can only be used in a child component of `<LiveShareProvider>` or `<AzureProvider>`.
- *
- * @param uniqueKey the unique key for the `LiveEvent`. If one does not yet exist, a new one will be created, otherwise it will use the existing one.
- * @param initialState Optional. the initial state value of type TState
- * @param allowedRoles Optional. the user roles that are allowed to mutate the synchronized state
- * @returns ordered values: first value is the synchronized state value and the second is a setter to change the state value.
- * The setter returns a void promise, which will throw if the user does not have the required roles to set.
- */
-export function useLiveState(uniqueKey, initialState, allowedRoles) {
-    const [currentState, setCurrentState] = React.useState(initialState);
-    /**
-     * User facing: dynamically load the DDS for the given unique key.
-     */
-    const { dds: liveState } = useDynamicDDS(uniqueKey, (LiveState));
-    const { container } = useFluidObjectsContext();
-    /**
-     * Change state callback that is user facing
-     * @param state TState to set
-     * @returns void promise, which will throw if the user does not have the required roles
-     */
-    const setState = React.useCallback((state) => __awaiter(this, void 0, void 0, function* () {
-        if (!container) {
-            throw new ActionContainerNotJoinedError("liveState", "setState");
-        }
-        if (liveState === undefined) {
-            throw new ActionLiveDataObjectUndefinedError("liveState", "setState");
-        }
-        if (!liveState.isInitialized) {
-            throw new ActionLiveDataObjectInitializedError("liveState", "setState");
-        }
-        const valueToSet = isPrevStateCallback(state)
-            ? state(liveState.state)
-            : state;
-        return yield liveState.set(valueToSet);
-    }), [container, liveState]);
-    /**
-     * Setup change listeners and start `LiveState` if needed
-     */
-    React.useEffect(() => {
-        if (liveState === undefined)
-            return;
-        const onStateChanged = (state) => {
-            setCurrentState(state);
-        };
-        liveState.on("stateChanged", onStateChanged);
-        if (liveState.initializeState === LiveDataObjectInitializeState.needed) {
-            liveState
-                .initialize(initialState, allowedRoles)
-                .then(() => onStateChanged(liveState.state));
-        }
-        else {
-            onStateChanged(liveState.state);
-        }
-        return () => {
-            liveState === null || liveState === void 0 ? void 0 : liveState.off("stateChanged", onStateChanged);
-        };
-    }, [liveState]);
-    return [currentState, setState, liveState];
-}
-//# sourceMappingURL=useLiveState.js.map

package/bin/live-hooks/useLiveState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLiveState.js","sourceRoot":"","sources":["../../src/live-hooks/useLiveState.ts"],"names":[],"mappings":"AAAA;;;GAGG;;;;;;;;;;AAEH,OAAO,EACH,6BAA6B,EAC7B,SAAS,GAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACH,6BAA6B,EAC7B,oCAAoC,EACpC,kCAAkC,EAClC,mBAAmB,GACtB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CACxB,SAAiB,EACjB,YAAoB,EACpB,YAAgC;IAEhC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GACjC,KAAK,CAAC,QAAQ,CAAS,YAAY,CAAC,CAAC;IACzC;;OAEG;IACH,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,aAAa,CACpC,SAAS,EACT,CAAA,SAAiB,CAAA,CACpB,CAAC;IAEF,MAAM,EAAE,SAAS,EAAE,GAAG,sBAAsB,EAAE,CAAC;IAE/C;;;;OAIG;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAC9B,CAAO,KAA+C,EAAE,EAAE;QACtD,IAAI,CAAC,SAAS,EAAE;YACZ,MAAM,IAAI,6BAA6B,CACnC,WAAW,EACX,UAAU,CACb,CAAC;SACL;QACD,IAAI,SAAS,KAAK,SAAS,EAAE;YACzB,MAAM,IAAI,kCAAkC,CACxC,WAAW,EACX,UAAU,CACb,CAAC;SACL;QACD,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE;YAC1B,MAAM,IAAI,oCAAoC,CAC1C,WAAW,EACX,UAAU,CACb,CAAC;SACL;QACD,MAAM,UAAU,GAAG,mBAAmB,CAAS,KAAK,CAAC;YACjD,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;YACxB,CAAC,CAAC,KAAK,CAAC;QACZ,OAAO,MAAM,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC,CAAA,EACD,CAAC,SAAS,EAAE,SAAS,CAAC,CACzB,CAAC;IAEF;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO;QAEpC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE;YACrC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC;QACF,SAAS,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAC7C,IACI,SAAS,CAAC,eAAe,KAAK,6BAA6B,CAAC,MAAM,EACpE;YACE,SAAS;iBACJ,UAAU,CAAC,YAAY,EAAE,YAAY,CAAC;iBACtC,IAAI,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;SACpD;aAAM;YACH,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;SACnC;QAED,OAAO,GAAG,EAAE;YACR,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QACnD,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC"}