@syra.fm/sdk 0.4.0 → 0.6.0

package/lib/typescript/module/live/context/LiveConfigContext.d.ts

@@ -0,0 +1,78 @@
+import React from 'react';
+import type { ViewStyle } from 'react-native';
+import type { LiveTheme, UserEntity, HttpClient } from '../types';
+import { type RoomsServiceInstance } from '../services/spacesService';
+import { RoomSocketService } from '../services/spaceSocketService';
+import { type GetRoomTokenFn } from '../services/livekitService';
+/**
+ * The viewer's pinned Syra podcast (resolved from their profile media), surfaced
+ * by {@link LiveConfig.getPinnedPodcast}. `title`/`artworkUrl` are optional —
+ * the id is all the picker needs to drill into the episode list.
+ */
+export interface PinnedPodcast {
+    syraPodcastId: string;
+    title?: string;
+    artworkUrl?: string;
+}
+export interface LiveConfig {
+    httpClient: HttpClient;
+    socketUrl: string;
+    useTheme: () => LiveTheme;
+    /**
+     * Translate a UI string key to the active locale. Optional: hosts WITH an i18n
+     * layer (the Mention frontend) inject their real translator so the shared
+     * live-room UI localizes; hosts WITHOUT one (the standalone live-rooms app) omit it
+     * and the shared components fall back to their bundled English source copy.
+     * Keys are looked up flat (e.g. `agora.podcastStream.disclaimer`).
+     */
+    t?: (key: string, options?: Record<string, string | number>) => string;
+    /**
+     * Resolve the viewer's pinned Syra podcast from their profile media, or `null`
+     * when they have none / it can't be read. Optional: hosts that expose profile
+     * media wire it so the podcast picker can offer a one-tap "stream my pinned
+     * podcast" quick-start row. The picker renders nothing when this is absent or
+     * resolves to `null`.
+     */
+    getPinnedPodcast?: () => Promise<PinnedPodcast | null>;
+    useUserById: (id: string | undefined) => UserEntity | undefined;
+    ensureUserById: (id: string, loader: (id: string) => Promise<UserEntity | null | undefined>) => Promise<UserEntity | undefined>;
+    getCachedFileDownloadUrl: (oxyServices: unknown, fileId: string, variant?: string) => Promise<string>;
+    getCachedFileDownloadUrlSync: (oxyServices: unknown, fileId: string, variant?: string) => string;
+    AvatarComponent: React.ComponentType<{
+        size: number;
+        source?: string;
+        shape?: string;
+        style?: ViewStyle;
+    }>;
+    toast: {
+        (message: string, options?: Record<string, unknown>): void;
+        success: (message: string) => void;
+        error: (message: string) => void;
+    };
+    introSound?: number;
+    isDesktop?: boolean;
+    useIsDesktop?: () => boolean;
+    onRoomChanged?: (roomId: string) => void;
+    /**
+     * Optional NativeWind className applied to the floating live-room dock and its
+     * backdrop. Hosts whose web shell uses a DOCUMENT-scroll model (html/body/#root
+     * = height:auto + overflow:visible, the window is the scroller) must pass
+     * `"web:fixed"` so the dock pins to the VIEWPORT bottom instead of resolving
+     * its `position: absolute` against the tall document and sinking to the page
+     * bottom. Omitted on hosts with the default fixed-viewport web model (and on
+     * native, where `web:fixed` is a no-op and the dock pins via `position:
+     * absolute` against the screen-filling root).
+     */
+    dockClassName?: string;
+}
+export interface LiveConfigInternal extends LiveConfig {
+    roomsService: RoomsServiceInstance;
+    roomSocketService: RoomSocketService;
+    getRoomToken: GetRoomTokenFn;
+}
+export declare function useLiveConfig(): LiveConfigInternal;
+export declare function LiveConfigProvider({ config, children }: {
+    config: LiveConfig;
+    children: React.ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=LiveConfigContext.d.ts.map

package/lib/typescript/module/live/context/LiveConfigContext.d.ts.map

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

package/lib/typescript/module/live/context/LiveRoomContext.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+interface LiveRoomContextProps {
+    activeRoomId: string | null;
+    joinLiveRoom: (roomId: string) => void;
+    leaveLiveRoom: () => void;
+}
+export declare function useLiveRoom(): LiveRoomContextProps;
+export declare function LiveRoomProvider({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+export {};
+//# sourceMappingURL=LiveRoomContext.d.ts.map

package/lib/typescript/module/live/context/LiveRoomContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveRoomContext.d.ts","sourceRoot":"","sources":["../../../../../src/live/context/LiveRoomContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoE,MAAM,OAAO,CAAC;AAkBzF,UAAU,oBAAoB;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAQD,wBAAgB,WAAW,yBAE1B;AAOD,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBA6K3E"}

package/lib/typescript/module/live/hooks/useActiveSpeakers.d.ts

@@ -0,0 +1,3 @@
+import { Room } from 'livekit-client';
+export declare function useActiveSpeakers(room: Room | null): Set<string>;
+//# sourceMappingURL=useActiveSpeakers.d.ts.map

package/lib/typescript/module/live/hooks/useActiveSpeakers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveSpeakers.d.ts","sourceRoot":"","sources":["../../../../../src/live/hooks/useActiveSpeakers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAA0B,MAAM,gBAAgB,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAmChE"}

package/lib/typescript/module/live/hooks/useRoomAudio.d.ts

@@ -0,0 +1,16 @@
+import { Room } from 'livekit-client';
+interface UseRoomAudioOptions {
+    roomId: string;
+    isSpeaker: boolean;
+    isMuted: boolean;
+    isConnected: boolean;
+}
+interface UseRoomAudioReturn {
+    isLiveKitConnected: boolean;
+    localAudioEnabled: boolean;
+    micPermissionDenied: boolean;
+    livekitRoom: Room | null;
+}
+export declare function useRoomAudio({ roomId, isSpeaker, isMuted, isConnected }: UseRoomAudioOptions): UseRoomAudioReturn;
+export {};
+//# sourceMappingURL=useRoomAudio.d.ts.map

package/lib/typescript/module/live/hooks/useRoomAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRoomAudio.d.ts","sourceRoot":"","sources":["../../../../../src/live/hooks/useRoomAudio.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAqC,MAAM,gBAAgB,CAAC;AASzE,UAAU,mBAAmB;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,kBAAkB;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,mBAAmB,GAAG,kBAAkB,CA6EjH"}

package/lib/typescript/module/live/hooks/useRoomConnection.d.ts

@@ -0,0 +1,29 @@
+import type { RoomParticipant, StreamInfo } from '../types';
+interface UseRoomConnectionOptions {
+    roomId: string;
+    enabled?: boolean;
+}
+interface UseRoomConnectionReturn {
+    isConnected: boolean;
+    participants: RoomParticipant[];
+    myRole: 'host' | 'speaker' | 'listener' | null;
+    isMuted: boolean;
+    speakerRequests: Array<{
+        userId: string;
+        requestedAt: string;
+    }>;
+    activeStream: StreamInfo | null;
+    isRecording: boolean;
+    activeRecordingId: string | null;
+    join: () => void;
+    leave: () => void;
+    toggleMute: () => void;
+    requestToSpeak: () => void;
+    approveSpeaker: (userId: string) => void;
+    denySpeaker: (userId: string) => void;
+    removeSpeaker: (userId: string) => void;
+    isRoomEnded: boolean;
+}
+export declare function useRoomConnection({ roomId, enabled, }: UseRoomConnectionOptions): UseRoomConnectionReturn;
+export {};
+//# sourceMappingURL=useRoomConnection.d.ts.map

package/lib/typescript/module/live/hooks/useRoomConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRoomConnection.d.ts","sourceRoot":"","sources":["../../../../../src/live/hooks/useRoomConnection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D,UAAU,wBAAwB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,uBAAuB;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,OAAc,GACf,EAAE,wBAAwB,GAAG,uBAAuB,CAgIpD"}

package/lib/typescript/module/live/hooks/useRoomManager.d.ts

@@ -0,0 +1,11 @@
+import type { RoomAttachmentData } from "../types";
+export declare const useRoomManager: () => {
+    room: RoomAttachmentData | null;
+    setRoom: import("react").Dispatch<import("react").SetStateAction<RoomAttachmentData | null>>;
+    attachRoom: (data: RoomAttachmentData) => void;
+    removeRoom: () => void;
+    hasContent: () => boolean;
+    loadRoomFromDraft: (draftRoom: RoomAttachmentData | null) => void;
+    clearRoom: () => void;
+};
+//# sourceMappingURL=useRoomManager.d.ts.map

package/lib/typescript/module/live/hooks/useRoomManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRoomManager.d.ts","sourceRoot":"","sources":["../../../../../src/live/hooks/useRoomManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,eAAO,MAAM,cAAc;;;uBAGa,kBAAkB;;;mCAMN,kBAAkB,GAAG,IAAI;;CAI5E,CAAC"}

package/lib/typescript/module/live/hooks/useRoomUsers.d.ts

@@ -0,0 +1,5 @@
+import type { UserEntity } from '../types';
+export declare function useRoomUsers(userIds: string[]): void;
+export declare function getDisplayName(userProfile: UserEntity | undefined, userId: string, isCurrentUser?: boolean): string;
+export declare function getAvatarUrl(userProfile: UserEntity | undefined, oxyServices: unknown, getCachedFileDownloadUrlSync: (oxyServices: unknown, fileId: string, variant?: string) => string): string | undefined;
+//# sourceMappingURL=useRoomUsers.d.ts.map

package/lib/typescript/module/live/hooks/useRoomUsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRoomUsers.d.ts","sourceRoot":"","sources":["../../../../../src/live/hooks/useRoomUsers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAyB7C;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAUnH;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,UAAU,GAAG,SAAS,EACnC,WAAW,EAAE,OAAO,EACpB,4BAA4B,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,GAC/F,MAAM,GAAG,SAAS,CAGpB"}

package/lib/typescript/module/live/index.d.ts

@@ -0,0 +1,25 @@
+export type { Room, RoomParticipant, Recording, House, HouseMember, Series, SeriesEpisode, Recurrence, RoomTemplate, RoomAttachment, RoomAttachmentData, ParticipantsUpdateData, MuteUpdateData, SpeakerRequestData, RecordingStateData, StreamInfo, UserEntity, LiveTheme, HttpRequestConfig, HttpClient, FileDownloadService, } from './types';
+export { LIVE_COLOR, LIVE_TINT_COLOR, LIVE_FOREGROUND_COLOR, ROOM_TYPE_META, getRoomTypeMeta, type BadgedRoomType, type RoomTypeMeta, } from './colors';
+export { ZRoom, ZRoomParticipant, ZHouse, ZHouseMember, ZSeries, ZRecurrence, ZRoomTemplate, ZSeriesEpisode, ZRoomAttachment, ZStartStreamResponse, ZGenerateStreamKeyResponse, ZStreamInfo, ZRecording, validateRoom, validateRooms, validateHouse, validateSeries, validateRecording, validateRecordings, } from './validation';
+export { LiveConfigProvider, useLiveConfig, type LiveConfig, type LiveConfigInternal, } from './context/LiveConfigContext';
+export { LiveRoomProvider, useLiveRoom } from './context/LiveRoomContext';
+export { createRoomsService, type RoomsServiceInstance, type CreateRoomData, type PodcastResult, type EpisodeListItem, } from './services/spacesService';
+export { RoomSocketService } from './services/spaceSocketService';
+export { createGetRoomToken, type GetRoomTokenFn, } from './services/livekitService';
+export { useRoomConnection } from './hooks/useRoomConnection';
+export { useRoomAudio } from './hooks/useRoomAudio';
+export { useRoomUsers, getDisplayName, getAvatarUrl } from './hooks/useRoomUsers';
+export { useRoomManager } from './hooks/useRoomManager';
+export { useActiveSpeakers } from './hooks/useActiveSpeakers';
+export { RoomCard } from './components/RoomCard';
+export { LiveRoomSheet } from './components/LiveRoomSheet';
+export { MiniRoomBar, MINI_BAR_HEIGHT } from './components/MiniRoomBar';
+export { StreamConfigModal } from './components/StreamConfigModal';
+export { StreamConfigPanel } from './components/StreamConfigPanel';
+export { InsightsPanel } from './components/InsightsPanel';
+export { CreateRoomSheet, type CreateRoomSheetRef, type CreateRoomFormState } from './components/CreateRoomSheet';
+export { RecordingsPanel } from './components/RecordingsPanel';
+export { RecordingCard } from './components/RecordingCard';
+export { LiveRoomsIcon, LiveRoomsIconActive } from './assets/icons/spaces-icon';
+export { SyraIcon, SyraIconActive } from './assets/icons/syra-icon';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/live/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/live/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,IAAI,EACJ,eAAe,EACf,SAAS,EACT,KAAK,EACL,WAAW,EACX,MAAM,EACN,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAIjB,OAAO,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,OAAO,EACP,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EACL,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAClH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/typescript/module/live/services/livekitService.d.ts

@@ -0,0 +1,7 @@
+import type { HttpClient } from '../types';
+export type GetRoomTokenFn = (roomId: string) => Promise<{
+    token: string;
+    url: string;
+}>;
+export declare function createGetRoomToken(httpClient: Pick<HttpClient, 'post'>): GetRoomTokenFn;
+//# sourceMappingURL=livekitService.d.ts.map

package/lib/typescript/module/live/services/livekitService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekitService.d.ts","sourceRoot":"","sources":["../../../../../src/live/services/livekitService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEzF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,cAAc,CAMvF"}

package/lib/typescript/module/live/services/spaceSocketService.d.ts

@@ -0,0 +1,69 @@
+import type { RoomParticipant, ParticipantsUpdateData, MuteUpdateData, SpeakerRequestData } from '../types';
+type SimpleRoomCallback = (data: {
+    roomId: string;
+    timestamp?: string;
+}) => void;
+export declare class RoomSocketService {
+    private socket;
+    private _isConnected;
+    private socketUrl;
+    constructor(socketUrl: string);
+    get isConnected(): boolean;
+    connect(userId: string, token?: string): void;
+    disconnect(): void;
+    joinRoom(roomId: string, callback?: (res: {
+        success: boolean;
+        participants?: RoomParticipant[];
+        myRole?: string;
+        error?: string;
+    }) => void): void;
+    leaveRoom(roomId: string): void;
+    setMute(roomId: string, isMuted: boolean): void;
+    requestToSpeak(roomId: string): void;
+    approveSpeaker(roomId: string, targetUserId: string): void;
+    denySpeaker(roomId: string, targetUserId: string): void;
+    removeSpeaker(roomId: string, targetUserId: string): void;
+    onParticipantsUpdate(cb: (data: ParticipantsUpdateData) => void): () => void;
+    onParticipantMute(cb: (data: MuteUpdateData) => void): () => void;
+    onSpeakerRequestReceived(cb: (data: SpeakerRequestData) => void): () => void;
+    onSpeakerApproved(cb: SimpleRoomCallback): () => void;
+    onSpeakerDenied(cb: SimpleRoomCallback): () => void;
+    onSpeakerRemoved(cb: SimpleRoomCallback): () => void;
+    onRoomStarted(cb: SimpleRoomCallback): () => void;
+    onRoomEnded(cb: SimpleRoomCallback): () => void;
+    onUserJoined(cb: (data: {
+        userId: string;
+        role: string;
+        roomId: string;
+    }) => void): () => void;
+    onUserLeft(cb: (data: {
+        userId: string;
+        roomId: string;
+    }) => void): () => void;
+    onStreamStarted(cb: (data: {
+        roomId: string;
+        title?: string;
+        image?: string;
+        description?: string;
+        startedAt?: string;
+        durationSec?: number;
+        timestamp: string;
+    }) => void): () => void;
+    onStreamStopped(cb: (data: {
+        roomId: string;
+        timestamp: string;
+    }) => void): () => void;
+    onRecordingStarted(cb: (data: {
+        roomId: string;
+        recordingId: string;
+        timestamp: string;
+    }) => void): () => void;
+    onRecordingStopped(cb: (data: {
+        roomId: string;
+        recordingId?: string;
+        reason?: string;
+        timestamp: string;
+    }) => void): () => void;
+}
+export {};
+//# sourceMappingURL=spaceSocketService.d.ts.map

package/lib/typescript/module/live/services/spaceSocketService.d.ts.map

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

package/lib/typescript/module/live/services/spacesService.d.ts

@@ -0,0 +1,181 @@
+import type { Room, Recording, House, HttpClient } from '../types';
+export interface CreateRoomData {
+    [key: string]: unknown;
+    title: string;
+    description?: string;
+    topic?: string;
+    scheduledStart?: string;
+    speakerPermission?: 'everyone' | 'followers' | 'invited';
+    type?: 'talk' | 'stage' | 'broadcast';
+    ownerType?: 'profile' | 'house';
+    houseId?: string;
+    broadcastKind?: 'user';
+    recordingEnabled?: boolean;
+}
+export interface StreamMetadataUpdate extends Record<string, unknown> {
+    url?: string;
+    title?: string;
+    image?: string;
+    description?: string;
+}
+/** A Syra podcast show, as proxied by Mention `GET /profile/media/search?type=podcast`. */
+export interface PodcastResult {
+    syraPodcastId: string;
+    title: string;
+    author?: string;
+    artworkUrl?: string;
+}
+/**
+ * A single episode row for the picker. Deliberately carries NO audio URL — the
+ * enclosure stays server-owned and is resolved at stream-start by the backend.
+ */
+export interface EpisodeListItem {
+    episodeId: string;
+    title: string;
+    durationSec?: number;
+    publishedAt?: string;
+    artworkUrl?: string;
+}
+/**
+ * A single Syra music track row for the listening-party picker. Like the podcast
+ * rows it carries NO audio URL — the playable source (presigned original /
+ * tokenized HLS / Audius passthrough) stays server-owned and is resolved at
+ * stream-start by the backend from the opaque `trackId` alone.
+ */
+export interface MusicTrackResult {
+    trackId: string;
+    title: string;
+    artist?: string;
+    durationSec?: number;
+    artworkUrl?: string;
+}
+/** Optional seed to start a track stream: a single track, an album, or a playlist. */
+export interface StartTrackStreamBody extends Record<string, unknown> {
+    trackId?: string;
+    albumId?: string;
+    playlistId?: string;
+    /** Tracks to queue AFTER `trackId` (up-next). Only used with `trackId`. */
+    queue?: {
+        trackId: string;
+    }[];
+}
+/**
+ * The outcome of a podcast catalog fetch. `ok:false` signals a genuine request
+ * failure (network/transport error), letting the picker distinguish it from a
+ * successful-but-empty result (`ok:true` with `items: []`). Neither
+ * `searchPodcasts` nor `getPodcastEpisodes` throws — a failure resolves to
+ * `{ ok:false }`.
+ */
+export type PodcastFetchResult<T> = {
+    ok: true;
+    items: T[];
+    hasMore: boolean;
+    offset: number;
+} | {
+    ok: false;
+};
+export declare function createRoomsService(httpClient: HttpClient): {
+    getRooms(status?: string, type?: string): Promise<Room[]>;
+    getRoom(id: string): Promise<Room | null>;
+    createRoom(data: CreateRoomData): Promise<Room | null>;
+    startRoom(id: string): Promise<boolean>;
+    endRoom(id: string): Promise<boolean>;
+    stopRoom(id: string): Promise<boolean>;
+    joinRoom(id: string): Promise<boolean>;
+    leaveRoom(id: string): Promise<boolean>;
+    startStream(id: string, data: {
+        url: string;
+        title?: string;
+        image?: string;
+        description?: string;
+    }): Promise<{
+        ingressId: string;
+        url: string;
+    } | null>;
+    generateStreamKey(id: string, data?: {
+        title?: string;
+        image?: string;
+        description?: string;
+    }): Promise<{
+        rtmpUrl: string;
+        streamKey: string;
+    } | null>;
+    updateStreamMetadata(id: string, data: StreamMetadataUpdate): Promise<boolean>;
+    stopStream(id: string): Promise<boolean>;
+    searchPodcasts(query: string, offset?: number): Promise<PodcastFetchResult<PodcastResult>>;
+    getPodcastEpisodes(syraPodcastId: string, offset?: number): Promise<PodcastFetchResult<EpisodeListItem>>;
+    startPodcastStream(roomId: string, body: {
+        syraPodcastId: string;
+        episodeId: string;
+        queue?: {
+            syraPodcastId?: string;
+            episodeId: string;
+        }[];
+    }): Promise<{
+        ingressId: string;
+        url: string;
+    } | null>;
+    /**
+     * Advance a live podcast stream to the next queued episode (manager + live
+     * gated server-side). Resolves `{ ended: false }` when the next episode
+     * started, `{ ended: true }` when the queue drained (the stream will clear
+     * via the `room:stream:stopped` socket event), or `null` on failure.
+     */
+    skipPodcastNext(roomId: string): Promise<{
+        ended: boolean;
+    } | null>;
+    /**
+     * Search the Syra music catalog for the listening-party picker. Reuses the
+     * existing tracks search endpoint (`GET /tracks/search`); like the podcast
+     * search it never throws — a failure resolves to `{ ok:false }` so the picker
+     * can tell a genuine error from a successful-but-empty result.
+     */
+    searchMusic(query: string, offset?: number): Promise<PodcastFetchResult<MusicTrackResult>>;
+    /**
+     * Start streaming Syra music into the room (a "listening party"): a single
+     * track (optionally with an up-next `queue`), or an album / playlist whose
+     * ordered tracks the backend resolves into the queue. The client sends only
+     * ids — the playable audio URL is resolved server-side at stream-start.
+     */
+    startTrackStream(roomId: string, body: StartTrackStreamBody): Promise<{
+        ingressId: string;
+        url: string;
+    } | null>;
+    deleteRoom(id: string): Promise<boolean>;
+    archiveRoom(id: string): Promise<{
+        success: boolean;
+        archived: boolean;
+    }>;
+    getHouses(search?: string): Promise<House[]>;
+    getHouse(id: string): Promise<House | null>;
+    getMyHouses(userId: string): Promise<House[]>;
+    getUserHouses(userId: string): Promise<House[]>;
+    getHouseRooms(houseId: string, status?: string): Promise<Room[]>;
+    startRecording(roomId: string): Promise<boolean>;
+    stopRecording(roomId: string): Promise<boolean>;
+    getRoomRecordings(roomId: string): Promise<Recording[]>;
+    getRecording(recordingId: string): Promise<{
+        recording: Recording;
+        playbackUrl: string;
+    } | null>;
+    updateRecordingAccess(recordingId: string, access: "public" | "participants"): Promise<boolean>;
+    deleteRecording(recordingId: string): Promise<boolean>;
+    getRecordings(sortBy?: string, limit?: number): Promise<Recording[]>;
+    getTopHosts(): Promise<{
+        userId: string;
+        roomCount: number;
+        totalListeners: number;
+    }[]>;
+    createHouse(data: {
+        name: string;
+        description?: string;
+        tags?: string[];
+        isPublic?: boolean;
+    }): Promise<House | null>;
+    uploadHouseAvatar(houseId: string, formData: FormData): Promise<string | null>;
+    uploadHouseCover(houseId: string, formData: FormData): Promise<string | null>;
+    uploadRoomImage(roomId: string, formData: FormData): Promise<string | null>;
+    uploadSeriesCover(seriesId: string, formData: FormData): Promise<string | null>;
+};
+export type RoomsServiceInstance = ReturnType<typeof createRoomsService>;
+//# sourceMappingURL=spacesService.d.ts.map

package/lib/typescript/module/live/services/spacesService.d.ts.map

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

package/lib/typescript/module/live/types.d.ts

@@ -0,0 +1,100 @@
+import type { RoomParticipant } from './validation';
+export type { Room, RoomParticipant, Recording, House, HouseMember, Series, SeriesEpisode, Recurrence, RoomTemplate, RoomAttachment, } from './validation';
+/**
+ * The "now playing" stream surfaced in the live room. Derived from the
+ * `room:stream:started` socket payload (and the room's persisted stream fields);
+ * it is NOT parsed through zod, so it stays a plain structural type rather than
+ * `z.infer<typeof ZStreamInfo>`. `startedAt` / `durationSec` are present for
+ * length-known streams (e.g. a podcast episode) and drive the progress bar;
+ * manual URL/RTMP streams omit them and render no progress UI.
+ */
+export interface StreamInfo {
+    title?: string;
+    image?: string;
+    description?: string;
+    /** ISO timestamp when the current stream began. */
+    startedAt?: string;
+    /** Total length of the current stream in seconds, when known. */
+    durationSec?: number;
+}
+export interface ParticipantsUpdateData {
+    roomId: string;
+    participants: RoomParticipant[];
+    count: number;
+    timestamp: string;
+}
+export interface MuteUpdateData {
+    userId: string;
+    isMuted: boolean;
+    timestamp: string;
+}
+export interface SpeakerRequestData {
+    roomId: string;
+    userId: string;
+    timestamp: string;
+}
+export interface RecordingStateData {
+    roomId: string;
+    recordingId: string;
+    reason?: 'manual' | 'max_duration' | 'room_ended' | 'room_stopped';
+    timestamp: string;
+}
+export interface RoomAttachmentData {
+    roomId: string;
+    title: string;
+    status?: 'scheduled' | 'live' | 'ended';
+    type?: 'talk' | 'stage' | 'broadcast';
+    topic?: string;
+    host?: string;
+}
+export interface UserEntity {
+    id: string;
+    username?: string;
+    name?: {
+        displayName?: string;
+        full?: string;
+        first?: string;
+        last?: string;
+    } | string;
+    handle?: string;
+    avatar?: string | null;
+    verified?: boolean;
+    bio?: string;
+    displayName?: string;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+export interface LiveTheme {
+    isDark?: boolean;
+    colors: {
+        text: string;
+        textSecondary: string;
+        background: string;
+        backgroundSecondary: string;
+        card: string;
+        border: string;
+        primary: string;
+        [key: string]: string;
+    };
+}
+export interface HttpRequestConfig {
+    params?: Record<string, string | number | boolean | undefined>;
+    [key: string]: unknown;
+}
+/**
+ * The HTTP client the engine consumes. Deliberately shaped to match an Oxy
+ * `oxyServices.createLinkedClient(...).client` as-is: every method resolves to
+ * the PARSED RESPONSE BODY directly (not a `{ data }` envelope). Consumers pass
+ * that Oxy client straight through — no per-app adapter.
+ */
+export interface HttpClient {
+    get: (url: string, config?: HttpRequestConfig) => Promise<Record<string, unknown>>;
+    post: (url: string, data?: Record<string, unknown> | FormData, config?: HttpRequestConfig) => Promise<Record<string, unknown>>;
+    patch: (url: string, data?: Record<string, unknown>, config?: HttpRequestConfig) => Promise<Record<string, unknown>>;
+    delete: (url: string, config?: HttpRequestConfig) => Promise<Record<string, unknown>>;
+}
+export interface FileDownloadService {
+    getFileDownloadUrl?(fileId: string, variant?: string, expiresIn?: number): string;
+    getFileDownloadUrlAsync?(fileId: string, variant?: string, expiresIn?: number): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/live/types.d.ts.map

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