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
import { TRANSFER_ERROR_CODES, type TransferErrorCode } from './types'
import type { Translate } from '../i18n'
const TRANSFER_ERROR_CODE_SET = new Set<string>(Object.values(TRANSFER_ERROR_CODES))
export function getTransferDebugMessage(error: unknown): string {
return error instanceof Error ? error.message : String(error)
}
export function isTransferErrorCode(value: unknown): value is TransferErrorCode {
return typeof value === 'string' && TRANSFER_ERROR_CODE_SET.has(value)
}
export function getTransferErrorCode(
error: unknown,
fallback: TransferErrorCode = TRANSFER_ERROR_CODES.transferFailed
): TransferErrorCode {
if (
error &&
typeof error === 'object' &&
'code' in error &&
isTransferErrorCode((error as { code?: unknown }).code)
) {
return (error as { code: TransferErrorCode }).code
}
if (
error &&
typeof error === 'object' &&
'transferErrorCode' in error &&
isTransferErrorCode((error as { transferErrorCode?: unknown }).transferErrorCode)
) {
return (error as { transferErrorCode: TransferErrorCode }).transferErrorCode
}
return fallback
}
export function getRelayBusyError(t: Translate, isPro: boolean): string {
return t(isPro ? 'errors:transfer.relayBusy' : 'errors:transfer.relayBusyFree')
}
export function getDisplayError(
t: Translate,
code: TransferErrorCode | null,
options: { invalidTopicKey?: string } = {}
) {
if (!code) return null
switch (code) {
case TRANSFER_ERROR_CODES.invalidTopic:
return t(options.invalidTopicKey ?? 'receive:errors.invalidCode')
case TRANSFER_ERROR_CODES.joinFailed:
return t('errors:transfer.joinFailed')
case TRANSFER_ERROR_CODES.peerUnreachable:
return t('errors:transfer.peerUnreachable')
case TRANSFER_ERROR_CODES.relayBusy:
return t('errors:transfer.relayBusy')
case TRANSFER_ERROR_CODES.downloadFailed:
return t('errors:transfer.downloadFailed')
case TRANSFER_ERROR_CODES.transferFailed:
return t('errors:transfer.transferFailed')
default: {
const exhaustiveCheck: never = code
return exhaustiveCheck
}
}
}