mediasfu-shared 1.0.5 → 1.1.0

package/dist/methods/utils/formatNumber.d.ts

@@ -0,0 +1,21 @@
+export interface FormatNumberOptions {
+    number: number;
+}
+export type FormatNumberType = (options: FormatNumberOptions) => Promise<string | undefined>;
+/**
+ * Formats large numbers into compact display strings.
+ *
+ * Values are converted to `K`, `M`, or `B` suffixes for UI-friendly display.
+ * Falsy values return `undefined` to match existing MediaSFU display behavior.
+ *
+ * @param options Number formatting options.
+ * @returns A compact string such as `1.2K` or `3.4M`, or `undefined` for empty input.
+ *
+ * @example
+ * ```typescript
+ * const viewers = await formatNumber({ number: 1530 });
+ * // viewers === '1.5K'
+ * ```
+ */
+export declare const formatNumber: ({ number }: FormatNumberOptions) => Promise<string | undefined>;
+//# sourceMappingURL=formatNumber.d.ts.map

package/dist/methods/utils/formatNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatNumber.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/formatNumber.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAE7F;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,GAAU,YAAY,mBAAmB,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAoB9F,CAAC"}

package/dist/methods/utils/generateRandomMessages.d.ts

@@ -0,0 +1,11 @@
+import { Message, Participant } from '../../types/shared-base-types';
+export interface GenerateRandomMessagesOptions {
+    participants: Participant[];
+    member: string;
+    coHost?: string;
+    host: string;
+    forChatBroadcast?: boolean;
+}
+export type GenerateRandomMessagesType = (options: GenerateRandomMessagesOptions) => Message[];
+export declare const generateRandomMessages: ({ participants, member, coHost, host, forChatBroadcast, }: GenerateRandomMessagesOptions) => Message[];
+//# sourceMappingURL=generateRandomMessages.d.ts.map

package/dist/methods/utils/generateRandomMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRandomMessages.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/generateRandomMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,EAAE,CAAC;AAE/F,eAAO,MAAM,sBAAsB,GAAI,2DAMpC,6BAA6B,KAAG,OAAO,EAmDzC,CAAC"}

package/dist/methods/utils/generateRandomParticipants.d.ts

@@ -0,0 +1,10 @@
+import { Participant } from '../../types/shared-base-types';
+export interface GenerateRandomParticipantsOptions {
+    member: string;
+    coHost?: string;
+    host: string;
+    forChatBroadcast?: boolean;
+}
+export type GenerateRandomParticipantsType = (options: GenerateRandomParticipantsOptions) => Participant[];
+export declare const generateRandomParticipants: ({ member, coHost, host, forChatBroadcast, }: GenerateRandomParticipantsOptions) => Participant[];
+//# sourceMappingURL=generateRandomParticipants.d.ts.map

package/dist/methods/utils/generateRandomParticipants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRandomParticipants.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/generateRandomParticipants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,OAAO,EAAE,iCAAiC,KACvC,WAAW,EAAE,CAAC;AAEnB,eAAO,MAAM,0BAA0B,GAAI,6CAKxC,iCAAiC,KAAG,WAAW,EAiFjD,CAAC"}

package/dist/methods/utils/generateRandomPolls.d.ts

@@ -0,0 +1,7 @@
+import { Poll } from '../../types/shared-base-types';
+export interface GenerateRandomPollsOptions {
+    numberOfPolls: number;
+}
+export type GenerateRandomPollsType = (options: GenerateRandomPollsOptions) => Poll[];
+export declare const generateRandomPolls: ({ numberOfPolls }: GenerateRandomPollsOptions) => Poll[];
+//# sourceMappingURL=generateRandomPolls.d.ts.map

package/dist/methods/utils/generateRandomPolls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRandomPolls.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/generateRandomPolls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAE1D,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI,EAAE,CAAC;AAEtF,eAAO,MAAM,mBAAmB,GAAI,mBAAmB,0BAA0B,KAAG,IAAI,EAkCvF,CAAC"}

package/dist/methods/utils/generateRandomRequestList.d.ts

@@ -0,0 +1,10 @@
+import { Participant, Request } from '../../types/shared-base-types';
+export interface GenerateRandomRequestListOptions {
+    participants: Participant[];
+    hostName: string;
+    coHostName?: string;
+    numberOfRequests: number;
+}
+export type GenerateRandomRequestListType = (options: GenerateRandomRequestListOptions) => Request[];
+export declare const generateRandomRequestList: ({ participants, hostName, coHostName, numberOfRequests, }: GenerateRandomRequestListOptions) => Request[];
+//# sourceMappingURL=generateRandomRequestList.d.ts.map

package/dist/methods/utils/generateRandomRequestList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRandomRequestList.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/generateRandomRequestList.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,EAAE,gCAAgC,KAAK,OAAO,EAAE,CAAC;AAErG,eAAO,MAAM,yBAAyB,GAAI,2DAKvC,gCAAgC,KAAG,OAAO,EAkC5C,CAAC"}

package/dist/methods/utils/generateRandomWaitingRoomList.d.ts

@@ -0,0 +1,4 @@
+import { WaitingRoomParticipant } from '../../types/shared-base-types';
+export type GenerateRandomWaitingRoomListType = () => WaitingRoomParticipant[];
+export declare const generateRandomWaitingRoomList: () => WaitingRoomParticipant[];
+//# sourceMappingURL=generateRandomWaitingRoomList.d.ts.map

package/dist/methods/utils/generateRandomWaitingRoomList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRandomWaitingRoomList.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/generateRandomWaitingRoomList.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,MAAM,iCAAiC,GAAG,MAAM,sBAAsB,EAAE,CAAC;AAE/E,eAAO,MAAM,6BAA6B,QAAO,sBAAsB,EAYtE,CAAC"}

package/dist/methods/utils/getModalPosition.d.ts

@@ -0,0 +1,7 @@
+import { ModalPositionStyle } from '../../types/shared-base-types';
+export interface GetModalPositionOptions {
+    position: string;
+}
+export type GetModalPositionType = (options: GetModalPositionOptions) => ModalPositionStyle;
+export declare const getModalPosition: ({ position }: GetModalPositionOptions) => ModalPositionStyle;
+//# sourceMappingURL=getModalPosition.d.ts.map

package/dist/methods/utils/getModalPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getModalPosition.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/getModalPosition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,kBAAkB,CAAC;AAE5F,eAAO,MAAM,gBAAgB,GAAI,cAAc,uBAAuB,KAAG,kBAcxE,CAAC"}

package/dist/methods/utils/getOverlayPosition.d.ts

@@ -0,0 +1,22 @@
+import { OverlayPositionStyle } from '../../types/types';
+export interface GetOverlayPositionOptions {
+    position: string;
+}
+export type GetOverlayPositionType = (options: GetOverlayPositionOptions) => OverlayPositionStyle;
+/**
+ * Maps a symbolic overlay position to CSS-style edge coordinates.
+ *
+ * This is used by display card components to anchor badges, audio indicators,
+ * or auxiliary overlays to a participant tile corner.
+ *
+ * @param options Overlay position options.
+ * @returns A partial coordinate object suitable for inline style application.
+ *
+ * @example
+ * ```typescript
+ * const style = getOverlayPosition({ position: 'bottomRight' });
+ * // style === { bottom: 0, right: 0 }
+ * ```
+ */
+export declare const getOverlayPosition: ({ position }: GetOverlayPositionOptions) => OverlayPositionStyle;
+//# sourceMappingURL=getOverlayPosition.d.ts.map

package/dist/methods/utils/getOverlayPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOverlayPosition.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/getOverlayPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,oBAAoB,CAAC;AAElG;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,GAAI,cAAc,yBAAyB,KAAG,oBAa5E,CAAC"}

package/dist/methods/utils/getParticipantMedia.d.ts

@@ -0,0 +1,55 @@
+import { Participant, Stream } from '../../types/types';
+export interface GetParticipantMediaOptions {
+    /**
+     * A participant id, or a producer id when the caller already holds one.
+     */
+    id?: string;
+    /** A participant display name. Used when `id` resolves nothing. */
+    name?: string;
+    /** Which media to resolve. Defaults to `video`. */
+    kind?: 'video' | 'audio';
+    /**
+     * The MediaSFU parameter bag — the object handed to `updateSourceParameters`,
+     * or anything exposing `participants`, `allVideoStreams` and `allAudioStreams`.
+     */
+    parameters: {
+        participants?: Participant[];
+        allVideoStreams?: (Participant | Stream)[];
+        allAudioStreams?: (Participant | Stream)[];
+        getCurrentParams?: () => any;
+        getUpdatedAllParams?: () => any;
+        [key: string]: any;
+    };
+}
+export type GetParticipantMediaType = (options: GetParticipantMediaOptions) => Promise<MediaStream | null>;
+/**
+ * Resolve a participant's live MediaStream from a MediaSFU parameter bag.
+ *
+ * This is the SDK-level counterpart of the `getParticipantMedia` helper that
+ * MediaSFU components publish through `sourceParameters`. That helper remains
+ * available for backwards compatibility; prefer this export when you drive the
+ * SDK headlessly (`returnUI={false}`) and only hold the parameter bag.
+ *
+ * Resolution order:
+ *  1. `parameters.participants` matched by `id`, then by `name`.
+ *  2. The matched participant's `videoID` / `audioID`, looked up against
+ *     `allVideoStreams` / `allAudioStreams` by `producerId`. These collections
+ *     are keyed by producer id only — a participant's `id` is its membership id
+ *     and never matches, which is why an id-keyed lookup silently returns null.
+ *  3. `id` treated directly as a producer id, for callers that already hold one.
+ *
+ * @example
+ * ```ts
+ * import { getParticipantMedia } from 'mediasfu-reactjs';
+ *
+ * const stream = await getParticipantMedia({
+ *   name: 'Paul',
+ *   kind: 'video',
+ *   parameters: sourceParameters.current,
+ * });
+ * if (stream) videoElement.srcObject = stream;
+ * ```
+ */
+export declare function getParticipantMedia({ id, name, kind, parameters, }: GetParticipantMediaOptions): Promise<MediaStream | null>;
+export default getParticipantMedia;
+//# sourceMappingURL=getParticipantMedia.d.ts.map

package/dist/methods/utils/getParticipantMedia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getParticipantMedia.d.ts","sourceRoot":"","sources":["../../../src/methods/utils/getParticipantMedia.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB;;;OAGG;IACH,UAAU,EAAE;QACV,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;QAC7B,eAAe,CAAC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC;QAC3C,eAAe,CAAC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC;QAC3C,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC;QAC7B,mBAAmB,CAAC,EAAE,MAAM,GAAG,CAAC;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,EAAO,EACP,IAAS,EACT,IAAc,EACd,UAAU,GACX,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA+C1D;AAED,eAAe,mBAAmB,CAAC"}

package/dist/methods/utils/headless/getCurrentParams.d.ts

@@ -0,0 +1,27 @@
+import { HeadlessOptions, HeadlessParameters } from './headlessTypes';
+export type GetCurrentParamsType = (options: HeadlessOptions) => HeadlessParameters;
+/**
+ * Read the freshest parameter bag **without** triggering a republish.
+ *
+ * `parameters.getUpdatedAllParams()` looks like a getter but is not one: it
+ * reassigns `sourceParameters` and calls `updateSourceParameters` as a side
+ * effect. Calling it from a React event handler or a polling loop therefore
+ * re-enters your own update path, which at best causes a render storm and at
+ * worst locks the tab before `getUserMedia` resolves.
+ *
+ * MediaSFU components now publish a pure `getCurrentParams()` on the bag; this
+ * helper uses it when present and otherwise returns the bag you already hold.
+ * It never calls `getUpdatedAllParams()` and never throws.
+ *
+ * @example
+ * ```ts
+ * import { getCurrentParams } from 'mediasfu-shared';
+ *
+ * // Safe inside a click handler — no re-entrant publish.
+ * const live = getCurrentParams({ parameters: parameterStore.getCurrent() });
+ * await live.clickVideo({ parameters: live });
+ * ```
+ */
+export declare function getCurrentParams({ parameters, }: HeadlessOptions): HeadlessParameters;
+export default getCurrentParams;
+//# sourceMappingURL=getCurrentParams.d.ts.map

package/dist/methods/utils/headless/getCurrentParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrentParams.d.ts","sourceRoot":"","sources":["../../../../src/methods/utils/headless/getCurrentParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,eAAe,KACrB,kBAAkB,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,GACX,EAAE,eAAe,GAAG,kBAAkB,CAWtC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/methods/utils/headless/getMediaStreams.d.ts

@@ -0,0 +1,96 @@
+import { HeadlessOptions, ResolvedMedia } from './headlessTypes';
+export type GetRemoteVideoStreamsType = (options: HeadlessOptions) => ResolvedMedia[];
+/**
+ * Every remote camera in the room, in render order.
+ *
+ * Two details make this hard to get right by hand, and both are why headless
+ * integrations lose the host's video:
+ *
+ *  - **`oldAllStreams` matters.** During normal conference layout processing the
+ *    SDK moves a stream out of `allVideoStreams` into `oldAllStreams`. Reading
+ *    only `allVideoStreams` makes the host disappear mid-call.
+ *  - **The self marker must go.** `allVideoStreams` is seeded with a
+ *    `producerId: 'youyou'` placeholder for the local user.
+ *
+ * Entries are de-duplicated by `producerId`, falling back to the stream id, so a
+ * stream present in both collections is returned once.
+ *
+ * @example
+ * ```ts
+ * import { getRemoteVideoStreams } from 'mediasfu-shared';
+ *
+ * const remotes = getRemoteVideoStreams({ parameters });
+ * const primary = remotes[0]?.stream ?? null;
+ * ```
+ */
+export declare function getRemoteVideoStreams({ parameters, }: HeadlessOptions): ResolvedMedia[];
+export type GetRemoteAudioStreamsType = (options: HeadlessOptions) => ResolvedMedia[];
+/**
+ * Every remote audio producer in the room.
+ *
+ * Note that for *hearing* participants you normally want
+ * {@link getAudioGridComponents} instead — MediaSFU prepares its own audio
+ * elements and mounting those is what actually plays sound. This helper is for
+ * cases where you need the raw `MediaStream` (recording, analysis, metering).
+ */
+export declare function getRemoteAudioStreams({ parameters, }: HeadlessOptions): ResolvedMedia[];
+export type GetLocalVideoStreamType = (options: HeadlessOptions) => MediaStream | null;
+/**
+ * The local camera stream to render as the self-view.
+ *
+ * The virtual-background case is the one everyone misses: when `keepBackground`
+ * is on, the stream that carries the processed frames is `virtualStream`, and
+ * `localStreamVideo` still holds the raw camera. Rendering the wrong one shows
+ * the user their unprocessed background. This mirrors the SDK's own grid rule.
+ *
+ * Returns `null` when the camera is off, so a falsy result is a truthful
+ * "no self-view" rather than something to paint black.
+ *
+ * Note: transport state such as `videoParams` or `videoProducer` is **not**
+ * renderable media and is deliberately never consulted here.
+ */
+export declare function getLocalVideoStream({ parameters, }: HeadlessOptions): MediaStream | null;
+export type GetLocalAudioStreamType = (options: HeadlessOptions) => MediaStream | null;
+/** The local microphone stream, or `null` when the mic is off. */
+export declare function getLocalAudioStream({ parameters, }: HeadlessOptions): MediaStream | null;
+export interface ScreenShareState {
+    /** The stream to render, local or remote, or `null` when nobody is sharing. */
+    stream: MediaStream | null;
+    /** True when the stream is this user's own screen. */
+    isLocal: boolean;
+    /** True when any screen share is active in the room. */
+    active: boolean;
+}
+export type GetScreenShareStreamType = (options: HeadlessOptions) => ScreenShareState;
+/**
+ * The active screen share, remote first.
+ *
+ * `remoteScreenStream` is an array in some SDK paths and a bare object in
+ * others; both shapes are handled here so callers do not have to guess.
+ *
+ * @example
+ * ```ts
+ * const share = getScreenShareStream({ parameters });
+ * const primary = share.stream ?? remotes[0]?.stream ?? localVideo;
+ * ```
+ */
+export declare function getScreenShareStream({ parameters, }: HeadlessOptions): ScreenShareState;
+export type GetAudioGridComponentsType = (options: HeadlessOptions) => any[];
+/**
+ * The prepared audio elements to mount so participants are actually audible.
+ *
+ * Mount **all** of them. Truncating this list to the participants you happen to
+ * draw on screen silently mutes everyone else — audio playback is decoupled from
+ * your video layout. The usual pattern is a visually hidden container:
+ *
+ * @example
+ * ```tsx
+ * import { getAudioGridComponents } from 'mediasfu-shared';
+ *
+ * <div style={{ position: 'absolute', width: 1, height: 1, opacity: 0 }}>
+ *   <AudioGrid componentsToRender={getAudioGridComponents({ parameters })} />
+ * </div>
+ * ```
+ */
+export declare function getAudioGridComponents({ parameters }: HeadlessOptions): any[];
+//# sourceMappingURL=getMediaStreams.d.ts.map

package/dist/methods/utils/headless/getMediaStreams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMediaStreams.d.ts","sourceRoot":"","sources":["../../../../src/methods/utils/headless/getMediaStreams.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAsB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAyErF,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,eAAe,KACrB,aAAa,EAAE,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,GACX,EAAE,eAAe,GAAG,aAAa,EAAE,CAMnC;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,eAAe,KACrB,aAAa,EAAE,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,GACX,EAAE,eAAe,GAAG,aAAa,EAAE,CAGnC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,eAAe,KACrB,WAAW,GAAG,IAAI,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,GACX,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,CAUtC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,eAAe,KACrB,WAAW,GAAG,IAAI,CAAC;AAExB,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,GACX,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,CAMtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,eAAe,KACrB,gBAAgB,CAAC;AAEtB;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,UAAU,GACX,EAAE,eAAe,GAAG,gBAAgB,CAyBpC;AAED,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,GAAG,EAAE,CAAC;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,UAAU,EAAE,EAAE,eAAe,GAAG,GAAG,EAAE,CAM7E"}

package/dist/methods/utils/headless/getRoomReadiness.d.ts

@@ -0,0 +1,25 @@
+import { HeadlessOptions, RoomReadiness } from './headlessTypes';
+export type GetRoomReadinessType = (options: HeadlessOptions) => RoomReadiness;
+/**
+ * Is the room actually usable yet?
+ *
+ * Headless consumers repeatedly re-derive this same predicate and each one picks
+ * a slightly different subset, so a control fires before the transport exists
+ * and fails silently. The five conditions below are the real gate: a room name,
+ * a member identity, server-side validation, a connected emittable socket, and a
+ * loaded mediasoup device.
+ *
+ * `reason` is safe to show a user — it names what is still pending, never an
+ * endpoint, credential, or internal identifier.
+ *
+ * @example
+ * ```ts
+ * import { getRoomReadiness } from 'mediasfu-shared';
+ *
+ * const { ready, reason } = getRoomReadiness({ parameters });
+ * if (!ready) return <p>{reason}</p>;
+ * ```
+ */
+export declare function getRoomReadiness({ parameters }: HeadlessOptions): RoomReadiness;
+export default getRoomReadiness;
+//# sourceMappingURL=getRoomReadiness.d.ts.map

package/dist/methods/utils/headless/getRoomReadiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRoomReadiness.d.ts","sourceRoot":"","sources":["../../../../src/methods/utils/headless/getRoomReadiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,aAAa,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,UAAU,EAAE,EAAE,eAAe,GAAG,aAAa,CAsB/E;AAED,eAAe,gBAAgB,CAAC"}

package/dist/methods/utils/headless/headlessTypes.d.ts

@@ -0,0 +1,89 @@
+import { Participant, Stream } from '../../../types/types';
+/**
+ * The MediaSFU parameter bag.
+ *
+ * This is the object handed to `updateSourceParameters`. Every field on it is a
+ * snapshot of an internal ref (`allVideoStreams.current`, `localStreamVideo.current`,
+ * …) taken at publish time, and the SDK **reassigns** those refs rather than
+ * mutating them — so a bag you hold onto goes stale as soon as a producer or
+ * consumer changes. Always read from the most recent publication.
+ */
+export interface HeadlessParameters {
+    roomName?: string;
+    member?: string;
+    islevel?: string;
+    validated?: boolean;
+    socket?: any;
+    localSocket?: any;
+    device?: {
+        loaded?: boolean;
+        [key: string]: any;
+    };
+    participants?: Participant[];
+    participantsAll?: Participant[];
+    allVideoStreams?: (Participant | Stream)[];
+    allAudioStreams?: (Participant | Stream)[];
+    oldAllStreams?: (Participant | Stream)[];
+    audioOnlyStreams?: any[];
+    translationStreams?: any[];
+    localStream?: MediaStream | null;
+    localStreamVideo?: MediaStream | null;
+    localStreamAudio?: MediaStream | null;
+    localStreamScreen?: MediaStream | null;
+    virtualStream?: MediaStream | null;
+    keepBackground?: boolean;
+    audioAlreadyOn?: boolean;
+    videoAlreadyOn?: boolean;
+    remoteScreenStream?: (Participant | Stream)[] | {
+        stream?: MediaStream;
+    } | null;
+    shareScreenStarted?: boolean;
+    shared?: boolean;
+    messages?: any[];
+    coHost?: string;
+    coHostResponsibility?: any[];
+    chatSetting?: string;
+    showAlert?: (options: any) => void;
+    audioLevel?: number;
+    audioDecibels?: {
+        name: string;
+        averageLoudness: number;
+    }[];
+    /** Republishes as a side effect — prefer `getCurrentParams`. */
+    getUpdatedAllParams?: () => any;
+    /** Pure read of the current bag. No republish. */
+    getCurrentParams?: () => any;
+    getParticipantMedia?: (...args: any[]) => Promise<MediaStream | null>;
+    getMediaDevicesList?: (kind: 'videoinput' | 'audioinput') => Promise<MediaDeviceInfo[]>;
+    updateAutoWave?: (value: boolean) => void;
+    /**
+     * Server-provided playback URLs, when the room has them provisioned.
+     *
+     * Unlike WebRTC media these are never consumed automatically — see
+     * getPlaybackSources/attachPlayback. Absence means the room has no HLS or
+     * WHEP egress, not an error.
+     */
+    hlsUrl?: string;
+    hlsPlaybackUrl?: string;
+    playbackUrl?: string;
+    whepUrl?: string;
+    whepPlaybackUrl?: string;
+    [key: string]: any;
+}
+export interface HeadlessOptions {
+    /** The most recent parameter bag from `updateSourceParameters`. */
+    parameters: HeadlessParameters;
+}
+/** A resolved media entry with the producer reference that identifies it. */
+export interface ResolvedMedia {
+    stream: MediaStream;
+    producerId: string;
+    /** Participant display name when the SDK exposes one for this producer. */
+    name: string;
+}
+export interface RoomReadiness {
+    ready: boolean;
+    /** Empty when ready; otherwise a short, user-safe explanation. */
+    reason: string;
+}
+//# sourceMappingURL=headlessTypes.d.ts.map

package/dist/methods/utils/headless/headlessTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headlessTypes.d.ts","sourceRoot":"","sources":["../../../../src/methods/utils/headless/headlessTypes.ts"],"names":[],"mappings":"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"}

package/dist/methods/utils/headless/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Headless helpers for `returnUI={false}` integrations.
+ *
+ * These exist because every headless consumer was re-deriving the same handful
+ * of rules from the raw parameter bag, and getting them subtly wrong in ways
+ * that only show up on a live call: a host whose video vanishes when the SDK
+ * moves their stream to `oldAllStreams`, participants who are silently
+ * inaudible because the audio element list was truncated, a self-view showing
+ * the unprocessed camera when a virtual background is on, or a tab that locks
+ * because `getUpdatedAllParams()` was called from a click handler.
+ *
+ * Import the individual helpers when your adapter needs finer control.
+ */
+export * from './headlessTypes';
+export * from './getRoomReadiness';
+export * from './getMediaStreams';
+export * from './getCurrentParams';
+export * from './roomActions';
+export * from './participantState';
+export * from './mediaPermissions';
+export * from './moderation';
+export * from './sessionFeatures';
+export * from './sessionExtras';
+export * from './virtualBackground';
+export * from './sessionControls';
+export * from './playback';
+export * from './viewerSession';
+export * from './mediaProduction';
+//# sourceMappingURL=index.d.ts.map

package/dist/methods/utils/headless/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/methods/utils/headless/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/methods/utils/headless/mediaPermissions.d.ts

@@ -0,0 +1,53 @@
+import { HeadlessOptions } from './headlessTypes';
+export interface MediaPermission {
+    /** True when turning this media ON would be accepted right now. */
+    allowed: boolean;
+    /** Empty when allowed; otherwise the reason, phrased for a user. */
+    reason: string;
+    /**
+     * True when enabling is possible but needs the host to approve first
+     * (`audioSetting`/`videoSetting` of 'approval'). The control still works —
+     * it raises a request rather than turning media on immediately.
+     */
+    needsApproval: boolean;
+}
+export interface MediaPermissions {
+    microphone: MediaPermission;
+    camera: MediaPermission;
+    screenShare: MediaPermission;
+    /** True when the local user is a host (islevel '2') and bypasses most gates. */
+    isHost: boolean;
+    /** True when focus mode is on and the local user is not a panelist. */
+    focusModeBlocked: boolean;
+}
+export type GetMediaPermissionsType = (options: HeadlessOptions) => MediaPermissions;
+/**
+ * Can this user turn their mic, camera or screen share on *right now*?
+ *
+ * MediaSFU decides this inside `clickAudio` / `clickVideo` / `clickScreenShare`,
+ * which return `void` and report a refusal only through `showAlert`. That means
+ * a headless surface finds out a control was blocked *after* the user pressed
+ * it — the button looks broken. This evaluates the same gates up front so you
+ * can disable the control and say why instead.
+ *
+ * The branches mirror the SDK's own order: audio-only rooms, host recording
+ * locks, `adminRestrictSetting`, focus-mode panelist restrictions, and the
+ * `allow` / `approval` / `disallow` settings. Host (`islevel === '2'`) bypasses
+ * the participant-level gates, exactly as the controls do.
+ *
+ * Note this cannot predict two cases: room capacity checks, which the SDK
+ * resolves by asking the server (`checkProduce`), and OS-level device
+ * permission, which only surfaces when capture is attempted. Treat a `false`
+ * here as authoritative and a `true` as "nothing known blocks it".
+ *
+ * @example
+ * ```tsx
+ * const perms = getMediaPermissions({ parameters });
+ * <button disabled={!perms.microphone.allowed} title={perms.microphone.reason}>
+ *   {perms.microphone.needsApproval ? 'Ask to unmute' : 'Unmute'}
+ * </button>
+ * ```
+ */
+export declare function getMediaPermissions({ parameters }: HeadlessOptions): MediaPermissions;
+export default getMediaPermissions;
+//# sourceMappingURL=mediaPermissions.d.ts.map

package/dist/methods/utils/headless/mediaPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaPermissions.d.ts","sourceRoot":"","sources":["../../../../src/methods/utils/headless/mediaPermissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAsB,MAAM,iBAAiB,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,eAAe,CAAC;IAC7B,gFAAgF;IAChF,MAAM,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,eAAe,KACrB,gBAAgB,CAAC;AAOtB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,UAAU,EAAE,EAAE,eAAe,GAAG,gBAAgB,CA4DrF;AAED,eAAe,mBAAmB,CAAC"}