@flamingo-stack/openframe-frontend-core 0.0.701 → 0.0.702

package/src/components/features/remote-session/remote-session-status.tsx

@@ -0,0 +1,102 @@
+'use client';
+
+import { cn } from '../../../utils/cn';
+import { AlertTriangleIcon, LockIcon } from '../../icons-v2-generated';
+import { Tag } from '../../ui/tag';
+import type { RemoteSessionStatus } from './types';
+
+/** The pulsing dot of the LIVE tag; still when the user asks for reduced motion. */
+function LiveDot() {
+  return <span aria-hidden className="size-2 animate-live-pulse rounded-full bg-current motion-reduce:animate-none" />;
+}
+
+const STATUS_TAG: Record<RemoteSessionStatus, { label: string; variant: 'critical' | 'warning' | 'error' }> = {
+  live: { label: 'Live', variant: 'critical' },
+  processing: { label: 'Processing', variant: 'warning' },
+  failed: { label: 'Failed', variant: 'error' },
+};
+
+export interface RemoteSessionStatusTagProps {
+  status: RemoteSessionStatus;
+  className?: string;
+}
+
+/** LIVE / PROCESSING / FAILED beside a session's date in the session list and on its page. */
+export function RemoteSessionStatusTag({ status, className }: RemoteSessionStatusTagProps) {
+  const { label, variant } = STATUS_TAG[status];
+  return (
+    <Tag
+      label={label}
+      variant={variant}
+      icon={status === 'live' ? <LiveDot /> : undefined}
+      className={cn('pointer-events-none shrink-0', className)}
+    />
+  );
+}
+
+export type RemoteSessionExpiryProps = { className?: string } & (
+  | { state: 'kept'; keptBy: string; reason: string }
+  | { state: 'scheduled'; date: string; remaining?: string | null }
+  | { state: 'expired' }
+  | { state: 'none' }
+);
+
+/** The EXPIRES cell of a recording: its expiry date, the Keep holding it, or that it has expired. */
+export function RemoteSessionExpiry(props: RemoteSessionExpiryProps) {
+  const { className } = props;
+  if (props.state === 'none') {
+    return <p className={cn('text-ods-text-primary text-h4', className)}>-</p>;
+  }
+  if (props.state === 'expired') {
+    return <p className={cn('text-ods-text-secondary text-h4', className)}>Expired</p>;
+  }
+  if (props.state === 'kept') {
+    return (
+      <div className={cn('flex min-w-0 flex-col', className)}>
+        <p className="flex items-center gap-[var(--spacing-system-xxs)] text-ods-text-primary text-h4">
+          <LockIcon size={24} color="currentColor" className="shrink-0" />
+          Kept
+        </p>
+        <p className="truncate text-ods-text-secondary text-h6">
+          Kept by {props.keptBy} · {props.reason}
+        </p>
+      </div>
+    );
+  }
+  return (
+    <div className={cn('flex min-w-0 flex-col', className)}>
+      <p className="text-ods-text-primary text-h4">{props.date}</p>
+      {props.remaining && <p className="truncate text-ods-text-secondary text-h6">{props.remaining}</p>}
+    </div>
+  );
+}
+
+export interface RemoteSessionStorageAlertProps {
+  /** `device` on the device page (new sessions there aren't recorded); `session` on a running session. */
+  scope: 'device' | 'session';
+  /** The plan's recording storage, e.g. "100 GB"; named on the device page. */
+  capacity?: string | null;
+  className?: string;
+}
+
+/** The banner shown while the tenant's recording storage is full. */
+export function RemoteSessionStorageAlert({ scope, capacity, className }: RemoteSessionStorageAlertProps) {
+  const message =
+    scope === 'session'
+      ? "This session isn't being recorded. Recording storage is full. New sessions aren't recorded until space is freed."
+      : `Recording storage full. New sessions aren't recorded.${
+          capacity ? ` All ${capacity} of recording storage is used.` : ''
+        }`;
+  return (
+    <div
+      role="alert"
+      className={cn(
+        'flex w-full items-start gap-[var(--spacing-system-m)] rounded-md bg-ods-warning-secondary p-[var(--spacing-system-s)] text-ods-warning',
+        className,
+      )}
+    >
+      <AlertTriangleIcon size={24} color="currentColor" className="shrink-0" />
+      <p className="min-w-0 flex-1 text-h3">{message}</p>
+    </div>
+  );
+}

package/src/components/features/remote-session/remote-session-viewers.tsx

@@ -0,0 +1,103 @@
+'use client';
+
+import { useState } from 'react';
+import { cn } from '../../../utils/cn';
+import { Chevron02DownIcon, Chevron02UpIcon } from '../../icons-v2-generated';
+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from '../../ui/dropdown-menu';
+import { SquareAvatar } from '../../ui/square-avatar';
+import type { RemoteSessionViewer } from './types';
+
+function viewerLabel(viewer: RemoteSessionViewer): string {
+  if (viewer.isHost) return `${viewer.name} (host)`;
+  if (viewer.isYou) return `${viewer.name} (you)`;
+  return viewer.name;
+}
+
+/** The host first, everyone else in the order the backend reports them. */
+function hostFirst(viewers: RemoteSessionViewer[]): RemoteSessionViewer[] {
+  return [...viewers.filter(viewer => viewer.isHost), ...viewers.filter(viewer => !viewer.isHost)];
+}
+
+export interface RemoteSessionViewersProps {
+  /** Everyone in the session, the host included. */
+  viewers: RemoteSessionViewer[];
+  /** Faces shown before the rest collapse into "+N". */
+  max?: number;
+  className?: string;
+}
+
+/**
+ * Who is in a live session: an avatar stack (the host ringed in the accent
+ * colour) that opens the full list. Shown to the host, to the watchers and to
+ * the end user.
+ */
+export function RemoteSessionViewers({ viewers, max = 4, className }: RemoteSessionViewersProps) {
+  const [open, setOpen] = useState(false);
+  if (viewers.length === 0) return null;
+
+  const ordered = hostFirst(viewers);
+  const faces = ordered.slice(0, max);
+  const overflow = ordered.length - faces.length;
+  const Chevron = open ? Chevron02UpIcon : Chevron02DownIcon;
+
+  return (
+    <DropdownMenu open={open} onOpenChange={setOpen}>
+      <DropdownMenuTrigger
+        aria-label={`In this session: ${ordered.map(viewerLabel).join(', ')}`}
+        className={cn(
+          'flex shrink-0 items-center gap-[var(--spacing-system-xxs)] rounded-md outline-none',
+          'focus-visible:ring-2 focus-visible:ring-ods-focus',
+          className,
+        )}
+      >
+        <span className="flex items-center">
+          {faces.map((viewer, index) => (
+            <SquareAvatar
+              key={viewer.id}
+              variant="round"
+              sizePx={32}
+              src={viewer.avatarUrl ?? undefined}
+              alt={viewer.name}
+              fallback={viewer.name}
+              className={cn(
+                'relative bg-ods-bg',
+                viewer.isHost ? 'ring-2 ring-ods-accent' : 'ring-1 ring-ods-border',
+                index > 0 && '-ml-2',
+              )}
+              style={{ zIndex: faces.length - index + 1 }}
+            />
+          ))}
+          {overflow > 0 && (
+            <span className="relative -ml-2 flex size-8 shrink-0 items-center justify-center rounded-full bg-ods-bg text-ods-text-secondary ring-1 ring-ods-border text-h6">
+              +{overflow}
+            </span>
+          )}
+        </span>
+        <span className="flex size-8 items-center justify-center rounded-md text-ods-text-primary">
+          <Chevron size={16} color="currentColor" />
+        </span>
+      </DropdownMenuTrigger>
+      <DropdownMenuContent align="end" className="w-[280px] p-0">
+        {ordered.map(viewer => (
+          <DropdownMenuItem
+            key={viewer.id}
+            className={cn(
+              'gap-[var(--spacing-system-xsf)] rounded-none border-b border-ods-border bg-ods-bg last:border-b-0',
+              'py-[var(--spacing-system-s)] pl-[var(--spacing-system-mf)] pr-[var(--spacing-system-xs)] text-h4',
+            )}
+          >
+            <SquareAvatar
+              variant="round"
+              sizePx={24}
+              src={viewer.avatarUrl ?? undefined}
+              alt=""
+              fallback={viewer.name}
+              className="shrink-0"
+            />
+            <span className="min-w-0 flex-1 truncate">{viewerLabel(viewer)}</span>
+          </DropdownMenuItem>
+        ))}
+      </DropdownMenuContent>
+    </DropdownMenu>
+  );
+}

package/src/components/features/remote-session/types.ts

@@ -31,6 +31,32 @@ export interface RemoteSessionChatMessage {
 /** The terminal dialogs of a session: the end confirm and the two "it is over" notices. */
 export type RemoteSessionDialogVariant = 'end-confirm' | 'session-ended' | 'connection-lost';
 
+/** Someone in a live session: the technician running it (the host) or a colleague watching. */
+export interface RemoteSessionViewer {
+  id: string;
+  name: string;
+  avatarUrl?: string | null;
+  /** The technician running the session; listed first and ringed in the accent colour. */
+  isHost?: boolean;
+  /** The signed-in user, labelled "(you)" in the list. */
+  isYou?: boolean;
+}
+
+/** Where a remote session's recording is in its lifecycle, as the session list tags it. */
+export type RemoteSessionStatus = 'live' | 'processing' | 'failed';
+
+/** Why a recording is kept past its expiry date. */
+export type RemoteSessionKeepReason = 'CLIENT_DISPUTE' | 'INTERNAL_REVIEW' | 'LEGAL_OR_COMPLIANCE' | 'OTHER';
+
+/** A moment of the session, placed on the recording by its offset from the start. */
+export interface RemoteSessionEvent {
+  id: string;
+  /** Milliseconds from the start of the recording. */
+  offsetMs: number;
+  title: string;
+  detail?: string | null;
+}
+
 /**
  * Pointer handlers a host attaches to the surfaces the user moves the window
  * by (the desktop chat starts a native window drag from them).

package/tailwind.config.ts

@@ -413,6 +413,11 @@ const config: Config = {
           '0%, 80%, 100%': { transform: 'scale(1)', opacity: '0.7' },
           '40%': { transform: 'scale(1.5)', opacity: '1' },
         },
+        // The dot on a LIVE tag: opacity only, so it reads as "on air" without moving.
+        'live-pulse': {
+          '0%, 100%': { opacity: '1' },
+          '50%': { opacity: '0.25' },
+        },
       },
       animation: {
         'accordion-down': 'accordion-down 0.2s ease-out',
@@ -420,6 +425,7 @@ const config: Config = {
         'fade-in': 'fade-in 0.3s ease-out',
         'cursor-blink': 'cursor-blink 1s steps(1) infinite',
         'dot-pulse': 'dot-pulse 1.4s ease-in-out infinite',
+        'live-pulse': 'live-pulse 1.6s ease-in-out infinite',
       },
     },
   },