FIRAuthErrorUtils.m 45 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031
  1. /*
  2. * Copyright 2017 Google
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License");
  5. * you may not use this file except in compliance with the License.
  6. * You may obtain a copy of the License at
  7. *
  8. * http://www.apache.org/licenses/LICENSE-2.0
  9. *
  10. * Unless required by applicable law or agreed to in writing, software
  11. * distributed under the License is distributed on an "AS IS" BASIS,
  12. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. * See the License for the specific language governing permissions and
  14. * limitations under the License.
  15. */
  16. #import "FIRAuthErrorUtils.h"
  17. #import "FIRAuthCredential.h"
  18. #import "FIRAuthInternalErrors.h"
  19. NS_ASSUME_NONNULL_BEGIN
  20. NSString *const FIRAuthErrorDomain = @"FIRAuthErrorDomain";
  21. NSString *const FIRAuthInternalErrorDomain = @"FIRAuthInternalErrorDomain";
  22. NSString *const FIRAuthErrorUserInfoDeserializedResponseKey =
  23. @"FIRAuthErrorUserInfoDeserializedResponseKey";
  24. NSString *const FIRAuthErrorUserInfoDataKey = @"FIRAuthErrorUserInfoDataKey";
  25. NSString *const FIRAuthErrorUserInfoEmailKey = @"FIRAuthErrorUserInfoEmailKey";
  26. NSString *const FIRAuthErrorNameKey = @"error_name";
  27. NSString *const FIRAuthUpdatedCredentialKey = @"FIRAuthUpdatedCredentialKey";
  28. /** @var kServerErrorDetailMarker
  29. @brief This marker indicates that the server error message contains a detail error message which
  30. should be used instead of the hardcoded client error message.
  31. */
  32. static NSString *const kServerErrorDetailMarker = @" : ";
  33. #pragma mark - URL response error codes
  34. /** @var kURLResponseErrorCodeInvalidClientID
  35. @brief Error code that indicates that the client ID provided was invalid.
  36. */
  37. static NSString *const kURLResponseErrorCodeInvalidClientID = @"auth/invalid-oauth-client-id";
  38. /** @var kURLResponseErrorCodeNetworkRequestFailed
  39. @brief Error code that indicates that a network request within the SFSafariViewController or
  40. UIWebView failed.
  41. */
  42. static NSString *const kURLResponseErrorCodeNetworkRequestFailed = @"auth/network-request-failed";
  43. /** @var kURLResponseErrorCodeInternalError
  44. @brief Error code that indicates that an internal error occurred within the
  45. SFSafariViewController or UIWebView failed.
  46. */
  47. static NSString *const kURLResponseErrorCodeInternalError = @"auth/internal-error";
  48. #pragma mark - Standard Error Messages
  49. /** @var kFIRAuthErrorMessageInvalidCustomToken
  50. @brief Message for @c FIRAuthErrorCodeInvalidCustomToken error code.
  51. */
  52. static NSString *const kFIRAuthErrorMessageInvalidCustomToken = @"The custom token format is "
  53. "incorrect. Please check the documentation.";
  54. /** @var kFIRAuthErrorMessageCustomTokenMismatch
  55. @brief Message for @c FIRAuthErrorCodeCustomTokenMismatch error code.
  56. */
  57. static NSString *const kFIRAuthErrorMessageCustomTokenMismatch = @"The custom token corresponds to "
  58. "a different audience.";
  59. /** @var kFIRAuthErrorMessageInvalidEmail
  60. @brief Message for @c FIRAuthErrorCodeInvalidEmail error code.
  61. */
  62. static NSString *const kFIRAuthErrorMessageInvalidEmail = @"The email address is badly formatted.";
  63. /** @var kFIRAuthErrorMessageInvalidCredential
  64. @brief Message for @c FIRAuthErrorCodeInvalidCredential error code.
  65. */
  66. static NSString *const kFIRAuthErrorMessageInvalidCredential = @"The supplied auth credential is "
  67. "malformed or has expired.";
  68. /** @var kFIRAuthErrorMessageUserDisabled
  69. @brief Message for @c FIRAuthErrorCodeUserDisabled error code.
  70. */
  71. static NSString *const kFIRAuthErrorMessageUserDisabled = @"The user account has been disabled by "
  72. "an administrator.";
  73. /** @var kFIRAuthErrorMessageEmailAlreadyInUse
  74. @brief Message for @c FIRAuthErrorCodeEmailAlreadyInUse error code.
  75. */
  76. static NSString *const kFIRAuthErrorMessageEmailAlreadyInUse = @"The email address is already in "
  77. "use by another account.";
  78. /** @var kFIRAuthErrorMessageWrongPassword
  79. @brief Message for @c FIRAuthErrorCodeWrongPassword error code.
  80. */
  81. static NSString *const kFIRAuthErrorMessageWrongPassword = @"The password is invalid or the user "
  82. "does not have a password.";
  83. /** @var kFIRAuthErrorMessageTooManyRequests
  84. @brief Message for @c FIRAuthErrorCodeTooManyRequests error code.
  85. */
  86. static NSString *const kFIRAuthErrorMessageTooManyRequests = @"We have blocked all requests from "
  87. "this device due to unusual activity. Try again later.";
  88. /** @var kFIRAuthErrorMessageAccountExistsWithDifferentCredential
  89. @brief Message for @c FIRAuthErrorCodeAccountExistsWithDifferentCredential error code.
  90. */
  91. static NSString *const kFIRAuthErrorMessageAccountExistsWithDifferentCredential = @"An account "
  92. "already exists with the same email address but different sign-in credentials. Sign in using a "
  93. "provider associated with this email address.";
  94. /** @var kFIRAuthErrorMessageRequiresRecentLogin
  95. @brief Message for @c FIRAuthErrorCodeRequiresRecentLogin error code.
  96. */
  97. static NSString *const kFIRAuthErrorMessageRequiresRecentLogin= @"This operation is sensitive and "
  98. "requires recent authentication. Log in again before retrying this request.";
  99. /** @var kFIRAuthErrorMessageProviderAlreadyLinked
  100. @brief Message for @c FIRAuthErrorCodeProviderAlreadyExists error code.
  101. */
  102. static NSString *const kFIRAuthErrorMessageProviderAlreadyLinked =
  103. @"[ERROR_PROVIDER_ALREADY_LINKED] - User can only be linked to one identity for the given "
  104. "provider.";
  105. /** @var kFIRAuthErrorMessageNoSuchProvider
  106. @brief Message for @c FIRAuthErrorCodeNoSuchProvider error code.
  107. */
  108. static NSString *const kFIRAuthErrorMessageNoSuchProvider = @"User was not linked to an account "
  109. "with the given provider.";
  110. /** @var kFIRAuthErrorMessageInvalidUserToken
  111. @brief Message for @c FIRAuthErrorCodeInvalidUserToken error code.
  112. */
  113. static NSString *const kFIRAuthErrorMessageInvalidUserToken = @"This user's credential isn't valid "
  114. "for this project. This can happen if the user's token has been tampered with, or if the user "
  115. "doesn’t belong to the project associated with the API key used in your request.";
  116. /** @var kFIRAuthErrorMessageNetworkError
  117. @brief Message for @c FIRAuthErrorCodeNetworkError error code.
  118. */
  119. static NSString *const kFIRAuthErrorMessageNetworkError = @"Network error (such as timeout, "
  120. "interrupted connection or unreachable host) has occurred.";
  121. /** @var kFIRAuthErrorMessageKeychainError
  122. @brief Message for @c FIRAuthErrorCodeKeychainError error code.
  123. */
  124. static NSString *const kFIRAuthErrorMessageKeychainError = @"An error occurred when accessing the "
  125. "keychain. The @c NSLocalizedFailureReasonErrorKey field in the @c NSError.userInfo dictionary "
  126. "will contain more information about the error encountered";
  127. /** @var kFIRAuthErrorMessageUserTokenExpired
  128. @brief Message for @c FIRAuthErrorCodeTokenExpired error code.
  129. */
  130. static NSString *const kFIRAuthErrorMessageUserTokenExpired = @"The user's credential is no longer "
  131. "valid. The user must sign in again.";
  132. /** @var kFIRAuthErrorMessageUserNotFound
  133. @brief Message for @c FIRAuthErrorCodeUserNotFound error code.
  134. */
  135. static NSString *const kFIRAuthErrorMessageUserNotFound = @"There is no user record corresponding "
  136. "to this identifier. The user may have been deleted.";
  137. /** @var kFIRAuthErrorMessageInvalidAPIKey
  138. @brief Message for @c FIRAuthErrorCodeInvalidAPIKey error code.
  139. @remarks This error is not thrown by the server.
  140. */
  141. static NSString *const kFIRAuthErrorMessageInvalidAPIKey = @"An invalid API Key was supplied in "
  142. "the request.";
  143. /** @var kFIRAuthErrorMessageUserMismatch.
  144. @brief Message for @c FIRAuthErrorCodeInvalidAPIKey error code.
  145. */
  146. static NSString *const FIRAuthErrorMessageUserMismatch = @"The supplied credentials do not "
  147. "correspond to the previously signed in user.";
  148. /** @var kFIRAuthErrorMessageCredentialAlreadyInUse
  149. @brief Message for @c FIRAuthErrorCodeCredentialAlreadyInUse error code.
  150. */
  151. static NSString *const kFIRAuthErrorMessageCredentialAlreadyInUse = @"This credential is already "
  152. "associated with a different user account.";
  153. /** @var kFIRAuthErrorMessageOperationNotAllowed
  154. @brief Message for @c FIRAuthErrorCodeOperationNotAllowed error code.
  155. */
  156. static NSString *const kFIRAuthErrorMessageOperationNotAllowed = @"The given sign-in provider is "
  157. "disabled for this Firebase project. Enable it in the Firebase console, under the sign-in "
  158. "method tab of the Auth section.";
  159. /** @var kFIRAuthErrorMessageWeakPassword
  160. @brief Message for @c FIRAuthErrorCodeWeakPassword error code.
  161. */
  162. static NSString *const kFIRAuthErrorMessageWeakPassword = @"The password must be 6 characters long "
  163. "or more.";
  164. /** @var kFIRAuthErrorMessageAppNotAuthorized
  165. @brief Message for @c FIRAuthErrorCodeAppNotAuthorized error code.
  166. */
  167. static NSString *const kFIRAuthErrorMessageAppNotAuthorized = @"This app is not authorized to use "
  168. "Firebase Authentication with the provided API key. Review your key configuration in the "
  169. "Google API console and ensure that it accepts requests from your app's bundle ID.";
  170. /** @var kFIRAuthErrorMessageExpiredActionCode
  171. @brief Message for @c FIRAuthErrorCodeExpiredActionCode error code.
  172. */
  173. static NSString *const kFIRAuthErrorMessageExpiredActionCode = @"The action code has expired.";
  174. /** @var kFIRAuthErrorMessageInvalidActionCode
  175. @brief Message for @c FIRAuthErrorCodeInvalidActionCode error code.
  176. */
  177. static NSString *const kFIRAuthErrorMessageInvalidActionCode = @"The action code is invalid. This "
  178. "can happen if the code is malformed, expired, or has already been used.";
  179. /** @var kFIRAuthErrorMessageInvalidMessagePayload
  180. @brief Message for @c FIRAuthErrorCodeInvalidMessagePayload error code.
  181. */
  182. static NSString *const kFIRAuthErrorMessageInvalidMessagePayload = @"The action code is invalid. "
  183. "This can happen if the code is malformed, expired, or has already been used.";
  184. /** @var kFIRAuthErrorMessageInvalidSender
  185. @brief Message for @c FIRAuthErrorCodeInvalidSender error code.
  186. */
  187. static NSString *const kFIRAuthErrorMessageInvalidSender = @"The email template corresponding to "
  188. "this action contains invalid characters in its message. Please fix by going to the Auth email "
  189. "templates section in the Firebase Console.";
  190. /** @var kFIRAuthErrorMessageInvalidRecipientEmail
  191. @brief Message for @c FIRAuthErrorCodeInvalidRecipient error code.
  192. */
  193. static NSString *const kFIRAuthErrorMessageInvalidRecipientEmail = @"The action code is invalid. "
  194. "This can happen if the code is malformed, expired, or has already been used.";
  195. /** @var kFIRAuthErrorMessageMissingIosBundleID
  196. @brief Message for @c FIRAuthErrorCodeMissingIosbundleID error code.
  197. */
  198. static NSString *const kFIRAuthErrorMessageMissingIosBundleID =
  199. @"An iOS Bundle ID must be provided if an App Store ID is provided.";
  200. /** @var kFIRAuthErrorMessageMissingAndroidPackageName
  201. @brief Message for @c FIRAuthErrorCodeMissingAndroidPackageName error code.
  202. */
  203. static NSString *const kFIRAuthErrorMessageMissingAndroidPackageName =
  204. @"An Android Package Name must be provided if the Android App is required to be installed.";
  205. /** @var kFIRAuthErrorMessageUnauthorizedDomain
  206. @brief Message for @c FIRAuthErrorCodeUnauthorizedDomain error code.
  207. */
  208. static NSString *const kFIRAuthErrorMessageUnauthorizedDomain = @"The domain of the continue URL "
  209. "is not whitelisted. Please whitelist the domain in the Firebase console.";
  210. /** @var kFIRAuthErrorMessageInvalidContinueURI
  211. @brief Message for @c FIRAuthErrorCodeInvalidContinueURI error code.
  212. */
  213. static NSString *const kFIRAuthErrorMessageInvalidContinueURI =
  214. @"The continue URL provided in the request is invalid.";
  215. /** @var kFIRAuthErrorMessageMissingEmail
  216. @brief Message for @c FIRAuthErrorCodeMissingEmail error code.
  217. */
  218. static NSString *const kFIRAuthErrorMessageMissingEmail = @"An email address must be provided.";
  219. /** @var kFIRAuthErrorMessageMissingContinueURI
  220. @brief Message for @c FIRAuthErrorCodeMissingContinueURI error code.
  221. */
  222. static NSString *const kFIRAuthErrorMessageMissingContinueURI =
  223. @"A continue URL must be provided in the request.";
  224. /** @var kFIRAuthErrorMessageMissingPhoneNumber
  225. @brief Message for @c FIRAuthErrorCodeMissingPhoneNumber error code.
  226. */
  227. static NSString *const kFIRAuthErrorMessageMissingPhoneNumber =
  228. @"To send verification codes, provide a phone number for the recipient.";
  229. /** @var kFIRAuthErrorMessageInvalidPhoneNumber
  230. @brief Message for @c FIRAuthErrorCodeInvalidPhoneNumber error code.
  231. */
  232. static NSString *const kFIRAuthErrorMessageInvalidPhoneNumber =
  233. @"The format of the phone number provided is incorrect. Please enter the phone number in a "
  234. "format that can be parsed into E.164 format. E.164 phone numbers are written in the format "
  235. "[+][country code][subscriber number including area code].";
  236. /** @var kFIRAuthErrorMessageMissingVerificationCode
  237. @brief Message for @c FIRAuthErrorCodeMissingVerificationCode error code.
  238. */
  239. static NSString *const kFIRAuthErrorMessageMissingVerificationCode =
  240. @"The phone auth credential was created with an empty SMS verification Code.";
  241. /** @var kFIRAuthErrorMessageInvalidVerificationCode
  242. @brief Message for @c FIRAuthErrorCodeInvalidVerificationCode error code.
  243. */
  244. static NSString *const kFIRAuthErrorMessageInvalidVerificationCode =
  245. @"The SMS verification code used to create the phone auth credential is invalid. Please resend "
  246. "the verification code SMS and be sure to use the verification code provided by the user.";
  247. /** @var kFIRAuthErrorMessageMissingVerificationID
  248. @brief Message for @c FIRAuthErrorCodeInvalidVerificationID error code.
  249. */
  250. static NSString *const kFIRAuthErrorMessageMissingVerificationID =
  251. @"The phone auth credential was created with an empty verification ID.";
  252. /** @var kFIRAuthErrorMessageInvalidVerificationID
  253. @brief Message for @c FIRAuthErrorCodeInvalidVerificationID error code.
  254. */
  255. static NSString *const kFIRAuthErrorMessageInvalidVerificationID =
  256. @"The verification ID used to create the phone auth credential is invalid.";
  257. /** @var kFIRAuthErrorMessageSessionExpired
  258. @brief Message for @c FIRAuthErrorCodeSessionExpired error code.
  259. */
  260. static NSString *const kFIRAuthErrorMessageSessionExpired = @"The SMS code has expired. Please "
  261. @"re-send the verification code to try again.";
  262. /** @var kFIRAuthErrorMessageMissingAppCredential
  263. @brief Message for @c FIRAuthErrorCodeMissingAppCredential error code.
  264. */
  265. static NSString *const kFIRAuthErrorMessageMissingAppCredential = @"The phone verification request "
  266. "is missing an APNs Device token. Firebase Auth automatically detects APNs Device Tokens, "
  267. "however, if method swizzling is disabled, the APNs token must be set via the APNSToken "
  268. "property on FIRAuth or by calling setAPNSToken:type on FIRAuth.";
  269. /** @var kFIRAuthErrorMessageInvalidAppCredential
  270. @brief Message for @c FIRAuthErrorCodeInvalidAppCredential error code.
  271. */
  272. static NSString *const kFIRAuthErrorMessageInvalidAppCredential = @"The APNs device token provided "
  273. "is either incorrect or does not match the private certificate uploaded to the Firebase "
  274. "Console.";
  275. /** @var kFIRAuthErrorMessageQuotaExceeded
  276. @brief Message for @c FIRAuthErrorCodeQuotaExceeded error code.
  277. */
  278. static NSString *const kFIRAuthErrorMessageQuotaExceeded = @"The phone verification quota for this "
  279. "project has been exceeded.";
  280. /** @var kFIRAuthErrorMessageMissingAppToken
  281. @brief Message for @c FIRAuthErrorCodeMissingAppToken error code.
  282. */
  283. static NSString *const kFIRAuthErrorMessageMissingAppToken = @"There seems to be a problem with "
  284. "your project's Firebase phone number authentication set-up, please make sure to follow the "
  285. "instructions found at https://firebase.google.com/docs/auth/ios/phone-auth";
  286. /** @var kFIRAuthErrorMessageMissingAppToken
  287. @brief Message for @c FIRAuthErrorCodeMissingAppToken error code.
  288. */
  289. static NSString *const kFIRAuthErrorMessageNotificationNotForwarded = @"If app delegate swizzling "
  290. "is disabled, remote notifications received by UIApplicationDelegate need to be forwarded to "
  291. "FIRAuth's canHandleNotificaton: method.";
  292. /** @var kFIRAuthErrorMessageAppNotVerified
  293. @brief Message for @c FIRAuthErrorCodeMissingAppToken error code.
  294. */
  295. static NSString *const kFIRAuthErrorMessageAppNotVerified = @"Firebase could not retrieve the "
  296. "silent push notification and therefore could not verify your app. Ensure that you configured "
  297. "your app correctly to receive push notifications.";
  298. /** @var kFIRAuthErrorMessageCaptchaCheckFailed
  299. @brief Message for @c FIRAuthErrorCodeCaptchaCheckFailed error code.
  300. */
  301. static NSString *const kFIRAuthErrorMessageCaptchaCheckFailed = @"The reCAPTCHA response token "
  302. "provided is either invalid, expired or already";
  303. /** @var kFIRAuthErrorMessageWebContextAlreadyPresented
  304. @brief Message for @c FIRAuthErrorCodeWebContextAlreadyPresented error code.
  305. */
  306. static NSString *const kFIRAuthErrorMessageWebContextAlreadyPresented = @"User interaction is "
  307. "still ongoing, another view cannot be presented.";
  308. /** @var kFIRAuthErrorMessageWebContextCancelled
  309. @brief Message for @c FIRAuthErrorCodeWebContextCancelled error code.
  310. */
  311. static NSString *const kFIRAuthErrorMessageWebContextCancelled = @"The interaction was cancelled "
  312. "by the user.";
  313. /** @var kFIRAuthErrorMessageInvalidClientID
  314. @brief Message for @c FIRAuthErrorCodeInvalidClientID error code.
  315. */
  316. static NSString *const kFIRAuthErrorMessageInvalidClientID = @"The OAuth client ID provided is "
  317. "either invalid or does not match the specified API key.";
  318. /** @var kFIRAuthErrorMessageWebRequestFailed
  319. @brief Message for @c FIRAuthErrorCodeWebRequestFailed error code.
  320. */
  321. static NSString *const kFIRAuthErrorMessageWebRequestFailed = @"A network error (such as timeout, "
  322. "interrupted connection, or unreachable host) has occurred within the web context.";
  323. /** @var kFIRAuthErrorMessageWebInternalError
  324. @brief Message for @c FIRAuthErrorCodeWebInternalError error code.
  325. */
  326. static NSString *const kFIRAuthErrorMessageWebInternalError = @"An internal error has occurred "
  327. "within the SFSafariViewController or UIWebView.";
  328. /** @var kFIRAuthErrorMessageAppVerificationUserInteractionFailure
  329. @brief Message for @c FIRAuthErrorCodeInvalidClientID error code.
  330. */
  331. static NSString *const kFIRAuthErrorMessageAppVerificationUserInteractionFailure = @"The app "
  332. "verification process has failed, print and inspect the error details for more information";
  333. /** @var kFIRAuthErrorMessageNullUser
  334. @brief Message for @c FIRAuthErrorCodeNullUser error code.
  335. */
  336. static NSString *const kFIRAuthErrorMessageNullUser = @"A null user object was provided as the "
  337. "argument for an operation which requires a non-null user object.";
  338. /** @var kFIRAuthErrorMessageInternalError
  339. @brief Message for @c FIRAuthErrorCodeInternalError error code.
  340. */
  341. static NSString *const kFIRAuthErrorMessageInternalError = @"An internal error has occurred, "
  342. "print and inspect the error details for more information.";
  343. /** @var kFIRAuthErrorMessageMalformedJWT
  344. @brief Error message constant describing @c FIRAuthErrorCodeMalformedJWT errors.
  345. */
  346. static NSString *const kFIRAuthErrorMessageMalformedJWT =
  347. @"Failed to parse JWT. Check the userInfo dictionary for the full token.";
  348. /** @var FIRAuthErrorDescription
  349. @brief The error descrioption, based on the error code.
  350. @remarks No default case so that we get a compiler warning if a new value was added to the enum.
  351. */
  352. static NSString *FIRAuthErrorDescription(FIRAuthErrorCode code) {
  353. switch (code) {
  354. case FIRAuthErrorCodeInvalidCustomToken:
  355. return kFIRAuthErrorMessageInvalidCustomToken;
  356. case FIRAuthErrorCodeCustomTokenMismatch:
  357. return kFIRAuthErrorMessageCustomTokenMismatch;
  358. case FIRAuthErrorCodeInvalidEmail:
  359. return kFIRAuthErrorMessageInvalidEmail;
  360. case FIRAuthErrorCodeInvalidCredential:
  361. return kFIRAuthErrorMessageInvalidCredential;
  362. case FIRAuthErrorCodeUserDisabled:
  363. return kFIRAuthErrorMessageUserDisabled;
  364. case FIRAuthErrorCodeEmailAlreadyInUse:
  365. return kFIRAuthErrorMessageEmailAlreadyInUse;
  366. case FIRAuthErrorCodeWrongPassword:
  367. return kFIRAuthErrorMessageWrongPassword;
  368. case FIRAuthErrorCodeTooManyRequests:
  369. return kFIRAuthErrorMessageTooManyRequests;
  370. case FIRAuthErrorCodeAccountExistsWithDifferentCredential:
  371. return kFIRAuthErrorMessageAccountExistsWithDifferentCredential;
  372. case FIRAuthErrorCodeRequiresRecentLogin:
  373. return kFIRAuthErrorMessageRequiresRecentLogin;
  374. case FIRAuthErrorCodeProviderAlreadyLinked:
  375. return kFIRAuthErrorMessageProviderAlreadyLinked;
  376. case FIRAuthErrorCodeNoSuchProvider:
  377. return kFIRAuthErrorMessageNoSuchProvider;
  378. case FIRAuthErrorCodeInvalidUserToken:
  379. return kFIRAuthErrorMessageInvalidUserToken;
  380. case FIRAuthErrorCodeNetworkError:
  381. return kFIRAuthErrorMessageNetworkError;
  382. case FIRAuthErrorCodeKeychainError:
  383. return kFIRAuthErrorMessageKeychainError;
  384. case FIRAuthErrorCodeUserTokenExpired:
  385. return kFIRAuthErrorMessageUserTokenExpired;
  386. case FIRAuthErrorCodeUserNotFound:
  387. return kFIRAuthErrorMessageUserNotFound;
  388. case FIRAuthErrorCodeInvalidAPIKey:
  389. return kFIRAuthErrorMessageInvalidAPIKey;
  390. case FIRAuthErrorCodeCredentialAlreadyInUse:
  391. return kFIRAuthErrorMessageCredentialAlreadyInUse;
  392. case FIRAuthErrorCodeInternalError:
  393. return kFIRAuthErrorMessageInternalError;
  394. case FIRAuthErrorCodeUserMismatch:
  395. return FIRAuthErrorMessageUserMismatch;
  396. case FIRAuthErrorCodeOperationNotAllowed:
  397. return kFIRAuthErrorMessageOperationNotAllowed;
  398. case FIRAuthErrorCodeWeakPassword:
  399. return kFIRAuthErrorMessageWeakPassword;
  400. case FIRAuthErrorCodeAppNotAuthorized:
  401. return kFIRAuthErrorMessageAppNotAuthorized;
  402. case FIRAuthErrorCodeExpiredActionCode:
  403. return kFIRAuthErrorMessageExpiredActionCode;
  404. case FIRAuthErrorCodeInvalidActionCode:
  405. return kFIRAuthErrorMessageInvalidActionCode;
  406. case FIRAuthErrorCodeInvalidSender:
  407. return kFIRAuthErrorMessageInvalidSender;
  408. case FIRAuthErrorCodeInvalidMessagePayload:
  409. return kFIRAuthErrorMessageInvalidMessagePayload;
  410. case FIRAuthErrorCodeInvalidRecipientEmail:
  411. return kFIRAuthErrorMessageInvalidRecipientEmail;
  412. case FIRAuthErrorCodeMissingIosBundleID:
  413. return kFIRAuthErrorMessageMissingIosBundleID;
  414. case FIRAuthErrorCodeMissingAndroidPackageName:
  415. return kFIRAuthErrorMessageMissingAndroidPackageName;
  416. case FIRAuthErrorCodeUnauthorizedDomain:
  417. return kFIRAuthErrorMessageUnauthorizedDomain;
  418. case FIRAuthErrorCodeInvalidContinueURI:
  419. return kFIRAuthErrorMessageInvalidContinueURI;
  420. case FIRAuthErrorCodeMissingContinueURI:
  421. return kFIRAuthErrorMessageMissingContinueURI;
  422. case FIRAuthErrorCodeMissingEmail:
  423. return kFIRAuthErrorMessageMissingEmail;
  424. case FIRAuthErrorCodeMissingPhoneNumber:
  425. return kFIRAuthErrorMessageMissingPhoneNumber;
  426. case FIRAuthErrorCodeInvalidPhoneNumber:
  427. return kFIRAuthErrorMessageInvalidPhoneNumber;
  428. case FIRAuthErrorCodeMissingVerificationCode:
  429. return kFIRAuthErrorMessageMissingVerificationCode;
  430. case FIRAuthErrorCodeInvalidVerificationCode:
  431. return kFIRAuthErrorMessageInvalidVerificationCode;
  432. case FIRAuthErrorCodeMissingVerificationID:
  433. return kFIRAuthErrorMessageMissingVerificationID;
  434. case FIRAuthErrorCodeInvalidVerificationID:
  435. return kFIRAuthErrorMessageInvalidVerificationID;
  436. case FIRAuthErrorCodeSessionExpired:
  437. return kFIRAuthErrorMessageSessionExpired;
  438. case FIRAuthErrorCodeMissingAppCredential:
  439. return kFIRAuthErrorMessageMissingAppCredential;
  440. case FIRAuthErrorCodeInvalidAppCredential:
  441. return kFIRAuthErrorMessageInvalidAppCredential;
  442. case FIRAuthErrorCodeQuotaExceeded:
  443. return kFIRAuthErrorMessageQuotaExceeded;
  444. case FIRAuthErrorCodeMissingAppToken:
  445. return kFIRAuthErrorMessageMissingAppToken;
  446. case FIRAuthErrorCodeNotificationNotForwarded:
  447. return kFIRAuthErrorMessageNotificationNotForwarded;
  448. case FIRAuthErrorCodeAppNotVerified:
  449. return kFIRAuthErrorMessageAppNotVerified;
  450. case FIRAuthErrorCodeCaptchaCheckFailed:
  451. return kFIRAuthErrorMessageCaptchaCheckFailed;
  452. case FIRAuthErrorCodeWebContextAlreadyPresented:
  453. return kFIRAuthErrorMessageWebContextAlreadyPresented;
  454. case FIRAuthErrorCodeWebContextCancelled:
  455. return kFIRAuthErrorMessageWebContextCancelled;
  456. case FIRAuthErrorCodeInvalidClientID:
  457. return kFIRAuthErrorMessageInvalidClientID;
  458. case FIRAuthErrorCodeAppVerificationUserInteractionFailure:
  459. return kFIRAuthErrorMessageAppVerificationUserInteractionFailure;
  460. case FIRAuthErrorCodeWebNetworkRequestFailed:
  461. return kFIRAuthErrorMessageWebRequestFailed;
  462. case FIRAuthErrorCodeNullUser:
  463. return kFIRAuthErrorMessageNullUser;
  464. case FIRAuthErrorCodeWebInternalError:
  465. return kFIRAuthErrorMessageWebInternalError;
  466. case FIRAuthErrorCodeMalformedJWT:
  467. return kFIRAuthErrorMessageMalformedJWT;
  468. }
  469. }
  470. /** @var FIRAuthErrorCodeString
  471. @brief The the error short string, based on the error code.
  472. @remarks No default case so that we get a compiler warning if a new value was added to the enum.
  473. */
  474. static NSString *const FIRAuthErrorCodeString(FIRAuthErrorCode code) {
  475. switch (code) {
  476. case FIRAuthErrorCodeInvalidCustomToken:
  477. return @"ERROR_INVALID_CUSTOM_TOKEN";
  478. case FIRAuthErrorCodeCustomTokenMismatch:
  479. return @"ERROR_CUSTOM_TOKEN_MISMATCH";
  480. case FIRAuthErrorCodeInvalidEmail:
  481. return @"ERROR_INVALID_EMAIL";
  482. case FIRAuthErrorCodeInvalidCredential:
  483. return @"ERROR_INVALID_CREDENTIAL";
  484. case FIRAuthErrorCodeUserDisabled:
  485. return @"ERROR_USER_DISABLED";
  486. case FIRAuthErrorCodeEmailAlreadyInUse:
  487. return @"ERROR_EMAIL_ALREADY_IN_USE";
  488. case FIRAuthErrorCodeWrongPassword:
  489. return @"ERROR_WRONG_PASSWORD";
  490. case FIRAuthErrorCodeTooManyRequests:
  491. return @"ERROR_TOO_MANY_REQUESTS";
  492. case FIRAuthErrorCodeAccountExistsWithDifferentCredential:
  493. return @"ERROR_ACCOUNT_EXISTS_WITH_DIFFERENT_CREDENTIAL";
  494. case FIRAuthErrorCodeRequiresRecentLogin:
  495. return @"ERROR_REQUIRES_RECENT_LOGIN";
  496. case FIRAuthErrorCodeProviderAlreadyLinked:
  497. return @"ERROR_PROVIDER_ALREADY_LINKED";
  498. case FIRAuthErrorCodeNoSuchProvider:
  499. return @"ERROR_NO_SUCH_PROVIDER";
  500. case FIRAuthErrorCodeInvalidUserToken:
  501. return @"ERROR_INVALID_USER_TOKEN";
  502. case FIRAuthErrorCodeNetworkError:
  503. return @"ERROR_NETWORK_REQUEST_FAILED";
  504. case FIRAuthErrorCodeKeychainError:
  505. return @"ERROR_KEYCHAIN_ERROR";
  506. case FIRAuthErrorCodeUserTokenExpired:
  507. return @"ERROR_USER_TOKEN_EXPIRED";
  508. case FIRAuthErrorCodeUserNotFound:
  509. return @"ERROR_USER_NOT_FOUND";
  510. case FIRAuthErrorCodeInvalidAPIKey:
  511. return @"ERROR_INVALID_API_KEY";
  512. case FIRAuthErrorCodeCredentialAlreadyInUse:
  513. return @"ERROR_CREDENTIAL_ALREADY_IN_USE";
  514. case FIRAuthErrorCodeInternalError:
  515. return @"ERROR_INTERNAL_ERROR";
  516. case FIRAuthErrorCodeUserMismatch:
  517. return @"ERROR_USER_MISMATCH";
  518. case FIRAuthErrorCodeOperationNotAllowed:
  519. return @"ERROR_OPERATION_NOT_ALLOWED";
  520. case FIRAuthErrorCodeWeakPassword:
  521. return @"ERROR_WEAK_PASSWORD";
  522. case FIRAuthErrorCodeAppNotAuthorized:
  523. return @"ERROR_APP_NOT_AUTHORIZED";
  524. case FIRAuthErrorCodeExpiredActionCode:
  525. return @"ERROR_EXPIRED_ACTION_CODE";
  526. case FIRAuthErrorCodeInvalidActionCode:
  527. return @"ERROR_INVALID_ACTION_CODE";
  528. case FIRAuthErrorCodeInvalidMessagePayload:
  529. return @"ERROR_INVALID_MESSAGE_PAYLOAD";
  530. case FIRAuthErrorCodeInvalidSender:
  531. return @"ERROR_INVALID_SENDER";
  532. case FIRAuthErrorCodeInvalidRecipientEmail:
  533. return @"ERROR_INVALID_RECIPIENT_EMAIL";
  534. case FIRAuthErrorCodeMissingIosBundleID:
  535. return @"ERROR_MISSING_IOS_BUNDLE_ID";
  536. case FIRAuthErrorCodeMissingAndroidPackageName:
  537. return @"ERROR_MISSING_ANDROID_PKG_NAME";
  538. case FIRAuthErrorCodeUnauthorizedDomain:
  539. return @"ERROR_UNAUTHORIZED_DOMAIN";
  540. case FIRAuthErrorCodeInvalidContinueURI:
  541. return @"ERROR_INVALID_CONTINUE_URI";
  542. case FIRAuthErrorCodeMissingContinueURI:
  543. return @"ERROR_MISSING_CONTINUE_URI";
  544. case FIRAuthErrorCodeMissingEmail:
  545. return @"ERROR_MISSING_EMAIL";
  546. case FIRAuthErrorCodeMissingPhoneNumber:
  547. return @"ERROR_MISSING_PHONE_NUMBER";
  548. case FIRAuthErrorCodeInvalidPhoneNumber:
  549. return @"ERROR_INVALID_PHONE_NUMBER";
  550. case FIRAuthErrorCodeMissingVerificationCode:
  551. return @"ERROR_MISSING_VERIFICATION_CODE";
  552. case FIRAuthErrorCodeInvalidVerificationCode:
  553. return @"ERROR_INVALID_VERIFICATION_CODE";
  554. case FIRAuthErrorCodeMissingVerificationID:
  555. return @"ERROR_MISSING_VERIFICATION_ID";
  556. case FIRAuthErrorCodeInvalidVerificationID:
  557. return @"ERROR_INVALID_VERIFICATION_ID";
  558. case FIRAuthErrorCodeSessionExpired:
  559. return @"ERROR_SESSION_EXPIRED";
  560. case FIRAuthErrorCodeMissingAppCredential:
  561. return @"MISSING_APP_CREDENTIAL";
  562. case FIRAuthErrorCodeInvalidAppCredential:
  563. return @"INVALID_APP_CREDENTIAL";
  564. case FIRAuthErrorCodeQuotaExceeded:
  565. return @"ERROR_QUOTA_EXCEEDED";
  566. case FIRAuthErrorCodeMissingAppToken:
  567. return @"ERROR_MISSING_APP_TOKEN";
  568. case FIRAuthErrorCodeNotificationNotForwarded:
  569. return @"ERROR_NOTIFICATION_NOT_FORWARDED";
  570. case FIRAuthErrorCodeAppNotVerified:
  571. return @"ERROR_APP_NOT_VERIFIED";
  572. case FIRAuthErrorCodeCaptchaCheckFailed:
  573. return @"ERROR_CAPTCHA_CHECK_FAILED";
  574. case FIRAuthErrorCodeWebContextAlreadyPresented:
  575. return @"ERROR_WEB_CONTEXT_ALREADY_PRESENTED";
  576. case FIRAuthErrorCodeWebContextCancelled:
  577. return @"ERROR_WEB_CONTEXT_CANCELLED";
  578. case FIRAuthErrorCodeInvalidClientID:
  579. return @"ERROR_INVALID_CLIENT_ID";
  580. case FIRAuthErrorCodeAppVerificationUserInteractionFailure:
  581. return @"ERROR_APP_VERIFICATION_FAILED";
  582. case FIRAuthErrorCodeWebNetworkRequestFailed:
  583. return @"ERROR_WEB_NETWORK_REQUEST_FAILED";
  584. case FIRAuthErrorCodeNullUser:
  585. return @"ERROR_NULL_USER";
  586. case FIRAuthErrorCodeWebInternalError:
  587. return @"ERROR_WEB_INTERNAL_ERROR";
  588. case FIRAuthErrorCodeMalformedJWT:
  589. return @"ERROR_MALFORMED_JWT";
  590. }
  591. }
  592. @implementation FIRAuthErrorUtils
  593. + (NSError *)errorWithCode:(FIRAuthInternalErrorCode)code {
  594. return [self errorWithCode:code message:nil];
  595. }
  596. + (NSError *)errorWithCode:(FIRAuthInternalErrorCode)code
  597. message:(nullable NSString *)message {
  598. NSDictionary *userInfo = nil;
  599. if (message.length) {
  600. userInfo = @{
  601. NSLocalizedDescriptionKey : message
  602. };
  603. }
  604. return [self errorWithCode:code userInfo:userInfo];
  605. }
  606. + (NSError *)errorWithCode:(FIRAuthInternalErrorCode)code
  607. underlyingError:(nullable NSError *)underlyingError {
  608. NSDictionary *errorUserInfo = nil;
  609. if (underlyingError) {
  610. errorUserInfo = @{
  611. NSUnderlyingErrorKey : underlyingError
  612. };
  613. }
  614. return [self errorWithCode:code userInfo:errorUserInfo];
  615. }
  616. + (NSError *)errorWithCode:(FIRAuthInternalErrorCode)code
  617. userInfo:(nullable NSDictionary *)userInfo {
  618. BOOL isPublic = (code & FIRAuthPublicErrorCodeFlag) == FIRAuthPublicErrorCodeFlag;
  619. if (isPublic) {
  620. // This is a public error. Return it as a public error and add a description.
  621. NSInteger errorCode = code & ~FIRAuthPublicErrorCodeFlag;
  622. NSMutableDictionary *errorUserInfo = [NSMutableDictionary dictionaryWithDictionary:userInfo];
  623. if (!errorUserInfo[NSLocalizedDescriptionKey]) {
  624. errorUserInfo[NSLocalizedDescriptionKey] = FIRAuthErrorDescription(errorCode);
  625. }
  626. errorUserInfo[FIRAuthErrorNameKey] = FIRAuthErrorCodeString(errorCode);
  627. return [NSError errorWithDomain:FIRAuthErrorDomain code:errorCode userInfo:errorUserInfo];
  628. } else {
  629. // This is an internal error. Wrap it in an internal error.
  630. NSError *error =
  631. [NSError errorWithDomain:FIRAuthInternalErrorDomain code:code userInfo:userInfo];
  632. return [self errorWithCode:FIRAuthInternalErrorCodeInternalError underlyingError:error];
  633. }
  634. }
  635. + (NSError *)RPCRequestEncodingErrorWithUnderlyingError:(NSError *)underlyingError {
  636. return [self errorWithCode:FIRAuthInternalErrorCodeRPCRequestEncodingError
  637. underlyingError:underlyingError];
  638. }
  639. + (NSError *)JSONSerializationErrorForUnencodableType {
  640. return [self errorWithCode:FIRAuthInternalErrorCodeJSONSerializationError];
  641. }
  642. + (NSError *)JSONSerializationErrorWithUnderlyingError:(NSError *)underlyingError {
  643. return [self errorWithCode:FIRAuthInternalErrorCodeJSONSerializationError
  644. underlyingError:underlyingError];
  645. }
  646. + (NSError *)networkErrorWithUnderlyingError:(NSError *)underlyingError {
  647. return [self errorWithCode:FIRAuthInternalErrorCodeNetworkError
  648. underlyingError:underlyingError];
  649. }
  650. + (NSError *)unexpectedErrorResponseWithData:(NSData *)data
  651. underlyingError:(NSError *)underlyingError {
  652. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedErrorResponse userInfo:@{
  653. FIRAuthErrorUserInfoDataKey : data,
  654. NSUnderlyingErrorKey : underlyingError
  655. }];
  656. }
  657. + (NSError *)unexpectedErrorResponseWithDeserializedResponse:(id)deserializedResponse {
  658. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedErrorResponse userInfo:@{
  659. FIRAuthErrorUserInfoDeserializedResponseKey : deserializedResponse
  660. }];
  661. }
  662. + (NSError *)malformedJWTErrorWithToken:(NSString *)token
  663. underlyingError:(NSError *_Nullable)underlyingError {
  664. NSMutableDictionary *userInfo =
  665. [NSMutableDictionary dictionaryWithObject:kFIRAuthErrorMessageMalformedJWT
  666. forKey:NSLocalizedDescriptionKey];
  667. [userInfo setObject:token forKey:FIRAuthErrorUserInfoDataKey];
  668. if (underlyingError != nil) {
  669. [userInfo setObject:underlyingError forKey:NSUnderlyingErrorKey];
  670. }
  671. return [self errorWithCode:FIRAuthInternalErrorCodeMalformedJWT userInfo:[userInfo copy]];
  672. }
  673. + (NSError *)unexpectedResponseWithData:(NSData *)data
  674. underlyingError:(NSError *)underlyingError {
  675. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedResponse userInfo:@{
  676. FIRAuthErrorUserInfoDataKey : data,
  677. NSUnderlyingErrorKey : underlyingError
  678. }];
  679. }
  680. + (NSError *)unexpectedResponseWithDeserializedResponse:(id)deserializedResponse {
  681. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedResponse userInfo:@{
  682. FIRAuthErrorUserInfoDeserializedResponseKey : deserializedResponse
  683. }];
  684. }
  685. + (NSError *)unexpectedResponseWithDeserializedResponse:(nullable id)deserializedResponse
  686. underlyingError:(NSError *)underlyingError {
  687. NSMutableDictionary *userInfo =
  688. [NSMutableDictionary dictionaryWithDictionary:@{ NSUnderlyingErrorKey : underlyingError }];
  689. if (deserializedResponse) {
  690. userInfo[FIRAuthErrorUserInfoDeserializedResponseKey] = deserializedResponse;
  691. }
  692. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedResponse userInfo:userInfo];
  693. }
  694. + (NSError *)RPCResponseDecodingErrorWithDeserializedResponse:(id)deserializedResponse
  695. underlyingError:(NSError *)underlyingError {
  696. return [self errorWithCode:FIRAuthInternalErrorCodeRPCResponseDecodingError userInfo:@{
  697. FIRAuthErrorUserInfoDeserializedResponseKey : deserializedResponse,
  698. NSUnderlyingErrorKey : underlyingError
  699. }];
  700. }
  701. + (NSError *)emailAlreadyInUseErrorWithEmail:(nullable NSString *)email {
  702. NSMutableDictionary *userInfo = [[NSMutableDictionary alloc] init];
  703. if (email.length) {
  704. userInfo[FIRAuthErrorUserInfoEmailKey] = email;
  705. }
  706. return [self errorWithCode:FIRAuthInternalErrorCodeEmailAlreadyInUse userInfo:userInfo];
  707. }
  708. + (NSError *)userDisabledErrorWithMessage:(nullable NSString *)message {
  709. return [self errorWithCode:FIRAuthInternalErrorCodeUserDisabled message:message];
  710. }
  711. + (NSError *)wrongPasswordErrorWithMessage:(nullable NSString *)message {
  712. return [self errorWithCode:FIRAuthInternalErrorCodeWrongPassword message:message];
  713. }
  714. + (NSError *)tooManyRequestsErrorWithMessage:(nullable NSString *)message {
  715. return [self errorWithCode:FIRAuthInternalErrorCodeTooManyRequests message:message];
  716. }
  717. + (NSError *)invalidCustomTokenErrorWithMessage:(nullable NSString *)message {
  718. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidCustomToken message:message];
  719. }
  720. + (NSError *)customTokenMistmatchErrorWithMessage:(nullable NSString *)message {
  721. return [self errorWithCode:FIRAuthInternalErrorCodeCustomTokenMismatch message:message];
  722. }
  723. + (NSError *)invalidCredentialErrorWithMessage:(nullable NSString *)message {
  724. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidCredential message:message];
  725. }
  726. + (NSError *)requiresRecentLoginErrorWithMessage:(nullable NSString *)message {
  727. return [self errorWithCode:FIRAuthInternalErrorCodeRequiresRecentLogin message:message];
  728. }
  729. + (NSError *)invalidUserTokenErrorWithMessage:(nullable NSString *)message {
  730. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidUserToken message:message];
  731. }
  732. + (NSError *)invalidEmailErrorWithMessage:(nullable NSString *)message {
  733. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidEmail message:message];
  734. }
  735. + (NSError *)accountExistsWithDifferentCredentialErrorWithEmail:(nullable NSString *)email {
  736. return [self errorWithCode:FIRAuthInternalErrorCodeAccountExistsWithDifferentCredential
  737. userInfo:@{ FIRAuthErrorUserInfoEmailKey : email }];
  738. }
  739. + (NSError *)providerAlreadyLinkedError {
  740. return [self errorWithCode:FIRAuthInternalErrorCodeProviderAlreadyLinked];
  741. }
  742. + (NSError *)noSuchProviderError {
  743. return [self errorWithCode:FIRAuthInternalErrorCodeNoSuchProvider];
  744. }
  745. + (NSError *)userTokenExpiredErrorWithMessage:(nullable NSString *)message {
  746. return [self errorWithCode:FIRAuthInternalErrorCodeUserTokenExpired message:message];
  747. }
  748. + (NSError *)userNotFoundErrorWithMessage:(nullable NSString *)message {
  749. return [self errorWithCode:FIRAuthInternalErrorCodeUserNotFound message:message];
  750. }
  751. + (NSError *)invalidAPIKeyError {
  752. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidAPIKey];
  753. }
  754. + (NSError *)userMismatchError {
  755. return [self errorWithCode:FIRAuthInternalErrorCodeUserMismatch];
  756. }
  757. + (NSError *)credentialAlreadyInUseErrorWithMessage:(nullable NSString *)message
  758. credential:(nullable FIRPhoneAuthCredential *)credential {
  759. if (credential) {
  760. return [self errorWithCode:FIRAuthInternalErrorCodeCredentialAlreadyInUse
  761. userInfo:@{ FIRAuthUpdatedCredentialKey : credential }];
  762. }
  763. return [self errorWithCode:FIRAuthInternalErrorCodeCredentialAlreadyInUse message:message];
  764. }
  765. + (NSError *)operationNotAllowedErrorWithMessage:(nullable NSString *)message {
  766. return [self errorWithCode:FIRAuthInternalErrorCodeOperationNotAllowed message:message];
  767. }
  768. + (NSError *)weakPasswordErrorWithServerResponseReason:(nullable NSString *)reason {
  769. return [self errorWithCode:FIRAuthInternalErrorCodeWeakPassword userInfo:@{
  770. NSLocalizedFailureReasonErrorKey : reason
  771. }];
  772. }
  773. + (NSError *)appNotAuthorizedError {
  774. return [self errorWithCode:FIRAuthInternalErrorCodeAppNotAuthorized];
  775. }
  776. + (NSError *)expiredActionCodeErrorWithMessage:(nullable NSString *)message {
  777. return [self errorWithCode:FIRAuthInternalErrorCodeExpiredActionCode message:message];
  778. }
  779. + (NSError *)invalidActionCodeErrorWithMessage:(nullable NSString *)message {
  780. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidActionCode message:message];
  781. }
  782. + (NSError *)invalidMessagePayloadErrorWithMessage:(nullable NSString *)message {
  783. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidMessagePayload message:message];
  784. }
  785. + (NSError *)invalidSenderErrorWithMessage:(nullable NSString *)message {
  786. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidSender message:message];
  787. }
  788. + (NSError *)invalidRecipientEmailErrorWithMessage:(nullable NSString *)message {
  789. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidRecipientEmail message:message];
  790. }
  791. + (NSError *)missingIosBundleIDErrorWithMessage:(nullable NSString *)message {
  792. return [self errorWithCode:FIRAuthinternalErrorCodeMissingIosBundleID message:message];
  793. }
  794. + (NSError *)missingAndroidPackageNameErrorWithMessage:(nullable NSString *)message {
  795. return [self errorWithCode:FIRAuthInternalErrorCodeMissingAndroidPackageName message:message];
  796. }
  797. + (NSError *)unauthorizedDomainErrorWithMessage:(nullable NSString *)message {
  798. return [self errorWithCode:FIRAuthInternalErrorCodeUnauthorizedDomain message:message];
  799. }
  800. + (NSError *)invalidContinueURIErrorWithMessage:(nullable NSString *)message {
  801. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidContinueURI message:message];
  802. }
  803. + (NSError *)missingContinueURIErrorWithMessage:(nullable NSString *)message {
  804. return[self errorWithCode:FIRAuthInternalErrorCodeMissingContinueURI message:message];
  805. }
  806. + (NSError *)missingEmailErrorWithMessage:(nullable NSString *)message {
  807. return [self errorWithCode:FIRAuthInternalErrorCodeMissingEmail message:message];
  808. }
  809. + (NSError *)missingPhoneNumberErrorWithMessage:(nullable NSString *)message {
  810. return [self errorWithCode:FIRAuthInternalErrorCodeMissingPhoneNumber message:message];
  811. }
  812. + (NSError *)invalidPhoneNumberErrorWithMessage:(nullable NSString *)message {
  813. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidPhoneNumber message:message];
  814. }
  815. + (NSError *)missingVerificationCodeErrorWithMessage:(nullable NSString *)message {
  816. return [self errorWithCode:FIRAuthInternalErrorCodeMissingVerificationCode message:message];
  817. }
  818. + (NSError *)invalidVerificationCodeErrorWithMessage:(nullable NSString *)message {
  819. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidVerificationCode message:message];
  820. }
  821. + (NSError *)missingVerificationIDErrorWithMessage:(nullable NSString *)message {
  822. return [self errorWithCode:FIRAuthInternalErrorCodeMissingVerificationID message:message];
  823. }
  824. + (NSError *)invalidVerificationIDErrorWithMessage:(nullable NSString *)message {
  825. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidVerificationID message:message];
  826. }
  827. + (NSError *)sessionExpiredErrorWithMessage:(nullable NSString *)message {
  828. return [self errorWithCode:FIRAuthInternalErrorCodeSessionExpired message:message];
  829. }
  830. + (NSError *)missingAppCredentialWithMessage:(nullable NSString *)message {
  831. return [self errorWithCode:FIRAuthInternalErrorCodeMissingAppCredential message:message];
  832. }
  833. + (NSError *)invalidAppCredentialWithMessage:(nullable NSString *)message {
  834. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidAppCredential message:message];
  835. }
  836. + (NSError *)quotaExceededErrorWithMessage:(nullable NSString *)message {
  837. return [self errorWithCode:FIRAuthInternalErrorCodeQuotaExceeded message:message];
  838. }
  839. + (NSError *)missingAppTokenErrorWithUnderlyingError:(nullable NSError *)underlyingError {
  840. return [self errorWithCode:FIRAuthInternalErrorCodeMissingAppToken
  841. underlyingError:underlyingError];
  842. }
  843. + (NSError *)notificationNotForwardedError {
  844. return [self errorWithCode:FIRAuthInternalErrorCodeNotificationNotForwarded];
  845. }
  846. + (NSError *)appNotVerifiedErrorWithMessage:(nullable NSString *)message {
  847. return [self errorWithCode:FIRAuthInternalErrorCodeAppNotVerified message:message];
  848. }
  849. + (NSError *)captchaCheckFailedErrorWithMessage:(nullable NSString *)message {
  850. return [self errorWithCode:FIRAuthInternalErrorCodeCaptchaCheckFailed message:message];
  851. }
  852. + (NSError *)webContextAlreadyPresentedErrorWithMessage:(nullable NSString *)message {
  853. return [self errorWithCode:FIRAuthInternalErrorCodeWebContextAlreadyPresented message:message];
  854. }
  855. + (NSError *)webContextCancelledErrorWithMessage:(nullable NSString *)message {
  856. return [self errorWithCode:FIRAuthInternalErrorCodeWebContextCancelled message:message];
  857. }
  858. + (NSError *)appVerificationUserInteractionFailureWithReason:(NSString *)reason {
  859. return [self errorWithCode:FIRAuthInternalErrorCodeAppVerificationUserInteractionFailure
  860. userInfo:@{
  861. NSLocalizedFailureReasonErrorKey : reason
  862. }];
  863. }
  864. + (nullable NSError *)URLResponseErrorWithCode:(NSString *)code message:(nullable NSString *)message {
  865. if ([code isEqualToString:kURLResponseErrorCodeInvalidClientID]) {
  866. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidClientID message:message];
  867. }
  868. if ([code isEqualToString:kURLResponseErrorCodeNetworkRequestFailed]) {
  869. return [self errorWithCode:FIRAuthInternalErrorCodeWebNetworkRequestFailed message:message];
  870. }
  871. if ([code isEqualToString:kURLResponseErrorCodeInternalError]) {
  872. return [self errorWithCode:FIRAuthInternalErrorCodeWebInternalError message:message];
  873. }
  874. return nil;
  875. }
  876. + (NSError *)nullUserErrorWithMessage:(nullable NSString *)message {
  877. return [self errorWithCode:FIRAuthInternalErrorCodeNullUser message:message];
  878. }
  879. + (NSError *)keychainErrorWithFunction:(NSString *)keychainFunction status:(OSStatus)status {
  880. NSString *failureReason = [NSString stringWithFormat:@"%@ (%li)", keychainFunction, (long)status];
  881. return [self errorWithCode:FIRAuthInternalErrorCodeKeychainError userInfo:@{
  882. NSLocalizedFailureReasonErrorKey : failureReason,
  883. }];
  884. }
  885. @end
  886. NS_ASSUME_NONNULL_END