Skip to content

A full-featured download manager.

4.9 KB
Raw Blame
export enum ErrorCode {
  AppUpdateManaged = 'APP_UPDATE_MANAGED',
  AppUpdateCheckFailed = 'APP_UPDATE_CHECK_FAILED',
  EngineStartFailed = 'ENGINE_START_FAILED',
  EngineConnectionLost = 'ENGINE_CONNECTION_LOST',
  EngineTimeout = 'ENGINE_TIMEOUT',
  EngineProcessOwnershipUnverified = 'ENGINE_PROCESS_OWNERSHIP_UNVERIFIED',
  EngineProcessTerminationFailed = 'ENGINE_PROCESS_TERMINATION_FAILED',
  TaskCreateFailed = 'TASK_CREATE_FAILED',
  TaskSourceInvalid = 'TASK_SOURCE_INVALID',
  TaskNotFound = 'TASK_NOT_FOUND',
  TaskRevealFailed = 'TASK_REVEAL_FAILED',
  TaskOpenFailed = 'TASK_OPEN_FAILED',
  TaskOpenAppFailed = 'TASK_OPEN_APP_FAILED',
  TaskNotRetryable = 'TASK_NOT_RETRYABLE',
  TaskPathTooLong = 'TASK_PATH_TOO_LONG',
  SessionRestoreFailed = 'SESSION_RESTORE_FAILED',
  SettingsInvalid = 'SETTINGS_INVALID',
  PluginNetworkFailed = 'PLUGIN_NETWORK_FAILED',
  PluginTimeout = 'PLUGIN_TIMEOUT',
  PluginExecutionFailed = 'PLUGIN_EXECUTION_FAILED',
  PluginLoadFailed = 'PLUGIN_LOAD_FAILED',
  // Phase 1A plugin runtime
  PluginManifestInvalid = 'PLUGIN_MANIFEST_INVALID',
  PluginEngineVersionTooOld = 'PLUGIN_ENGINE_VERSION_TOO_OLD',
  PluginPermissionUnsupported = 'PLUGIN_PERMISSION_UNSUPPORTED',
  PluginActivationTimeout = 'PLUGIN_ACTIVATION_TIMEOUT',
  PluginActivationCapExceeded = 'PLUGIN_ACTIVATION_CAP_EXCEEDED',
  PluginCapabilityUnavailable = 'PLUGIN_CAPABILITY_UNAVAILABLE',
  PluginCircuitOpen = 'PLUGIN_CIRCUIT_OPEN',
  PluginRuntimeFault = 'PLUGIN_RUNTIME_FAULT',
  PluginDirNotConfigured = 'PLUGIN_DIR_NOT_CONFIGURED',
  PluginSecurityBlocked = 'PLUGIN_SECURITY_BLOCKED',
  PluginSecurityPending = 'PLUGIN_SECURITY_PENDING',
  // NAT Manager
  NatDiscoveryFailed = 'NAT_DISCOVERY_FAILED',
  NatMappingFailed = 'NAT_MAPPING_FAILED',
  NatMappingConflict = 'NAT_MAPPING_CONFLICT',
  NatProtocolRejected = 'NAT_PROTOCOL_REJECTED',
  NatParseError = 'NAT_PARSE_ERROR',
  NatSecurityViolation = 'NAT_SECURITY_VIOLATION',
  NatTimeout = 'NAT_TIMEOUT',
  NatNetworkChanged = 'NAT_NETWORK_CHANGED',
  NatGatewayUnreachable = 'NAT_GATEWAY_UNREACHABLE',
  StunDetectionFailed = 'STUN_DETECTION_FAILED',
  // Torrent
  TorrentParseFailed = 'TORRENT_PARSE_FAILED',
  TorrentCreateFailed = 'TORRENT_CREATE_FAILED',
  TorrentDuplicateConflict = 'TORRENT_DUPLICATE_CONFLICT',
  MagnetResolveFailed = 'MAGNET_RESOLVE_FAILED',
  MagnetResolveTimeout = 'MAGNET_RESOLVE_TIMEOUT',
  /** Plan B: aria2 cleanup of the magnet metadata fetch is still
   *  pending (RPC transient failure → MagnetTracker.cancel returned
   *  'quarantined'). Operations that would create a sibling aria2 GID
   *  (e.g. swapping the metadata instance for a bt_download instance
   *  after user file selection) must abort and surface a retryable
   *  error so the user can re-confirm after aria2 recovers. */
  MagnetCleanupPending = 'MAGNET_CLEANUP_PENDING',
  // IPC security
  IpcInvalidPayload = 'IPC_INVALID_PAYLOAD',
  IpcRateLimited = 'IPC_RATE_LIMITED',
  InvalidSelection = 'INVALID_SELECTION',
  // Tracker
  TrackerSyncFailed = 'TRACKER_SYNC_FAILED',
  TrackerProbeFailed = 'TRACKER_PROBE_FAILED',
  TrackerRefreshFailed = 'TRACKER_REFRESH_FAILED',
  EngineNotSupported = 'ENGINE_NOT_SUPPORTED',
  EngineFeatureUnavailable = 'ENGINE_FEATURE_UNAVAILABLE',
  EngineProtocolError = 'ENGINE_PROTOCOL_ERROR',
  // Incomplete-suffix feature
  TaskCreateDedupExhausted = 'TASK_CREATE_DEDUP_EXHAUSTED',
  TaskCreateTorrentMetaFailed = 'TASK_CREATE_TORRENT_META_FAILED',
  TaskFinalizeFailed = 'TASK_FINALIZE_FAILED',
  TaskFinalizeRenameFailed = 'TASK_FINALIZE_RENAME_FAILED',
  TaskFinalizeReseedFailed = 'TASK_FINALIZE_RESEED_FAILED',
  TaskFinalizeMetaMissing = 'TASK_FINALIZE_META_MISSING',
  TaskRemoveCleanupPartial = 'TASK_REMOVE_CLEANUP_PARTIAL',
  TaskRemoveNotAvailableDuringFinalize = 'TASK_REMOVE_NOT_AVAILABLE_DURING_FINALIZE',
  TaskRecoveryFsMismatch = 'TASK_RECOVERY_FS_MISMATCH',
  TaskRecoveryAria2Mismatch = 'TASK_RECOVERY_ARIA2_MISMATCH',
  // GeoIP
  GeoIPDownloadFailed = 'GEOIP_DOWNLOAD_FAILED',
  GeoIPSourceUnsupported = 'GEOIP_SOURCE_UNSUPPORTED',
  GeoIPDatabaseInvalid = 'GEOIP_DATABASE_INVALID',
  FfmpegInstallBusy = 'FFMPEG_INSTALL_BUSY',
  FfmpegInstallFailed = 'FFMPEG_INSTALL_FAILED',
  FfmpegReleaseUnavailable = 'FFMPEG_RELEASE_UNAVAILABLE',
}

export enum DownloadErrorCode {
  Unknown = 'DL_UNKNOWN',
  NotFound = 'DL_NOT_FOUND',
  Unauthorized = 'DL_UNAUTHORIZED',
  NetworkError = 'DL_NETWORK_ERROR',
  Timeout = 'DL_TIMEOUT',
  DiskFull = 'DL_DISK_FULL',
  FileWriteError = 'DL_FILE_WRITE_ERROR',
  PathTooLong = 'DL_PATH_TOO_LONG',
  ChecksumMismatch = 'DL_CHECKSUM_MISMATCH',
  TooManyRedirects = 'DL_TOO_MANY_REDIRECTS',
  ServerError = 'DL_SERVER_ERROR',
  BtMetadataFailed = 'DL_BT_METADATA_FAILED',
  BtTrackerError = 'DL_BT_TRACKER_ERROR',
}

export class AppError extends Error {
  constructor(
    public readonly code: ErrorCode,
    message: string,
    public readonly cause?: unknown
  ) {
    super(message)
    this.name = 'AppError'
  }
}