@fishjam-cloud/react-client 0.19.0 → 0.20.0

package/dist/FishjamProvider.d.ts

@@ -33,6 +33,7 @@ export interface FishjamProviderProps extends PropsWithChildren {
      * Configure whether to use audio simulcast and which layers to send if so.
      */
     audioConfig?: StreamConfig;
+    fishjamId?: string;
 }
 /**
  * Provides the Fishjam Context

package/dist/FishjamProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FishjamProvider.d.ts","sourceRoot":"","sources":["../src/FishjamProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,OAAO,CAAC;AAiBhE,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI/F;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;IAC9D;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,yBAAyB,CAAC;IACxD;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3C;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CA+E1D"}
+{"version":3,"file":"FishjamProvider.d.ts","sourceRoot":"","sources":["../src/FishjamProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,OAAO,CAAC;AAkBhE,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI/F;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;IAC9D;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,yBAAyB,CAAC;IACxD;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3C;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;IAK3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CAiF1D"}

package/dist/FishjamProvider.js

@@ -4,6 +4,7 @@ import { useMemo, useRef } from "react";
 import { CameraContext } from "./contexts/camera";
 import { CustomSourceContext } from "./contexts/customSource";
 import { FishjamClientContext } from "./contexts/fishjamClient";
+import { FishjamIdContext } from "./contexts/fishjamId";
 import { FishjamClientStateContext } from "./contexts/fishjamState";
 import { InitDevicesContext } from "./contexts/initDevices";
 import { MicrophoneContext } from "./contexts/microphone";
@@ -65,5 +66,5 @@ export function FishjamProvider(props) {
         peerStatus,
     });
     const fishjamClientState = useFishjamClientState(fishjamClientRef.current);
-    return (_jsx(FishjamClientContext.Provider, { value: fishjamClientRef, children: _jsx(FishjamClientStateContext.Provider, { value: fishjamClientState, children: _jsx(InitDevicesContext.Provider, { value: initializeDevices, children: _jsx(PeerStatusContext.Provider, { value: peerStatus, children: _jsx(CameraContext.Provider, { value: cameraContext, children: _jsx(MicrophoneContext.Provider, { value: microphoneContext, children: _jsx(ScreenshareContext.Provider, { value: screenShareManager, children: _jsx(CustomSourceContext.Provider, { value: customSourceManager, children: props.children }) }) }) }) }) }) }) }));
+    return (_jsx(FishjamClientContext.Provider, { value: fishjamClientRef, children: _jsx(FishjamClientStateContext.Provider, { value: fishjamClientState, children: _jsx(FishjamIdContext.Provider, { value: props.fishjamId ?? null, children: _jsx(InitDevicesContext.Provider, { value: initializeDevices, children: _jsx(PeerStatusContext.Provider, { value: peerStatus, children: _jsx(CameraContext.Provider, { value: cameraContext, children: _jsx(MicrophoneContext.Provider, { value: microphoneContext, children: _jsx(ScreenshareContext.Provider, { value: screenShareManager, children: _jsx(CustomSourceContext.Provider, { value: customSourceManager, children: props.children }) }) }) }) }) }) }) }) }));
 }

package/dist/consts.d.ts

@@ -0,0 +1,5 @@
+export declare const FISHJAM_HTTP_CONNECT_URL = "https://fishjam.io/api/v1/connect";
+export declare const FISHJAM_WS_CONNECT_URL = "wss://fishjam.io/api/v1/connect";
+export declare const FISHJAM_WHIP_URL = "https://fishjam.io/api/v1/live/api/whip";
+export declare const FISHJAM_WHEP_URL = "https://fishjam.io/api/v1/live/api/whep";
+//# sourceMappingURL=consts.d.ts.map

package/dist/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,sCAAoC,CAAC;AAC1E,eAAO,MAAM,sBAAsB,oCAAkC,CAAC;AAItE,eAAO,MAAM,gBAAgB,4CAAiC,CAAC;AAC/D,eAAO,MAAM,gBAAgB,4CAAiC,CAAC"}

package/dist/consts.js

@@ -0,0 +1,7 @@
+const FISHJAM_URL_BASE = "fishjam.io/api/v1";
+const FISHJAM_CONNECT_PATH = `${FISHJAM_URL_BASE}/connect`;
+export const FISHJAM_HTTP_CONNECT_URL = `https://${FISHJAM_CONNECT_PATH}`;
+export const FISHJAM_WS_CONNECT_URL = `wss://${FISHJAM_CONNECT_PATH}`;
+const FISHJAM_LIVE_URL = `https://${FISHJAM_URL_BASE}/live`;
+export const FISHJAM_WHIP_URL = `${FISHJAM_LIVE_URL}/api/whip`;
+export const FISHJAM_WHEP_URL = `${FISHJAM_LIVE_URL}/api/whep`;

package/dist/contexts/fishjamId.d.ts

@@ -0,0 +1,2 @@
+export declare const FishjamIdContext: import("react").Context<string | null>;
+//# sourceMappingURL=fishjamId.d.ts.map

package/dist/contexts/fishjamId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fishjamId.d.ts","sourceRoot":"","sources":["../../src/contexts/fishjamId.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,wCAAqC,CAAC"}

package/dist/contexts/fishjamId.js

@@ -0,0 +1,2 @@
+import { createContext } from "react";
+export const FishjamIdContext = createContext(null);

package/dist/hooks/useConnection.d.ts

@@ -1,9 +1,9 @@
 import type { GenericMetadata } from "@fishjam-cloud/ts-client";
 export interface JoinRoomConfig<PeerMetadata extends GenericMetadata = GenericMetadata> {
     /**
-     * Fishjam URL
+     * Overrides the default url derived from the Fishjam ID passed to FishjamProvider
      */
-    url: string;
+    url?: string;
     /**
      * Token received from server (or Room Manager)
      */

package/dist/hooks/useConnection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useConnection.d.ts","sourceRoot":"","sources":["../../src/hooks/useConnection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAOhE,MAAM,WAAW,cAAc,CAAC,YAAY,SAAS,eAAe,GAAG,eAAe;IACpF;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,aAAa;IAuBzB;;OAEG;eAfF,YAAY,SAAS,eAAe,uDAIlC,cAAc,CAAC,YAAY,CAAC;IAa/B;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;EAGN"}
+{"version":3,"file":"useConnection.d.ts","sourceRoot":"","sources":["../../src/hooks/useConnection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAShE,MAAM,WAAW,cAAc,CAAC,YAAY,SAAS,eAAe,GAAG,eAAe;IACpF;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,aAAa;IAgCzB;;OAEG;eAvBF,YAAY,SAAS,eAAe,uDAIlC,cAAc,CAAC,YAAY,CAAC;IAqB/B;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;EAGN"}

package/dist/hooks/useConnection.js

@@ -1,5 +1,7 @@
 import { useCallback, useContext } from "react";
+import { FISHJAM_WS_CONNECT_URL } from "../consts";
 import { FishjamClientContext } from "../contexts/fishjamClient";
+import { FishjamIdContext } from "../contexts/fishjamId";
 import { PeerStatusContext } from "../contexts/peerStatus";
 import { useReconnection } from "./internal/useReconnection";
 /**
@@ -9,12 +11,19 @@ import { useReconnection } from "./internal/useReconnection";
  */
 export function useConnection() {
     const fishjamClientRef = useContext(FishjamClientContext);
+    const fishjamId = useContext(FishjamIdContext);
     if (!fishjamClientRef)
         throw Error("useConnection must be used within FishjamProvider");
     const peerStatus = useContext(PeerStatusContext);
     const client = fishjamClientRef.current;
     const reconnectionStatus = useReconnection();
-    const joinRoom = useCallback(({ url, peerToken, peerMetadata, }) => client.connect({ url, token: peerToken, peerMetadata: peerMetadata ?? {} }), [client]);
+    const joinRoom = useCallback(({ url, peerToken, peerMetadata, }) => {
+        if (!url && !fishjamId) {
+            throw Error(`You haven't passed your Fishjam ID to the FishjamProvider. You can get your Fishjam ID at https://fishjam.io/app`);
+        }
+        const connectUrl = `${FISHJAM_WS_CONNECT_URL}/${fishjamId}`;
+        return client.connect({ url: url ?? connectUrl, token: peerToken, peerMetadata: peerMetadata ?? {} });
+    }, [client, fishjamId]);
     const leaveRoom = useCallback(() => {
         client.disconnect();
     }, [client]);

package/dist/hooks/useLivestreamStreamer.d.ts

@@ -0,0 +1,40 @@
+import { LivestreamError } from "@fishjam-cloud/ts-client";
+/** @category Livestream */
+export type StreamerInputs = {
+    /** The video source to publish. e.g. `cameraStream` from {@link useCamera} or `stream` from {@link useScreenShare} */
+    video: MediaStream;
+    /** The audio source to publish. e.g. `microphoneStream` from {@link useMicrophone} or `stream` from {@link useScreenShare} */
+    audio?: MediaStream | null;
+} | {
+    video?: null;
+    audio: MediaStream;
+};
+/** @category Livestream */
+export type ConnectStreamerConfig = {
+    inputs: StreamerInputs;
+    /** Streamer token used to authenticate with Fishjam */
+    token: string;
+};
+/** @category Livestream */
+export interface UseLivestreamStreamerResult {
+    /**
+     * Callback used to start publishing the selected audio and video media streams.
+     *
+     * @remarks
+     * Calling {@link connect} multiple times will have the effect of only publishing the **last** specified inputs.
+     */
+    connect: (inputs: ConnectStreamerConfig, urlOverride?: string) => Promise<void>;
+    /** Callback to stop publishing anything previously published with {@link connect} */
+    disconnect: () => void;
+    /** Any errors encounterd in {@link connect} will populate this field */
+    error: LivestreamError | null;
+    /** Utility flag which indicates the current connection status */
+    isConnected: boolean;
+}
+/**
+ * Hook for publishing a livestream, which can be then received with {@link useLivestreamViewer}
+ * @category Livestream
+ * @group Hooks
+ */
+export declare const useLivestreamStreamer: () => UseLivestreamStreamerResult;
+//# sourceMappingURL=useLivestreamStreamer.d.ts.map

package/dist/hooks/useLivestreamStreamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLivestreamStreamer.d.ts","sourceRoot":"","sources":["../../src/hooks/useLivestreamStreamer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAmD,MAAM,0BAA0B,CAAC;AAK5G,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GACtB;IACE,sHAAsH;IACtH,KAAK,EAAE,WAAW,CAAC;IACnB,8HAA8H;IAC9H,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B,GACD;IACE,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAEN,2BAA2B;AAC3B,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,2BAA2B;AAC3B,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,qFAAqF;IACrF,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wEAAwE;IACxE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAC;CACtB;AAKD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,2BAyCxC,CAAC"}

package/dist/hooks/useLivestreamStreamer.js

@@ -0,0 +1,44 @@
+import { LivestreamError, publishLivestream } from "@fishjam-cloud/ts-client";
+import { useCallback, useRef, useState } from "react";
+import { FISHJAM_WHIP_URL } from "../consts";
+const isLivestreamError = (err) => Object.values(LivestreamError).includes(err);
+/**
+ * Hook for publishing a livestream, which can be then received with {@link useLivestreamViewer}
+ * @category Livestream
+ * @group Hooks
+ */
+export const useLivestreamStreamer = () => {
+    const [error, setError] = useState(null);
+    const [isConnected, setIsConnected] = useState(false);
+    const resultRef = useRef(null);
+    const disconnect = useCallback(() => {
+        resultRef.current?.stopPublishing();
+        resultRef.current = null;
+    }, []);
+    const onConnectionStateChange = useCallback((pc) => {
+        if (isConnected && pc.connectionState !== "connected")
+            disconnect();
+        setIsConnected(pc.connectionState === "connected");
+    }, [isConnected, disconnect]);
+    const connect = useCallback(async ({ inputs: { video, audio }, token }, urlOverride) => {
+        if (resultRef.current !== null)
+            disconnect();
+        const videoTrack = video?.getVideoTracks().at(0);
+        const audioTrack = audio?.getAudioTracks().at(0);
+        const stream = new MediaStream([videoTrack, audioTrack].filter((v) => v != null));
+        try {
+            const result = await publishLivestream(stream, urlOverride ?? FISHJAM_WHIP_URL, token, {
+                onConnectionStateChange,
+            });
+            resultRef.current = result;
+            setError(null);
+        }
+        catch (e) {
+            if (isLivestreamError(e))
+                setError(e);
+            else
+                console.error(e);
+        }
+    }, [disconnect, onConnectionStateChange]);
+    return { connect, disconnect, error, isConnected };
+};

package/dist/hooks/useLivestreamViewer.d.ts

@@ -0,0 +1,34 @@
+import { LivestreamError } from "@fishjam-cloud/ts-client";
+export type ConnectViewerConfig = {
+    token: string;
+    streamId?: never;
+} | {
+    streamId: string;
+    token?: never;
+};
+/**
+ * @category Livestream
+ */
+export interface UseLivestreamViewerResult {
+    /** The received livestream media */
+    stream: MediaStream | null;
+    /**
+     * Callback to start receiving a livestream.
+     * If the livestream is private, provide `token`.
+     * If the livestream is public, provide `streamId`.
+     */
+    connect: (config: ConnectViewerConfig, url?: string) => Promise<void>;
+    /** Callback used to disconnect from a stream previously connected to with {@link connect} */
+    disconnect: () => void;
+    /** Any errors encountered in {@link connect} will be present in this field. */
+    error: LivestreamError | null;
+    /** Utility flag which indicates the current connection status */
+    isConnected: boolean;
+}
+/**
+ * Hook for receiving a published livestream.
+ * @category Livestream
+ * @group Hooks
+ */
+export declare const useLivestreamViewer: () => UseLivestreamViewerResult;
+//# sourceMappingURL=useLivestreamViewer.d.ts.map

package/dist/hooks/useLivestreamViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLivestreamViewer.d.ts","sourceRoot":"","sources":["../../src/hooks/useLivestreamViewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAmD,MAAM,0BAA0B,CAAC;AAK5G,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE5G;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,6FAA6F;IAC7F,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,+EAA+E;IAC/E,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAC;CACtB;AAUD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAO,yBAqCtC,CAAC"}

package/dist/hooks/useLivestreamViewer.js

@@ -0,0 +1,45 @@
+import { LivestreamError, receiveLivestream } from "@fishjam-cloud/ts-client";
+import { useCallback, useRef, useState } from "react";
+import { FISHJAM_WHEP_URL } from "../consts";
+const isLivestreamError = (err) => Object.values(LivestreamError).includes(err);
+const urlFromConfig = (config) => {
+    if (config.streamId)
+        return `${FISHJAM_WHEP_URL}/${config.streamId}`;
+    return FISHJAM_WHEP_URL;
+};
+/**
+ * Hook for receiving a published livestream.
+ * @category Livestream
+ * @group Hooks
+ */
+export const useLivestreamViewer = () => {
+    const [stream, setStream] = useState(null);
+    const [error, setError] = useState(null);
+    const resultRef = useRef(null);
+    const [isConnected, setIsConnected] = useState(false);
+    const disconnect = useCallback(() => {
+        setStream(null);
+        resultRef.current?.stop();
+        resultRef.current = null;
+    }, []);
+    const onConnectionStateChange = useCallback((pc) => {
+        if (isConnected && pc.connectionState !== "connected")
+            disconnect();
+        setIsConnected(pc.connectionState === "connected");
+    }, [isConnected, disconnect]);
+    const connect = useCallback(async (config, url) => {
+        if (resultRef.current !== null)
+            disconnect();
+        try {
+            const result = await receiveLivestream(url ?? urlFromConfig(config), config.token, { onConnectionStateChange });
+            resultRef.current = result;
+            setError(null);
+            setStream(result.stream);
+        }
+        catch (e) {
+            if (isLivestreamError(e))
+                setError(e);
+        }
+    }, [disconnect, onConnectionStateChange]);
+    return { stream, connect, disconnect, error, isConnected };
+};

package/dist/hooks/useSandbox.d.ts

@@ -0,0 +1,18 @@
+export type UseSandboxProps = {
+    configOverride?: {
+        fishjamUrl?: string;
+    };
+};
+export type RoomType = "conference" | "livestream" | "audio_only";
+export declare const useSandbox: (props?: UseSandboxProps) => {
+    getSandboxPeerToken: (roomName: string, peerName: string, roomType?: RoomType) => Promise<string>;
+    getSandboxViewerToken: (roomName: string) => Promise<string>;
+    getSandboxLivestream: (roomName: string, isPublic?: boolean) => Promise<{
+        streamerToken: string;
+        room: {
+            id: string;
+            name: string;
+        };
+    }>;
+};
+//# sourceMappingURL=useSandbox.d.ts.map

package/dist/hooks/useSandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSandbox.d.ts","sourceRoot":"","sources":["../../src/hooks/useSandbox.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,eAAe,GAAG;IAE5B,cAAc,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAElE,eAAO,MAAM,UAAU,GAAI,QAAQ,eAAe;oCAUH,MAAM,YAAY,MAAM,aAAY,QAAQ;sCAmB1C,MAAM;qCAkBP,MAAM,aAAY,OAAO;uBAUxC,MAAM;cAAQ;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE;;CAK1E,CAAC"}

package/dist/hooks/useSandbox.js

@@ -0,0 +1,58 @@
+import { useContext } from "react";
+import { FISHJAM_HTTP_CONNECT_URL } from "../consts";
+import { FishjamIdContext } from "../contexts/fishjamId";
+class FishjamIdMisconfiguredError extends Error {
+    constructor() {
+        super("You haven't passed the fishjamId to the FishjamProvider.");
+    }
+}
+export const useSandbox = (props) => {
+    const fishjamId = useContext(FishjamIdContext);
+    const overridenFishjamUrl = props?.configOverride?.fishjamUrl;
+    const fishjamUrl = `${FISHJAM_HTTP_CONNECT_URL}/${fishjamId}`;
+    const isFishjamIdMisconfigured = !fishjamId && !props?.configOverride?.fishjamUrl;
+    const roomManagerUrl = `${overridenFishjamUrl ?? fishjamUrl}/room-manager`;
+    const getSandboxPeerToken = async (roomName, peerName, roomType = "conference") => {
+        if (isFishjamIdMisconfigured)
+            throw new FishjamIdMisconfiguredError();
+        const url = new URL(roomManagerUrl);
+        url.searchParams.set("roomName", roomName);
+        url.searchParams.set("peerName", peerName);
+        url.searchParams.set("roomType", roomType);
+        const res = await fetch(url);
+        if (!res.ok) {
+            const message = `Failed to retrieve peer token for peer '${peerName}' in ${roomType} room '${roomName}'.`;
+            throw new Error(message);
+        }
+        const data = await res.json();
+        return data.peerToken;
+    };
+    const getSandboxViewerToken = async (roomName) => {
+        if (isFishjamIdMisconfigured)
+            throw new FishjamIdMisconfiguredError();
+        const url = new URL(`${roomManagerUrl}/${roomName}/livestream-viewer-token`);
+        const res = await fetch(url);
+        if (!res.ok) {
+            let message = `Failed to retrieve viewer token for '${roomName}' livestream room.`;
+            if (res.status === 404) {
+                message = `A livestream room of name '${roomName}' does not exist.`;
+            }
+            throw new Error(message);
+        }
+        const data = await res.json();
+        return data.token;
+    };
+    const getSandboxLivestream = async (roomName, isPublic = false) => {
+        if (isFishjamIdMisconfigured)
+            throw new FishjamIdMisconfiguredError();
+        const url = new URL(`${roomManagerUrl}/livestream`);
+        url.searchParams.set("roomName", roomName);
+        url.searchParams.set("public", isPublic.toString());
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Failed to retrieve streamer token for '${roomName}' livestream room.`);
+        const data = await res.json();
+        return data;
+    };
+    return { getSandboxPeerToken, getSandboxViewerToken, getSandboxLivestream };
+};

package/dist/index.d.ts

@@ -5,8 +5,10 @@ export { useMicrophone } from "./hooks/devices/useMicrophone";
 export { InitializeDevicesSettings } from "./hooks/internal/devices/useMediaDevices";
 export { type JoinRoomConfig, useConnection } from "./hooks/useConnection";
 export { useCustomSource } from "./hooks/useCustomSource";
-export { useLivestream, type UseLivestreamResult } from "./hooks/useLivestream";
+export { type ConnectStreamerConfig, type StreamerInputs, useLivestreamStreamer, type UseLivestreamStreamerResult, } from "./hooks/useLivestreamStreamer";
+export { type ConnectViewerConfig, useLivestreamViewer, type UseLivestreamViewerResult, } from "./hooks/useLivestreamViewer";
 export { type PeerWithTracks, usePeers } from "./hooks/usePeers";
+export { type RoomType, useSandbox, type UseSandboxProps } from "./hooks/useSandbox";
 export { useScreenShare } from "./hooks/useScreenShare";
 export { useUpdatePeerMetadata } from "./hooks/useUpdatePeerMetadata";
 export { useVAD } from "./hooks/useVAD";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,KAAK,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,KAAK,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,YAAY,EACV,eAAe,EACf,KAAK,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,YAAY,EACZ,KAAK,EACL,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,eAAe,EACf,eAAe,EACf,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,KAAK,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,qBAAqB,EACrB,KAAK,2BAA2B,GACjC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,KAAK,QAAQ,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,YAAY,EACV,eAAe,EACf,KAAK,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,YAAY,EACZ,KAAK,EACL,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,eAAe,EACf,eAAe,EACf,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -4,8 +4,10 @@ export { useInitializeDevices } from "./hooks/devices/useInitializeDevices";
 export { useMicrophone } from "./hooks/devices/useMicrophone";
 export { useConnection } from "./hooks/useConnection";
 export { useCustomSource } from "./hooks/useCustomSource";
-export { useLivestream } from "./hooks/useLivestream";
+export { useLivestreamStreamer, } from "./hooks/useLivestreamStreamer";
+export { useLivestreamViewer, } from "./hooks/useLivestreamViewer";
 export { usePeers } from "./hooks/usePeers";
+export { useSandbox } from "./hooks/useSandbox";
 export { useScreenShare } from "./hooks/useScreenShare";
 export { useUpdatePeerMetadata } from "./hooks/useUpdatePeerMetadata";
 export { useVAD } from "./hooks/useVAD";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fishjam-cloud/react-client",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "React client library for Fishjam",
   "license": "Apache-2.0",
   "author": "Fishjam Team",
@@ -60,7 +60,7 @@
     "vitest": "^3.1.1"
   },
   "dependencies": {
-    "@fishjam-cloud/ts-client": "0.19.0",
+    "@fishjam-cloud/ts-client": "0.20.0",
     "events": "3.3.0",
     "lodash.isequal": "4.5.0"
   },

package/dist/hooks/useLivestream.d.ts

@@ -1,9 +0,0 @@
-import { LivestreamError } from "@fishjam-cloud/ts-client";
-export interface UseLivestreamResult {
-    stream: MediaStream | null;
-    connect: (url: string, token: string) => Promise<void>;
-    disconnect: () => void;
-    error: LivestreamError | null;
-}
-export declare const useLivestream: () => UseLivestreamResult;
-//# sourceMappingURL=useLivestream.d.ts.map

package/dist/hooks/useLivestream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLivestream.d.ts","sourceRoot":"","sources":["../../src/hooks/useLivestream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAmD,MAAM,0BAA0B,CAAC;AAG5G,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAKD,eAAO,MAAM,aAAa,QAAO,mBAyBhC,CAAC"}

package/dist/hooks/useLivestream.js

@@ -1,27 +0,0 @@
-import { LivestreamError, receiveLivestream } from "@fishjam-cloud/ts-client";
-import { useCallback, useRef, useState } from "react";
-const isLivestreamError = (err) => Object.values(LivestreamError).includes(err);
-export const useLivestream = () => {
-    const [stream, setStream] = useState(null);
-    const [error, setError] = useState(null);
-    const resultRef = useRef(null);
-    const connect = useCallback(async (url, token) => {
-        try {
-            const result = await receiveLivestream(url, token);
-            resultRef.current = result;
-            setError(null);
-            setStream(result.stream);
-        }
-        catch (e) {
-            if (isLivestreamError(e)) {
-                setError(e);
-            }
-        }
-    }, []);
-    const disconnect = useCallback(() => {
-        setStream(null);
-        resultRef.current?.stop();
-        resultRef.current = null;
-    }, []);
-    return { stream, connect, disconnect, error };
-};