diff --git a/packages/plugin/src/client/presentation.ts b/packages/plugin/src/client/presentation.ts new file mode 100644 index 0000000..d725275 --- /dev/null +++ b/packages/plugin/src/client/presentation.ts @@ -0,0 +1,232 @@ +import type { LocaleKey, Translate } from '../client-locale.js' +import type { RemoteConnectionProgress, RemoteStatus, RemoteTransportPreference } from './types.js' + +const defaultPreferredTransports: readonly RemoteTransportPreference[] = ['lan', 'p2p', 'turn', 'relay'] + +function normalizedPreferredTransports(value: readonly RemoteTransportPreference[] | undefined): RemoteTransportPreference[] { + return value === undefined || value.length === 0 ? [...defaultPreferredTransports] : [...value] +} + +export function formatLocalTime(value: number): string { + const date = new Date(value) + return Number.isNaN(date.getTime()) ? '—' : date.toLocaleString() +} + +export function formatByteSize(value: number): string { + if (value < 1024) return `${value.toLocaleString()} B` + const units = ['KiB', 'MiB', 'GiB'] + let amount = value + let unit = 'B' + for (const nextUnit of units) { + amount /= 1024 + unit = nextUnit + if (amount < 1024) break + } + return `${amount.toLocaleString(undefined, { maximumFractionDigits: 1 })} ${unit}` +} + +export function formatBitrate(value: number): string { + const units = ['bit/s', 'Kbit/s', 'Mbit/s', 'Gbit/s'] + let amount = value + let unitIndex = 0 + while (amount >= 1000 && unitIndex < units.length - 1) { + amount /= 1000 + unitIndex += 1 + } + return `${amount.toLocaleString(undefined, { maximumFractionDigits: 1 })} ${units[unitIndex]}` +} + +export function shortDeviceId(value: string): string { + return value.length <= 14 ? value : `${value.slice(0, 8)}…${value.slice(-4)}` +} + +function serverHostname(value: string): string { + try { + return new URL(value).hostname + } catch { + return value + } +} + +export function transportLabel(value: RemoteTransportPreference, t: Translate): string { + if (value === 'lan') return t('remoteNetworkLan') + if (value === 'p2p') return t('remoteNetworkP2p') + if (value === 'turn') return t('remoteNetworkTurn') + return t('remoteNetworkRelay') +} + +export function transportDiagnosticLabel(value: RemoteTransportPreference): string { + if (value === 'lan') return 'LAN' + if (value === 'p2p') return 'P2P' + if (value === 'turn') return 'TURN' + return 'Relay' +} + +function transportProgressCopy(value: RemoteTransportPreference): { label: LocaleKey; detail: LocaleKey } { + if (value === 'lan') return { label: 'remoteProgressProbeLan', detail: 'remoteProgressProbeLanDetail' } + if (value === 'p2p') return { label: 'remoteProgressProbeP2p', detail: 'remoteProgressProbeP2pDetail' } + if (value === 'turn') return { label: 'remoteProgressProbeTurn', detail: 'remoteProgressProbeTurnDetail' } + return { label: 'remoteProgressProbeRelay', detail: 'remoteProgressProbeRelayDetail' } +} + +function statusTransportPreference(status: RemoteStatus | undefined): RemoteTransportPreference | undefined { + if (status?.transport === 'LAN') return 'lan' + if (status?.transport === 'P2P') return 'p2p' + if (status?.transport === 'TURN') return 'turn' + if (status?.transport === 'Relay') return 'relay' + return undefined +} + +export function connectedProgress(status: RemoteStatus | undefined): RemoteConnectionProgress | undefined { + const activeTransport = statusTransportPreference(status) + if (activeTransport === undefined) return undefined + return { + label: 'remoteProgressReady', + detail: 'remoteProgressReadyDetail', + percent: 100, + transports: normalizedPreferredTransports(status?.preferredTransports), + activeTransports: [activeTransport], + routeVerb: 'using', + } +} + +function loadingProgressPercent(elapsedMs: number): number { + if (elapsedMs >= 6_800) return 96 + if (elapsedMs >= 3_800) return 93 + if (elapsedMs >= 1_600) return 89 + return 84 +} + +export function observedConnectionProgress( + status: RemoteStatus, + targetDeviceId: string, + preferredTransports: readonly RemoteTransportPreference[] | undefined, + connectedStep: Pick, + connectedAt: number | undefined, +): RemoteConnectionProgress | undefined { + const transports = normalizedPreferredTransports(status.preferredTransports ?? preferredTransports) + const connection = status.connectionProgress + if (connection?.targetDeviceId === targetDeviceId) { + if (connection.phase === 'checking-host') { + return { label: 'remoteProgressCheckingHost', detail: 'remoteProgressCheckingHostDetail', percent: 12 } + } + if (connection.phase === 'authorizing-peer') { + return { label: 'remoteProgressAuthorizingPeer', detail: 'remoteProgressAuthorizingPeerDetail', percent: 30 } + } + const activeTransports = connection.activeTransports?.filter(transport => transports.includes(transport)) ?? [] + if (connection.phase === 'probing') { + const activeIndex = Math.max(0, ...activeTransports.map(transport => transports.indexOf(transport))) + const copy = activeTransports.length === 1 + ? transportProgressCopy(activeTransports[0]!) + : { label: 'remoteProgressOpeningChannel' as const, detail: 'remoteProgressOpeningChannelDetail' as const } + return { + ...copy, + percent: Math.min(76, 42 + activeIndex * 10), + transports, + activeTransports, + routeVerb: 'trying', + } + } + return { + ...connectedStep, + percent: loadingProgressPercent(connectedAt === undefined ? 0 : Date.now() - connectedAt), + transports, + activeTransports, + routeVerb: 'using', + } + } + if (status.connectedTargetDeviceId !== targetDeviceId) return undefined + const activeTransport = statusTransportPreference(status) + return { + ...connectedStep, + percent: loadingProgressPercent(connectedAt === undefined ? 0 : Date.now() - connectedAt), + transports, + ...(activeTransport === undefined ? {} : { activeTransports: [activeTransport], routeVerb: 'using' as const }), + } +} + +export function connectionErrorMessage(code: string, t: Translate): string { + if (code === 'ACCOUNT_AUTH_REQUIRED') return t('hostSignInHint') + if (code === 'AUTH_REQUIRED') return t('hostSignInHint') + if (code === 'AUTH_INVALID' || code === 'TOKEN_EXPIRED') { + return t('connectionAuthorizationExpired') + } + if (code === 'CONNECTION_REPLACED') return t('connectionReplaced') + if (code === 'SERVER_CREDENTIALS_BUSY') return t('connectionCredentialsBusy') + if (code === 'DEVICE_REVOKED') return t('connectionDeviceRevoked') + if (code === 'DEVICE_OWNERSHIP_REQUIRED') return t('connectionOwnershipRequired') + if (code === 'RATE_LIMITED') return t('connectionRateLimited') + if (code === 'UNSUPPORTED_VERSION') return t('connectionVersionMismatch') + if (code === 'INVALID_MESSAGE') return t('connectionInvalidResponse') + if (code === 'CONNECTION_FAILED') return t('serverUnavailableError') + if (code === 'SERVER_NOT_CONFIGURED') return t('connectionReachability') + return t('connectionUnexpected') +} + +export function connectionStatusLabel(status: RemoteStatus['host'] | undefined, t: Translate): string { + if (status === undefined) return t('checkingConnection') + if (status.online) return t('online') + if (status.error !== undefined) return connectionErrorMessage(status.error, t) + if (!status.reconnecting) return t('offline') + return t(status.lastActiveAt === undefined ? 'connecting' : 'serverUnavailableShort') +} + +export function connectionStatusClass(status: RemoteStatus['host'] | undefined): string { + if (status?.online) return ' isOnline' + if (status?.reconnecting) return ' isReconnecting' + return status === undefined ? '' : ' isOffline' +} + +export function startupErrorMessage(error: { code: string; message: string }, t: Translate): string { + if (error.code === 'IDENTITY_INVALID') return t('identityCorrupted') + if (error.code === 'SERVER_CREDENTIALS_INVALID') return t('credentialsCorrupted') + if (error.code === 'IDENTITY_LOCKED') return t('identityLocked') + if (error.code === 'STORAGE_CONFLICT') return storageConflictMessage(error.message, t) + if (error.code === 'SERVER_CREDENTIALS_BUSY') return t('connectionCredentialsBusy') + return error.message || t('remoteStartupFailed') +} + +function storageConflictMessage(message: string, t: Translate): string { + const match = /^Remote storage ownership could not be verified; nothing was moved\. Inspect the legacy directory manually\. Unexpected entry "([A-Za-z0-9._-]{1,160})" was found\.$/.exec(message) + return match === null ? t('storageConflict') : t('storageConflictEntry', { name: match[1] }) +} + +export function messageOf(reason: unknown, t: Translate): string { + if (typeof reason === 'object' && reason !== null && 'code' in reason && typeof reason.code === 'string') { + if (reason.code === 'CONNECTION_FAILED') return t('serverUnavailableError') + if (reason.code === 'IDENTITY_INVALID') return t('identityCorrupted') + if (reason.code === 'SERVER_CREDENTIALS_INVALID') return t('credentialsCorrupted') + if (reason.code === 'IDENTITY_LOCKED') return t('identityLocked') + if (reason.code === 'STORAGE_CONFLICT') { + const message = 'message' in reason && typeof reason.message === 'string' ? reason.message : '' + return storageConflictMessage(message, t) + } + if (reason.code === 'SERVER_CREDENTIALS_BUSY') return t('connectionCredentialsBusy') + } + return reason instanceof Error ? reason.message : String(reason) +} + +export function formatPlatform(value: string): string { + const normalized = value.toLowerCase() + if (normalized === 'darwin' || normalized === 'macos') return 'macOS' + if (normalized === 'win32' || normalized === 'windows') return 'Windows' + if (normalized === 'linux') return 'Linux' + if (normalized === 'android') return 'Android' + return value +} + +export function connectedClientModeLabel( + mode: 'LAN' | 'P2P' | 'TURN' | 'Relay' | undefined, + t: Translate, +): string { + if (mode === 'LAN') return t('remoteNetworkLan') + if (mode === 'P2P') return t('remoteNetworkP2p') + if (mode === 'TURN') return t('remoteNetworkTurn') + if (mode === 'Relay') return t('remoteNetworkRelay') + return t('connected') +} + +/** Normalize legacy internal account labels without changing credential identity. */ +export function displayRemoteAccount(account: string): string { + return account.replace(/^device:([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i, 'dsh-device:$1') +}