diff --git a/apps/android/src/lib/errors.ts b/apps/android/src/lib/errors.ts new file mode 100644 index 0000000..a738748 --- /dev/null +++ b/apps/android/src/lib/errors.ts @@ -0,0 +1,77 @@ +import { strings as zhCN } from '../locales/i18n' +import { AccountRequiredError } from '../services/server-session-manager' + +export class RemoteApiError extends Error { + constructor( + public readonly code: string, + message: string, + public readonly status?: number, + public readonly retryable = false, + ) { + super(message) + this.name = 'RemoteApiError' + } +} + +/** Server / credential failures that require the user to sign in again. */ +const SESSION_AUTH_CODES = new Set([ + 'ACCOUNT_AUTH_REQUIRED', + 'AUTH_INVALID', + 'AUTH_REQUIRED', + 'TOKEN_EXPIRED', + 'TOKEN_REUSED', + 'DEVICE_REVOKED', + 'DEVICE_OWNERSHIP_REQUIRED', +]) + +export function isSessionAuthError(error: unknown): boolean { + if (error instanceof AccountRequiredError) return true + if (error instanceof RemoteApiError) return SESSION_AUTH_CODES.has(error.code) + if (error instanceof Error) { + const code = (error as Error & { code?: unknown }).code + return typeof code === 'string' && SESSION_AUTH_CODES.has(code) + } + return false +} + +export function friendlyError(error: unknown): string { + const friendlyByCode: Record = zhCN.errors + if (isSessionWriterHeldError(error)) return friendlyByCode['session/writer-held']! + if (error instanceof AccountRequiredError) return friendlyByCode.AUTH_REQUIRED ?? error.message + if (error instanceof RemoteApiError) return friendlyByCode[error.code] ?? error.message + if (error instanceof Error) { + const code = (error as Error & { code?: unknown }).code + if (typeof code === 'string' && friendlyByCode[code] !== undefined) return friendlyByCode[code]! + if (/network request failed|failed to fetch|websocket/i.test(error.message)) { + return zhCN.errors.serverUnreachable + } + if (isRpcTimeoutError(error)) return friendlyByCode.RPC_TIMEOUT! + return error.message + } + return zhCN.errors.unknown +} + +/** Newer Harness exposes a code; older carriers retain only the native message. */ +function isSessionWriterHeldError(error: unknown): boolean { + if (!(error instanceof Error)) return false + const code = (error as Error & { code?: unknown }).code + return code === 'session/writer-held' + || error.name === 'SessionAlreadyOwnedError' + || /^session "[^"\r\n]+" is already owned by an active write handle$/.test(error.message) +} + +export function isRpcTimeoutError(error: unknown): boolean { + return error instanceof Error && /timed?\s*out|timeout/i.test(error.message) +} + +/** The bounded session-follow open/snapshot timeout (client-core STREAM_TIMEOUT). */ +export function isStreamTimeoutError(error: unknown): boolean { + return error instanceof Error && (error as Error & { code?: unknown }).code === 'STREAM_TIMEOUT' +} + +/** A request can race with the transport closing while Android resumes. */ +export function isRecoverableTransportError(error: unknown): boolean { + if (!(error instanceof Error)) return false + const code = (error as Error & { code?: unknown }).code + return code === 'TRANSPORT_CLOSED' || code === 'CLIENT_CLOSED' +}