@dxos/plugin-thread 0.8.4-main.abd8ff62ef → 0.8.4-main.bc2380dfbc

package/src/components/ResponsiveGrid/ResponsivePanel.tsx

@@ -1,31 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import React, { type PropsWithChildren } from 'react';
-
-import { mx } from '@dxos/ui-theme';
-
-/**
- * A container component that maintains the child's aspect ratio while centering its content.
- * The container will scale to fit within its parent's bounds while preserving the aspect ratio.
- *
- * @example
- * <ResponsivePanel>
- *   <VideoObject />
- * </ResponsivePanel>
- */
-export const ResponsivePanel = ({ children }: PropsWithChildren) => {
-  return (
-    // Outer container that takes full size of parent.
-    <div role='none' className='dx-expander relative flex'>
-      {/* Absolute positioning layer for centering content. */}
-      <div role='none' className='absolute inset-0 flex justify-center items-center'>
-        {/* Content container that maintains given aspect ratio and proper scaling. */}
-        <div role='none' className={mx('max-h-full max-w-full w-auto h-auto aspect-video')}>
-          {children}
-        </div>
-      </div>
-    </div>
-  );
-};

package/src/components/ResponsiveGrid/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export * from './ResponsivePanel';
-export * from './ResponsiveGrid';
-export * from './ResponsiveGridItem';

package/src/containers/CallDebugPanel/CallDebugPanel.tsx

@@ -1,173 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { WebRTCStats, type WebRTCStatsEvent } from '@peermetrics/webrtc-stats';
-import React, { useEffect, useMemo, useState } from 'react';
-
-import { truncateKey } from '@dxos/debug';
-import { JsonView, Panel } from '@dxos/devtools';
-import { log } from '@dxos/log';
-import { IconButton, Input, type ThemedClassName, useTranslation } from '@dxos/react-ui';
-
-import { meta } from '#meta';
-
-import { type EncodedTrackName, type GlobalState } from '../../calls';
-
-export type CallDebugPanelProps = ThemedClassName<{ state?: GlobalState }>;
-
-export const CallDebugPanel = ({ state }: CallDebugPanelProps) => {
-  const { t } = useTranslation(meta.id);
-
-  const [open, setOpen] = useState(false);
-  const handleToggle = () => setOpen(!open);
-  const [showServiceHistory, setShowServiceHistory] = useState(false);
-  const handleToggleServiceHistory = () => setShowServiceHistory(!showServiceHistory);
-
-  const handleCopyRaw = async () => {
-    await navigator.clipboard.writeText(JSON.stringify({ users: state?.call?.users, stats }, null, 2));
-  };
-
-  const [showDetailedWebRTCStats, setShowDetailedWebRTCStats] = useState(false);
-  const handleShowDetailedWebRTCStats = () => setShowDetailedWebRTCStats(!showDetailedWebRTCStats);
-
-  const webrtcStats = useMemo(
-    () =>
-      new WebRTCStats({
-        getStatsInterval: 1000,
-      }),
-    [],
-  );
-  const [stats, setStats] = useState<WebRTCStatsEvent['data']>();
-
-  useEffect(() => {
-    const pc = state?.media.peer?.session?.peerConnection;
-    const handleStats = (stats: WebRTCStatsEvent) => {
-      setStats(stats.data);
-    };
-    let added = false;
-    if (pc && showDetailedWebRTCStats) {
-      webrtcStats.addConnection({ pc, peerId: 1, connectionId: '1' });
-      webrtcStats.on('stats', handleStats as never);
-      added = true;
-    }
-    return () => {
-      try {
-        if (pc && added) {
-          webrtcStats.removeConnection({ pc });
-          webrtcStats.removeListener('stats', handleStats as never);
-        }
-      } catch (error) {
-        log.error('error removing webrtc stats', { error, pc, peerId: 1, connectionId: '1' });
-      }
-    };
-  }, [state?.media.peer?.session?.peerConnection, showDetailedWebRTCStats]);
-
-  const rows = useMemo(() => getCallStatusTable(state), [state?.call.users, state?.media.pulledAudioTracks]);
-
-  return (
-    <Panel
-      id='meeting-status'
-      icon='ph--video-conference--regular'
-      open={open}
-      onToggle={handleToggle}
-      title={t('meeting-status.title')}
-      info={<div className='flex items-center gap-2'> {state?.call.joined ? 'Active' : 'Inactive'}</div>}
-      maxHeight={0}
-    >
-      <div className='flex flex-col w-full text-xs'>
-        <div className='flex items-center gap-2 items-center'>
-          <Input.Root>
-            <Input.Switch checked={showDetailedWebRTCStats} onCheckedChange={handleShowDetailedWebRTCStats} />
-            <Input.Label>{t('show-webrtc-stats.title')}</Input.Label>
-          </Input.Root>
-        </div>
-        <div className='flex items-center gap-2 items-center'>
-          <Input.Root>
-            <Input.Switch checked={showServiceHistory} onCheckedChange={handleToggleServiceHistory} />
-            <Input.Label>{t('show-calls-history.title')}</Input.Label>
-          </Input.Root>
-        </div>
-        <div className='flex items-center gap-2 items-center'>
-          <IconButton icon='ph--copy--regular' label={'copy raw'} onClick={handleCopyRaw} />
-        </div>
-        <Table rows={rows} />
-        {showDetailedWebRTCStats && <JsonView data={{ stats }} />}
-        {showServiceHistory && <JsonView data={{ history: state?.media.peer?.history.get() }} />}
-      </div>
-    </Panel>
-  );
-};
-
-const getCallStatusTable = (state?: GlobalState): TableProps['rows'] => {
-  if (!state || !state.call?.users) {
-    return [];
-  }
-
-  const self = state.call.self;
-  const users = state.call.users
-    .filter((user) => user.id !== self!.id)
-    .map((user) => {
-      const isOk = {
-        audio:
-          user.tracks?.audio &&
-          state.media.pulledAudioTracks[user.tracks?.audio as EncodedTrackName]?.ctx.disposed === false,
-        video:
-          user.tracks?.video &&
-          state.media.pulledVideoStreams[user.tracks?.video as EncodedTrackName]?.ctx.disposed === false,
-        screenshare:
-          user.tracks?.screenshare &&
-          state.media.pulledVideoStreams[user.tracks?.screenshare as EncodedTrackName]?.ctx.disposed === false,
-      };
-
-      return {
-        ...user,
-        isOk,
-      };
-    });
-
-  return [
-    ['users', state.call.users.length ?? 0],
-    [
-      '*self* ' + (self?.name ?? truncateKey(self!.id, 8)),
-      self?.tracks?.audio && state.media.pushedAudioTrack ? 'AUD ✅' : 'AUD ❌',
-      self?.tracks?.video && state.media.pushedVideoTrack ? 'VID ✅' : 'VID ❌',
-      self?.tracks?.screenshareEnabled
-        ? self.tracks.screenshareEnabled && state.media.pushedScreenshareTrack
-          ? 'SCR ✅'
-          : 'SCR ❌'
-        : undefined,
-    ],
-
-    ...users.map((user) => [
-      user.name ?? truncateKey(user.id, 8),
-      user.isOk.audio ? 'AUD ✅' : 'AUD ❌',
-      user.isOk.video ? 'VID ✅' : 'VID ❌',
-      user.tracks?.screenshareEnabled ? (user.isOk.screenshare ? 'SCR ✅' : 'SCR ❌') : undefined,
-    ]),
-    ['ICE', state.media.peer?.session?.peerConnection.iceConnectionState ?? 'no connection'],
-  ];
-};
-
-export namespace Unit {
-  export const KB = (n?: number) => ((n ?? 0) / 1_000).toFixed(2);
-}
-
-export type TableProps = {
-  rows: (string | number | undefined)[][];
-};
-
-export const Table = ({ rows }: TableProps) => {
-  return (
-    <div className='w-full text-xs font-mono'>
-      {rows.map(([prefix, label, value, unit], i) => (
-        <div key={i} className='grid grid-cols-[3fr_1fr_1fr_1fr]'>
-          <div className='p-1'>{prefix}</div>
-          <div className='p-1'>{label}</div>
-          <div className='p-1'>{value}</div>
-          <div className='p-1'>{unit}</div>
-        </div>
-      ))}
-    </div>
-  );
-};

package/src/containers/CallDebugPanel/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-export { CallDebugPanel as default } from './CallDebugPanel';

package/src/containers/CallSidebar/CallSidebar.tsx

@@ -1,18 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { useAtomValue } from '@effect-atom/atom-react';
-import React from 'react';
-
-import { useCapability } from '@dxos/app-framework/ui';
-
-import { ThreadCapabilities } from '#types';
-
-import ChannelContainer from '../ChannelContainer';
-
-export const CallSidebar = () => {
-  const call = useCapability(ThreadCapabilities.CallManager);
-  const roomId = useAtomValue(call.roomIdAtom);
-  return <ChannelContainer subject={undefined} attendableId={roomId ?? ''} roomId={roomId} role='article' />;
-};

package/src/containers/CallSidebar/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-export { CallSidebar as default } from './CallSidebar';

package/src/containers/ChannelContainer/ChannelContainer.tsx

@@ -1,223 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Atom, useAtomValue } from '@effect-atom/atom-react';
-import React, { type ChangeEvent, useCallback, useEffect, useMemo, useState } from 'react';
-
-import { useCapabilities, useCapability } from '@dxos/app-framework/ui';
-import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { Context } from '@dxos/context';
-import { failUndefined } from '@dxos/debug';
-import { log } from '@dxos/log';
-import { useClient } from '@dxos/react-client';
-import { getSpace } from '@dxos/react-client/echo';
-import { useIdentity } from '@dxos/react-client/halo';
-import { Button, ElevationProvider, Input, Panel, useTranslation } from '@dxos/react-ui';
-import { Settings } from '@dxos/react-ui-form';
-import { Menu, MenuRootProps, createMenuAction, createMenuItemGroup, useMenuActions } from '@dxos/react-ui-menu';
-import { useSoundEffect } from '@dxos/react-ui-sfx';
-import { type Channel } from '@dxos/types';
-import { composable, composableProps } from '@dxos/ui-theme';
-
-import { Call } from '#components';
-import { meta } from '#meta';
-import { ThreadCapabilities } from '#types';
-
-import { ChannelChat } from '../ChannelChat';
-
-export type ChannelContainerProps = AppSurface.ObjectArticleProps<
-  Channel.Channel | undefined,
-  {
-    roomId?: string;
-    fullscreen?: boolean;
-  }
->;
-
-/**
- * Renders a call when active, otherwise renders the channel chat.
- */
-// TODO(burdon): Create Radix style layout.
-export const ChannelContainer = ({
-  role,
-  subject: channel,
-  attendableId,
-  roomId: roomIdProp,
-  fullscreen,
-}: ChannelContainerProps) => {
-  const space = getSpace(channel);
-  const callManager = useCapability(ThreadCapabilities.CallManager);
-  const extensions = useCapabilities(ThreadCapabilities.CallExtension);
-  const joined = useAtomValue(callManager.joinedAtom);
-  const currentRoomId = useAtomValue(callManager.roomIdAtom);
-  const roomId = roomIdProp ?? attendableId ?? failUndefined();
-  const identity = useIdentity();
-  const isNamed = !!identity?.profile?.displayName;
-  const joinSound = useSoundEffect('JoinCall');
-  const leaveSound = useSoundEffect('LeaveCall');
-
-  useEffect(() => {
-    const ctx = new Context();
-    callManager.left.on(ctx, (roomId) => {
-      extensions.forEach((extension) => {
-        void extension.onLeave?.(roomId);
-      });
-    });
-
-    callManager.callStateUpdated.on(ctx, (state) => {
-      extensions.forEach((extension) => {
-        void extension.onCallStateUpdated?.(state);
-      });
-    });
-
-    callManager.mediaStateUpdated.on(ctx, (state) => {
-      extensions.forEach((extension) => {
-        void extension.onMediaStateUpdated?.(state);
-      });
-    });
-
-    return () => {
-      void ctx.dispose();
-    };
-  }, [callManager, extensions]);
-
-  /**
-   * Join the call.
-   */
-  // TODO(wittjosiah): Show preview before joining?
-  const handleJoin = useCallback(async () => {
-    if (!roomId || !channel) {
-      return;
-    }
-
-    if (joined) {
-      await callManager.leave();
-    }
-
-    try {
-      void joinSound.play();
-      callManager.setRoomId(roomId);
-      await callManager.join();
-      await Promise.all(extensions.map((extension) => extension.onJoin?.({ channel, roomId })));
-    } catch (err) {
-      // TODO(burdon): Error sound.
-      log.catch(err);
-    }
-  }, [extensions, channel, roomId, joined]);
-
-  /**
-   * Leave the call.
-   */
-  const handleLeave = useCallback(async () => {
-    try {
-      void leaveSound.play();
-    } catch (err) {
-      // TODO(burdon): Error sound.
-      log.catch(err);
-    } finally {
-      void callManager.turnAudioOff();
-      void callManager.turnVideoOff();
-      void callManager.turnScreenshareOff();
-      void callManager.leave();
-    }
-  }, [extensions, roomId]);
-
-  const isJoined = joined && currentRoomId === roomId;
-  if (isJoined) {
-    return (
-      <Panel.Root>
-        <Panel.Content>
-          {isNamed ? (
-            <Call.Root>
-              <Call.Grid fullscreen={fullscreen} />
-              <Call.Toolbar channel={channel} onLeave={handleLeave} />
-            </Call.Root>
-          ) : (
-            <DisplayNameMissing />
-          )}
-        </Panel.Content>
-      </Panel.Root>
-    );
-  }
-
-  if (channel && space) {
-    return (
-      <Panel.Root classNames='dx-document'>
-        <Panel.Toolbar asChild>
-          <ChannelToolbar attendableId={attendableId} role={role} onJoinCall={handleJoin} />
-        </Panel.Toolbar>
-        <Panel.Content asChild>
-          <ChannelChat space={space} channel={channel} />
-        </Panel.Content>
-      </Panel.Root>
-    );
-  }
-
-  return null;
-};
-
-const DisplayNameMissing = () => {
-  const { t } = useTranslation(meta.id);
-  const client = useClient();
-  const [displayName, setDisplayName] = useState('');
-  const handleChange = useCallback((event: ChangeEvent<HTMLInputElement>) => setDisplayName(event.target.value), []);
-  const handleSave = useCallback(() => client.halo.updateProfile({ displayName }), [client, displayName]);
-
-  return (
-    <div className='space-y-trim-md p-4 place-content-center'>
-      <Settings.Item title={t('display-name.label')} description={t('display-name.description')}>
-        <Input.TextInput
-          value={displayName}
-          onChange={handleChange}
-          placeholder={t('display-name-input.placeholder')}
-          classNames='md:min-w-64'
-        />
-      </Settings.Item>
-      <Button classNames='md:col-span-2' disabled={!displayName} onClick={handleSave}>
-        {t('set-display-name.label')}
-      </Button>
-    </div>
-  );
-};
-
-const useChannelToolbarActions = (onJoinCall?: () => void) => {
-  const creator = useMemo(
-    () =>
-      Atom.make(() => {
-        return {
-          nodes: [
-            createMenuItemGroup('root', {
-              label: ['channel-toolbar.title', { ns: meta.id }],
-            }),
-            createMenuAction('video-call', () => onJoinCall?.(), {
-              label: ['start-video-call.menu', { ns: meta.id }],
-              icon: 'ph--video-camera--regular',
-              type: 'video-call',
-            }),
-          ],
-          edges: [{ source: 'root', target: 'video-call', relation: 'child' }],
-        };
-      }),
-    [],
-  );
-
-  return useMenuActions(creator);
-};
-
-type ChannelToolbarProps = Pick<MenuRootProps, 'attendableId'> & {
-  onJoinCall?: () => void;
-};
-
-const ChannelToolbar = composable<HTMLDivElement, ChannelToolbarProps>(
-  ({ attendableId, role, onJoinCall, ...props }, forwardedRef) => {
-    const menuActions = useChannelToolbarActions(onJoinCall);
-
-    return (
-      <ElevationProvider elevation={role === 'section' ? 'positioned' : 'base'}>
-        <Menu.Root {...menuActions} attendableId={attendableId}>
-          <Menu.Toolbar {...composableProps(props)} ref={forwardedRef} />
-        </Menu.Root>
-      </ElevationProvider>
-    );
-  },
-);

package/src/containers/ChannelContainer/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export { ChannelContainer as default } from './ChannelContainer';

package/src/hooks/useBlackCanvasStreamTrack.tsx

@@ -1,27 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useState } from 'react';
-
-import { scheduleTask } from '@dxos/async';
-import { Context } from '@dxos/context';
-
-import { createBlackCanvasStreamTrack } from '../calls/util/stub-media-streams';
-
-export const useBlackCanvasStreamTrack = () => {
-  const [blackCanvasStreamTrack, setBlackCanvasStreamTrack] = useState<MediaStreamTrack | undefined>(undefined);
-  useEffect(() => {
-    const ctx = new Context();
-    scheduleTask(ctx, async () => {
-      const blackCanvasStreamTrack = await createBlackCanvasStreamTrack({ ctx, width: 720, height: 480 });
-      setBlackCanvasStreamTrack(blackCanvasStreamTrack);
-    });
-
-    return () => {
-      void ctx.dispose();
-    };
-  }, []);
-
-  return blackCanvasStreamTrack;
-};

package/src/hooks/useDebugMode.ts

@@ -1,25 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useState } from 'react';
-
-// TODO(burdon): Standardize across plugins/composer.
-export const useDebugMode = () => {
-  const [enabled, setEnabled] = useState(false);
-  useEffect(() => {
-    const handler = (ev: KeyboardEvent) => {
-      if (ev.key.toLowerCase() === 'd' && ev.ctrlKey) {
-        ev.preventDefault();
-        setEnabled(!enabled);
-      }
-    };
-
-    document.addEventListener('keypress', handler);
-    return () => {
-      document.removeEventListener('keypress', handler);
-    };
-  }, [enabled]);
-
-  return enabled;
-};

package/src/hooks/useInaudibleAudioStreamTrack.tsx

@@ -1,27 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useState } from 'react';
-
-import { scheduleTask } from '@dxos/async';
-import { Context } from '@dxos/context';
-
-import { createInaudibleAudioStreamTrack } from '../calls/util/stub-media-streams';
-
-export const useInaudibleAudioStreamTrack = () => {
-  const [audioStreamTrack, setAudioStreamTrack] = useState<MediaStreamTrack | undefined>(undefined);
-  useEffect(() => {
-    const ctx = new Context();
-    scheduleTask(ctx, async () => {
-      const audioStreamTrack = await createInaudibleAudioStreamTrack({ ctx });
-      setAudioStreamTrack(audioStreamTrack);
-    });
-
-    return () => {
-      void ctx.dispose();
-    };
-  }, []);
-
-  return audioStreamTrack;
-};

package/src/hooks/useVideoStreamTrack.tsx

@@ -1,36 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type RefObject, useEffect, useRef, useState } from 'react';
-
-export const useVideoStreamTrack = (videoElement: RefObject<HTMLVideoElement | null>, videoSrc: string) => {
-  // Get video stream track.
-  const [videoStreamTrack, setVideoStreamTrack] = useState<MediaStreamTrack | undefined>(undefined);
-  const hadRun = useRef(false);
-  useEffect(() => {
-    // This is done to capture only one video stream.
-    if (!videoElement.current || hadRun.current || !videoSrc) {
-      return;
-    }
-    hadRun.current = true;
-    videoElement.current.addEventListener('playing', () => {
-      if (videoStreamTrack) {
-        return;
-      }
-      const stream = (videoElement.current as any).captureStream();
-      const track = stream.getTracks()[0];
-      if (track && !videoStreamTrack) {
-        setVideoStreamTrack(track);
-      }
-      stream.onaddtrack = (event: MediaStreamTrackEvent) => {
-        if (event.track.kind === 'video' && !videoStreamTrack) {
-          setVideoStreamTrack(event.track);
-        }
-      };
-    });
-    videoElement.current.src = videoSrc;
-  }, [videoElement.current, videoSrc]);
-
-  return videoStreamTrack;
-};

package/src/types/capabilities.ts

@@ -1,37 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type Atom } from '@effect-atom/atom-react';
-
-import { Capability } from '@dxos/app-framework';
-import { type Channel } from '@dxos/types';
-
-import { meta } from '#meta';
-
-import { type CallManager, type CallState, type MediaState } from '../calls';
-import { type ThreadState, type ViewStore } from '../types';
-import * as Settings from './Settings';
-
-export namespace ThreadCapabilities {
-  export const Settings = Capability.make<Atom.Writable<Settings.Settings>>(`${meta.id}.capability.settings`);
-  export const CallManager = Capability.make<CallManager>(`${meta.id}.capability.call-manager`);
-
-  // TODO(burdon): Better way to define specific extensions for meeting companions.
-  // TODO(burdon): This brings in deps from ../calls; how should we manage/minimize explicit type exposure to other plugins?
-  // TODO(wittjosiah): These callbacks could be intents once we support broadcast.
-  export type CallProperties = {
-    onJoin: (state: { channel?: Channel.Channel; roomId?: string }) => Promise<void>;
-    onLeave: (roomId?: string) => Promise<void>;
-    onCallStateUpdated: (callState: CallState) => Promise<void>;
-    onMediaStateUpdated: ([mediaState, isSpeaking]: [MediaState, boolean]) => Promise<void>;
-  };
-
-  export const CallExtension = Capability.make<CallProperties>(`${meta.id}.capability.call-extension`);
-
-  /** Thread state (drafts, toolbar state, current selection). */
-  export const State = Capability.make<Atom.Writable<ThreadState>>(`${meta.id}.capability.state`);
-
-  /** Per-subject view state (e.g., showResolvedThreads). */
-  export const ViewState = Capability.make<Atom.Writable<ViewStore>>(`${meta.id}.capability.view-state`);
-}

package/src/typings/peermetrics-webrtc-stats.d.ts

@@ -1,46 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-declare module '@peermetrics/webrtc-stats' {
-  import { EventEmitter } from 'events';
-
-  export interface WebRTCStatsConstructorOptions {
-    getStatsInterval?: number;
-    rawStats?: boolean;
-    statsObject?: boolean;
-    filteredStats?: boolean;
-    wrapGetUserMedia?: boolean;
-    debug?: boolean;
-    remote?: boolean;
-    logLevel?: LogLevel;
-  }
-
-  export interface ConnectionInfo {
-    pc: RTCPeerConnection;
-    peerId: number | string;
-    connectionId: string;
-  }
-
-  type TrackStats = {
-    id: string;
-    kind: 'audio' | 'video';
-    codecId: string;
-    mid: string;
-    bytesSent: number;
-    bytesReceived: number;
-  };
-
-  export type WebRTCStatsEvent = {
-    data: {
-      audio: { inbound: TrackStats[]; outbound: TrackStats[] };
-      video: { inbound: TrackStats[]; outbound: TrackStats[] };
-    };
-  };
-
-  export class WebRTCStats extends EventEmitter<{ stats: WebRTCStatsEvent }> {
-    constructor(options: WebRTCStatsConstructorOptions);
-    addConnection(info: ConnectionInfo): void;
-    removeConnection(info: Pick<ConnectionInfo, 'pc'>): void;
-  }
-}

package/src/typings.d.ts

@@ -1,8 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-declare module '*.mp4?raw' {
-  const content: string;
-  export default content;
-}