cuenca-validations 2.1.7.dev6__py3-none-any.whl → 2.1.8__py3-none-any.whl

cuenca_validations/types/__init__.py

@@ -7,6 +7,7 @@ __all__ = [
     'BalanceEntryQuery',
     'BankAccountValidationQuery',
     'BankAccountValidationRequest',
+    'PostalCodeQuery',
     'BankAccountStatus',
     'BatchFileMetadata',
     'Beneficiary',
@@ -185,6 +186,7 @@ from .queries import (
     EventQuery,
     FileQuery,
     IdentityQuery,
+    PostalCodeQuery,
     QueryParams,
     SessionQuery,
     StatementQuery,

cuenca_validations/types/enums.py

@@ -691,16 +691,16 @@ class SATRegimeCode(str, Enum):
 
 
 class Profession(str, Enum):
-    arts = 'arts'
-    agriculture = 'agriculture'
-    commerce = 'commerce'
-    student = 'student'
-    employee = 'employee'
-    entrepreneur = 'entrepreneur'
-    homemaker = 'homemaker'
-    teacher = 'teacher'
-    professional = 'professional'
-    public_servant = 'public_servant'
-    it_communications = 'it_communications'
-    freelancer = 'freelancer'
-    skilled_trades = 'skilled_trades'
+    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,17 +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: NonEmptyStr
-    postal_code: NonEmptyStr
+    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: Country
-    city: NonEmptyStr
-
+    country: Optional[Country] = None
+    city: Optional[str] = None
+    full_name: Optional[str] = None
     model_config = ConfigDict(
         json_schema_extra={
             "example": {
@@ -63,6 +70,25 @@ 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

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

@@ -7,6 +7,7 @@ from pydantic import (
     EmailStr,
     Field,
     PositiveInt,
+    StringConstraints,
     field_validator,
 )
 
@@ -179,3 +180,15 @@ class FileQuery(QueryParams):
 class BankAccountValidationQuery(QueryParams):
     account_number: Optional[str] = None
     status: Optional[BankAccountStatus] = None
+
+
+class PostalCodeQuery(QueryParams):
+    postal_code: Annotated[
+        str,
+        StringConstraints(
+            strip_whitespace=True,
+            min_length=5,
+            max_length=5,
+            pattern=r'^\d+$',
+        ),
+    ]

cuenca_validations/types/requests.py

@@ -64,7 +64,7 @@ from .general import (
     StrictPositiveInt,
 )
 from .identities import (
-    Address,
+    AddressRequest,
     Beneficiary,
     Curp,
     KYCFile,
@@ -416,7 +416,7 @@ class UserRequest(BaseModel):
     )
 
     profession: Profession = Field(description='User profession or occupation')
-    address: Address = Field(
+    address: AddressRequest = Field(
         description='User residential address information'
     )
     phone_verification_id: str = Field(
@@ -435,7 +435,7 @@ class UserRequest(BaseModel):
                 'phone_number': '+525511223344',
                 'email_address': 'user@example.com',
                 'profession': 'engineer',
-                'address': Address.model_json_schema().get('example'),
+                'address': AddressRequest.model_json_schema().get('example'),
             }
         },
     )
@@ -464,7 +464,7 @@ class UserUpdateRequest(BaseModel):
     verification_id: Optional[str] = None
     email_verification_id: Optional[str] = None
     phone_verification_id: Optional[str] = None
-    address: Optional[Address] = None
+    address: Optional[AddressRequest] = None
     beneficiaries: Optional[list[Beneficiary]] = None
     govt_id: Optional[KYCFile] = None
     proof_of_address: Optional[KYCFile] = None
@@ -685,7 +685,7 @@ class PartnerRequest(BaseRequest):
     web_site: str
     phone_number: PhoneNumber
     email_address: EmailStr
-    address: Address
+    address: AddressRequest
 
 
 class PartnerUpdateRequest(BaseRequest):
@@ -699,7 +699,7 @@ class PartnerUpdateRequest(BaseRequest):
     web_site: Optional[str] = None
     phone_number: Optional[PhoneNumber] = None
     email_address: Optional[EmailStr] = None
-    address: Optional[Address] = None
+    address: Optional[AddressRequest] = None
     business_details: Optional[BusinessDetails] = None
     transactional_profile: Optional[TransactionalProfile] = None
     external_account: Optional[Clabe] = None

cuenca_validations/version.py

@@ -1 +1 @@
-__version__ = '2.1.7.dev6'
+__version__ = '2.1.8'

{cuenca_validations-2.1.7.dev6.dist-info → cuenca_validations-2.1.8.dist-info}/METADATA

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

{cuenca_validations-2.1.7.dev6.dist-info → cuenca_validations-2.1.8.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=xNYuWD95tiTllFVfWM7FmDp_XLbRZ6ABQ89u9YqAhXw,27
-cuenca_validations/types/__init__.py,sha256=1xGfD2tlFsPlhIy-T7BZPs-vvEgDoc6ZW2iXFLbyQpM,4799
+cuenca_validations/version.py,sha256=pYuB8qK-6nufcTu4rxmUsi2yMIYFokx7P2J_Q_IT9sg,22
+cuenca_validations/types/__init__.py,sha256=fPmHzU6mY6l3qK2R8cOhjcrICTOnoHS6VQteX663FRE,4843
 cuenca_validations/types/card.py,sha256=UGzz8NTFAverUmdUKAK1oGHnOnjSNTpIRUm93vKSSGY,1295
-cuenca_validations/types/enums.py,sha256=o2XmufNIBhx88KDVARnpoXqLkyXVP89XMW0DDPDH9NI,19424
+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=FBpWUwRfy99jBr2Zhuv9gArnnUe12o3A2kbs25i9nwo,4470
-cuenca_validations/types/morals.py,sha256=m8kAedevmwfSPTA9GYe03l7pkgipynwYgKfejyVtnuI,1813
-cuenca_validations/types/queries.py,sha256=KCRx0sPzWDtDDbZysmFGVgANgfqil17EITWaG7tGQ-A,4700
-cuenca_validations/types/requests.py,sha256=SdLE0N-3bRNVUQRQ2IWtShjR8Iok_Ev818o9UbcraTU,20370
-cuenca_validations-2.1.7.dev6.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=5VHVyTcN9lELcCNXL_b7kWXWw5-6e7G3NTVPF8FT11Y,4963
+cuenca_validations/types/requests.py,sha256=u2lUkeIQu2KqSo1PU0XNb1mFczBXZZoLy1p7vivQwiU,20412
+cuenca_validations-2.1.8.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=TimSUqe0YX83qIzo7p6XUy8YYuf19a7M3iPkVKw0iMg,19203
-cuenca_validations-2.1.7.dev6.dist-info/METADATA,sha256=bN1iprUBHlSHDDvjNOOo9I-l8_fZN207JIm9Jkwvp-w,1599
-cuenca_validations-2.1.7.dev6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cuenca_validations-2.1.7.dev6.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
-cuenca_validations-2.1.7.dev6.dist-info/RECORD,,
+tests/test_types.py,sha256=EJwZ0a0L7085aISg-mZFwxWpeE0RDQupp-YxZUyZNgc,18867
+cuenca_validations-2.1.8.dist-info/METADATA,sha256=bL7fyLJrhANl7DDAcT66KTJK9rHrzlvSfGN8PuyzQrI,1594
+cuenca_validations-2.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cuenca_validations-2.1.8.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
+cuenca_validations-2.1.8.dist-info/RECORD,,

tests/test_types.py

@@ -20,7 +20,6 @@ from cuenca_validations.types import (
     get_state_name,
 )
 from cuenca_validations.types.enums import (
-    Country,
     EcommerceIndicator,
     Profession,
     SessionType,
@@ -307,23 +306,15 @@ def test_saving_update_request():
 def test_user_request():
     request = dict(
         curp='ABCD920604HDFSRN03',
-        profession=Profession.employee,
+        profession=Profession.empleado,
         address=dict(
             street='calle 1',
             ext_number='2',
             int_number='3',
-            colonia='Juarez',
-            postal_code='09900',
-            state=State.DF,
-            country=Country.MX,
-            city='Obrera',
+            postal_code_id='PC2ygq9j2bS9-9tsuVawzErA',
         ),
         phone_verification_id='VE12345678',
         email_verification_id='VE0987654321',
-        tos_agreement=dict(
-            tos_id='TOS123',
-            location=dict(latitude=19.4326, longitude=-99.1332),
-        ),
     )
     assert UserRequest(**request).model_dump() == request
 
@@ -337,11 +328,7 @@ def test_user_request_underage():
             street='calle 1',
             ext_number='2',
             int_number='3',
-            colonia='Juarez',
-            postal_code='09900',
-            state=State.DF,
-            country=Country.MX,
-            city='Obrera',
+            postal_code_id='PC2ygq9j2bS9-9tsuVawzErA',
         ),
         phone_verification_id='VE12345678',
         email_verification_id='VE0987654321',