FIRAuthErrorUtils.m 45 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046
  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 kFIRAuthErrorMessageInvalidDynamicLinkDomain
  339. @brief Message for @c kFIRAuthErrorMessageInvalidDynamicLinkDomain error code.
  340. */
  341. static NSString *const kFIRAuthErrorMessageInvalidDynamicLinkDomain = @"The "
  342. "Firebase Dynamic Link domain used is either not configured or is unauthorized "
  343. "for the current project.";
  344. /** @var kFIRAuthErrorMessageInternalError
  345. @brief Message for @c FIRAuthErrorCodeInternalError error code.
  346. */
  347. static NSString *const kFIRAuthErrorMessageInternalError = @"An internal error has occurred, "
  348. "print and inspect the error details for more information.";
  349. /** @var kFIRAuthErrorMessageMalformedJWT
  350. @brief Error message constant describing @c FIRAuthErrorCodeMalformedJWT errors.
  351. */
  352. static NSString *const kFIRAuthErrorMessageMalformedJWT =
  353. @"Failed to parse JWT. Check the userInfo dictionary for the full token.";
  354. /** @var FIRAuthErrorDescription
  355. @brief The error descrioption, based on the error code.
  356. @remarks No default case so that we get a compiler warning if a new value was added to the enum.
  357. */
  358. static NSString *FIRAuthErrorDescription(FIRAuthErrorCode code) {
  359. switch (code) {
  360. case FIRAuthErrorCodeInvalidCustomToken:
  361. return kFIRAuthErrorMessageInvalidCustomToken;
  362. case FIRAuthErrorCodeCustomTokenMismatch:
  363. return kFIRAuthErrorMessageCustomTokenMismatch;
  364. case FIRAuthErrorCodeInvalidEmail:
  365. return kFIRAuthErrorMessageInvalidEmail;
  366. case FIRAuthErrorCodeInvalidCredential:
  367. return kFIRAuthErrorMessageInvalidCredential;
  368. case FIRAuthErrorCodeUserDisabled:
  369. return kFIRAuthErrorMessageUserDisabled;
  370. case FIRAuthErrorCodeEmailAlreadyInUse:
  371. return kFIRAuthErrorMessageEmailAlreadyInUse;
  372. case FIRAuthErrorCodeWrongPassword:
  373. return kFIRAuthErrorMessageWrongPassword;
  374. case FIRAuthErrorCodeTooManyRequests:
  375. return kFIRAuthErrorMessageTooManyRequests;
  376. case FIRAuthErrorCodeAccountExistsWithDifferentCredential:
  377. return kFIRAuthErrorMessageAccountExistsWithDifferentCredential;
  378. case FIRAuthErrorCodeRequiresRecentLogin:
  379. return kFIRAuthErrorMessageRequiresRecentLogin;
  380. case FIRAuthErrorCodeProviderAlreadyLinked:
  381. return kFIRAuthErrorMessageProviderAlreadyLinked;
  382. case FIRAuthErrorCodeNoSuchProvider:
  383. return kFIRAuthErrorMessageNoSuchProvider;
  384. case FIRAuthErrorCodeInvalidUserToken:
  385. return kFIRAuthErrorMessageInvalidUserToken;
  386. case FIRAuthErrorCodeNetworkError:
  387. return kFIRAuthErrorMessageNetworkError;
  388. case FIRAuthErrorCodeKeychainError:
  389. return kFIRAuthErrorMessageKeychainError;
  390. case FIRAuthErrorCodeUserTokenExpired:
  391. return kFIRAuthErrorMessageUserTokenExpired;
  392. case FIRAuthErrorCodeUserNotFound:
  393. return kFIRAuthErrorMessageUserNotFound;
  394. case FIRAuthErrorCodeInvalidAPIKey:
  395. return kFIRAuthErrorMessageInvalidAPIKey;
  396. case FIRAuthErrorCodeCredentialAlreadyInUse:
  397. return kFIRAuthErrorMessageCredentialAlreadyInUse;
  398. case FIRAuthErrorCodeInternalError:
  399. return kFIRAuthErrorMessageInternalError;
  400. case FIRAuthErrorCodeUserMismatch:
  401. return FIRAuthErrorMessageUserMismatch;
  402. case FIRAuthErrorCodeOperationNotAllowed:
  403. return kFIRAuthErrorMessageOperationNotAllowed;
  404. case FIRAuthErrorCodeWeakPassword:
  405. return kFIRAuthErrorMessageWeakPassword;
  406. case FIRAuthErrorCodeAppNotAuthorized:
  407. return kFIRAuthErrorMessageAppNotAuthorized;
  408. case FIRAuthErrorCodeExpiredActionCode:
  409. return kFIRAuthErrorMessageExpiredActionCode;
  410. case FIRAuthErrorCodeInvalidActionCode:
  411. return kFIRAuthErrorMessageInvalidActionCode;
  412. case FIRAuthErrorCodeInvalidSender:
  413. return kFIRAuthErrorMessageInvalidSender;
  414. case FIRAuthErrorCodeInvalidMessagePayload:
  415. return kFIRAuthErrorMessageInvalidMessagePayload;
  416. case FIRAuthErrorCodeInvalidRecipientEmail:
  417. return kFIRAuthErrorMessageInvalidRecipientEmail;
  418. case FIRAuthErrorCodeMissingIosBundleID:
  419. return kFIRAuthErrorMessageMissingIosBundleID;
  420. case FIRAuthErrorCodeMissingAndroidPackageName:
  421. return kFIRAuthErrorMessageMissingAndroidPackageName;
  422. case FIRAuthErrorCodeUnauthorizedDomain:
  423. return kFIRAuthErrorMessageUnauthorizedDomain;
  424. case FIRAuthErrorCodeInvalidContinueURI:
  425. return kFIRAuthErrorMessageInvalidContinueURI;
  426. case FIRAuthErrorCodeMissingContinueURI:
  427. return kFIRAuthErrorMessageMissingContinueURI;
  428. case FIRAuthErrorCodeMissingEmail:
  429. return kFIRAuthErrorMessageMissingEmail;
  430. case FIRAuthErrorCodeMissingPhoneNumber:
  431. return kFIRAuthErrorMessageMissingPhoneNumber;
  432. case FIRAuthErrorCodeInvalidPhoneNumber:
  433. return kFIRAuthErrorMessageInvalidPhoneNumber;
  434. case FIRAuthErrorCodeMissingVerificationCode:
  435. return kFIRAuthErrorMessageMissingVerificationCode;
  436. case FIRAuthErrorCodeInvalidVerificationCode:
  437. return kFIRAuthErrorMessageInvalidVerificationCode;
  438. case FIRAuthErrorCodeMissingVerificationID:
  439. return kFIRAuthErrorMessageMissingVerificationID;
  440. case FIRAuthErrorCodeInvalidVerificationID:
  441. return kFIRAuthErrorMessageInvalidVerificationID;
  442. case FIRAuthErrorCodeSessionExpired:
  443. return kFIRAuthErrorMessageSessionExpired;
  444. case FIRAuthErrorCodeMissingAppCredential:
  445. return kFIRAuthErrorMessageMissingAppCredential;
  446. case FIRAuthErrorCodeInvalidAppCredential:
  447. return kFIRAuthErrorMessageInvalidAppCredential;
  448. case FIRAuthErrorCodeQuotaExceeded:
  449. return kFIRAuthErrorMessageQuotaExceeded;
  450. case FIRAuthErrorCodeMissingAppToken:
  451. return kFIRAuthErrorMessageMissingAppToken;
  452. case FIRAuthErrorCodeNotificationNotForwarded:
  453. return kFIRAuthErrorMessageNotificationNotForwarded;
  454. case FIRAuthErrorCodeAppNotVerified:
  455. return kFIRAuthErrorMessageAppNotVerified;
  456. case FIRAuthErrorCodeCaptchaCheckFailed:
  457. return kFIRAuthErrorMessageCaptchaCheckFailed;
  458. case FIRAuthErrorCodeWebContextAlreadyPresented:
  459. return kFIRAuthErrorMessageWebContextAlreadyPresented;
  460. case FIRAuthErrorCodeWebContextCancelled:
  461. return kFIRAuthErrorMessageWebContextCancelled;
  462. case FIRAuthErrorCodeInvalidClientID:
  463. return kFIRAuthErrorMessageInvalidClientID;
  464. case FIRAuthErrorCodeAppVerificationUserInteractionFailure:
  465. return kFIRAuthErrorMessageAppVerificationUserInteractionFailure;
  466. case FIRAuthErrorCodeWebNetworkRequestFailed:
  467. return kFIRAuthErrorMessageWebRequestFailed;
  468. case FIRAuthErrorCodeNullUser:
  469. return kFIRAuthErrorMessageNullUser;
  470. case FIRAuthErrorCodeInvalidDynamicLinkDomain:
  471. return kFIRAuthErrorMessageInvalidDynamicLinkDomain;
  472. case FIRAuthErrorCodeWebInternalError:
  473. return kFIRAuthErrorMessageWebInternalError;
  474. case FIRAuthErrorCodeMalformedJWT:
  475. return kFIRAuthErrorMessageMalformedJWT;
  476. }
  477. }
  478. /** @var FIRAuthErrorCodeString
  479. @brief The the error short string, based on the error code.
  480. @remarks No default case so that we get a compiler warning if a new value was added to the enum.
  481. */
  482. static NSString *const FIRAuthErrorCodeString(FIRAuthErrorCode code) {
  483. switch (code) {
  484. case FIRAuthErrorCodeInvalidCustomToken:
  485. return @"ERROR_INVALID_CUSTOM_TOKEN";
  486. case FIRAuthErrorCodeCustomTokenMismatch:
  487. return @"ERROR_CUSTOM_TOKEN_MISMATCH";
  488. case FIRAuthErrorCodeInvalidEmail:
  489. return @"ERROR_INVALID_EMAIL";
  490. case FIRAuthErrorCodeInvalidCredential:
  491. return @"ERROR_INVALID_CREDENTIAL";
  492. case FIRAuthErrorCodeUserDisabled:
  493. return @"ERROR_USER_DISABLED";
  494. case FIRAuthErrorCodeEmailAlreadyInUse:
  495. return @"ERROR_EMAIL_ALREADY_IN_USE";
  496. case FIRAuthErrorCodeWrongPassword:
  497. return @"ERROR_WRONG_PASSWORD";
  498. case FIRAuthErrorCodeTooManyRequests:
  499. return @"ERROR_TOO_MANY_REQUESTS";
  500. case FIRAuthErrorCodeAccountExistsWithDifferentCredential:
  501. return @"ERROR_ACCOUNT_EXISTS_WITH_DIFFERENT_CREDENTIAL";
  502. case FIRAuthErrorCodeRequiresRecentLogin:
  503. return @"ERROR_REQUIRES_RECENT_LOGIN";
  504. case FIRAuthErrorCodeProviderAlreadyLinked:
  505. return @"ERROR_PROVIDER_ALREADY_LINKED";
  506. case FIRAuthErrorCodeNoSuchProvider:
  507. return @"ERROR_NO_SUCH_PROVIDER";
  508. case FIRAuthErrorCodeInvalidUserToken:
  509. return @"ERROR_INVALID_USER_TOKEN";
  510. case FIRAuthErrorCodeNetworkError:
  511. return @"ERROR_NETWORK_REQUEST_FAILED";
  512. case FIRAuthErrorCodeKeychainError:
  513. return @"ERROR_KEYCHAIN_ERROR";
  514. case FIRAuthErrorCodeUserTokenExpired:
  515. return @"ERROR_USER_TOKEN_EXPIRED";
  516. case FIRAuthErrorCodeUserNotFound:
  517. return @"ERROR_USER_NOT_FOUND";
  518. case FIRAuthErrorCodeInvalidAPIKey:
  519. return @"ERROR_INVALID_API_KEY";
  520. case FIRAuthErrorCodeCredentialAlreadyInUse:
  521. return @"ERROR_CREDENTIAL_ALREADY_IN_USE";
  522. case FIRAuthErrorCodeInternalError:
  523. return @"ERROR_INTERNAL_ERROR";
  524. case FIRAuthErrorCodeUserMismatch:
  525. return @"ERROR_USER_MISMATCH";
  526. case FIRAuthErrorCodeOperationNotAllowed:
  527. return @"ERROR_OPERATION_NOT_ALLOWED";
  528. case FIRAuthErrorCodeWeakPassword:
  529. return @"ERROR_WEAK_PASSWORD";
  530. case FIRAuthErrorCodeAppNotAuthorized:
  531. return @"ERROR_APP_NOT_AUTHORIZED";
  532. case FIRAuthErrorCodeExpiredActionCode:
  533. return @"ERROR_EXPIRED_ACTION_CODE";
  534. case FIRAuthErrorCodeInvalidActionCode:
  535. return @"ERROR_INVALID_ACTION_CODE";
  536. case FIRAuthErrorCodeInvalidMessagePayload:
  537. return @"ERROR_INVALID_MESSAGE_PAYLOAD";
  538. case FIRAuthErrorCodeInvalidSender:
  539. return @"ERROR_INVALID_SENDER";
  540. case FIRAuthErrorCodeInvalidRecipientEmail:
  541. return @"ERROR_INVALID_RECIPIENT_EMAIL";
  542. case FIRAuthErrorCodeMissingIosBundleID:
  543. return @"ERROR_MISSING_IOS_BUNDLE_ID";
  544. case FIRAuthErrorCodeMissingAndroidPackageName:
  545. return @"ERROR_MISSING_ANDROID_PKG_NAME";
  546. case FIRAuthErrorCodeUnauthorizedDomain:
  547. return @"ERROR_UNAUTHORIZED_DOMAIN";
  548. case FIRAuthErrorCodeInvalidContinueURI:
  549. return @"ERROR_INVALID_CONTINUE_URI";
  550. case FIRAuthErrorCodeMissingContinueURI:
  551. return @"ERROR_MISSING_CONTINUE_URI";
  552. case FIRAuthErrorCodeMissingEmail:
  553. return @"ERROR_MISSING_EMAIL";
  554. case FIRAuthErrorCodeMissingPhoneNumber:
  555. return @"ERROR_MISSING_PHONE_NUMBER";
  556. case FIRAuthErrorCodeInvalidPhoneNumber:
  557. return @"ERROR_INVALID_PHONE_NUMBER";
  558. case FIRAuthErrorCodeMissingVerificationCode:
  559. return @"ERROR_MISSING_VERIFICATION_CODE";
  560. case FIRAuthErrorCodeInvalidVerificationCode:
  561. return @"ERROR_INVALID_VERIFICATION_CODE";
  562. case FIRAuthErrorCodeMissingVerificationID:
  563. return @"ERROR_MISSING_VERIFICATION_ID";
  564. case FIRAuthErrorCodeInvalidVerificationID:
  565. return @"ERROR_INVALID_VERIFICATION_ID";
  566. case FIRAuthErrorCodeSessionExpired:
  567. return @"ERROR_SESSION_EXPIRED";
  568. case FIRAuthErrorCodeMissingAppCredential:
  569. return @"MISSING_APP_CREDENTIAL";
  570. case FIRAuthErrorCodeInvalidAppCredential:
  571. return @"INVALID_APP_CREDENTIAL";
  572. case FIRAuthErrorCodeQuotaExceeded:
  573. return @"ERROR_QUOTA_EXCEEDED";
  574. case FIRAuthErrorCodeMissingAppToken:
  575. return @"ERROR_MISSING_APP_TOKEN";
  576. case FIRAuthErrorCodeNotificationNotForwarded:
  577. return @"ERROR_NOTIFICATION_NOT_FORWARDED";
  578. case FIRAuthErrorCodeAppNotVerified:
  579. return @"ERROR_APP_NOT_VERIFIED";
  580. case FIRAuthErrorCodeCaptchaCheckFailed:
  581. return @"ERROR_CAPTCHA_CHECK_FAILED";
  582. case FIRAuthErrorCodeWebContextAlreadyPresented:
  583. return @"ERROR_WEB_CONTEXT_ALREADY_PRESENTED";
  584. case FIRAuthErrorCodeWebContextCancelled:
  585. return @"ERROR_WEB_CONTEXT_CANCELLED";
  586. case FIRAuthErrorCodeInvalidClientID:
  587. return @"ERROR_INVALID_CLIENT_ID";
  588. case FIRAuthErrorCodeAppVerificationUserInteractionFailure:
  589. return @"ERROR_APP_VERIFICATION_FAILED";
  590. case FIRAuthErrorCodeWebNetworkRequestFailed:
  591. return @"ERROR_WEB_NETWORK_REQUEST_FAILED";
  592. case FIRAuthErrorCodeNullUser:
  593. return @"ERROR_NULL_USER";
  594. case FIRAuthErrorCodeInvalidDynamicLinkDomain:
  595. return @"ERROR_INVALID_DYNAMIC_LINK_DOMAIN";
  596. case FIRAuthErrorCodeWebInternalError:
  597. return @"ERROR_WEB_INTERNAL_ERROR";
  598. case FIRAuthErrorCodeMalformedJWT:
  599. return @"ERROR_MALFORMED_JWT";
  600. }
  601. }
  602. @implementation FIRAuthErrorUtils
  603. + (NSError *)errorWithCode:(FIRAuthInternalErrorCode)code {
  604. return [self errorWithCode:code message:nil];
  605. }
  606. + (NSError *)errorWithCode:(FIRAuthInternalErrorCode)code
  607. message:(nullable NSString *)message {
  608. NSDictionary *userInfo = nil;
  609. if (message.length) {
  610. userInfo = @{
  611. NSLocalizedDescriptionKey : message
  612. };
  613. }
  614. return [self errorWithCode:code userInfo:userInfo];
  615. }
  616. + (NSError *)errorWithCode:(FIRAuthInternalErrorCode)code
  617. underlyingError:(nullable NSError *)underlyingError {
  618. NSDictionary *errorUserInfo = nil;
  619. if (underlyingError) {
  620. errorUserInfo = @{
  621. NSUnderlyingErrorKey : underlyingError
  622. };
  623. }
  624. return [self errorWithCode:code userInfo:errorUserInfo];
  625. }
  626. + (NSError *)errorWithCode:(FIRAuthInternalErrorCode)code
  627. userInfo:(nullable NSDictionary *)userInfo {
  628. BOOL isPublic = (code & FIRAuthPublicErrorCodeFlag) == FIRAuthPublicErrorCodeFlag;
  629. if (isPublic) {
  630. // This is a public error. Return it as a public error and add a description.
  631. NSInteger errorCode = code & ~FIRAuthPublicErrorCodeFlag;
  632. NSMutableDictionary *errorUserInfo = [NSMutableDictionary dictionaryWithDictionary:userInfo];
  633. if (!errorUserInfo[NSLocalizedDescriptionKey]) {
  634. errorUserInfo[NSLocalizedDescriptionKey] = FIRAuthErrorDescription(errorCode);
  635. }
  636. errorUserInfo[FIRAuthErrorNameKey] = FIRAuthErrorCodeString(errorCode);
  637. return [NSError errorWithDomain:FIRAuthErrorDomain code:errorCode userInfo:errorUserInfo];
  638. } else {
  639. // This is an internal error. Wrap it in an internal error.
  640. NSError *error =
  641. [NSError errorWithDomain:FIRAuthInternalErrorDomain code:code userInfo:userInfo];
  642. return [self errorWithCode:FIRAuthInternalErrorCodeInternalError underlyingError:error];
  643. }
  644. }
  645. + (NSError *)RPCRequestEncodingErrorWithUnderlyingError:(NSError *)underlyingError {
  646. return [self errorWithCode:FIRAuthInternalErrorCodeRPCRequestEncodingError
  647. underlyingError:underlyingError];
  648. }
  649. + (NSError *)JSONSerializationErrorForUnencodableType {
  650. return [self errorWithCode:FIRAuthInternalErrorCodeJSONSerializationError];
  651. }
  652. + (NSError *)JSONSerializationErrorWithUnderlyingError:(NSError *)underlyingError {
  653. return [self errorWithCode:FIRAuthInternalErrorCodeJSONSerializationError
  654. underlyingError:underlyingError];
  655. }
  656. + (NSError *)networkErrorWithUnderlyingError:(NSError *)underlyingError {
  657. return [self errorWithCode:FIRAuthInternalErrorCodeNetworkError
  658. underlyingError:underlyingError];
  659. }
  660. + (NSError *)unexpectedErrorResponseWithData:(NSData *)data
  661. underlyingError:(NSError *)underlyingError {
  662. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedErrorResponse userInfo:@{
  663. FIRAuthErrorUserInfoDataKey : data,
  664. NSUnderlyingErrorKey : underlyingError
  665. }];
  666. }
  667. + (NSError *)unexpectedErrorResponseWithDeserializedResponse:(id)deserializedResponse {
  668. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedErrorResponse userInfo:@{
  669. FIRAuthErrorUserInfoDeserializedResponseKey : deserializedResponse
  670. }];
  671. }
  672. + (NSError *)malformedJWTErrorWithToken:(NSString *)token
  673. underlyingError:(NSError *_Nullable)underlyingError {
  674. NSMutableDictionary *userInfo =
  675. [NSMutableDictionary dictionaryWithObject:kFIRAuthErrorMessageMalformedJWT
  676. forKey:NSLocalizedDescriptionKey];
  677. [userInfo setObject:token forKey:FIRAuthErrorUserInfoDataKey];
  678. if (underlyingError != nil) {
  679. [userInfo setObject:underlyingError forKey:NSUnderlyingErrorKey];
  680. }
  681. return [self errorWithCode:FIRAuthInternalErrorCodeMalformedJWT userInfo:[userInfo copy]];
  682. }
  683. + (NSError *)unexpectedResponseWithData:(NSData *)data
  684. underlyingError:(NSError *)underlyingError {
  685. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedResponse userInfo:@{
  686. FIRAuthErrorUserInfoDataKey : data,
  687. NSUnderlyingErrorKey : underlyingError
  688. }];
  689. }
  690. + (NSError *)unexpectedResponseWithDeserializedResponse:(id)deserializedResponse {
  691. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedResponse userInfo:@{
  692. FIRAuthErrorUserInfoDeserializedResponseKey : deserializedResponse
  693. }];
  694. }
  695. + (NSError *)unexpectedResponseWithDeserializedResponse:(nullable id)deserializedResponse
  696. underlyingError:(NSError *)underlyingError {
  697. NSMutableDictionary *userInfo =
  698. [NSMutableDictionary dictionaryWithDictionary:@{ NSUnderlyingErrorKey : underlyingError }];
  699. if (deserializedResponse) {
  700. userInfo[FIRAuthErrorUserInfoDeserializedResponseKey] = deserializedResponse;
  701. }
  702. return [self errorWithCode:FIRAuthInternalErrorCodeUnexpectedResponse userInfo:userInfo];
  703. }
  704. + (NSError *)RPCResponseDecodingErrorWithDeserializedResponse:(id)deserializedResponse
  705. underlyingError:(NSError *)underlyingError {
  706. return [self errorWithCode:FIRAuthInternalErrorCodeRPCResponseDecodingError userInfo:@{
  707. FIRAuthErrorUserInfoDeserializedResponseKey : deserializedResponse,
  708. NSUnderlyingErrorKey : underlyingError
  709. }];
  710. }
  711. + (NSError *)emailAlreadyInUseErrorWithEmail:(nullable NSString *)email {
  712. NSMutableDictionary *userInfo = [[NSMutableDictionary alloc] init];
  713. if (email.length) {
  714. userInfo[FIRAuthErrorUserInfoEmailKey] = email;
  715. }
  716. return [self errorWithCode:FIRAuthInternalErrorCodeEmailAlreadyInUse userInfo:userInfo];
  717. }
  718. + (NSError *)userDisabledErrorWithMessage:(nullable NSString *)message {
  719. return [self errorWithCode:FIRAuthInternalErrorCodeUserDisabled message:message];
  720. }
  721. + (NSError *)wrongPasswordErrorWithMessage:(nullable NSString *)message {
  722. return [self errorWithCode:FIRAuthInternalErrorCodeWrongPassword message:message];
  723. }
  724. + (NSError *)tooManyRequestsErrorWithMessage:(nullable NSString *)message {
  725. return [self errorWithCode:FIRAuthInternalErrorCodeTooManyRequests message:message];
  726. }
  727. + (NSError *)invalidCustomTokenErrorWithMessage:(nullable NSString *)message {
  728. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidCustomToken message:message];
  729. }
  730. + (NSError *)customTokenMistmatchErrorWithMessage:(nullable NSString *)message {
  731. return [self errorWithCode:FIRAuthInternalErrorCodeCustomTokenMismatch message:message];
  732. }
  733. + (NSError *)invalidCredentialErrorWithMessage:(nullable NSString *)message {
  734. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidCredential message:message];
  735. }
  736. + (NSError *)requiresRecentLoginErrorWithMessage:(nullable NSString *)message {
  737. return [self errorWithCode:FIRAuthInternalErrorCodeRequiresRecentLogin message:message];
  738. }
  739. + (NSError *)invalidUserTokenErrorWithMessage:(nullable NSString *)message {
  740. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidUserToken message:message];
  741. }
  742. + (NSError *)invalidEmailErrorWithMessage:(nullable NSString *)message {
  743. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidEmail message:message];
  744. }
  745. + (NSError *)accountExistsWithDifferentCredentialErrorWithEmail:(nullable NSString *)email {
  746. return [self errorWithCode:FIRAuthInternalErrorCodeAccountExistsWithDifferentCredential
  747. userInfo:@{ FIRAuthErrorUserInfoEmailKey : email }];
  748. }
  749. + (NSError *)providerAlreadyLinkedError {
  750. return [self errorWithCode:FIRAuthInternalErrorCodeProviderAlreadyLinked];
  751. }
  752. + (NSError *)noSuchProviderError {
  753. return [self errorWithCode:FIRAuthInternalErrorCodeNoSuchProvider];
  754. }
  755. + (NSError *)userTokenExpiredErrorWithMessage:(nullable NSString *)message {
  756. return [self errorWithCode:FIRAuthInternalErrorCodeUserTokenExpired message:message];
  757. }
  758. + (NSError *)userNotFoundErrorWithMessage:(nullable NSString *)message {
  759. return [self errorWithCode:FIRAuthInternalErrorCodeUserNotFound message:message];
  760. }
  761. + (NSError *)invalidAPIKeyError {
  762. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidAPIKey];
  763. }
  764. + (NSError *)userMismatchError {
  765. return [self errorWithCode:FIRAuthInternalErrorCodeUserMismatch];
  766. }
  767. + (NSError *)credentialAlreadyInUseErrorWithMessage:(nullable NSString *)message
  768. credential:(nullable FIRPhoneAuthCredential *)credential {
  769. if (credential) {
  770. return [self errorWithCode:FIRAuthInternalErrorCodeCredentialAlreadyInUse
  771. userInfo:@{ FIRAuthUpdatedCredentialKey : credential }];
  772. }
  773. return [self errorWithCode:FIRAuthInternalErrorCodeCredentialAlreadyInUse message:message];
  774. }
  775. + (NSError *)operationNotAllowedErrorWithMessage:(nullable NSString *)message {
  776. return [self errorWithCode:FIRAuthInternalErrorCodeOperationNotAllowed message:message];
  777. }
  778. + (NSError *)weakPasswordErrorWithServerResponseReason:(nullable NSString *)reason {
  779. return [self errorWithCode:FIRAuthInternalErrorCodeWeakPassword userInfo:@{
  780. NSLocalizedFailureReasonErrorKey : reason
  781. }];
  782. }
  783. + (NSError *)appNotAuthorizedError {
  784. return [self errorWithCode:FIRAuthInternalErrorCodeAppNotAuthorized];
  785. }
  786. + (NSError *)expiredActionCodeErrorWithMessage:(nullable NSString *)message {
  787. return [self errorWithCode:FIRAuthInternalErrorCodeExpiredActionCode message:message];
  788. }
  789. + (NSError *)invalidActionCodeErrorWithMessage:(nullable NSString *)message {
  790. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidActionCode message:message];
  791. }
  792. + (NSError *)invalidMessagePayloadErrorWithMessage:(nullable NSString *)message {
  793. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidMessagePayload message:message];
  794. }
  795. + (NSError *)invalidSenderErrorWithMessage:(nullable NSString *)message {
  796. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidSender message:message];
  797. }
  798. + (NSError *)invalidRecipientEmailErrorWithMessage:(nullable NSString *)message {
  799. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidRecipientEmail message:message];
  800. }
  801. + (NSError *)missingIosBundleIDErrorWithMessage:(nullable NSString *)message {
  802. return [self errorWithCode:FIRAuthinternalErrorCodeMissingIosBundleID message:message];
  803. }
  804. + (NSError *)missingAndroidPackageNameErrorWithMessage:(nullable NSString *)message {
  805. return [self errorWithCode:FIRAuthInternalErrorCodeMissingAndroidPackageName message:message];
  806. }
  807. + (NSError *)unauthorizedDomainErrorWithMessage:(nullable NSString *)message {
  808. return [self errorWithCode:FIRAuthInternalErrorCodeUnauthorizedDomain message:message];
  809. }
  810. + (NSError *)invalidContinueURIErrorWithMessage:(nullable NSString *)message {
  811. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidContinueURI message:message];
  812. }
  813. + (NSError *)missingContinueURIErrorWithMessage:(nullable NSString *)message {
  814. return[self errorWithCode:FIRAuthInternalErrorCodeMissingContinueURI message:message];
  815. }
  816. + (NSError *)missingEmailErrorWithMessage:(nullable NSString *)message {
  817. return [self errorWithCode:FIRAuthInternalErrorCodeMissingEmail message:message];
  818. }
  819. + (NSError *)missingPhoneNumberErrorWithMessage:(nullable NSString *)message {
  820. return [self errorWithCode:FIRAuthInternalErrorCodeMissingPhoneNumber message:message];
  821. }
  822. + (NSError *)invalidPhoneNumberErrorWithMessage:(nullable NSString *)message {
  823. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidPhoneNumber message:message];
  824. }
  825. + (NSError *)missingVerificationCodeErrorWithMessage:(nullable NSString *)message {
  826. return [self errorWithCode:FIRAuthInternalErrorCodeMissingVerificationCode message:message];
  827. }
  828. + (NSError *)invalidVerificationCodeErrorWithMessage:(nullable NSString *)message {
  829. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidVerificationCode message:message];
  830. }
  831. + (NSError *)missingVerificationIDErrorWithMessage:(nullable NSString *)message {
  832. return [self errorWithCode:FIRAuthInternalErrorCodeMissingVerificationID message:message];
  833. }
  834. + (NSError *)invalidVerificationIDErrorWithMessage:(nullable NSString *)message {
  835. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidVerificationID message:message];
  836. }
  837. + (NSError *)sessionExpiredErrorWithMessage:(nullable NSString *)message {
  838. return [self errorWithCode:FIRAuthInternalErrorCodeSessionExpired message:message];
  839. }
  840. + (NSError *)missingAppCredentialWithMessage:(nullable NSString *)message {
  841. return [self errorWithCode:FIRAuthInternalErrorCodeMissingAppCredential message:message];
  842. }
  843. + (NSError *)invalidAppCredentialWithMessage:(nullable NSString *)message {
  844. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidAppCredential message:message];
  845. }
  846. + (NSError *)quotaExceededErrorWithMessage:(nullable NSString *)message {
  847. return [self errorWithCode:FIRAuthInternalErrorCodeQuotaExceeded message:message];
  848. }
  849. + (NSError *)missingAppTokenErrorWithUnderlyingError:(nullable NSError *)underlyingError {
  850. return [self errorWithCode:FIRAuthInternalErrorCodeMissingAppToken
  851. underlyingError:underlyingError];
  852. }
  853. + (NSError *)notificationNotForwardedError {
  854. return [self errorWithCode:FIRAuthInternalErrorCodeNotificationNotForwarded];
  855. }
  856. + (NSError *)appNotVerifiedErrorWithMessage:(nullable NSString *)message {
  857. return [self errorWithCode:FIRAuthInternalErrorCodeAppNotVerified message:message];
  858. }
  859. + (NSError *)captchaCheckFailedErrorWithMessage:(nullable NSString *)message {
  860. return [self errorWithCode:FIRAuthInternalErrorCodeCaptchaCheckFailed message:message];
  861. }
  862. + (NSError *)webContextAlreadyPresentedErrorWithMessage:(nullable NSString *)message {
  863. return [self errorWithCode:FIRAuthInternalErrorCodeWebContextAlreadyPresented message:message];
  864. }
  865. + (NSError *)webContextCancelledErrorWithMessage:(nullable NSString *)message {
  866. return [self errorWithCode:FIRAuthInternalErrorCodeWebContextCancelled message:message];
  867. }
  868. + (NSError *)appVerificationUserInteractionFailureWithReason:(NSString *)reason {
  869. return [self errorWithCode:FIRAuthInternalErrorCodeAppVerificationUserInteractionFailure
  870. userInfo:@{
  871. NSLocalizedFailureReasonErrorKey : reason
  872. }];
  873. }
  874. + (nullable NSError *)URLResponseErrorWithCode:(NSString *)code message:(nullable NSString *)message {
  875. if ([code isEqualToString:kURLResponseErrorCodeInvalidClientID]) {
  876. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidClientID message:message];
  877. }
  878. if ([code isEqualToString:kURLResponseErrorCodeNetworkRequestFailed]) {
  879. return [self errorWithCode:FIRAuthInternalErrorCodeWebNetworkRequestFailed message:message];
  880. }
  881. if ([code isEqualToString:kURLResponseErrorCodeInternalError]) {
  882. return [self errorWithCode:FIRAuthInternalErrorCodeWebInternalError message:message];
  883. }
  884. return nil;
  885. }
  886. + (NSError *)nullUserErrorWithMessage:(nullable NSString *)message {
  887. return [self errorWithCode:FIRAuthInternalErrorCodeNullUser message:message];
  888. }
  889. + (NSError *)invalidDynamicLinkDomainErrorWithMessage:(nullable NSString *)message {
  890. return [self errorWithCode:FIRAuthInternalErrorCodeInvalidDynamicLinkDomain message:message];
  891. }
  892. + (NSError *)keychainErrorWithFunction:(NSString *)keychainFunction status:(OSStatus)status {
  893. NSString *failureReason = [NSString stringWithFormat:@"%@ (%li)", keychainFunction, (long)status];
  894. return [self errorWithCode:FIRAuthInternalErrorCodeKeychainError userInfo:@{
  895. NSLocalizedFailureReasonErrorKey : failureReason,
  896. }];
  897. }
  898. @end
  899. NS_ASSUME_NONNULL_END