cuenca-validations 2.1.8.dev5__py3-none-any.whl → 2.1.8.dev7__py3-none-any.whl

cuenca_validations/types/__init__.py

@@ -56,6 +56,7 @@ __all__ = [
     'PlatformRequest',
     'PlatformType',
     'PosCapability',
+    'Profession',
     'QueryParams',
     'Rfc',
     'QuestionnairesRequest',
@@ -135,6 +136,7 @@ from .enums import (
     Language,
     PlatformType,
     PosCapability,
+    Profession,
     SATRegimeCode,
     SavingCategory,
     ServiceProviderCategory,

cuenca_validations/types/enums.py

@@ -688,3 +688,19 @@ class SATRegimeCode(str, Enum):
     ING_PREM = "615"  # Régimen de los ingresos por obtención de premios
     AE_PLAT_TEC = "625"  # Régimen de las Actividades Empresariales con ingresos a través de Plataformas Tecnológicas # noqa: E501
     RS_CONF = "626"  # Régimen Simplificado de Confianza
+
+
+class Profession(str, Enum):
+    artisticas = 'Actividades Artísticas'
+    agropecuario = 'Agricultura, Ganadería o Pesca'
+    comercio = 'Comercio'
+    estudiante = 'Estudiante'
+    empleado = 'Empleado(a/e)'
+    emprendimiento = 'Emprendimiento'
+    hogar = 'Hogar'
+    profesor = 'Profesor(a/e)'
+    profesionista = 'Profesionista'
+    servidor_publico = 'Servidor(a/e) Público'
+    sistemas = 'Sistemas y Comunicaciones'
+    independiente = 'Trabajador(a/e) Independiente'
+    oficios = 'Oficios Varios'

cuenca_validations/types/identities.py

@@ -36,16 +36,24 @@ Rfc = Annotated[
     ),
 ]
 
+# NOTE:
+# The Address model is kept for compatibility with legacy models and data
+# that expect all address fields to be optional. This allows older systems
+# or stored data using Address to continue working without breaking changes.
+# For new request validation, use AddressRequest, which enforces required
+# fields and is intended for validating incoming data.
+
 
 class Address(BaseModel):
-    street: NonEmptyStr
-    ext_number: NonEmptyStr
-    int_number: Optional[NonEmptyStr] = None
-    colonia: Optional[NonEmptyStr] = None
-    postal_code: Optional[NonEmptyStr] = None
+    street: Optional[str] = None
+    ext_number: Optional[str] = None
+    int_number: Optional[str] = None
+    colonia: Optional[str] = None
+    postal_code: Optional[str] = None
     state: Optional[State] = None
     country: Optional[Country] = None
-    city: Optional[NonEmptyStr] = None
+    city: Optional[str] = None
+    full_name: Optional[str] = None
     model_config = ConfigDict(
         json_schema_extra={
             "example": {
@@ -62,12 +70,31 @@ class Address(BaseModel):
     )
 
 
+class AddressRequest(BaseModel):
+    # This model is mainly for request validation, enforcing required fields.
+    street: NonEmptyStr
+    ext_number: NonEmptyStr
+    int_number: Optional[NonEmptyStr] = None
+    postal_code_id: NonEmptyStr
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            "example": {
+                "street": "Reforma",
+                "ext_number": "265",
+                "int_number": "5",
+                "postal_code_id": "PC2ygq9j2bS9-9tsuVawzErA",
+            }
+        }
+    )
+
+
 class Beneficiary(BaseModel):
     name: str
     birth_date: dt.date
     phone_number: PhoneNumber
     user_relationship: str
-    percentage: int
+    percentage: Annotated[int, Field(ge=1, le=100)]
     model_config = ConfigDict(
         json_schema_extra={
             "example": {

cuenca_validations/types/morals.py

@@ -3,7 +3,8 @@ from typing import Optional
 
 from pydantic import BaseModel, EmailStr
 
-from cuenca_validations.types import Address, Curp, PhoneNumber, Rfc
+from ..types import Curp, PhoneNumber, Rfc
+from .identities import AddressRequest
 
 
 class BusinessDetails(BaseModel):
@@ -60,7 +61,7 @@ class LegalRepresentative(PhysicalPerson):
     job: str
     phone_number: PhoneNumber
     email_address: EmailStr
-    address: Address
+    address: AddressRequest
 
 
 class ShareholderPhysical(PhysicalPerson):

cuenca_validations/types/queries.py

@@ -24,6 +24,7 @@ from .enums import (
     TransferNetwork,
     UserStatus,
 )
+from .general import digits
 from .identities import Curp
 
 MAX_PAGE_SIZE = 100
@@ -182,4 +183,4 @@ class BankAccountValidationQuery(QueryParams):
 
 
 class PostalCodeQuery(QueryParams):
-    postal_code: str
+    postal_code: digits(5, 5)  # type: ignore

cuenca_validations/types/requests.py

@@ -32,6 +32,7 @@ from ..types.enums import (
     KYCValidationSource,
     PlatformType,
     PosCapability,
+    Profession,
     SavingCategory,
     SessionType,
     State,
@@ -39,7 +40,6 @@ from ..types.enums import (
     TrackDataMethod,
     TransactionTokenValidationStatus,
     UserCardNotification,
-    UserStatus,
     VerificationType,
     WalletTransactionType,
     WebhookEvent,
@@ -64,13 +64,13 @@ from .general import (
     StrictPositiveInt,
 )
 from .identities import (
+    AddressRequest,
     Beneficiary,
     Curp,
     KYCFile,
     Password,
     PhoneNumber,
     Rfc,
-    TOSAgreement,
 )
 from .morals import (
     AuditDetails,
@@ -83,24 +83,6 @@ from .morals import (
 )
 
 
-class AddressRequest(BaseModel):
-    street: NonEmptyStr
-    ext_number: NonEmptyStr
-    int_number: Optional[NonEmptyStr] = None
-    postal_code_id: NonEmptyStr
-
-    model_config = ConfigDict(
-        json_schema_extra={
-            "example": {
-                "street": "Reforma",
-                "ext_number": "265",
-                "int_number": "5",
-                "postal_code_id": "PC2ygq9j2bS9-9tsuVawzErA",
-            }
-        }
-    )
-
-
 class BaseRequest(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
@@ -427,43 +409,25 @@ class UserTOSAgreementRequest(BaseModel):
 
 
 class UserRequest(BaseModel):
-    id: Optional[str] = Field(
-        None, description='if you want to create with specific `id`'
-    )
     curp: Curp = Field(
-        description='Previously validated in `curp_validations`'
-    )
-    phone_number: Optional[PhoneNumber] = Field(
-        None, description='Only if you validated previously on your side'
-    )
-    email_address: Optional[EmailStr] = Field(
-        None, description='Only if you validated previously on your side'
-    )
-    profession: Optional[str] = None
-    address: AddressRequest
-    status: Optional[UserStatus] = Field(
-        None,
-        description='Status that the user will have when created. '
-        'Defined by platform',
+        description=(
+            'Mexican government ID (18 characters). ' 'Must be pre-validated.'
+        )
     )
-    required_level: Optional[int] = Field(
-        None,
-        ge=1,
-        le=3,
-        description='Maximum level a User can reach. Defined by platform',
+
+    profession: Profession = Field(description='User profession or occupation')
+    address: AddressRequest = Field(
+        description='User residential address information'
     )
-    phone_verification_id: Optional[str] = Field(
-        None,
-        description='Only if you validated it previously with the '
-        'resource `verifications`',
+    phone_verification_id: str = Field(
+        ...,
+        description='ID of previously validated phone verification',
     )
-    email_verification_id: Optional[str] = Field(
-        None,
-        description='Only if you validated it previously with the '
-        'resource `verifications`',
+    email_verification_id: str = Field(
+        ...,
+        description='ID of previously validated email verification',
     )
-    terms_of_service: Optional[TOSRequest] = None
-    signature: Optional[KYCFile] = None
+
     model_config = ConfigDict(
         json_schema_extra={
             'example': {
@@ -496,9 +460,7 @@ class UserRequest(BaseModel):
 
 
 class UserUpdateRequest(BaseModel):
-    phone_number: Optional[PhoneNumber] = None
-    email_address: Optional[EmailStr] = None
-    profession: Optional[str] = None
+    profession: Optional[Profession] = None
     verification_id: Optional[str] = None
     email_verification_id: Optional[str] = None
     phone_verification_id: Optional[str] = None
@@ -508,9 +470,6 @@ class UserUpdateRequest(BaseModel):
     proof_of_address: Optional[KYCFile] = None
     proof_of_life: Optional[KYCFile] = None
     signature: Optional[KYCFile] = None
-    status: Optional[UserStatus] = None
-    terms_of_service: Optional[TOSRequest] = None
-    platform_terms_of_service: Optional[TOSAgreement] = None
     curp_document_uri: Optional[SerializableHttpUrl] = None
 
     @field_validator('beneficiaries')
@@ -518,8 +477,8 @@ class UserUpdateRequest(BaseModel):
     def beneficiary_percentage(
         cls, beneficiaries: Optional[list[Beneficiary]] = None
     ):
-        if beneficiaries and sum(b.percentage for b in beneficiaries) > 100:
-            raise ValueError('The total percentage is more than 100.')
+        if beneficiaries and sum(b.percentage for b in beneficiaries) != 100:
+            raise ValueError('The total percentage should be 100%')
         return beneficiaries
 
 

cuenca_validations/version.py

@@ -1 +1 @@
-__version__ = '2.1.8.dev5'
+__version__ = '2.1.8.dev7'

{cuenca_validations-2.1.8.dev5.dist-info → cuenca_validations-2.1.8.dev7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuenca_validations
-Version: 2.1.8.dev5
+Version: 2.1.8.dev7
 Summary: Cuenca common validations
 Home-page: https://github.com/cuenca-mx/cuenca-validations
 Author: Cuenca

{cuenca_validations-2.1.8.dev5.dist-info → cuenca_validations-2.1.8.dev7.dist-info}/RECORD

@@ -4,25 +4,25 @@ cuenca_validations/errors.py,sha256=OtM8EgiKqYdz9Hn66AbBO96orL1or7efkyt0vh0Zxbs,
 cuenca_validations/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cuenca_validations/typing.py,sha256=1QCu81IbVZZpyInjyeAuO-nF36gpT5Gi4o6V9PozuOU,204
 cuenca_validations/validators.py,sha256=wzwLnJ4wHggZvqp3mearbFkzvDERGeTNvJkuofQnuMc,1484
-cuenca_validations/version.py,sha256=duU_AdKadD1ZARK_F3KZT5u5R_p3hMMNhAyc7s5vM7I,27
-cuenca_validations/types/__init__.py,sha256=jSc37T7oFYbaJFQhES7AQSWnMsgJtc21oPXb39V9SNg,4809
+cuenca_validations/version.py,sha256=B2hWK2p5W-fX6zxqTAD1i3ZsbEG-CnF83ttZiD9Q8ko,27
+cuenca_validations/types/__init__.py,sha256=fPmHzU6mY6l3qK2R8cOhjcrICTOnoHS6VQteX663FRE,4843
 cuenca_validations/types/card.py,sha256=UGzz8NTFAverUmdUKAK1oGHnOnjSNTpIRUm93vKSSGY,1295
-cuenca_validations/types/enums.py,sha256=Vm9HGf83jPkEp8iZ-KGtKGWQGx5q-cIUuQj32y_QcvU,18997
+cuenca_validations/types/enums.py,sha256=533fUCip5CXMD7m4Ww8VAcB5Yr4A0EmT5GBRt2mF4b0,19510
 cuenca_validations/types/files.py,sha256=2CszbwF9ytXV9suFFwyDjYG4XxY8UhCjRw3HttVXXNw,269
 cuenca_validations/types/general.py,sha256=vJmQBD_Iv_hsxD8x3_Bip-NlYAiE2rmXSPQKj4kTtto,2621
 cuenca_validations/types/helpers.py,sha256=6rHUhwoQ7jJZtGcW3LX-W5ZDl42PWE1RoBpGme7KCkk,610
-cuenca_validations/types/identities.py,sha256=y8ywi2qvp6X1GrfZ8vRbFvOi3PxqRaOuoj1bwU-eOb8,4505
-cuenca_validations/types/morals.py,sha256=m8kAedevmwfSPTA9GYe03l7pkgipynwYgKfejyVtnuI,1813
-cuenca_validations/types/queries.py,sha256=fDXm2LIpM4IrkaANTDTr3_tqqAK6nvs5-CGCTjjK9Oo,4759
-cuenca_validations/types/requests.py,sha256=fXk1O3oX4MosBv1C0xGmkVGPgYSUFuOifk8n6wPcE6w,21804
-cuenca_validations-2.1.8.dev5.dist-info/licenses/LICENSE,sha256=wR76FmxBbfnQpwELkkE5iMF8sFIafEMgXLTE4N4WPTc,1063
+cuenca_validations/types/identities.py,sha256=1wkutHzL9Gpd9oAZdyiikNxWKe5iBVAQT3TabR6YG1o,5451
+cuenca_validations/types/morals.py,sha256=davabh5hAnFVQyM7-yCyDaT5ewXnm0cr1BtqDIwzkX8,1833
+cuenca_validations/types/queries.py,sha256=hrbH4bMRIffSwXSKsUg7JLIiW6IM2KjfctdYJCwG2a8,4812
+cuenca_validations/types/requests.py,sha256=u2lUkeIQu2KqSo1PU0XNb1mFczBXZZoLy1p7vivQwiU,20412
+cuenca_validations-2.1.8.dev7.dist-info/licenses/LICENSE,sha256=wR76FmxBbfnQpwELkkE5iMF8sFIafEMgXLTE4N4WPTc,1063
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/test_card.py,sha256=QAfRz7e11gWICPnFJZ2tiYgUsFV3C9TwzJXrDnDNXFw,1202
 tests/test_errors.py,sha256=ixiIgEuBuzfsL5p4uCFdF32XqFRtTPF6EVhGJ0keOrI,930
 tests/test_helpers.py,sha256=ubzpi1UXCryLQdgsT_Zm2IX-XE_4L0dnHnhLwH06xK8,748
 tests/test_statement.py,sha256=IOE0rRRBgBZSJv_FLaETEyn5NzzXKMNTqgjv99GX-68,1436
-tests/test_types.py,sha256=peD5U1PIS7wZvdF1hTXNoStrYc3CkJbZnKPGJaXZz70,18656
-cuenca_validations-2.1.8.dev5.dist-info/METADATA,sha256=2Z9W6wfeMX284M4uf4pw9h4KdO0VomylaflNPQZdkbw,1599
-cuenca_validations-2.1.8.dev5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cuenca_validations-2.1.8.dev5.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
-cuenca_validations-2.1.8.dev5.dist-info/RECORD,,
+tests/test_types.py,sha256=EJwZ0a0L7085aISg-mZFwxWpeE0RDQupp-YxZUyZNgc,18867
+cuenca_validations-2.1.8.dev7.dist-info/METADATA,sha256=NodOqJFY26WdjBpw7Gxsv3LWtxQKrW4JqKKkRIuCDTQ,1599
+cuenca_validations-2.1.8.dev7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cuenca_validations-2.1.8.dev7.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
+cuenca_validations-2.1.8.dev7.dist-info/RECORD,,

tests/test_types.py

@@ -21,6 +21,7 @@ from cuenca_validations.types import (
 )
 from cuenca_validations.types.enums import (
     EcommerceIndicator,
+    Profession,
     SessionType,
     State,
 )
@@ -304,12 +305,8 @@ def test_saving_update_request():
 @freeze_time('2022-01-01')
 def test_user_request():
     request = dict(
-        id=None,
         curp='ABCD920604HDFSRN03',
-        phone_number='+525555555555',
-        email_address='email@email.com',
-        profession='worker',
-        status='active',
+        profession=Profession.empleado,
         address=dict(
             street='calle 1',
             ext_number='2',
@@ -318,17 +315,29 @@ def test_user_request():
         ),
         phone_verification_id='VE12345678',
         email_verification_id='VE0987654321',
-        required_level=3,
-        terms_of_service=None,
-        signature=None,
     )
     assert UserRequest(**request).model_dump() == request
 
-    # changing curp so user is underage
-    request['curp'] = 'ABCD060604HDFSRN03'
+
+@freeze_time('2022-01-01')
+def test_user_request_underage():
+    request = dict(
+        curp='ABCD060604HDFSRN03',  # underage CURP
+        profession='worker',
+        address=dict(
+            street='calle 1',
+            ext_number='2',
+            int_number='3',
+            postal_code_id='PC2ygq9j2bS9-9tsuVawzErA',
+        ),
+        phone_verification_id='VE12345678',
+        email_verification_id='VE0987654321',
+    )
+
     with pytest.raises(ValueError) as v:
         UserRequest(**request)
-        assert 'User does not meet age requirement.' in str(v)
+
+    assert 'User does not meet age requirement.' in str(v)
 
 
 @freeze_time('2022-01-01')
@@ -410,7 +419,7 @@ def test_user_update_request():
             birth_date=dt.date(2020, 1, 1).isoformat(),
             phone_number='+525555555555',
             user_relationship='brother',
-            percentage=50,
+            percentage=100,
         ),
     ]
     assert UserUpdateRequest(**request)
@@ -421,12 +430,21 @@ def test_user_update_request():
             birth_date=dt.date(2020, 1, 1).isoformat(),
             phone_number='+525555555555',
             user_relationship='brother',
-            percentage=101,
+            percentage=50,
+        ),
+        dict(
+            name='José Pérez',
+            birth_date=dt.date(2020, 1, 2).isoformat(),
+            phone_number='+525544444444',
+            user_relationship='brother',
+            percentage=51,
         ),
     ]
-    with pytest.raises(ValueError) as v:
+    with pytest.raises(ValidationError) as v:
         UserUpdateRequest(**request)
-        assert 'The total percentage is more than 100.' in str(v)
+
+    assert 'The total percentage should be 100%' in str(v)
+    request.pop('beneficiaries')
 
     tos_request = dict(
         terms_of_service=dict(
@@ -457,12 +475,6 @@ def test_user_update_request():
     )
     UserUpdateRequest(**kyc_request)
 
-    # chagning to invalid request
-    tos_request['terms_of_service']['ip'] = 'not valid ip'
-    with pytest.raises(ValueError) as v:
-        UserUpdateRequest(**tos_request)
-    assert 'not valid ip' in str(v.value)
-
 
 def test_session_request():
     data = dict(