Send files directly between devices over the internet - no cloud storage, no size limits.
TypeScript cross-platformdata-transferdecentralizedfile-sharingfile-transferhole-punchingopen-sourcep2ppeer-to-peerprivacyprivacy-tools
Add relay fallback for symmetric NAT transfers (#52)
Denis Lupookov67d032c03f9f
diff --git a/.github/workflows/release-desktop.yml b/.github/workflows/release-desktop.ymlindex 3d2c8a8..94fa9e7 100644--- a/.github/workflows/release-desktop.yml+++ b/.github/workflows/release-desktop.yml@@ -25,6 +25,7 @@ jobs:run: npm run build -w apps/desktopenv:SENTRY_DSN: ${{ secrets.SENTRY_DSN }}+ RELAY_CONF_PUBKEY_HEX: ${{ secrets.RELAY_CONF_PUBKEY_HEX }}VITE_SENTRY_DSN: ${{ secrets.SENTRY_DSN }}VITE_DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}@@ -104,6 +105,7 @@ jobs:run: npm run build -w apps/desktopenv:SENTRY_DSN: ${{ secrets.SENTRY_DSN }}+ RELAY_CONF_PUBKEY_HEX: ${{ secrets.RELAY_CONF_PUBKEY_HEX }}VITE_SENTRY_DSN: ${{ secrets.SENTRY_DSN }}VITE_DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}@@ -198,6 +200,7 @@ jobs:run: npm run build -w apps/desktopenv:SENTRY_DSN: ${{ secrets.SENTRY_DSN }}+ RELAY_CONF_PUBKEY_HEX: ${{ secrets.RELAY_CONF_PUBKEY_HEX }}VITE_SENTRY_DSN: ${{ secrets.SENTRY_DSN }}VITE_DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}@@ -230,6 +233,7 @@ jobs:run: npm run build -w apps/desktopenv:SENTRY_DSN: ${{ secrets.SENTRY_DSN }}+ RELAY_CONF_PUBKEY_HEX: ${{ secrets.RELAY_CONF_PUBKEY_HEX }}VITE_SENTRY_DSN: ${{ secrets.SENTRY_DSN }}VITE_DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}diff --git a/.gitignore b/.gitignoreindex c813887..4b1def3 100644--- a/.gitignore+++ b/.gitignore@@ -59,6 +59,7 @@ releaseapps/desktop/distapps/desktop/outapps/desktop/src/electron/sentry-dsn.gen.ts+apps/desktop/src/electron/relay-conf-pubkey.gen.tsapps/mobile/iosapps/mobile/androiddiff --git a/README.md b/README.mdindex 10df0d4..49e668e 100644--- a/README.md+++ b/README.md@@ -6,7 +6,7 @@### File transfer without the cloud storage.-Files go directly between your devices — end-to-end encrypted, no accounts, no servers, no limits.+Files go directly between your devices — end-to-end encrypted, no accounts, nothing stored, no limits.[](LICENSE)[](#download)@@ -54,7 +54,7 @@ Why use WeTransfer, Dropbox, or Google Drive when you can send files directly## Features- **No accounts** — no signup, no login, no email address required-- **No servers** — files transfer directly device-to-device, nothing stored in the cloud+- **No cloud storage** — files go directly between devices; nothing is ever uploaded or stored on a server- **End-to-end encrypted** — only your devices can read your files, always- **No file size limit** — send a 100 MB photo or 500 GB video archive, same experience- **Pair your devices** — pair a device once, then send to it without scanning or typing a code each time@@ -95,7 +95,7 @@ brew install --cask altersend```┌─────────┐ encrypted P2P ┌─────────┐│ Device │ ◄──────────────────────────────► │ Device │- │ A │ direct, no middleman │ B │+ │ A │ direct & encrypted │ B │└─────────┘ └─────────┘▲ ▲│ peer discovery via Hyperswarm │@@ -109,8 +109,8 @@ AlterSend is built on [Hyperswarm](https://github.com/holepunchto/hyperswarm), a1. **A random 32-byte key is generated** for each transfer (`crypto.randomBytes(32)`). That 64-char hex string _is_ the join code you share.2. **Peers rendezvous on a hash of that key, not the key itself.** Both sides compute the same discovery key — a BLAKE2b hash derived from the join code — and join the DHT on that. The raw key never leaves your device, only its hash is published.-3. **Public bootstrap nodes are the only entry point.** A handful of them get peers onto the DHT. After that, no central server is involved — and there's no relay fallback, so if direct hole-punching fails, the connection fails.-4. **The connection is direct and end-to-end encrypted.** Peers connect over a Noise-encrypted socket, and the sender shares its [Hyperdrive](https://github.com/holepunchto/hyperdrive) key over that channel. Files are imported into the sender's local Hyperdrive, replicated to the receiver's, then written out to disk — so in v1 each side needs roughly **2× the transfer size** in free space while a transfer runs. _(Working to improve this.)_+3. **Public bootstrap nodes are the only entry point.** A handful of them get peers onto the DHT. After that, no central server is involved in discovery. Most transfers are direct peer-to-peer; when a direct connection can't be established — usually because both peers are behind symmetric NAT (for example both on a VPN) — the transfer falls back to a **relay** that forwards the already-encrypted stream between them without ever seeing file contents. It's on by default and can be turned off in Settings → Relay.+4. **The connection is end-to-end encrypted.** Peers connect over a Noise-encrypted socket, and the sender shares its [Hyperdrive](https://github.com/holepunchto/hyperdrive) key over that channel. Files are imported into the sender's local Hyperdrive, replicated to the receiver's, then written out to disk — so in v1 each side needs roughly **2× the transfer size** in free space while a transfer runs. _(Working to improve this.)_**Pair once, skip the code.** You can pair devices you own so future transfers go straight through — no code to scan or type. Pairing only stores a public device key, the secret stays in your OS keychain, and a paired device is recognized without exposing your identity to anyone else. See [docs/architecture.md](docs/architecture.md#remembered-devices--pairing) for the full design.@@ -133,20 +133,19 @@ npm installcp apps/desktop/.env.example apps/desktop/.envcp apps/mobile/.env.example apps/mobile/.env-# All env vars are optional in dev — the app runs without them.```### Run```sh-npm run dev # desktop (Electron)-npm run mobile:start # mobile (Expo)+npm run dev+npm run mobile:start```### Build```sh-npm run desktop:build # packages + desktop app+npm run desktop:build```Platform installers (`.dmg`, `.exe`, `.AppImage`) are produced by the release CI workflow — trigger manually from the Actions tab.diff --git a/apps/desktop/.env.example b/apps/desktop/.env.exampleindex c32d989..a7322c6 100644--- a/apps/desktop/.env.example+++ b/apps/desktop/.env.example@@ -8,3 +8,5 @@ VITE_SENTRY_DSN=# Discord webhook URL for in-app feedback submissions (optional)# Must be prefixed VITE_ to be exposed to the renderer via import.meta.envVITE_DISCORD_WEBHOOK_URL=++RELAY_CONF_PUBKEY_HEX=diff --git a/apps/desktop/package.json b/apps/desktop/package.jsonindex 9d21358..24c7ec3 100644--- a/apps/desktop/package.json+++ b/apps/desktop/package.json@@ -10,8 +10,8 @@"main": "dist/electron/main.js","private": true,"scripts": {- "build": "node scripts/gen-sentry-dsn.cjs && tsc -p src/tsconfig.electron.json && node scripts/copy-preload.cjs && vite build",- "build:electron": "node scripts/gen-sentry-dsn.cjs && tsc -p src/tsconfig.electron.json",+ "build": "node scripts/gen-env.cjs && tsc -p src/tsconfig.electron.json && node scripts/copy-preload.cjs && vite build",+ "build:electron": "node scripts/gen-env.cjs && tsc -p src/tsconfig.electron.json","build:renderer": "vite build","typecheck": "tsc --noEmit -p src/tsconfig.electron.json && tsc --noEmit -p tsconfig.json","start": "npm run build && electron-forge start -- --no-updates",@@ -71,6 +71,7 @@"@types/react-dom": "^19.2.3","@vitejs/plugin-react": "^5.2.0","app-builder-lib": "^26.8.1",+ "dotenv": "^16.6.1","electron": "^40.2.1","electron-builder": "^26.8.1","pear-build": "^1.1.0",diff --git a/apps/desktop/scripts/gen-env.cjs b/apps/desktop/scripts/gen-env.cjsnew file mode 100644index 0000000..5ed7277--- /dev/null+++ b/apps/desktop/scripts/gen-env.cjs@@ -0,0 +1,14 @@+const fs = require('fs')+const path = require('path')+require('dotenv').config({ path: path.join(__dirname, '../.env') })++const outDir = path.join(__dirname, '../src/electron')+const GENERATED = [+ { name: 'SENTRY_DSN', file: 'sentry-dsn.gen.ts' },+ { name: 'RELAY_CONF_PUBKEY_HEX', file: 'relay-conf-pubkey.gen.ts' }+]++for (const { name, file } of GENERATED) {+ const value = process.env[name] ?? ''+ fs.writeFileSync(path.join(outDir, file), `export const ${name} = ${JSON.stringify(value)};\n`)+}diff --git a/apps/desktop/scripts/gen-sentry-dsn.cjs b/apps/desktop/scripts/gen-sentry-dsn.cjsdeleted file mode 100644index 8fcc673..0000000--- a/apps/desktop/scripts/gen-sentry-dsn.cjs+++ /dev/null@@ -1,6 +0,0 @@-#!/usr/bin/env node-const fs = require('fs')-const path = require('path')-const dsn = process.env.SENTRY_DSN ?? ''-const out = path.join(__dirname, '../src/electron/sentry-dsn.gen.ts')-fs.writeFileSync(out, `export const SENTRY_DSN = '${dsn}';\n`)diff --git a/apps/desktop/src/electron/runtime.ts b/apps/desktop/src/electron/runtime.tsindex 15f9576..d7838f7 100644--- a/apps/desktop/src/electron/runtime.ts+++ b/apps/desktop/src/electron/runtime.ts@@ -14,6 +14,7 @@ import { isMac, isLinux, isWindows } from 'which-runtime'import { command, flag, sloppy } from 'paparam'import { createRequire } from 'module'import { getAppPath, getWorkerClientPath, getWorkerEntryPath } from './workerPaths.js'+import { RELAY_CONF_PUBKEY_HEX } from './relay-conf-pubkey.gen.js'const __filename = fileURLToPath(import.meta.url)const __dirname = path.dirname(__filename)@@ -155,6 +156,7 @@ function appDataDir(name: string): string {export function createDesktopRuntime({ broadcast }: { broadcast: Broadcast }): DesktopRuntime {const workers = new Map<string, WorkerRuntime>()let pear: PearRuntimeInstance | null = null+ let rememberedRelayConfig: Parameters<WorkerClient['setRelayConfig']>[0] | null = nullfunction getPear() {if (pear) return pear@@ -206,6 +208,8 @@ export function createDesktopRuntime({ broadcast }: { broadcast: Broadcast }): D`--storage=${pear.storage}`,`--identity=${identityRoot}`,'--device-type=desktop',+ ...(RELAY_CONF_PUBKEY_HEX ? [`--relay-conf-pubkey=${RELAY_CONF_PUBKEY_HEX}`] : []),+ ...cliArgs.filter((arg) => arg.startsWith('--relay-')),...args])const client = createTransferWorkerClient(worker, {@@ -220,6 +224,15 @@ export function createDesktopRuntime({ broadcast }: { broadcast: Broadcast }): Dready: client.ready}+ if (rememberedRelayConfig) {+ const cfg = rememberedRelayConfig+ runtime.ready+ .then(() => runtime.client.setRelayConfig(cfg))+ .catch((err) =>+ console.error('[relay] re-applying relay config on worker respawn failed', err)+ )+ }+function sendWorkerStdout(data: unknown) {process.stdout.write(`[worker:${specifier}] ${String(data)}`)broadcast('pear:worker:stdout:' + specifier, data)@@ -272,6 +285,9 @@ export function createDesktopRuntime({ broadcast }: { broadcast: Broadcast }): D}const runtime = getWorker(specifier)+ if (method === 'setRelayConfig') {+ rememberedRelayConfig = args[0] as typeof rememberedRelayConfig+ }return (runtime.client[method] as (...a: unknown[]) => Promise<unknown>)(...args)}diff --git a/apps/desktop/src/renderer/components/Settings/index.tsx b/apps/desktop/src/renderer/components/Settings/index.tsxindex 4041db9..d13459f 100644--- a/apps/desktop/src/renderer/components/Settings/index.tsx+++ b/apps/desktop/src/renderer/components/Settings/index.tsx@@ -5,6 +5,7 @@ import {LaptopIcon,MailIcon,ShieldIcon,+ WaypointsIcon,type IconProps} from '@altersend/components/icons'import { loadPeers } from '@altersend/domain'@@ -13,6 +14,7 @@ import { Modal } from '../Modal'import { ListItem } from '@altersend/components'import { DevicesSection } from './sections/DevicesSection'import { LanguageSection } from './sections/LanguageSection'+import { ConnectionSection } from './sections/ConnectionSection'import { FeedbackSection } from './sections/FeedbackSection'import { SecuritySection } from './sections/SecuritySection'import { AboutSection } from './sections/AboutSection'@@ -23,8 +25,9 @@ export { openSettingsPanel } from './settingsControl'const NAV: { id: SettingsSection; icon: ComponentType<IconProps>; labelKey: string }[] = [{ id: 'devices', icon: LaptopIcon, labelKey: 'settings:pairing.pairedDevices' },{ id: 'language', icon: GlobeIcon, labelKey: 'settings:languageTitle' },- { id: 'feedback', icon: MailIcon, labelKey: 'settings:rows.feedback' },+ { id: 'connection', icon: WaypointsIcon, labelKey: 'settings:rows.connection' },{ id: 'security', icon: ShieldIcon, labelKey: 'settings:rows.security' },+ { id: 'feedback', icon: MailIcon, labelKey: 'settings:rows.feedback' },{ id: 'about', icon: InfoIcon, labelKey: 'settings:sections.about' }]@@ -66,6 +69,8 @@ export function Settings({ version }: { version: string }) {<DevicesSection />) : section === 'language' ? (<LanguageSection />+ ) : section === 'connection' ? (+ <ConnectionSection />) : section === 'feedback' ? (<FeedbackSection version={version} />) : section === 'security' ? (diff --git a/apps/desktop/src/renderer/components/Settings/sections/ConnectionSection.tsx b/apps/desktop/src/renderer/components/Settings/sections/ConnectionSection.tsxnew file mode 100644index 0000000..55e9aa0--- /dev/null+++ b/apps/desktop/src/renderer/components/Settings/sections/ConnectionSection.tsx@@ -0,0 +1,38 @@+import { useState } from 'react'+import { ExternalLink, ToggleSwitch } from '@altersend/components'+import { useTranslation } from '@altersend/locales'+import { websiteUrl } from '@altersend/domain'+import { bridgeApi } from '../../../api/bridgeApi'+import { isRelayEnabled, setRelayEnabledStorage } from '../../../lifecycle/relayStorage'+import { SectionShell } from './SectionShell'++export function ConnectionSection() {+ const { t } = useTranslation(['settings'])+ const [relay, setRelay] = useState(isRelayEnabled)++ const handleRelayToggle = (next: boolean) => {+ setRelay(next)+ setRelayEnabledStorage(next)+ bridgeApi.worker.setRelayConfig({ enabled: next }).catch(() => {+ setRelay(!next)+ setRelayEnabledStorage(!next)+ })+ }++ return (+ <SectionShell title={t('settings:rows.connection')}>+ <ToggleSwitch+ checked={relay}+ onChange={handleRelayToggle}+ label={t('settings:relay.label')}+ description={t('settings:relay.description')}+ />+ <p className='m-0 mt-5 text-[12px] leading-5 text-text-muted'>+ {t('settings:relay.fairUse')} {t('settings:relay.contact')}{' '}+ <ExternalLink onPress={() => bridgeApi.openExternalUrl(websiteUrl).catch(() => {})}>+ {t('settings:rows.contact')}+ </ExternalLink>+ </p>+ </SectionShell>+ )+}diff --git a/apps/desktop/src/renderer/components/Settings/settingsControl.ts b/apps/desktop/src/renderer/components/Settings/settingsControl.tsindex d9f77e7..b5c05f2 100644--- a/apps/desktop/src/renderer/components/Settings/settingsControl.ts+++ b/apps/desktop/src/renderer/components/Settings/settingsControl.ts@@ -1,4 +1,10 @@-export type SettingsSection = 'devices' | 'language' | 'feedback' | 'security' | 'about'+export type SettingsSection =+ | 'devices'+ | 'language'+ | 'connection'+ | 'feedback'+ | 'security'+ | 'about'type Listener = (section: SettingsSection) => voiddiff --git a/apps/desktop/src/renderer/lifecycle/relayStorage.ts b/apps/desktop/src/renderer/lifecycle/relayStorage.tsnew file mode 100644index 0000000..75a7212--- /dev/null+++ b/apps/desktop/src/renderer/lifecycle/relayStorage.ts@@ -0,0 +1,16 @@+const KEY = 'altersend.relay.enabled'++export function isRelayEnabled(): boolean {+ try {+ const value = window.localStorage.getItem(KEY)+ return value === null ? true : value === '1'+ } catch {+ return true+ }+}++export function setRelayEnabledStorage(value: boolean): void {+ try {+ window.localStorage.setItem(KEY, value ? '1' : '0')+ } catch {}+}diff --git a/apps/desktop/src/renderer/main.tsx b/apps/desktop/src/renderer/main.tsxindex fbc2181..d698bae 100644--- a/apps/desktop/src/renderer/main.tsx+++ b/apps/desktop/src/renderer/main.tsx@@ -18,6 +18,7 @@ import { bridgeApi, hasBridge } from './api/bridgeApi'import { startDeepLinkHandler } from './lifecycle/deepLinkHandler'import { initSentry, captureException } from './sentry'import { isCrashReportingEnabled } from './lifecycle/crashReportingStorage'+import { isRelayEnabled } from './lifecycle/relayStorage'import { getSavedLocalePreference } from './lifecycle/localePreferenceStorage'import { getDesktopSystemLocales } from './lifecycle/systemLocale'import './strict.css'@@ -65,6 +66,9 @@ if (hasBridge()) {bindTransferApi(bridgeApi, {onError: (context, error) => captureException(error, context)})+ bridgeApi.worker+ .setRelayConfig({ enabled: isRelayEnabled() })+ .catch((err) => captureException(err, 'setRelayConfig'))startPeerWatchdog()startBackgroundReconnectEffect()startDeepLinkHandler()diff --git a/apps/desktop/src/renderer/pages/ReceivePage/index.tsx b/apps/desktop/src/renderer/pages/ReceivePage/index.tsxindex 0ff2daf..d35ab06 100644--- a/apps/desktop/src/renderer/pages/ReceivePage/index.tsx+++ b/apps/desktop/src/renderer/pages/ReceivePage/index.tsx@@ -1,7 +1,9 @@import { useMemo } from 'react'import { Button } from '@altersend/components'+import { InfoIcon } from '@altersend/components/icons'import { useTranslation } from '@altersend/locales'import { TransferStatusPanel, TransferCardFrame } from '../../components'+import { openSettingsPanel } from '../../components/Settings'import { ReceiveCompleteView } from './ReceiveCompleteView'import { ReceiveConnectedView } from './ReceiveConnectedView'import { ReceiveDisconnectedView } from './ReceiveDisconnectedView'@@ -22,6 +24,7 @@ export default function ReceivePage() {const incomingFileOffers = useTransferStore((s) => s.incomingFileOffers)const receiveDownloadStates = useTransferStore((s) => s.receiveDownloadStates)const peerCount = useTransferStore((s) => s.peerCount)+ const connectionType = useTransferStore((s) => s.connectionType)const hasIncomingFiles = incomingFileOffers.length > 0const totals = useMemo(@@ -48,11 +51,18 @@ export default function ReceivePage() {totals.totalBytes)+ const isRelay = connectionType === 'relay'const connectedBadge =isConnectedStep(step) && step !== 'completed' && step !== 'interrupted' ? (- <div className='inline-flex items-center gap-1.5 rounded-full bg-success/12 px-2.5 py-1 text-[12px] font-semibold text-success'>+ <div+ onClick={isRelay ? () => openSettingsPanel('connection') : undefined}+ className={`inline-flex items-center gap-1.5 rounded-full bg-success/12 px-2.5 py-1 text-[12px] font-semibold text-success ${+ isRelay ? 'cursor-pointer transition-opacity hover:opacity-80' : ''+ }`}+ ><span className='h-2 w-2 shrink-0 rounded-full bg-success' />- {t('common:status.connected')}+ {isRelay ? t('common:status.connectedViaRelay') : t('common:status.connected')}+ {isRelay ? <InfoIcon size={13} /> : null}</div>) : undefineddiff --git a/apps/mobile/.env.example b/apps/mobile/.env.exampleindex 6831bd0..3d78bb9 100644--- a/apps/mobile/.env.example+++ b/apps/mobile/.env.example@@ -1,2 +1,4 @@# Sentry DSN — EXPO_PUBLIC_ prefix makes it available at runtime via process.envEXPO_PUBLIC_SENTRY_DSN=++EXPO_PUBLIC_RELAY_CONF_PUBKEY=diff --git a/apps/mobile/app/_layout.tsx b/apps/mobile/app/_layout.tsxindex 6836c99..5bd907b 100644--- a/apps/mobile/app/_layout.tsx+++ b/apps/mobile/app/_layout.tsx@@ -34,6 +34,7 @@ import { useAlterSendFonts } from '../src/theme/useAlterSendFonts'import { startAppStateBridge } from '../src/lifecycle/appStateBridge'import { startDeepLinkHandler } from '../src/lifecycle/deepLinkHandler'import { getSavedLocalePreference } from '../src/lifecycle/localePreferenceStorage'+import { isRelayEnabled } from '../src/lifecycle/relayStorage'import { getMobileSystemLocales } from '../src/lifecycle/systemLocale'import { ShareIntentHandler } from '../src/lifecycle/ShareIntentHandler'import { startPhotosCopyEffect } from '../src/transfer/receive'@@ -45,6 +46,9 @@ initSentry()bindTransferApi(mobileApi, {onError: (context, error) => captureException(error, context)})+mobileApi.worker+ .setRelayConfig({ enabled: isRelayEnabled() })+ .catch((err) => captureException(err, 'setRelayConfig'))startAppStateBridge()startPeerWatchdog()startBackgroundReconnectEffect()@@ -92,6 +96,7 @@ function ThemedStack() {<Stack.Screen name='onboarding' options={{ headerShown: false, gestureEnabled: false }} /><Stack.Screen name='settings' options={flowScreenOptions} /><Stack.Screen name='language' options={flowScreenOptions} />+ <Stack.Screen name='connection' options={flowScreenOptions} /><Stack.Screen name='security' options={flowScreenOptions} /><Stack.Screen name='devices' options={flowScreenOptions} /><Stack.Screen name='about' options={flowScreenOptions} />diff --git a/apps/mobile/app/connection.tsx b/apps/mobile/app/connection.tsxnew file mode 100644index 0000000..b2f9b3e--- /dev/null+++ b/apps/mobile/app/connection.tsx@@ -0,0 +1,70 @@+import { Linking, StyleSheet, View } from 'react-native'+import { useState } from 'react'+import { ExternalLink, ToggleSwitch, useTheme } from '@altersend/components'+import { useTranslation } from '@altersend/locales'+import { websiteUrl } from '@altersend/domain'+import { Layout } from '@/src/components'+import { Text } from '@/src/components/ThemedText'+import { isRelayEnabled, setRelayEnabledStorage } from '@/src/lifecycle/relayStorage'+import { mobileApi } from '@/src/api/mobileApi'++export default function ConnectionScreen() {+ const { t } = useTranslation(['settings'])+ const { theme } = useTheme()+ const [relay, setRelay] = useState(isRelayEnabled)++ const handleRelayToggle = (value: boolean) => {+ setRelay(value)+ setRelayEnabledStorage(value)+ mobileApi.worker.setRelayConfig({ enabled: value }).catch(() => {+ setRelay(!value)+ setRelayEnabledStorage(!value)+ })+ }++ const cardStyle = {+ backgroundColor: theme.colors.colorBackgroundSubtle,+ borderColor: theme.colors.colorBorderPrimary+ }++ return (+ <Layout title={t('settings:rows.connection')} description='' hasNativeHeader>+ <View style={[styles.card, styles.cardPad, cardStyle]}>+ <ToggleSwitch+ checked={relay}+ onChange={handleRelayToggle}+ label={t('settings:relay.label')}+ description={t('settings:relay.description')}+ />+ </View>+ <View style={styles.info}>+ <Text style={[styles.infoLine, { color: theme.colors.colorTextMuted }]}>+ {t('settings:relay.fairUse')} {t('settings:relay.contact')}+ </Text>+ <ExternalLink href={websiteUrl} onPress={() => Linking.openURL(websiteUrl).catch(() => {})}>+ {t('settings:rows.contact')}+ </ExternalLink>+ </View>+ </Layout>+ )+}++const styles = StyleSheet.create({+ card: {+ borderRadius: 16,+ borderWidth: 1,+ overflow: 'hidden'+ },+ cardPad: {+ paddingHorizontal: 16,+ paddingVertical: 13+ },+ info: {+ marginTop: 16,+ gap: 6+ },+ infoLine: {+ fontSize: 13,+ lineHeight: 19+ }+})diff --git a/apps/mobile/app/receive/incoming.tsx b/apps/mobile/app/receive/incoming.tsxindex 6388e23..9be84cd 100644--- a/apps/mobile/app/receive/incoming.tsx+++ b/apps/mobile/app/receive/incoming.tsx@@ -2,7 +2,7 @@ import { useCallback, useEffect, useMemo } from 'react'import { View, StyleSheet, Pressable } from 'react-native'import { Paths } from 'expo-file-system'import { Button, useTheme } from '@altersend/components'-import { ArrowLeftIcon, DownloadIcon } from '@altersend/components/icons'+import { ArrowLeftIcon, DownloadIcon, InfoIcon } from '@altersend/components/icons'import { useTranslation } from '@altersend/locales'import { useNavigation, useRouter } from 'expo-router'import { uriToPath } from '@/src/api/mobileApi'@@ -30,6 +30,7 @@ export default function ReceiveIncomingScreen() {const receiveDownloadStates = useTransferStore((s) => s.receiveDownloadStates)const role = useTransferStore((s) => s.role)const peerCount = useTransferStore((s) => s.peerCount)+ const connectionType = useTransferStore((s) => s.connectionType)const isReconnecting = useTransferStore((s) => s.isReconnecting)const errorCode = useTransferStore((s) => s.errorCode)const displayError = getDisplayError(t, errorCode)@@ -146,7 +147,24 @@ export default function ReceiveIncomingScreen() {)}- const badge = (+ const isRelay = connectionType === 'relay'+ const badge = isRelay ? (+ <Pressable+ accessibilityRole='button'+ accessibilityLabel={t('common:status.connectedViaRelay')}+ onPress={() => router.push('/connection')}+ style={({ pressed }) => [+ styles.badge,+ { backgroundColor: theme.colors.colorSuccessSubtle, opacity: pressed ? 0.7 : 1 }+ ]}+ >+ <View style={[styles.badgeDot, { backgroundColor: theme.colors.colorSuccess }]} />+ <Text style={[styles.badgeText, { color: theme.colors.colorSuccess }]}>+ {t('common:status.connectedViaRelay')}+ </Text>+ <InfoIcon size={13} color={theme.colors.colorSuccess} />+ </Pressable>+ ) : (<View style={[styles.badge, { backgroundColor: theme.colors.colorSuccessSubtle }]}><View style={[styles.badgeDot, { backgroundColor: theme.colors.colorSuccess }]} /><Text style={[styles.badgeText, { color: theme.colors.colorSuccess }]}>diff --git a/apps/mobile/app/settings.tsx b/apps/mobile/app/settings.tsxindex 377dd42..a36dee3 100644--- a/apps/mobile/app/settings.tsx+++ b/apps/mobile/app/settings.tsx@@ -10,7 +10,8 @@ import {GlobeIcon,InfoIcon,ShieldIcon,- SmartphoneIcon+ SmartphoneIcon,+ WaypointsIcon} from '@altersend/components/icons'import { Layout } from '@/src/components'import { Text } from '@/src/components/ThemedText'@@ -83,6 +84,13 @@ export default function SettingsScreen() {icon={<GlobeIcon size={16} color={c.colorTextSecondary} />}onPress={() => router.push('/language')}/>+ <LinkRow+ standalone+ label={t('settings:rows.connection')}+ subtitle={t('settings:relay.label')}+ icon={<WaypointsIcon size={16} color={c.colorTextSecondary} />}+ onPress={() => router.push('/connection')}+ /><LinkRowstandalonelabel={t('settings:rows.security')}diff --git a/apps/mobile/src/api/mobileApi.ts b/apps/mobile/src/api/mobileApi.tsindex 2b8e094..be0ae62 100644--- a/apps/mobile/src/api/mobileApi.ts+++ b/apps/mobile/src/api/mobileApi.ts@@ -12,6 +12,7 @@ import { Directory, Paths } from 'expo-file-system'import * as SecureStore from 'expo-secure-store'import { Platform } from 'react-native'import { Worklet } from 'react-native-bare-kit'+import { isRelayEnabled } from '../lifecycle/relayStorage'const STORAGE_ROOT_DIRNAME = 'altersend'const IDENTITY_ROOT_DIRNAME = 'altersend-identity'@@ -66,6 +67,10 @@ async function getWorkletArgs() {if (deviceName) args.push(`--device-name=${deviceName}`)const isPad = Platform.OS === 'ios' && (Platform as { isPad?: boolean }).isPad === trueargs.push(`--device-type=${isPad ? 'tablet' : 'phone'}`)+ const relayConfPubkey = process.env.EXPO_PUBLIC_RELAY_CONF_PUBKEY?.trim()+ if (relayConfPubkey) args.push(`--relay-conf-pubkey=${relayConfPubkey}`)+ if (isRelayEnabled()) args.push('--relay-enabled')+return args}diff --git a/apps/mobile/src/lifecycle/relayStorage.ts b/apps/mobile/src/lifecycle/relayStorage.tsnew file mode 100644index 0000000..6da0fb1--- /dev/null+++ b/apps/mobile/src/lifecycle/relayStorage.ts@@ -0,0 +1,35 @@+import { Directory, File, Paths } from 'expo-file-system'++const DIRNAME = 'altersend'+const FILENAME = 'relay.disabled'++function getMarkerFile(): File | null {+ const documentDirectory = Paths.document+ if (!documentDirectory?.uri) return null+ return new File(new Directory(documentDirectory, DIRNAME), FILENAME)+}++export function isRelayEnabled(): boolean {+ try {+ return !(getMarkerFile()?.exists ?? false)+ } catch {+ return true+ }+}++export function setRelayEnabledStorage(value: boolean): void {+ try {+ const documentDirectory = Paths.document+ if (!documentDirectory?.uri) return+ const dir = new Directory(documentDirectory, DIRNAME)+ const file = new File(dir, FILENAME)+ if (value) {+ if (file.exists) file.delete()+ } else {+ if (!dir.exists) dir.create({ idempotent: true, intermediates: true })+ if (!file.exists) file.create()+ }+ } catch (err) {+ console.warn('relayStorage: setRelayEnabledStorage failed', err)+ }+}diff --git a/docs/architecture.md b/docs/architecture.mdindex cc6929f..6ca333b 100644--- a/docs/architecture.md+++ b/docs/architecture.md@@ -57,6 +57,8 @@ Key modules:- `worklet/transfer/storage.ts` — `TransferStorage`: the ephemeral Corestore + Hyperdrive backing a session, plus the sender/receiver bound to them (wiped on every disconnect)- `worklet/transfer/sender.ts` — `TransferSender`: stages local files into the writable Hyperdrive (sender path)- `worklet/transfer/receiver.ts` — `TransferReceiver`: writes replicated remote Hyperdrive contents to disk (receiver path)+- `worklet/relay/config.ts` — relay enable state + relay list; `relayThrough` (the Hyperswarm fallback callback) and `isRelayHost` (connection-type classification)+- `worklet/relay/conf.ts` — fetches the relay list from a signed HyperDHT mutable record; loads lazily once the relay is enabled (see [Relay fallback](#relay-fallback))- `worklet/identity/device-identity-store.ts` — `DeviceIdentityStore`: the stable device keypair, its secret is sealed in the OS keychain and injected at startup (see [Remembered devices & pairing](#remembered-devices--pairing))- `worklet/peers/store.ts` — `RememberedPeerStore`: persistent (HyperDB) list of paired devices- `worklet/peers/pairing-coordinator.ts` — `PairingCoordinator`: the dedicated pairing swarm + QR / code pairing handshake@@ -94,6 +96,16 @@ Shared internationalization package used by desktop and mobile. It owns supporte4. Sender stages the selected files into its writable Hyperdrive, then broadcasts a `transfer-ready` control message carrying file offers (each with the drive key).5. Receiver requests the offered files and downloads their blobs from the replicated drive. Progress and completion events flow back over the control channel → RPC → domain reducer → UI.+## Relay fallback++Most transfers connect directly (P2P hole-punching). When two peers can't reach each other — typically both behind symmetric NAT, e.g. both on a commercial VPN — the transfer falls back to a **blind relay**: a public server that pairs the two peers and forwards their already-encrypted UDX stream. The relay never has the keys to decrypt the data — it relays ciphertext only.++- **Engagement.** `relay/config.ts` exposes `relayThrough` to both swarms (`TransferSwarm`, `DiscoveryCoordinator`). It runs in "eager" mode: when enabled, it always offers the relay, so hyperdht can race a relayed path against a direct hole-punch and upgrade to direct if the punch lands.+- **Relay discovery (relay-conf).** The relay's public key isn't baked into the app. `relay/conf.ts` reads the current relay list from a signed HyperDHT **mutable record** whose public key ships with the app (`--relay-conf-pubkey`, injected at build time); only the relay operator's secret can update it, so relays rotate with no app release. The list is fetched **lazily** — only once the relay is enabled — with a small bounded retry to survive a cold-start DHT miss. This uses a mutable record (not a hypercore) specifically because the worklet wipes its Corestore on every startup.+- **Connection-type classification.** `TransferSwarm.classifyConnection` compares a peer socket's `remoteHost` against the known relay hosts (`isRelayHost`) and emits a per-peer `connection-type` (`direct` / `relay`) event. The receiver keys this per sender (`transferPeerKey`) so a mesh of receivers can't cross-contaminate the badge, and the UI shows **Connected** vs **Connected via relay**.++The app is only ever a relay *client* — it holds the relay's **public** key and address (from the relay-conf record) and never any relay secret.+## Remembered devices & pairingBeyond one-off code transfers, you can **pair** devices you own (or trust) so you can send to them later without a code. This lives entirely in the worklet (`packages/core/src/worklet/peers/*` + `identity/`) and is backed by three separate Hyperswarm instances:diff --git a/knip.json b/knip.jsonindex 248c131..5d3df7a 100644--- a/knip.json+++ b/knip.json@@ -61,7 +61,8 @@"app-builder-lib"],"ignoreUnresolved": [- "^\\./sentry-dsn\\.gen\\.js$"+ "^\\./sentry-dsn\\.gen\\.js$",+ "^\\./relay-conf-pubkey\\.gen\\.js$"],"ignoreBinaries": ["electron-builder.mac.json",diff --git a/package-lock.json b/package-lock.jsonindex b0064f4..f28de20 100644--- a/package-lock.json+++ b/package-lock.json@@ -72,6 +72,7 @@"@types/react-dom": "^19.2.3","@vitejs/plugin-react": "^5.2.0","app-builder-lib": "^26.8.1",+ "dotenv": "^16.6.1","electron": "^40.2.1","electron-builder": "^26.8.1","pear-build": "^1.1.0",@@ -27346,6 +27347,7 @@"corestore": "^7.9.1","hypercore-crypto": "^3.6.1","hyperdb": "^6.7.0",+ "hyperdht": "^6.32.0","hyperdrive": "^13.3.0","hyperswarm": "^4.17.0","localdrive": "^2.2.0",diff --git a/packages/components/src/icons/set.tsx b/packages/components/src/icons/set.tsxindex 7b7b96c..6fe75b5 100644--- a/packages/components/src/icons/set.tsx+++ b/packages/components/src/icons/set.tsx@@ -50,6 +50,7 @@ import {Trash2,Upload,Video,+ Waypoints,X} from './lucide'import { adaptLucide } from './adaptLucide'@@ -106,4 +107,5 @@ export const SmartphoneIcon = adaptLucide(Smartphone)export const TrashIcon = adaptLucide(Trash2)export const UploadIcon = adaptLucide(Upload)export const VideoIcon = adaptLucide(Video)+export const WaypointsIcon = adaptLucide(Waypoints)export const CloseIcon = adaptLucide(X)diff --git a/packages/core/package.json b/packages/core/package.jsonindex 10d3320..b84767e 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -45,6 +45,7 @@"corestore": "^7.9.1","hypercore-crypto": "^3.6.1","hyperdb": "^6.7.0",+ "hyperdht": "^6.32.0","hyperdrive": "^13.3.0","hyperswarm": "^4.17.0","localdrive": "^2.2.0",diff --git a/packages/core/src/types.d.ts b/packages/core/src/types.d.tsindex aeca05d..c26ee89 100644--- a/packages/core/src/types.d.ts+++ b/packages/core/src/types.d.ts@@ -128,6 +128,7 @@ declare module 'hyperswarm' {constructor(opts?: {keyPair?: NoiseKeyPairfirewall?: (remotePublicKey: Uint8Array) => boolean+ relayThrough?: ((force: boolean, swarm: unknown) => Uint8Array[] | null) | Uint8Array[] | null})join(discoveryKey: Uint8Array,@@ -140,6 +141,21 @@ declare module 'hyperswarm' {}}+declare module 'hyperdht' {+ export interface MutableRecord {+ seq: number+ value: Uint8Array+ signature: Uint8Array+ }+ export default class HyperDHT {+ mutableGet(+ publicKey: Uint8Array,+ opts?: { latest?: boolean; seq?: number }+ ): Promise<MutableRecord | null>+ destroy(): Promise<void>+ }+}+declare module 'protomux' {export interface ProtomuxMessage<T = unknown> {send(message: T): voiddiff --git a/packages/core/src/worklet/index.ts b/packages/core/src/worklet/index.tsindex ea36361..b076a26 100644--- a/packages/core/src/worklet/index.ts+++ b/packages/core/src/worklet/index.ts@@ -14,6 +14,8 @@ import { isDeviceType } from './identity/device-type'import { createReadyEvent } from './rpc/events'import { API, encodeRPCPayload } from './rpc/protocol'import { createTransferWorkerRPCServer } from './rpc/server'+import { configureRelay } from './relay/config'+import { startRelayConf, stopRelayConf } from './relay/conf'function readArg(prefix: string): string | undefined {const flag = (Bare.argv as string[]).find((arg) => arg.startsWith(prefix))@@ -66,6 +68,20 @@ const providedName = readArg('--device-name=')?.trim()const displayName = providedName || os.hostname().replace(/\.local$/, '') || 'AlterSend Device'const providedType = readArg('--device-type=')const deviceType = isDeviceType(providedType) ? providedType : undefined++const relayKeyArg = readArg('--relay-key=')?.trim()+const relayHostArg = readArg('--relay-host=')?.trim() ?? ''+const relayEnabledArg = (Bare.argv as string[]).includes('--relay-enabled')+if (relayKeyArg && !relayHostArg) {+ console.warn('[relay] --relay-key set without --relay-host; connections will classify as direct')+}+if (relayKeyArg || relayEnabledArg) {+ configureRelay({+ ...(relayKeyArg ? { relays: [{ keyHex: relayKeyArg, host: relayHostArg }] } : {}),+ enabled: relayEnabledArg || !!relayKeyArg+ })+}+const orchestrator = new TransferOrchestrator(sendTransferEvent, storageRoot, identityRoot, {displayName,deviceType@@ -74,6 +90,8 @@ const rpc = createTransferWorkerRPCServer(ipc, orchestrator, sendTransferEvent,orchestrator.abortInFlight())+startRelayConf(readArg('--relay-conf-pubkey='))+const originalLog: typeof console.log = console.logconst originalWarn: typeof console.warn = console.warnconst originalError: typeof console.error = console.error@@ -101,6 +119,11 @@ async function gracefulShutdown(_reason: string) {} catch (err) {console.error('Core: orchestrator.destroy failed', err)}+ try {+ await stopRelayConf()+ } catch (err) {+ console.error('Core: stopRelayConf failed', err)+ }}function exitProcess() {diff --git a/packages/core/src/worklet/peers/discovery.ts b/packages/core/src/worklet/peers/discovery.tsindex 62f2f51..eb1a51a 100644--- a/packages/core/src/worklet/peers/discovery.ts+++ b/packages/core/src/worklet/peers/discovery.ts@@ -15,6 +15,7 @@ import {type TransferIPCMessage} from '../rpc/events'import { BadRequestError, type InviteDeviceReply, type InviteResponseReply } from '../rpc/protocol'+import { relayThrough } from '../relay/config'export const INVITE_WAIT_MS = 30_000@@ -27,6 +28,7 @@ export interface DiscoverySwarm {type CreateDiscoverySwarm = (opts: {keyPair: NoiseKeyPairfirewall: (remotePublicKey: Uint8Array) => boolean+ relayThrough: (force: boolean, swarm: unknown) => Uint8Array[] | null}) => DiscoverySwarmexport interface DiscoveryDeps {@@ -84,7 +86,8 @@ export class DiscoveryCoordinator {this.swarm = createSwarm({keyPair: { publicKey: identity.publicKey, secretKey: identity.secretKey },firewall: (remotePublicKey) =>- !this.knownPubkeys.has(normalizeKey(b4a.toString(remotePublicKey, 'hex')))+ !this.knownPubkeys.has(normalizeKey(b4a.toString(remotePublicKey, 'hex'))),+ relayThrough})this.swarm.on('connection', (socket, info) => {this.handleConnection(socket, info)diff --git a/packages/core/src/worklet/relay/conf.ts b/packages/core/src/worklet/relay/conf.tsnew file mode 100644index 0000000..a038b53--- /dev/null+++ b/packages/core/src/worklet/relay/conf.ts@@ -0,0 +1,108 @@+import b4a from 'b4a'+import DHT from 'hyperdht'+import { configureRelay, registerRelayLoader, relayConfigSummary } from './config'+import { isValidHexKey } from '../transfer/utils'++const MAX_ATTEMPTS = 3+const RETRY_DELAY_MS = 5000++let pubkey: Uint8Array | null = null+let loaded = false+let inFlight = false+let activeDht: DHT | null = null++export function startRelayConf(pubkeyHex: string | undefined): void {+ if (!pubkeyHex || pubkey) return++ pubkey = b4a.from(pubkeyHex, 'hex')+ registerRelayLoader(() => ensureRelayConf())++ if (relayConfigSummary().enabled) ensureRelayConf()+}++interface RelayRecordEntry {+ key: string+ host: string+}++function isValidEntry(entry: unknown): entry is RelayRecordEntry {+ const e = entry as Partial<RelayRecordEntry> | null+ return (+ !!e &&+ typeof e === 'object' &&+ isValidHexKey(e.key) &&+ typeof e.host === 'string' &&+ e.host.length > 0+ )+}++const delay = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms))++async function ensureRelayConf(): Promise<void> {+ if (!pubkey || loaded || inFlight || !relayConfigSummary().enabled) return++ inFlight = true+ const dht = new DHT()+ activeDht = dht++ try {+ for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {+ if (activeDht !== dht) return+ if (await tryFetch(dht)) {+ loaded = true+ return+ }+ if (attempt < MAX_ATTEMPTS - 1) await delay(RETRY_DELAY_MS)+ }+ } finally {+ activeDht = null+ inFlight = false+ try {+ await dht.destroy()+ } catch (err) {+ console.warn(+ '[relay-conf] dht.destroy failed',+ err instanceof Error ? err.message : String(err)+ )+ }+ }+}++async function tryFetch(dht: DHT): Promise<boolean> {+ if (!pubkey) return false++ try {+ const record = await dht.mutableGet(pubkey, { latest: true })+ if (!record?.value) return false+ const parsed = JSON.parse(b4a.toString(record.value, 'utf8')) as { relays?: unknown }+ if (+ Array.isArray(parsed.relays) &&+ parsed.relays.length > 0 &&+ parsed.relays.every(isValidEntry)+ ) {+ const relays = parsed.relays as RelayRecordEntry[]+ configureRelay({ relays: relays.map((r) => ({ keyHex: r.key, host: r.host })) })+ return true+ }+ } catch (err) {+ console.warn('[relay-conf] fetch failed', err instanceof Error ? err.message : String(err))+ }++ return false+}++export async function stopRelayConf(): Promise<void> {+ const dht = activeDht+ activeDht = null++ if (dht) {+ try {+ await dht.destroy()+ } catch (err) {+ console.warn(+ '[relay-conf] dht.destroy failed',+ err instanceof Error ? err.message : String(err)+ )+ }+ }+}diff --git a/packages/core/src/worklet/relay/config.test.ts b/packages/core/src/worklet/relay/config.test.tsnew file mode 100644index 0000000..e3214af--- /dev/null+++ b/packages/core/src/worklet/relay/config.test.ts@@ -0,0 +1,54 @@+import b4a from 'b4a'+import { beforeEach, describe, expect, it } from 'vitest'+import { configureRelay, isRelayHost, relayConfigSummary, relayThrough } from './config'++const KEY_A = 'a'.repeat(64)+const HOST_A = '1.2.3.4'+const KEY_B = 'b'.repeat(64)+const HOST_B = '5.6.7.8'++beforeEach(() => {+ configureRelay({ enabled: false, relays: [] })+})++describe('relay/config', () => {+ it('relayThrough returns null when disabled, even with relays configured', () => {+ configureRelay({ relays: [{ keyHex: KEY_A, host: HOST_A }] })+ expect(relayThrough(false)).toBeNull()+ })++ it('relayThrough returns null when enabled but no relays', () => {+ configureRelay({ enabled: true })+ expect(relayThrough(false)).toBeNull()+ })++ it('relayThrough returns the keys when enabled with relays', () => {+ configureRelay({+ enabled: true,+ relays: [+ { keyHex: KEY_A, host: HOST_A },+ { keyHex: KEY_B, host: HOST_B }+ ]+ })+ const keys = relayThrough(false)+ expect(keys).toHaveLength(2)+ expect(keys?.map((k) => b4a.toString(k, 'hex'))).toEqual([KEY_A, KEY_B])+ })++ it('isRelayHost matches configured hosts only', () => {+ configureRelay({ enabled: true, relays: [{ keyHex: KEY_A, host: HOST_A }] })+ expect(isRelayHost(HOST_A)).toBe(true)+ expect(isRelayHost(HOST_B)).toBe(false)+ expect(isRelayHost(null)).toBe(false)+ expect(isRelayHost(undefined)).toBe(false)+ })++ it('configureRelay replaces relays; summary and isRelayHost follow', () => {+ configureRelay({ enabled: true, relays: [{ keyHex: KEY_A, host: HOST_A }] })+ expect(relayConfigSummary()).toEqual({ enabled: true, keyCount: 1 })++ configureRelay({ relays: [] })+ expect(relayConfigSummary()).toEqual({ enabled: true, keyCount: 0 })+ expect(isRelayHost(HOST_A)).toBe(false)+ })+})diff --git a/packages/core/src/worklet/relay/config.ts b/packages/core/src/worklet/relay/config.tsnew file mode 100644index 0000000..6914c0e--- /dev/null+++ b/packages/core/src/worklet/relay/config.ts@@ -0,0 +1,61 @@+import b4a from 'b4a'++interface RelayEntry {+ key: Uint8Array+ host: string+}++interface RelayState {+ enabled: boolean+ relays: RelayEntry[]+}++const state: RelayState = {+ enabled: false,+ relays: []+}++let relayLoader: (() => void) | null = null++export function registerRelayLoader(load: () => void): void {+ relayLoader = load+}++interface RelayEntryInput {+ keyHex: string+ host: string+}++export interface RelayConfigInput {+ enabled?: boolean+ relays?: readonly RelayEntryInput[]+}++function toRelayEntry({ keyHex, host }: RelayEntryInput): RelayEntry {+ return { key: b4a.from(keyHex, 'hex'), host }+}++export function configureRelay(input: RelayConfigInput): void {+ if (typeof input.enabled === 'boolean') {+ state.enabled = input.enabled+ }++ if (input.relays) {+ state.relays = input.relays.map(toRelayEntry)+ }++ if (state.enabled) relayLoader?.()+}++export function relayConfigSummary(): { enabled: boolean; keyCount: number } {+ return { enabled: state.enabled, keyCount: state.relays.length }+}++export function relayThrough(_force: boolean, _swarm?: unknown): Uint8Array[] | null {+ if (!state.enabled || state.relays.length === 0) return null+ return state.relays.map((r) => r.key)+}++export function isRelayHost(host: string | null | undefined): boolean {+ return !!host && state.relays.some((r) => r.host === host)+}diff --git a/packages/core/src/worklet/rpc/commands.ts b/packages/core/src/worklet/rpc/commands.tsindex a3a18ba..0ea4c33 100644--- a/packages/core/src/worklet/rpc/commands.ts+++ b/packages/core/src/worklet/rpc/commands.ts@@ -13,7 +13,8 @@ export const API = {forgetPeer: 11,initDeviceSecret: 12,hostPairing: 13,- joinPairing: 14+ joinPairing: 14,+ setRelayConfig: 15},channels: {event: 100,diff --git a/packages/core/src/worklet/rpc/events.ts b/packages/core/src/worklet/rpc/events.tsindex 6120e7d..5b0558c 100644--- a/packages/core/src/worklet/rpc/events.ts+++ b/packages/core/src/worklet/rpc/events.ts@@ -17,6 +17,7 @@ export type TransferStatus =| 'joined'| 'disconnected'| 'reconnecting'+ | 'connection-type'export type TransferRole = 'sender' | 'receiver'@@ -52,6 +53,7 @@ export interface StatusEvent {totalBytes?: numberbytesTransferred?: numbermessage?: string+ connectionType?: 'direct' | 'relay'}export interface RoleEvent {diff --git a/packages/core/src/worklet/rpc/protocol.ts b/packages/core/src/worklet/rpc/protocol.tsindex 906f448..c8b112a 100644--- a/packages/core/src/worklet/rpc/protocol.ts+++ b/packages/core/src/worklet/rpc/protocol.ts@@ -107,6 +107,15 @@ export interface InitDeviceSecretReply {secretKey: string | null}+export interface SetRelayConfigInput {+ enabled: boolean+}++export interface SetRelayConfigReply {+ enabled: boolean+ keyCount: number+}+export interface RPCErrorPayload {code: 'BAD_REQUEST' | 'UNKNOWN_COMMAND' | 'INTERNAL_ERROR'message: string@@ -156,6 +165,7 @@ export interface TransferRPC {initDeviceSecret(init: DeviceSecretInit): Promise<InitDeviceSecretReply>hostPairing(): Promise<HostReply>joinPairing(topic: string): Promise<JoinReply>+ setRelayConfig(input: SetRelayConfigInput): Promise<SetRelayConfigReply>}export class BadRequestError extends Error {diff --git a/packages/core/src/worklet/transfer/control-channel.ts b/packages/core/src/worklet/transfer/control-channel.tsindex 115bb82..92441b4 100644--- a/packages/core/src/worklet/transfer/control-channel.ts+++ b/packages/core/src/worklet/transfer/control-channel.ts@@ -29,6 +29,7 @@ export interface TransferReady {type: 'transfer-ready'transferId: stringfiles: TransferOffer[]+ peer?: string}export interface TransferStart {diff --git a/packages/core/src/worklet/transfer/orchestrator.ts b/packages/core/src/worklet/transfer/orchestrator.tsindex 3a3a7de..9b34592 100644--- a/packages/core/src/worklet/transfer/orchestrator.ts+++ b/packages/core/src/worklet/transfer/orchestrator.ts@@ -24,6 +24,8 @@ import type {JoinReply,RememberVoteInput,RememberVoteReply,+ SetRelayConfigInput,+ SetRelayConfigReply,ShareFileRequest,ShareFilesReply,TransferRPC@@ -66,6 +68,7 @@ import { RememberCoordinator } from '../peers/remember-coordinator'import { RecognitionCoordinator } from '../peers/recognition-coordinator'import { DiscoveryCoordinator } from '../peers/discovery'import { PairingCoordinator } from '../peers/pairing-coordinator'+import { configureRelay, relayConfigSummary } from '../relay/config'function createTransferId(): string {return crypto.randomBytes(16).toString('hex')@@ -143,6 +146,10 @@ export class TransferOrchestrator implements TransferRPC {onControlMessage: (message, session) => {if (this.suspended) returnthis.onControlMessage(message, session)+ },+ onConnectionType: (peerKey, connectionType) => {+ if (this.suspended) return+ this.sendStatus('connection-type', { peer: peerKey, connectionType })}},{ identityStore }@@ -258,7 +265,9 @@ export class TransferOrchestrator implements TransferRPC {console.warn(`TransferOrchestrator: dropping inbound ${message.type} in role=${this.role}`)return}- this.emitIPC(message)+ this.emitIPC(+ message.type === 'transfer-ready' ? { ...message, peer: session.peerKey } : message+ )return}@@ -524,6 +533,12 @@ export class TransferOrchestrator implements TransferRPC {await this.swarm.endSession()}+ async setRelayConfig(input: SetRelayConfigInput): Promise<SetRelayConfigReply> {+ configureRelay({ enabled: input.enabled })+ const { enabled, keyCount } = relayConfigSummary()+ return { enabled, keyCount }+ }+async suspend(): Promise<void> {if (this.suspended) returndiff --git a/packages/core/src/worklet/transfer/swarm.ts b/packages/core/src/worklet/transfer/swarm.tsindex 9c54e99..7f723c8 100644--- a/packages/core/src/worklet/transfer/swarm.ts+++ b/packages/core/src/worklet/transfer/swarm.ts@@ -4,6 +4,9 @@ import Hyperswarm, { type PeerInfo, type PeerSocket } from 'hyperswarm'import { PeerControlChannel } from './control-channel'import type { PeerControlMessage } from './control-channel'import { PeerIdentityStore, type NoiseKeyPair } from './peer-identity-store'+import { relayThrough, isRelayHost } from '../relay/config'++type ConnectionType = 'direct' | 'relay'export interface PeerSession {socket: PeerSocket@@ -18,6 +21,7 @@ export interface TransferSwarmCallbacks {onPeerConnected: (session: PeerSession) => voidonPeerDisconnected: (peerKey: string | null, remainingCount: number) => voidonControlMessage: (message: PeerControlMessage, session: PeerSession) => void+ onConnectionType?: (peerKey: string, connectionType: ConnectionType) => void}export interface TransferSwarmOptions {@@ -59,9 +63,9 @@ export class TransferSwarm {}private createSwarm(keyPair?: NoiseKeyPair): Hyperswarm {- const swarm = keyPair ? new Hyperswarm({ keyPair }) : new Hyperswarm()+ const swarm = new Hyperswarm({ ...(keyPair ? { keyPair } : {}), relayThrough })swarm.on('connection', (socket, info) => {- void this.handleConnection(socket, info).catch((err) => {+ this.handleConnection(socket, info).catch((err) => {console.error('TransferSwarm: handleConnection failed',err instanceof Error ? err.message : String(err)@@ -104,11 +108,37 @@ export class TransferSwarm {session = { socket, peerKey, controlChannel, handshakeHash: socket.handshakeHash ?? null }this.peerSessions.set(socket, session)this.callbacks.onPeerConnected(session)+ this.classifyConnection(socket, peerKey)socket.on('close', () => this.cleanupPeer(socket))socket.on('error', () => this.cleanupPeer(socket))}+ private classifyConnection(socket: PeerSocket, peerKey: string): void {+ if (!this.callbacks.onConnectionType) return+ const remoteHost = () =>+ (socket as unknown as { rawStream?: { remoteHost?: string } }).rawStream?.remoteHost+ const classify = (): ConnectionType => (isRelayHost(remoteHost()) ? 'relay' : 'direct')++ let current = classify()+ this.callbacks.onConnectionType(peerKey, current)++ if (current !== 'relay') return++ let ticks = 0+ const timer = setInterval(() => {+ const next = classify()+ if (next !== current) {+ current = next+ this.callbacks.onConnectionType?.(peerKey, next)+ }+ if (next !== 'relay' || ++ticks >= 8) clearInterval(timer)+ }, 2000)+ ;(timer as unknown as { unref?: () => void }).unref?.()++ socket.on('close', () => clearInterval(timer))+ }+private cleanupPeer(socket: PeerSocket): void {const session = this.peerSessions.get(socket)if (!session) returndiff --git a/packages/domain/src/onboarding.ts b/packages/domain/src/onboarding.tsindex 164c126..8be83b3 100644--- a/packages/domain/src/onboarding.ts+++ b/packages/domain/src/onboarding.ts@@ -2,7 +2,6 @@ export type OnboardingSlideKind = 'pairing' | 'keep-open' | 'privacy'export const privacyPolicyUrl = 'https://altersend.com/privacy'export const termsOfServiceUrl = 'https://altersend.com/terms'-export const abuseEmail = '[email protected]'export const supportEmail = '[email protected]'export const websiteUrl = 'https://altersend.com'export const githubUrl = 'https://github.com/denislupookov/altersend'diff --git a/packages/domain/src/transfer/binding.ts b/packages/domain/src/transfer/binding.tsindex f3df64e..97cd1d0 100644--- a/packages/domain/src/transfer/binding.ts+++ b/packages/domain/src/transfer/binding.ts@@ -44,7 +44,11 @@ function dispatchRendererEvent(event: RendererTransferEvent): void {case 'status':return dispatchStatusEvent(event)case 'transfer-ready':- return dispatchToTransferStore({ type: 'transfer_ready', files: event.files })+ return dispatchToTransferStore({+ type: 'transfer_ready',+ files: event.files,+ peer: event.peer+ })case 'role':return dispatchToTransferStore({ type: 'role_changed', role: event.role })case 'error':@@ -125,6 +129,15 @@ function dispatchStatusEvent(event: StatusEvent): void {case 'peer-disconnected':if (event.peer) dispatchToTransferStore({ type: 'peer_left', peerKey: event.peer })return+ case 'connection-type':+ if (event.connectionType && event.peer) {+ dispatchToTransferStore({+ type: 'connection_type_changed',+ peer: event.peer,+ connectionType: event.connectionType+ })+ }+ returncase 'joining':case 'joined':case 'disconnected':diff --git a/packages/domain/src/transfer/reducer.test.ts b/packages/domain/src/transfer/reducer.test.tsindex de33388..1b54525 100644--- a/packages/domain/src/transfer/reducer.test.ts+++ b/packages/domain/src/transfer/reducer.test.ts@@ -405,3 +405,57 @@ describe('transferSessionReducer — misc', () => {})})})++describe('transferSessionReducer — connection type (per-peer)', () => {+ const SENDER = 'a'.repeat(64)+ const OTHER = 'b'.repeat(64)+ const ready = (peer: string): TransferAction => ({+ type: 'transfer_ready',+ files: [offer('1', 'a.txt')],+ peer+ })++ it('shows the sender connection type, not another peer that connects later', () => {+ let state = apply(make({ role: 'receiver' }), ready(SENDER))+ state = apply(state, {+ type: 'connection_type_changed',+ peer: SENDER,+ connectionType: 'direct'+ })+ expect(state.connectionType).toBe('direct')++ state = apply(state, { type: 'connection_type_changed', peer: OTHER, connectionType: 'relay' })+ expect(state.connectionType).toBe('direct')+ })++ it('derives the sender type regardless of event order', () => {+ let state = make({ role: 'receiver' })+ state = apply(state, { type: 'connection_type_changed', peer: SENDER, connectionType: 'relay' })+ expect(state.connectionType).toBeNull()++ state = apply(state, ready(SENDER))+ expect(state.connectionType).toBe('relay')+ })++ it('reflects a relay→direct upgrade on the sender', () => {+ let state = apply(make({ role: 'receiver' }), ready(SENDER))+ state = apply(state, { type: 'connection_type_changed', peer: SENDER, connectionType: 'relay' })+ expect(state.connectionType).toBe('relay')++ state = apply(state, {+ type: 'connection_type_changed',+ peer: SENDER,+ connectionType: 'direct'+ })+ expect(state.connectionType).toBe('direct')+ })++ it('clears per-peer connection state on session end', () => {+ let state = apply(make({ role: 'receiver' }), ready(SENDER))+ state = apply(state, { type: 'connection_type_changed', peer: SENDER, connectionType: 'relay' })+ state = apply(state, { type: 'status_changed', state: 'disconnected' })+ expect(state.connectionType).toBeNull()+ expect(state.transferPeerKey).toBeNull()+ expect(state.connectionTypes).toEqual({})+ })+})diff --git a/packages/domain/src/transfer/reducer.ts b/packages/domain/src/transfer/reducer.tsindex 8ad968d..de20723 100644--- a/packages/domain/src/transfer/reducer.ts+++ b/packages/domain/src/transfer/reducer.ts@@ -11,6 +11,7 @@ import type {ConnectionState,IncomingPairRequest,TransferAction,+ TransferConnectionType,TransferSessionState} from './types'@@ -26,6 +27,9 @@ export { TRANSFER_ERROR_CODES } from './types'export const initialTransferSessionState: TransferSessionState = {topic: '',connectionState: 'disconnected',+ connectionType: null,+ connectionTypes: {},+ transferPeerKey: null,role: null,peerCount: 0,isReconnecting: false,@@ -49,6 +53,13 @@ export const initialTransferSessionState: TransferSessionState = {peers: []}+function deriveConnectionType(+ connectionTypes: Record<string, TransferConnectionType>,+ transferPeerKey: string | null+): TransferConnectionType | null {+ return transferPeerKey ? (connectionTypes[transferPeerKey] ?? null) : null+}+function clearError(state: TransferSessionState): TransferSessionState {return state.errorCode === null && state.errorMessage === null? state@@ -77,6 +88,9 @@ function endSession(state: TransferSessionState): TransferSessionState {peerDownloads: {},connectedPeers: {},connectionState: 'disconnected',+ connectionType: null,+ connectionTypes: {},+ transferPeerKey: null,peerCount: 0,topic: '',errorCode: null,@@ -137,6 +151,15 @@ export function transferSessionReducer(}}}+ case 'connection_type_changed': {+ if (state.connectionTypes[action.peer] === action.connectionType) return state+ const connectionTypes = { ...state.connectionTypes, [action.peer]: action.connectionType }+ return {+ ...state,+ connectionTypes,+ connectionType: deriveConnectionType(connectionTypes, state.transferPeerKey)+ }+ }case 'reconnecting':return { ...state, isReconnecting: true }case 'clear_session':@@ -254,6 +277,9 @@ export function transferSessionReducer(peerDownloads: {},connectedPeers: {},connectionState: 'joining',+ connectionType: null,+ connectionTypes: {},+ transferPeerKey: null,peerCount: 0,errorCode: null,errorMessage: null@@ -261,6 +287,7 @@ export function transferSessionReducer(case 'transfer_ready': {if (state.role !== 'receiver') return stateconst incomingFileOffers = mergeIncomingFileOffers(state.incomingFileOffers, action.files)+ const transferPeerKey = action.peer ?? state.transferPeerKeyreturn {...state,incomingFileOffers,@@ -268,6 +295,8 @@ export function transferSessionReducer(state.receiveDownloadStates,incomingFileOffers),+ transferPeerKey,+ connectionType: deriveConnectionType(state.connectionTypes, transferPeerKey),transferId: action.files[0]?.transferId ?? state.transferId,errorCode: null,errorMessage: nulldiff --git a/packages/domain/src/transfer/types.ts b/packages/domain/src/transfer/types.tsindex e96887a..bbfc074 100644--- a/packages/domain/src/transfer/types.ts+++ b/packages/domain/src/transfer/types.ts@@ -22,6 +22,8 @@ export type { TransferErrorCode }export type ConnectionState = 'disconnected' | 'joining' | 'joined' | 'peer-connected'+export type TransferConnectionType = 'direct' | 'relay'+export type PeerPairStatus = 'requested' | 'paired'export interface IncomingPairRequest {@@ -59,6 +61,9 @@ export interface RememberState {export interface TransferSessionState {topic: stringconnectionState: ConnectionState+ connectionType: TransferConnectionType | null+ connectionTypes: Record<string, TransferConnectionType>+ transferPeerKey: string | nullrole: TransferRole | nullpeerCount: numberisReconnecting: boolean@@ -86,6 +91,7 @@ export type TransferAction =| { type: 'clear_session' }| { type: 'set_error'; code?: TransferErrorCode; message: string }| { type: 'status_changed'; state: ConnectionState; peers?: number }+ | { type: 'connection_type_changed'; peer: string; connectionType: TransferConnectionType }| { type: 'role_changed'; role: TransferRole | null }| { type: 'apply_sharing_progress'; event: SharingStatusEvent }| { type: 'init_upload_items'; items: SenderUploadItem[] }@@ -106,7 +112,7 @@ export type TransferAction =intendedDestination: SaveDestinationsavedTo?: string}- | { type: 'transfer_ready'; files: IncomingFileOffer[] }+ | { type: 'transfer_ready'; files: IncomingFileOffer[]; peer?: string }| { type: 'reconnecting' }| { type: 'peer_unreachable' }| { type: 'remember_confirmed'; peerKey: string; displayName: string }diff --git a/packages/locales/src/locales/de-DE/common.json b/packages/locales/src/locales/de-DE/common.jsonindex 830387e..c9037d7 100644--- a/packages/locales/src/locales/de-DE/common.json+++ b/packages/locales/src/locales/de-DE/common.json@@ -30,7 +30,8 @@"copyText": "Text kopieren","add": "Hinzufügen","showMore": "Mehr anzeigen",- "showLess": "Weniger anzeigen"+ "showLess": "Weniger anzeigen",+ "learnMore": "Mehr erfahren"},"labels": {"settings": "Einstellungen",@@ -76,7 +77,8 @@},"status": {"connected": "Verbunden",- "wantsToSend": "möchte dir {{label}}{{size}} senden"+ "wantsToSend": "möchte dir {{label}}{{size}} senden",+ "connectedViaRelay": "Verbunden über Relay"},"confirm": {"leaveShareSession": "Durch das Verlassen wird Ihre aktive Freigabesitzung beendet. Weitermachen?",diff --git a/packages/locales/src/locales/de-DE/settings.json b/packages/locales/src/locales/de-DE/settings.jsonindex 7d4a1ee..966b17f 100644--- a/packages/locales/src/locales/de-DE/settings.json+++ b/packages/locales/src/locales/de-DE/settings.json@@ -11,6 +11,12 @@"label": "Absturzberichte","description": "Teilen Sie anonyme Absturzdaten, um AlterSend zu verbessern"},+ "relay": {+ "label": "Relay verwenden, wenn keine direkte Verbindung möglich ist",+ "description": "Wenn sich zwei Geräte nicht direkt verbinden können (zum Beispiel beide über ein VPN), wird die Übertragung über das Relay von AlterSend geleitet. Dateien bleiben Ende-zu-Ende-verschlüsselt.",+ "contact": "Benötigen Sie ein dediziertes Relay oder höhere Limits?",+ "fairUse": "Das Relay hat Grenzen für die Übertragungsgröße und dafür, wie viele Übertragungen gleichzeitig laufen können."+ },"rows": {"security": "Sicherheit","feedback": "Rückmeldung",@@ -24,7 +30,8 @@"termsHint": "Regeln für die Verwendung von AlterSend","website": "Webseite","noDevices": "Noch keine Geräte",- "pairedCount": "{{count}} gekoppelt"+ "pairedCount": "{{count}} gekoppelt",+ "connection": "Relay"},"legal": {"terms": "Nutzungsbedingungen",diff --git a/packages/locales/src/locales/en-GB/common.json b/packages/locales/src/locales/en-GB/common.jsonindex d0fd515..fb3cbdd 100644--- a/packages/locales/src/locales/en-GB/common.json+++ b/packages/locales/src/locales/en-GB/common.json@@ -30,7 +30,8 @@"copyText": "Copy Text","add": "Add","showMore": "Show more",- "showLess": "Show less"+ "showLess": "Show less",+ "learnMore": "Learn more"},"labels": {"settings": "Settings",@@ -76,7 +77,8 @@},"status": {"connected": "Connected",- "wantsToSend": "wants to send you {{label}}{{size}}"+ "wantsToSend": "wants to send you {{label}}{{size}}",+ "connectedViaRelay": "Connected via relay"},"confirm": {"leaveShareSession": "Leaving will end your active share session. Continue?",diff --git a/packages/locales/src/locales/en-GB/settings.json b/packages/locales/src/locales/en-GB/settings.jsonindex c1c7661..a0803fc 100644--- a/packages/locales/src/locales/en-GB/settings.json+++ b/packages/locales/src/locales/en-GB/settings.json@@ -11,6 +11,12 @@"label": "Crash reports","description": "Share anonymous crash data to help improve AlterSend"},+ "relay": {+ "label": "Use relay when direct connection fails",+ "description": "When two devices can't connect directly (for example both on a VPN), the transfer is routed through AlterSend's relay. Files stay end-to-end encrypted.",+ "contact": "Need a dedicated relay or higher limits?",+ "fairUse": "The relay has limits on transfer size and how many transfers can run at once."+ },"rows": {"security": "Security","feedback": "Feedback",@@ -24,7 +30,8 @@"termsHint": "Rules for using AlterSend","website": "Website","noDevices": "No devices yet",- "pairedCount": "{{count}} paired"+ "pairedCount": "{{count}} paired",+ "connection": "Relay"},"legal": {"terms": "Terms of Use",diff --git a/packages/locales/src/locales/en-US/common.json b/packages/locales/src/locales/en-US/common.jsonindex d0fd515..fb3cbdd 100644--- a/packages/locales/src/locales/en-US/common.json+++ b/packages/locales/src/locales/en-US/common.json@@ -30,7 +30,8 @@"copyText": "Copy Text","add": "Add","showMore": "Show more",- "showLess": "Show less"+ "showLess": "Show less",+ "learnMore": "Learn more"},"labels": {"settings": "Settings",@@ -76,7 +77,8 @@},"status": {"connected": "Connected",- "wantsToSend": "wants to send you {{label}}{{size}}"+ "wantsToSend": "wants to send you {{label}}{{size}}",+ "connectedViaRelay": "Connected via relay"},"confirm": {"leaveShareSession": "Leaving will end your active share session. Continue?",diff --git a/packages/locales/src/locales/en-US/settings.json b/packages/locales/src/locales/en-US/settings.jsonindex c1c7661..a0803fc 100644--- a/packages/locales/src/locales/en-US/settings.json+++ b/packages/locales/src/locales/en-US/settings.json@@ -11,6 +11,12 @@"label": "Crash reports","description": "Share anonymous crash data to help improve AlterSend"},+ "relay": {+ "label": "Use relay when direct connection fails",+ "description": "When two devices can't connect directly (for example both on a VPN), the transfer is routed through AlterSend's relay. Files stay end-to-end encrypted.",+ "contact": "Need a dedicated relay or higher limits?",+ "fairUse": "The relay has limits on transfer size and how many transfers can run at once."+ },"rows": {"security": "Security","feedback": "Feedback",@@ -24,7 +30,8 @@"termsHint": "Rules for using AlterSend","website": "Website","noDevices": "No devices yet",- "pairedCount": "{{count}} paired"+ "pairedCount": "{{count}} paired",+ "connection": "Relay"},"legal": {"terms": "Terms of Use",diff --git a/packages/locales/src/locales/es-419/common.json b/packages/locales/src/locales/es-419/common.jsonindex 892e198..7f769ad 100644--- a/packages/locales/src/locales/es-419/common.json+++ b/packages/locales/src/locales/es-419/common.json@@ -30,7 +30,8 @@"copyText": "Copiar texto","add": "Agregar","showMore": "Mostrar más",- "showLess": "Mostrar menos"+ "showLess": "Mostrar menos",+ "learnMore": "Más información"},"labels": {"settings": "Configuración",@@ -76,7 +77,8 @@},"status": {"connected": "Conectado",- "wantsToSend": "quiere enviarte {{label}}{{size}}"+ "wantsToSend": "quiere enviarte {{label}}{{size}}",+ "connectedViaRelay": "Conectado vía relé"},"confirm": {"leaveShareSession": "Al salir, finalizará su sesión activa para compartir. ¿Continuar?",diff --git a/packages/locales/src/locales/es-419/settings.json b/packages/locales/src/locales/es-419/settings.jsonindex acd9e9d..3eb7582 100644--- a/packages/locales/src/locales/es-419/settings.json+++ b/packages/locales/src/locales/es-419/settings.json@@ -11,6 +11,12 @@"label": "Informes de fallos","description": "Comparte datos anónimos sobre fallos para ayudar a mejorar AlterSend"},+ "relay": {+ "label": "Usar relé cuando falle la conexión directa",+ "description": "Cuando dos dispositivos no pueden conectarse directamente (por ejemplo, ambos con VPN), la transferencia se enruta a través del relé de AlterSend. Los archivos siguen cifrados de extremo a extremo.",+ "contact": "¿Necesitas un relé dedicado o límites más altos?",+ "fairUse": "El relé tiene límites en el tamaño de las transferencias y en cuántas pueden ejecutarse a la vez."+ },"rows": {"security": "Seguridad","feedback": "Comentarios",@@ -24,7 +30,8 @@"termsHint": "Reglas para usar AlterSend","website": "Sitio web","noDevices": "Aún no hay dispositivos",- "pairedCount": "{{count}} emparejados"+ "pairedCount": "{{count}} emparejados",+ "connection": "Relé"},"legal": {"terms": "Términos de uso",diff --git a/packages/locales/src/locales/es-ES/common.json b/packages/locales/src/locales/es-ES/common.jsonindex b24618a..f492a09 100644--- a/packages/locales/src/locales/es-ES/common.json+++ b/packages/locales/src/locales/es-ES/common.json@@ -30,7 +30,8 @@"copyText": "Copiar texto","add": "Añadir","showMore": "Mostrar más",- "showLess": "Mostrar menos"+ "showLess": "Mostrar menos",+ "learnMore": "Más información"},"labels": {"settings": "Ajustes",@@ -76,7 +77,8 @@},"status": {"connected": "Conectado",- "wantsToSend": "quiere enviarte {{label}}{{size}}"+ "wantsToSend": "quiere enviarte {{label}}{{size}}",+ "connectedViaRelay": "Conectado vía relé"},"confirm": {"leaveShareSession": "Al salir, finalizará su sesión activa para compartir. ¿Continuar?",diff --git a/packages/locales/src/locales/es-ES/settings.json b/packages/locales/src/locales/es-ES/settings.jsonindex 46a3695..9133af3 100644--- a/packages/locales/src/locales/es-ES/settings.json+++ b/packages/locales/src/locales/es-ES/settings.json@@ -11,6 +11,12 @@"label": "Informes de fallos","description": "Comparte datos anónimos sobre fallos para ayudar a mejorar AlterSend"},+ "relay": {+ "label": "Usar relé cuando falle la conexión directa",+ "description": "Cuando dos dispositivos no pueden conectarse directamente (por ejemplo, ambos con VPN), la transferencia se enruta a través del relé de AlterSend. Los archivos siguen cifrados de extremo a extremo.",+ "contact": "¿Necesitas un relé dedicado o límites más altos?",+ "fairUse": "El relé tiene límites en el tamaño de las transferencias y en cuántas pueden ejecutarse a la vez."+ },"rows": {"security": "Seguridad","feedback": "Comentarios",@@ -24,7 +30,8 @@"termsHint": "Reglas para usar AlterSend","website": "Sitio web","noDevices": "Aún no hay dispositivos",- "pairedCount": "{{count}} emparejados"+ "pairedCount": "{{count}} emparejados",+ "connection": "Relé"},"legal": {"terms": "Términos de uso",diff --git a/packages/locales/src/locales/fr-FR/common.json b/packages/locales/src/locales/fr-FR/common.jsonindex cf8ae3c..4cf29ec 100644--- a/packages/locales/src/locales/fr-FR/common.json+++ b/packages/locales/src/locales/fr-FR/common.json@@ -30,7 +30,8 @@"copyText": "Copier le texte","add": "Ajouter","showMore": "Afficher plus",- "showLess": "Afficher moins"+ "showLess": "Afficher moins",+ "learnMore": "En savoir plus"},"labels": {"settings": "Paramètres",@@ -76,7 +77,8 @@},"status": {"connected": "Connecté",- "wantsToSend": "veut vous envoyer {{label}}{{size}}"+ "wantsToSend": "veut vous envoyer {{label}}{{size}}",+ "connectedViaRelay": "Connecté via relais"},"confirm": {"leaveShareSession": "Quitter mettra fin à votre session de partage active. Continuer?",diff --git a/packages/locales/src/locales/fr-FR/settings.json b/packages/locales/src/locales/fr-FR/settings.jsonindex 4fda75e..ed14c57 100644--- a/packages/locales/src/locales/fr-FR/settings.json+++ b/packages/locales/src/locales/fr-FR/settings.json@@ -11,6 +11,12 @@"label": "Rapports d'erreur","description": "Partagez des données anonymes sur les accidents pour contribuer à améliorer AlterSend"},+ "relay": {+ "label": "Utiliser un relais en cas d’échec de la connexion directe",+ "description": "Quand deux appareils ne peuvent pas se connecter directement (par exemple tous deux sur un VPN), le transfert passe par le relais d'AlterSend. Les fichiers restent chiffrés de bout en bout.",+ "contact": "Besoin d’un relais dédié ou de limites plus élevées ?",+ "fairUse": "Le relais impose des limites sur la taille des transferts et sur le nombre de transferts simultanés."+ },"rows": {"security": "Sécurité","feedback": "Commentaires",@@ -24,7 +30,8 @@"termsHint": "Règles d'utilisation de AlterSend","website": "Site Web","noDevices": "Aucun appareil pour l’instant",- "pairedCount": "{{count}} associé(s)"+ "pairedCount": "{{count}} associé(s)",+ "connection": "Relais"},"legal": {"terms": "Conditions d'utilisation",diff --git a/packages/locales/src/locales/it-IT/common.json b/packages/locales/src/locales/it-IT/common.jsonindex 16c35b2..46a19a0 100644--- a/packages/locales/src/locales/it-IT/common.json+++ b/packages/locales/src/locales/it-IT/common.json@@ -30,7 +30,8 @@"copyText": "Copia testo","add": "Aggiungi","showMore": "Mostra altro",- "showLess": "Mostra meno"+ "showLess": "Mostra meno",+ "learnMore": "Scopri di più"},"labels": {"settings": "Impostazioni",@@ -76,7 +77,8 @@},"status": {"connected": "Connesso",- "wantsToSend": "vuole inviarti {{label}}{{size}}"+ "wantsToSend": "vuole inviarti {{label}}{{size}}",+ "connectedViaRelay": "Connesso via relay"},"confirm": {"leaveShareSession": "L'abbandono terminerà la sessione di condivisione attiva. Continuare?",diff --git a/packages/locales/src/locales/it-IT/settings.json b/packages/locales/src/locales/it-IT/settings.jsonindex dfee0a0..100f38b 100644--- a/packages/locales/src/locales/it-IT/settings.json+++ b/packages/locales/src/locales/it-IT/settings.json@@ -11,6 +11,12 @@"label": "Rapporti sugli incidenti","description": "Condividi dati anonimi sugli arresti anomali per contribuire a migliorare AlterSend"},+ "relay": {+ "label": "Usa il relay quando la connessione diretta non riesce",+ "description": "Quando due dispositivi non riescono a connettersi direttamente (ad esempio entrambi su una VPN), il trasferimento passa attraverso il relay di AlterSend. I file restano cifrati end-to-end.",+ "contact": "Ti serve un relay dedicato o limiti più alti?",+ "fairUse": "Il relay ha limiti sulla dimensione dei trasferimenti e su quanti possono essere eseguiti contemporaneamente."+ },"rows": {"security": "Sicurezza","feedback": "Segnalazioni",@@ -24,7 +30,8 @@"termsHint": "Regole per l'utilizzo di AlterSend","website": "Sito web","noDevices": "Ancora nessun dispositivo",- "pairedCount": "{{count}} accoppiati"+ "pairedCount": "{{count}} accoppiati",+ "connection": "Relay"},"legal": {"terms": "Condizioni d'uso",diff --git a/packages/locales/src/locales/ja-JP/common.json b/packages/locales/src/locales/ja-JP/common.jsonindex 04f03d0..f2ca307 100644--- a/packages/locales/src/locales/ja-JP/common.json+++ b/packages/locales/src/locales/ja-JP/common.json@@ -30,7 +30,8 @@"copyText": "テキストをコピー","add": "追加","showMore": "もっと見る",- "showLess": "折りたたむ"+ "showLess": "折りたたむ",+ "learnMore": "詳細を見る"},"labels": {"settings": "設定",@@ -76,7 +77,8 @@},"status": {"connected": "接続済み",- "wantsToSend": "が{{label}}{{size}}を送信しようとしています"+ "wantsToSend": "が{{label}}{{size}}を送信しようとしています",+ "connectedViaRelay": "リレー経由で接続"},"confirm": {"leaveShareSession": "退出すると、アクティブな共有セッションが終了します。続く?",diff --git a/packages/locales/src/locales/ja-JP/settings.json b/packages/locales/src/locales/ja-JP/settings.jsonindex a58c479..6fe1997 100644--- a/packages/locales/src/locales/ja-JP/settings.json+++ b/packages/locales/src/locales/ja-JP/settings.json@@ -11,6 +11,12 @@"label": "クラッシュレポート","description": "AlterSend 改善のため匿名のクラッシュデータを共有する"},+ "relay": {+ "label": "直接接続できないときにリレーを使用",+ "description": "2台のデバイスが直接接続できない場合(例:両方がVPN上)、転送はAlterSendのリレーを経由します。ファイルはエンドツーエンドで暗号化されたままです。",+ "contact": "専用リレーや上限の引き上げが必要ですか?",+ "fairUse": "リレーには、転送サイズと同時に実行できる転送数に制限があります。"+ },"rows": {"security": "セキュリティ","feedback": "フィードバック",@@ -24,7 +30,8 @@"termsHint": "AlterSend の利用ルール","website": "Webサイト","noDevices": "デバイスはまだありません",- "pairedCount": "{{count}} 台ペアリング済み"+ "pairedCount": "{{count}} 台ペアリング済み",+ "connection": "リレー"},"legal": {"terms": "利用規約",diff --git a/packages/locales/src/locales/ko-KR/common.json b/packages/locales/src/locales/ko-KR/common.jsonindex a300014..1fb7862 100644--- a/packages/locales/src/locales/ko-KR/common.json+++ b/packages/locales/src/locales/ko-KR/common.json@@ -30,7 +30,8 @@"copyText": "텍스트 복사","add": "추가","showMore": "더 보기",- "showLess": "접기"+ "showLess": "접기",+ "learnMore": "자세히 보기"},"labels": {"settings": "설정",@@ -76,7 +77,8 @@},"status": {"connected": "연결됨",- "wantsToSend": "님이 {{label}}{{size}}을 보내려고 합니다"+ "wantsToSend": "님이 {{label}}{{size}}을 보내려고 합니다",+ "connectedViaRelay": "릴레이를 통해 연결됨"},"confirm": {"leaveShareSession": "나가면 활성 공유 세션이 종료됩니다. 계속하다?",diff --git a/packages/locales/src/locales/ko-KR/settings.json b/packages/locales/src/locales/ko-KR/settings.jsonindex 840fe00..f2f635b 100644--- a/packages/locales/src/locales/ko-KR/settings.json+++ b/packages/locales/src/locales/ko-KR/settings.json@@ -11,6 +11,12 @@"label": "충돌 보고서","description": "AlterSend 개선을 위해 익명 충돌 데이터 공유"},+ "relay": {+ "label": "직접 연결이 실패하면 릴레이 사용",+ "description": "두 기기가 직접 연결할 수 없을 때(예: 둘 다 VPN 사용) 전송이 AlterSend 릴레이를 통해 이루어집니다. 파일은 종단 간 암호화가 유지됩니다.",+ "contact": "전용 릴레이나 더 높은 한도가 필요하신가요?",+ "fairUse": "릴레이에는 전송 크기와 동시에 실행할 수 있는 전송 수에 제한이 있습니다."+ },"rows": {"security": "보안","feedback": "피드백",@@ -24,7 +30,8 @@"termsHint": "AlterSend 사용 규칙","website": "웹사이트","noDevices": "아직 기기가 없습니다",- "pairedCount": "{{count}}개 페어링됨"+ "pairedCount": "{{count}}개 페어링됨",+ "connection": "릴레이"},"legal": {"terms": "이용약관",diff --git a/packages/locales/src/locales/pt-BR/common.json b/packages/locales/src/locales/pt-BR/common.jsonindex 825a13d..ff49b78 100644--- a/packages/locales/src/locales/pt-BR/common.json+++ b/packages/locales/src/locales/pt-BR/common.json@@ -30,7 +30,8 @@"copyText": "Copiar texto","add": "Adicionar","showMore": "Mostrar mais",- "showLess": "Mostrar menos"+ "showLess": "Mostrar menos",+ "learnMore": "Saiba mais"},"labels": {"settings": "Configurações",@@ -76,7 +77,8 @@},"status": {"connected": "Conectado",- "wantsToSend": "quer enviar {{label}}{{size}} para você"+ "wantsToSend": "quer enviar {{label}}{{size}} para você",+ "connectedViaRelay": "Conectado via retransmissor"},"confirm": {"leaveShareSession": "Sair encerrará sua sessão de compartilhamento ativa. Continuar?",diff --git a/packages/locales/src/locales/pt-BR/settings.json b/packages/locales/src/locales/pt-BR/settings.jsonindex d0b1df5..c36ae12 100644--- a/packages/locales/src/locales/pt-BR/settings.json+++ b/packages/locales/src/locales/pt-BR/settings.json@@ -11,6 +11,12 @@"label": "Relatórios de falhas","description": "Compartilhe dados anônimos de falhas para ajudar a melhorar o AlterSend"},+ "relay": {+ "label": "Usar retransmissor quando a conexão direta falhar",+ "description": "Quando dois dispositivos não conseguem se conectar diretamente (por exemplo, ambos em uma VPN), a transferência é roteada pelo retransmissor da AlterSend. Os arquivos permanecem criptografados de ponta a ponta.",+ "contact": "Precisa de um retransmissor dedicado ou limites maiores?",+ "fairUse": "O retransmissor tem limites de tamanho de transferência e de quantas podem ocorrer ao mesmo tempo."+ },"rows": {"security": "Segurança","feedback": "Feedback",@@ -24,7 +30,8 @@"termsHint": "Regras para usar o AlterSend","website": "Site","noDevices": "Ainda não há dispositivos",- "pairedCount": "{{count}} emparelhados"+ "pairedCount": "{{count}} emparelhados",+ "connection": "Retransmissor"},"legal": {"terms": "Termos de Uso",diff --git a/packages/locales/src/locales/zh-CN/common.json b/packages/locales/src/locales/zh-CN/common.jsonindex d88b900..39dca06 100644--- a/packages/locales/src/locales/zh-CN/common.json+++ b/packages/locales/src/locales/zh-CN/common.json@@ -30,7 +30,8 @@"copyText": "复制文本","add": "添加","showMore": "显示更多",- "showLess": "收起"+ "showLess": "收起",+ "learnMore": "了解更多"},"labels": {"settings": "设置",@@ -76,7 +77,8 @@},"status": {"connected": "已连接",- "wantsToSend": "想要发送 {{label}}{{size}} 给你"+ "wantsToSend": "想要发送 {{label}}{{size}} 给你",+ "connectedViaRelay": "已通过中继连接"},"confirm": {"leaveShareSession": "离开将结束您的活跃共享会话。继续?",diff --git a/packages/locales/src/locales/zh-CN/settings.json b/packages/locales/src/locales/zh-CN/settings.jsonindex 83bc5f0..b4bffe4 100644--- a/packages/locales/src/locales/zh-CN/settings.json+++ b/packages/locales/src/locales/zh-CN/settings.json@@ -11,6 +11,12 @@"label": "崩溃报告","description": "共享匿名崩溃数据以帮助改进AlterSend"},+ "relay": {+ "label": "直连失败时使用中继",+ "description": "当两台设备无法直接连接时(例如都在使用 VPN),传输会通过 AlterSend 的中继进行。文件仍保持端到端加密。",+ "contact": "需要专用中继或更高的限额?",+ "fairUse": "中继对传输大小和同时进行的传输数量有限制。"+ },"rows": {"security": "安全","feedback": "反馈",@@ -24,7 +30,8 @@"termsHint": "AlterSend 使用规则","website": "网站","noDevices": "暂无设备",- "pairedCount": "已配对 {{count}} 台"+ "pairedCount": "已配对 {{count}} 台",+ "connection": "中继"},"legal": {"terms": "使用条款",diff --git a/packages/locales/src/locales/zh-TW/common.json b/packages/locales/src/locales/zh-TW/common.jsonindex 8f282d7..759c31f 100644--- a/packages/locales/src/locales/zh-TW/common.json+++ b/packages/locales/src/locales/zh-TW/common.json@@ -30,7 +30,8 @@"copyText": "複製文字","add": "新增","showMore": "顯示更多",- "showLess": "收起"+ "showLess": "收起",+ "learnMore": "瞭解更多"},"labels": {"settings": "設定",@@ -76,7 +77,8 @@},"status": {"connected": "已連線",- "wantsToSend": "想要傳送 {{label}}{{size}} 給你"+ "wantsToSend": "想要傳送 {{label}}{{size}} 給你",+ "connectedViaRelay": "已透過中繼連線"},"confirm": {"leaveShareSession": "離開將結束您的活躍共享會話。繼續?",diff --git a/packages/locales/src/locales/zh-TW/settings.json b/packages/locales/src/locales/zh-TW/settings.jsonindex e60338d..5b0abaf 100644--- a/packages/locales/src/locales/zh-TW/settings.json+++ b/packages/locales/src/locales/zh-TW/settings.json@@ -11,6 +11,12 @@"label": "崩潰報告","description": "共享匿名崩潰資料以幫助改進AlterSend"},+ "relay": {+ "label": "直連失敗時使用中繼",+ "description": "當兩台裝置無法直接連線時(例如都在使用 VPN),傳輸會透過 AlterSend 的中繼進行。檔案仍維持端對端加密。",+ "contact": "需要專用中繼或更高的額度?",+ "fairUse": "中繼對傳輸大小和同時進行的傳輸數量有限制。"+ },"rows": {"security": "安全","feedback": "意見回饋",@@ -24,7 +30,8 @@"termsHint": "AlterSend 使用規則","website": "網站","noDevices": "尚無裝置",- "pairedCount": "已配對 {{count}} 台"+ "pairedCount": "已配對 {{count}} 台",+ "connection": "中繼"},"legal": {"terms": "使用條款",diff --git a/packages/locales/src/resources.test.ts b/packages/locales/src/resources.test.tsindex 69e50d0..eb049c1 100644--- a/packages/locales/src/resources.test.ts+++ b/packages/locales/src/resources.test.ts@@ -41,7 +41,8 @@ const identicalValueAllowList = new Set(['GitHub','GitHub Issues','QR',- 'OK'+ 'OK',+ 'Relay'])const identicalKeyAllowList = new Set([