(phDSrSSKrSSKJr SSKrSSKJr SSKrSSKJ r SSKJ r SSKJ r SSKJ r SS K Jr S rS r\R""S 5r"S S 5r\"S5r"SS5r"SS5r"SS\5r"SS\5r"SS5r"SS5r"SS5r"SS5r"SS \5r"S!S"5rS#r"S$S%5r "S&S'\ RB5r"g)(z$Firebase user management sub module.N) defaultdict)parse) _auth_utils)_rfc3339)_user_identifier) _user_import) ErrorInfosREDACTEDc\rSrSrSrSrg)Sentinel$cXlgN description)selfrs K/var/www/html/venv/lib/python3.13/site-packages/firebase_admin/_user_mgt.py__init__Sentinel.__init__&s&rN)__name__ __module__ __qualname____firstlineno__r__static_attributes__rrr r $s'rr z5Value used to delete an attribute from a user profilecV\rSrSrSrS Sjr\S5r\S5r\S5r Sr g) UserMetadata-z$'2'E'E "$<(>$rcUR$)zCreation timestamp in milliseconds since the epoch. Returns: integer: The user creation timestamp in milliseconds since the epoch. )r%rs rr!UserMetadata.creation_timestamp9s'''rcUR$)zLast sign in timestamp in milliseconds since the epoch. Returns: integer: The last sign in timestamp in milliseconds since the epoch. )r&r*s rr"#UserMetadata.last_sign_in_timestampBs+++rcUR$)zThe time at which the user was last active (ID token refreshed). Returns: integer: Milliseconds since epoch timestamp, or `None` if the user was never active. )r'r*s rr##UserMetadata.last_refresh_timestampKs+++r)r%r'r&)NNN) rrrr__doc__rpropertyr!r"r#rrrrrr-sLFGK(,>((,,,,rrcx\rSrSrSr\S5r\S5r\S5r\S5r \S5r \S5r S r g ) UserInfoVzA collection of standard profile information for a user. Used to expose profile information returned by an identity provider. c[e)z!Returns the user ID of this user.NotImplementedErrorr*s ruid UserInfo.uid\ "!rc[e)z&Returns the display name of this user.r6r*s r display_nameUserInfo.display_namear:rc[e)z4Returns the email address associated with this user.r6r*s remailUserInfo.emailfr:rc[e)z3Returns the phone number associated with this user.r6r*s r phone_numberUserInfo.phone_numberkr:rc[e)z#Returns the photo URL of this user.r6r*s r photo_urlUserInfo.photo_urlpr:rc[e)zReturns the ID of the identity provider. This can be a short domain name (e.g. google.com), or the identity of an OpenID identity provider. r6r*s r provider_idUserInfo.provider_idus "!rrN) rrrrr0r1r8r<r?rBrErHrrrrr3r3Vs """"""""""""rr3c^\rSrSrSrU4Sjr\S5r\S5r\S5r \S5r \S5r \S 5r \S 5r \S 5r\S 5r\S 5r\S5r\S5r\S5rSrU=r$) UserRecordz:Contains metadata associated with a Firebase user account.c>[[U] 5 [U[5(d[ SR U55eURS5(d [ S5eXlg)N1Invalid data argument: {0}. Must be a dictionary.localId"User ID must not be None or empty.) superrKr isinstancedict ValueErrorformatget_datardata __class__s rrUserRecord.__init__sU j$(*$%%PWWX\]^ ^xx ""AB B rc8URRS5$)zkReturns the user ID of this user. Returns: string: A user ID string. This value is never None or empty. rOrWrVr*s rr8UserRecord.uidszz~~i((rc8URRS5$)zZReturns the display name of this user. Returns: string: A display name string or None. displayNamer]r*s rr<UserRecord.display_namezz~~m,,rc8URRS5$)zjReturns the email address associated with this user. Returns: string: An email address string or None. r?r]r*s rr?UserRecord.emailszz~~g&&rc8URRS5$)zgReturns the phone number associated with this user. Returns: string: A phone number string or None. phoneNumberr]r*s rrBUserRecord.phone_numberrbrc8URRS5$)zNReturns the photo URL of this user. Returns: string: A URL string or None. photoUrlr]r*s rrEUserRecord.photo_urlzz~~j))rcg)zXReturns the provider ID of this user. Returns: string: A constant provider ID value. firebaserr*s rrHUserRecord.provider_idsrcJ[URRS55$)zReturns whether the email address of this user has been verified. Returns: bool: True if the email has been verified, and False otherwise. emailVerifiedboolrWrVr*s remail_verifiedUserRecord.email_verifiedsDJJNN?344rcJ[URRS55$)z|Returns whether this user account is disabled. Returns: bool: True if the user account is disabled, and False otherwise. disabledrqr*s rrvUserRecord.disabledsDJJNN:.//rc\URRS5nUbS[U5-$g)aReturns the time, in milliseconds since the epoch, before which tokens are invalid. Note: this is truncated to 1 second accuracy. Returns: int: Timestamp in milliseconds since the epoch, truncated to the second. All tokens issued before that time are considered revoked. validSincer r)rWrVint)r valid_sinces rtokens_valid_after_timestamp'UserRecord.tokens_valid_after_timestamps/jjnn\2  "#k** *rc^U4SjnSnTRRSS5nU(a"[[R"U5S-5n[ U"S5U"S5U5$)zReturns additional metadata associated with this user. Returns: UserMetadata: A UserMetadata instance. Does not return None. cV>UTR;a[TRU5$gr)rWrz)keyrs r _int_or_none.UserRecord.user_metadata.._int_or_nones%djj 4::c?++rN lastRefreshAtr createdAt lastLoginAt)rWrVrzrparse_to_epochr)rrlast_refresh_at_millislast_refresh_at_rfc3339s` r user_metadataUserRecord.user_metadatasf "&"&**..$"G "%()@)@AX)Y\`)`%a "  %|M'BDZ\ \rc|URRS/5nUVs/sHn[U5PM sn$s snf)zReturns a list of UserInfo instances. Each object represents an identity from an identity provider that is linked to this user. Returns: list: A list of UserInfo objects, which may be empty. providerUserInfo)rWrVProviderUserInfo)r providersentrys r provider_dataUserRecord.provider_datas7JJNN#5r: 5>?YE 'Y???s9cURRS5nU(a[R"U5nU0:waU$g)zfReturns any custom claims set on this user account. Returns: dict: A dictionary of claims or None. customAttributesN)rWrVjsonloads)rclaimsparseds r custom_claimsUserRecord.custom_claimss7 23 ZZ'F| rc8URRS5$)zTReturns the tenant ID of this user. Returns: string: A tenant ID string or None. tenantIdr]r*s r tenant_idUserRecord.tenant_id rkrrW)rrrrr0rr1r8r<r?rBrErHrsrvr|rrrrr __classcell__rZs@rrKrKsD))--''--**5500  \\" @ @  **rrKc8\rSrSrSr\S5r\S5rSrg)ExportedUserRecordizJContains metadata associated with a user including password hash and salt.cRURRS5nU[:XagU$)aThe user's password hash as a base64-encoded string. If the Firebase Auth hashing algorithm (SCRYPT) was used to create the user account, this is the base64-encoded password hash of the user. If a different hashing algorithm was used to create this user, as is typical when migrating from another Auth system, this is an empty string. If no password is set, or if the service account doesn't have permission to read the password, then this is ``None``. passwordHashN)rWrV B64_REDACTED)r password_hashs rr ExportedUserRecord.password_hashs) ~6 L (rc8URRS5$)aThe user's password salt as a base64-encoded string. If the Firebase Auth hashing algorithm (SCRYPT) was used to create the user account, this is the base64-encoded password salt of the user. If a different hashing algorithm was used to create this user, as is typical when migrating from another Auth system, this is an empty string. If no password is set, or if the service account doesn't have permission to read the password, then this is ``None``. saltr]r*s r password_salt ExportedUserRecord.password_salt-szz~~f%%rrN) rrrrr0r1rrrrrrrrs+T $ & &rrc>\rSrSrSrSr\S5r\S5rSr g)GetUsersResulti:z6Represents the result of the ``auth.get_users()`` API.cXlX lg)zConstructs a `GetUsersResult` object. Args: users: List of `UserRecord` instances. not_found: List of `UserIdentifier` instances. N)_users _not_found)rusers not_founds rrGetUsersResult.__init__=s #rcUR$)zSet of `UserRecord` instances, corresponding to the set of users that were requested. Only users that were found are listed here. The result set is unordered. )rr*s rrGetUsersResult.usersGs {{rcUR$)zFSet of `UserIdentifier` instances that were requested, but not found. )rr*s rrGetUsersResult.not_foundOs r)rrN) rrrrr0rr1rrrrrrrr:s2@$rrcZ\rSrSrSrSr\S5r\S5r\S5r Sr Sr S r g ) ListUsersPageiWaDRepresents a page of user records exported from a Firebase project. Provides methods for traversing the user accounts included in this page, as well as retrieving subsequent pages of users. The iterator returned by ``iterate_all()`` can be used to iterate through all users in the Firebase project starting from this page. c6XlX0lU"X#5Ulgr) _download _max_results_current)rdownload page_token max_resultss rrListUsersPage.__init___s!' 9 rcxURRS/5Vs/sHn[U5PM sn$s snf)zBA list of ``ExportedUserRecord`` instances available in this page.r)rrVr)rusers rrListUsersPage.usersds66:]]5F5FwPR5ST5ST"4(5STTTs7c:URRSS5$)zKPage token string for the next page (empty string indicates no more pages). nextPageToken)rrVr*s rnext_page_tokenListUsersPage.next_page_tokenis}}  "55rc,[UR5$)z6A boolean indicating whether more pages are available.)rrrr*s r has_next_pageListUsersPage.has_next_pagensD(())rc|UR(a+[URURUR5$g)zRetrieves the next page of user accounts, if available. Returns: ListUsersPage: Next page of users, or None if this is the last page. N)rrrrrr*s r get_next_pageListUsersPage.get_next_pagess/    1E1EtGXGXY Yrc[U5$)a-Retrieves an iterator for user accounts. Returned iterator will iterate through all the user accounts in the Firebase project starting from this page. The iterator will never buffer more than one page of users in memory at a time. Returns: iterator: An iterator of ExportedUserRecord instances. ) _UserIteratorr*s r iterate_allListUsersPage.iterate_all}sT""r)rrrN) rrrrr0rr1rrrrrrrrrrrWsT: UU66** #rrcN\rSrSrSrSr\S5r\S5r\S5r Sr g) DeleteUsersResultiz9Represents the result of the ``auth.delete_users()`` API.cnURnU[U5- Ul[U5UlX0lg)zConstructs a `DeleteUsersResult` object. Args: result: The proto response, wrapped in a `BatchDeleteAccountsResponse` instance. total: Total integer number of deletion attempts. N)errorslen_success_count_failure_count_errors)rresulttotalrs rrDeleteUsersResult.__init__s/#c&k1!&k rcUR$)zReturns the number of users that were deleted successfully (possibly zero). Users that did not exist prior to calling `delete_users()` are considered to be successfully deleted. )rr*s r success_countDeleteUsersResult.success_counts"""rcUR$)zGReturns the number of users that failed to be deleted (possibly zero). )rr*s r failure_countDeleteUsersResult.failure_counts """rcUR$)zA list of `auth.ErrorInfo` instances describing the errors that were encountered during the deletion. Length of this list is equal to `failure_count`. )rr*s rrDeleteUsersResult.errorss ||r)rrrN) rrrrr0rr1rrrrrrrrrsFC #### rrc"\rSrSrSrSSjrSrg)BatchDeleteAccountsResponseiz2Represents the results of a `delete_users()` call.NcnU(a"UVs/sHn[U5PM snUlg/Ulgs snf)a1Constructs a `BatchDeleteAccountsResponse` instance, corresponding to the JSON representing the `BatchDeleteAccountsResponse` proto. Args: errors: List of dictionaries, with each dictionary representing an `ErrorInfo` instance as returned by the server. `None` implies an empty list. N)r r)rrerrs rr$BatchDeleteAccountsResponse.__init__s*=C8#y~8  8s2)rrrrrrr0rrrrrrrs < Krrc^\rSrSrSrU4Sjr\S5r\S5r\S5r \S5r \S5r \S 5r S r U=r$) rizRContains metadata regarding how a user is known by a particular identity provider.c>[[U] 5 [U[5(d[ SR U55eURS5(d [ S5eXlg)NrNrawIdrP) rQrrrRrSrTrUrVrWrXs rrProviderUserInfo.__init__sV .0$%%PWWX\]^ ^xx  AB B rc8URRS5$)Nrr]r*s rr8ProviderUserInfo.uidzz~~g&&rc8URRS5$)Nr`r]r*s rr<ProviderUserInfo.display_namezz~~m,,rc8URRS5$)Nr?r]r*s rr?ProviderUserInfo.emailrrc8URRS5$)Nrfr]r*s rrBProviderUserInfo.phone_numberrrc8URRS5$)Nrir]r*s rrEProviderUserInfo.photo_urlszz~~j))rc8URRS5$)N providerIdr]r*s rrHProviderUserInfo.provider_idszz~~l++rr)rrrrr0rr1r8r<r?rBrErHrrrs@rrrs\''--''--**,,rrc&\rSrSrSrSSjrSrg)ActionCodeSettingsizContains required continue/state URL with optional Android and iOS settings. Used when invoking the email action link generation APIs. NcXXlX lX0lX@lXPlX`lXplgr)urlhandle_code_in_appdynamic_link_domain ios_bundle_idandroid_package_nameandroid_install_appandroid_minimum_version)rrrrrrrr s rrActionCodeSettings.__init__s+"4#6 *$8!#6 '>$r)rr rrrrr)NNNNNNrrrrrrs^b^b?rrc`0nUR(d [S5e[R"UR5nUR(d$[SR UR55eURUS'URbR[UR[5(d$[SR UR55eURUS'URbR[UR[5(d$[SR UR55eURUS'URbR[UR[5(d$[SR UR55eURUS 'UR(dUR(aUR(d [S 5eURbR[UR[5(d$[S R UR55eURUS 'URbR[UR[5(d$[S R UR55eURUS'URbR[UR[5(d$[SR UR55eURUS'U$![ a% [SR UR55ef=f)zValidates the provided action code settings for email link generation and populates the REST api parameters. settings - ``ActionCodeSettings`` object provided to be encoded returns - dict of parameters to be passed for link gereration. z%Dynamic action links url is mandatoryz*Malformed dynamic action links url: "{0}". continueUrlz2Invalid value provided for handle_code_in_app: {0}canHandleCodeInAppz3Invalid value provided for dynamic_link_domain: {0}dynamicLinkDomainz-Invalid value provided for ios_bundle_id: {0} iOSBundleIdzGAndroid package name is required when specifying other Android settingsz4Invalid value provided for android_package_name: {0}androidPackageNamez7Invalid value provided for android_minimum_version: {0}androidMinimumVersionz3Invalid value provided for android_install_app: {0}androidInstallApp)rrTrurlparsenetlocrU ExceptionrrRrrrstrrr rr)settings parametersrs rencode_action_code_settingsrsJ <<@AA\ -}}IPPQYQ]Q]^_ _$,LL =! "".(55t<<Q$fX%@%@AC C+3+F+F '(##/(66<<R$fX%A%ABD D*2*F*F &')(00#66L$fX%;%;<> >$,$:$: =! ((H,H,H--bcc$$0(77==S$fX%B%BCE E+3+H+H '(''3(::C@@V$fX%E%EFH H.6.N.N *+##/(66==R$fX%A%ABD D*2*F*F &' _ \ELLX\\Z[[\s A$K>>/L-c\rSrSrSrSrSSjrSrSrS\ 4Sjr SS jr SS jr S r SS jrSS jrSSjrSrSrg) UserManageri;zBProvides methods for interacting with the Google Identity Toolkit.z)https://identitytoolkit.googleapis.com/v1NcXlU=(d URnSRXR5UlU(a%U=RSRU5- slgg)Nz{0}/projects/{1}z /tenants/{0}) http_clientID_TOOLKIT_URLrUbase_url)rr project_idr url_override url_prefixs rrUserManager.__init__@sK&!8T%8%8 *11*I  MM^229= =M rc SU;a+URS5Sp2S[R"USS9/0nO|SU;a+URS5Sp2S[R"USS9/0nOKSU;a+URS5Sp2S [R"USS9/0nO[ S R U55eURS S US 9upVU(aURS5(d$[R"SR X25US9eUSS$)z5Gets the user data corresponding to the provided key.r8zuser IDrOTrequiredr?rBz phone numberrfz#Unsupported keyword arguments: {0}.post/accounts:lookuprrz/No user record found for the provided {0}: {1}. http_responser) popr validate_uidvalidate_emailvalidate_phone TypeErrorrU _make_requestrVUserNotFoundError)rkwargsrkey_typepayloadbody http_resps rget_userUserManager.get_userGs F?"JJu-y K$<$? ? ?k,BBv457 7 - '1O $$$U,@$Q rc J[R"U5[R"U5[R"U5[R"U5[R "U5[R "U5Ub [U5OSUb [U5OSS.n U R5V V s0sH upU cM X_M n n n URSSU S9upU (aU RS5(d[R"SU S9eU RS5$s sn n f) z9Creates a new user account with the specified properties.N)rOr`r?rfripasswordrprvr'z /accountsr)rOzFailed to create new user.r*) rr-validate_display_namer.r/validate_photo_urlvalidate_passwordrritemsr1rVrF)rr8r<r?rBrErTrvrsr5kvr6r7s r create_userUserManager.create_users#//4&<<\J //6&55lC#66yA#55h?5C5OT.1UY*2*>XD  %,MMOEODAq414OE,,V[w,O488I..55,IG Gxx "" Fs 3 DDc [R"USS9[R"U5[R"U5[R"U S5Ub [ U5OSUb [ U5OSS.n /n [R "U 5nUb4U[LaU RS5 O[R"U5U S'Ub4U[LaU RS5 O[R"U5U S 'U (aXS 'Ub4U[LaURS 5 O[R"U5U S 'U bQU [La0n [U [5(a[R"U 5OU n[R "U5U S 'U(a[#[%U55U S'U R'5VVs0sHunnUcM UU_M n nnUR)SSU S9unnU(aUR+S5(d$[R,"SR/U5US9eUR+S5$s snnf)z>Updates an existing user account with the specified propertiesTr%r{N)rOr?rTryrp disableUser DISPLAY_NAMEr` PHOTO_URLrideleteAttributephonerfrdeleteProviderr'z/accounts:updater)rOzFailed to update user: {0}.r*)rr-r.rWr$rrvalidate_provider_idsDELETE_ATTRIBUTEr?rUrVr/rRrSrdumpsvalidate_custom_claimsr=setrXr1rVrFrU)rr8r<r?rBrErTrvrsr{rproviders_to_deleter5removeremove_provider json_claimsrYrZr6r7s r update_userUserManager.update_users #//dC //6#55h?%88mT5C5OT.1UY-5-A4>t  %;;Users must be a non-empty list with no more than {0} elements.z%One or more user objects are invalid.zusers must be iterablerrz> T[[-/00eTe 1l&C&CDDeTUU !HIIV %8%QYY[%89 WW-=>-=!#-=> ? ?h (C(CDD !_`` NN8++- .,,V5LSZ,[$%%55)D D U 756 6 79>s*AE)E,E E32E8EE0cL[R"U5[R"U5SS.nU(aUR[ U55 UR SSUS9upVU(aUR S5(d[R"SUS9eUR S5$) aFetches the email action links for types Args: action_type: String. Valid values ['VERIFY_EMAIL', 'EMAIL_SIGNIN', 'PASSWORD_RESET'] email: Email of the user for which the action is performed action_code_settings: ``ActionCodeSettings`` object or dict (optional). Defines whether the link is to be handled by a mobile app and the additional state information to be passed in the deep link, etc. Returns: link_url: action url to be emailed to the user Raises: UnexpectedResponseError: If the backend server responds with an unexpected message FirebaseError: If an error occurs while generating the link ValueError: If the provided arguments are invalid T) requestTyper? returnOobLinkr'z/accounts:sendOobCoder)oobLinkz%Failed to generate email action link.r*)rvalidate_action_typer.rrr1rVrF)r action_typer?action_code_settingsr5r6r7s rgenerate_email_action_link&UserManager.generate_email_action_link's$';;KH //6!  NN67KL M,,V5LSZ,[488I..557yR Rxx ""rc SRURU5nURR"X40UD6$![R R an[R"U5eSnAff=f)Nz{0}{1}) rUrrbody_and_responserequests exceptionsRequestExceptionrhandle_auth_backend_error)rmethodpathr3rerrors rr1UserManager._make_requestGsdoodmmT2 ?##55fLVL L""33 ?77> > ?s;A4A//A4)rr)NN)NNNNNNNN) NNNNNNNNNN)Fr)rrrrr0rrr8rIrOrQr[rmrqrxrrr1rrrrrr;sfL@N> *-%^%)6L$QUQU#(LPQUNR1#fT"CH.#@?rrc$\rSrSr\S5rSrg)riOc.URR$r) _current_pagerr*s rrX_UserIterator.itemsQs!!'''rrN)rrrrr1rXrrrrrrOs ((rr)#r0base64 collectionsrrurllibrrfirebase_adminrrrrfirebase_admin._user_importr rOr{ b64encoderr rerr3rKrrrrrrrrr PageIteratorrrrrrs+ # &#+'1 , '' ST&,&,R&"&"RU*U*p & &F:0#0#f''T K K!,x!,H ? ? AHQ?Q?h(K,,(r