New Passwords (#127)

* new_passwords2

* Map error codes to login exceptions

* Version

* Tests and cassettes

* Bump version

* New cassettes and resources

* Missing test

* user_credentials

* Update version

* All tests working

* Readme

* Fix

* Version

* more generalized

* clarifications

* correct version of cuenca-validations

* cuenca-validations requirement should be 0.7.*

* ERROR_CODES

Co-authored-by: Felipe López <flh.1989@gmail.com>
Co-authored-by: Matin Tamizi <matin@users.noreply.github.com>

Author: 3 people

README.md

@@ -113,3 +113,40 @@ old_id = cuenca.session.auth[0]
 cuenca.session.configure(new.id, new.secret)
 cuenca.ApiKey.deactivate(old_id, 60)  # revoke prior API key in an hour
 ```
+
+## Login
+
+
+Create a new password
+```python
+cuenca.UserCredential.create(password='1234567890')
+```
+
+To update your password
+```python
+cuenca.UserCredential.update(password='1234567890')
+```
+
+To reset password
+```python
+cuenca.UserCredential.update(password=None)
+```
+
+Login in and out
+```python
+cuenca.UserLogin.create(password='1234567890')
+...  # authenticated operation
+cuenca.UserLogin.logout()
+```
+
+Create login token for biometrics
+```python
+# Must be logged in
+cuenca.UserLogin.create(password='1234567890')
+token = cuenca.LoginToken.create()
+cuenca.UserLogin.logout()
+
+# Then you can use the token which lasts for 7 days
+cuenca.configure(login_token=token)
+...  # authenticated operation
+```

cuenca/__init__.py

@@ -8,9 +8,12 @@
     'CardTransaction',
     'Commission',
     'Deposit',
+    'LoginToken',
     'ServiceProvider',
     'Statement',
     'Transfer',
+    'UserCredential',
+    'UserLogin',
     'WhatsappTransfer',
     'configure',
 ]
@@ -26,9 +29,12 @@
     CardTransaction,
     Commission,
     Deposit,
+    LoginToken,
     ServiceProvider,
     Statement,
     Transfer,
+    UserCredential,
+    UserLogin,
     WhatsappTransfer,
 )
 from .version import __version__

cuenca/http/client.py

@@ -4,6 +4,7 @@
 from urllib.parse import urljoin
 
 import requests
+from cuenca_validations.errors import ERROR_CODES
 from cuenca_validations.typing import (
     ClientRequestParams,
     DictStrAny,
@@ -17,8 +18,6 @@
 
 API_HOST = 'api.cuenca.com'
 SANDBOX_HOST = 'sandbox.cuenca.com'
-AWS_DEFAULT_REGION = 'us-east-1'
-AWS_SERVICE = 'execute-api'
 
 
 class Session:
@@ -52,6 +51,7 @@ def configure(
         api_secret: Optional[str] = None,
         use_jwt: Optional[bool] = False,
         sandbox: Optional[bool] = None,
+        login_token: Optional[str] = None,
     ):
         """
         This allows us to instantiate the http client when importing the
@@ -72,6 +72,9 @@ def configure(
         if use_jwt:
             self.jwt_token = Jwt.create(self)
 
+        if login_token:
+            self.session.headers['X-Cuenca-LoginToken'] = login_token
+
     def get(
         self, endpoint: str, params: ClientRequestParams = None
     ) -> DictStrAny:
@@ -116,6 +119,9 @@ def request(
     def _check_response(response: Response):
         if response.ok:
             return
+        json = response.json()
+        if 'code' in json:
+            raise ERROR_CODES[json['code']](json['error'])
         raise CuencaResponseException(
             json=response.json(),
             status_code=response.status_code,

cuenca/resources/__init__.py

@@ -7,9 +7,11 @@
     'CardTransaction',
     'Commission',
     'Deposit',
+    'LoginToken',
     'ServiceProvider',
     'Statement',
     'Transfer',
+    'UserLogin',
     'WhatsappTransfer',
 ]
 
@@ -21,10 +23,13 @@
 from .cards import Card
 from .commissions import Commission
 from .deposits import Deposit
+from .login_tokens import LoginToken
 from .resources import RESOURCES
 from .service_providers import ServiceProvider
 from .statements import Statement
 from .transfers import Transfer
+from .user_credentials import UserCredential
+from .user_logins import UserLogin
 from .whatsapp_transfers import WhatsappTransfer
 
 # avoid circular imports
@@ -37,9 +42,12 @@
     CardTransaction,
     Commission,
     Deposit,
+    LoginToken,
     ServiceProvider,
     Statement,
     Transfer,
+    UserCredential,
+    UserLogin,
     WhatsappTransfer,
 ]
 for resource_cls in resource_classes:

cuenca/resources/login_tokens.py

@@ -0,0 +1,20 @@
+from typing import ClassVar, cast
+
+from pydantic.dataclasses import dataclass
+
+from ..http import Session, session as global_session
+from .base import Creatable
+
+
+@dataclass
+class LoginToken(Creatable):
+    _resource: ClassVar = 'login_tokens'
+
+    @classmethod
+    def create(cls, session: Session = global_session) -> 'LoginToken':
+        """
+        Use this method to create a token that will last for 7 days
+        Make sure to store this token in a safe place
+        :return: Token that you can use in cuenca.configure
+        """
+        return cast('LoginToken', cls._create(session=session))

cuenca/resources/user_credentials.py

@@ -0,0 +1,46 @@
+import datetime as dt
+from typing import ClassVar, Optional, cast
+
+from cuenca_validations.types.requests import (
+    UserCredentialRequest,
+    UserCredentialUpdateRequest,
+)
+from pydantic.dataclasses import dataclass
+
+from ..http import Session, session as global_session
+from .base import Creatable, Updateable
+
+
+@dataclass
+class UserCredential(Creatable, Updateable):
+    _resource: ClassVar = 'user_credentials'
+
+    is_active: bool
+    created_at: dt.datetime
+
+    @classmethod
+    def create(
+        cls, password: str, *, session: Session = global_session
+    ) -> 'UserCredential':
+        req = UserCredentialRequest(password=password)
+        return cast(
+            'UserCredential', cls._create(**req.dict(), session=session)
+        )
+
+    @classmethod
+    def update(
+        cls,
+        user_id: str = 'me',
+        is_active: Optional[bool] = None,
+        password: Optional[str] = None,
+        *,
+        session: Session = global_session,
+    ) -> 'UserCredential':
+        req = UserCredentialUpdateRequest(
+            is_active=is_active,
+            password=password,
+        )
+        return cast(
+            'UserCredential',
+            cls._update(id=user_id, **req.dict(), session=session),
+        )

cuenca/resources/user_logins.py

@@ -0,0 +1,35 @@
+import datetime as dt
+from dataclasses import dataclass
+from typing import ClassVar, Optional, cast
+
+from cuenca_validations.types.requests import UserCredentialRequest
+
+from ..http import Session, session as global_session
+from .base import Creatable
+
+
+@dataclass
+class UserLogin(Creatable):
+    _resource: ClassVar = 'user_logins'
+
+    last_login_at: Optional[dt.datetime]
+    success: bool
+
+    @classmethod
+    def create(
+        cls, password: str, *, session: Session = global_session
+    ) -> 'UserLogin':
+        req = UserCredentialRequest(password=password)
+        login = cast('UserLogin', cls._create(session=session, **req.dict()))
+        if login.success:
+            session.session.headers['X-Cuenca-LoginId'] = login.id
+        return login
+
+    @classmethod
+    def logout(
+        cls, user_id: str = 'me', *, session: Session = global_session
+    ) -> None:
+        # Using user_id vs user_login_id to avoid needing to store
+        # user_login_id or perform a query to fetch it
+        session.delete(f'{cls._resource}/{user_id}', dict())
+        session.session.headers.pop('X-Cuenca-LoginId', None)

cuenca/version.py

@@ -1,3 +1,3 @@
-__version__ = '0.6.2'
+__version__ = '0.6.3'
 CLIENT_VERSION = __version__
 API_VERSION = '2020-03-19'

requirements.txt

@@ -1,3 +1,3 @@
 requests==2.25.1
-cuenca-validations==0.7.5
+cuenca-validations==0.7.8
 dataclasses>=0.7;python_version<"3.7"