cuenca-validations 2.1.41.dev0__py3-none-any.whl → 2.1.41.dev1__py3-none-any.whl

cuenca_validations/types/__init__.py

@@ -63,8 +63,16 @@ __all__ = [
     'LimitedWalletRequest',
     'MonthlyMovementsType',
     'MonthlySpendingType',
+    'MoralPersonRequest',
+    'MoralPersonUpdateRequest',
     'OperationalEventAction',
     'OperationalEventQuery',
+    'OperatorLoginRequest',
+    'OperatorLoginResponse',
+    'OperatorRequest',
+    'OperatorRole',
+    'OperatorStatus',
+    'OperatorUpdateRequest',
     'PartnerRequest',
     'PartnerUpdateRequest',
     'PasswordResetRequest',
@@ -162,6 +170,8 @@ from .enums import (
     MonthlyMovementsType,
     MonthlySpendingType,
     OperationalEventAction,
+    OperatorRole,
+    OperatorStatus,
     PlatformType,
     PosCapability,
     Profession,
@@ -249,6 +259,12 @@ from .requests import (
     FraudFundsTransferRequest,
     KYCValidationRequest,
     LimitedWalletRequest,
+    MoralPersonRequest,
+    MoralPersonUpdateRequest,
+    OperatorLoginRequest,
+    OperatorLoginResponse,
+    OperatorRequest,
+    OperatorUpdateRequest,
     PartnerRequest,
     PartnerUpdateRequest,
     PasswordResetRequest,

cuenca_validations/types/enums.py

@@ -756,3 +756,13 @@ class OperationalEventAction(str, Enum):
     account_updated = 'account_updated'
     transfer_created = 'transfer_created'
     statement_downloaded = 'statement_downloaded'
+
+
+class OperatorRole(str, Enum):
+    operator = 'operator'
+    authorizer = 'authorizer'
+
+
+class OperatorStatus(str, Enum):
+    active = 'active'
+    disabled = 'disabled'

cuenca_validations/types/requests.py

@@ -37,6 +37,8 @@ from ..types.enums import (
     KYCValidationSource,
     MonthlyMovementsType,
     MonthlySpendingType,
+    OperatorRole,
+    OperatorStatus,
     PlatformType,
     PosCapability,
     Profession,
@@ -897,5 +899,130 @@ class PartnerUpdateRequest(BaseRequest):
     shareholders: Optional[list[Shareholder]] = None
 
 
+class MoralPersonRequest(BaseRequest):
+    legal_name: str
+    rfc: Rfc
+    legal_representatives: list[LegalRepresentative]
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'legal_name': 'Aceros del Norte SA de CV',
+                'rfc': 'ADN850101ABC',
+                'legal_representatives': [
+                    {
+                        'names': 'Juan',
+                        'first_surname': 'Perez',
+                        'job': 'Director General',
+                        'phone_number': '+525512345678',
+                        'email_address': 'juan.perez@aceros.com',
+                        'address': AddressRequest.model_json_schema().get(
+                            'example'
+                        ),
+                    }
+                ],
+            }
+        },
+    )
+
+    @field_validator('rfc')
+    @classmethod
+    def validate_moral_rfc(cls, rfc: Rfc) -> Rfc:
+        if len(rfc) != 12:
+            raise ValueError('RFC must be 12 characters for moral persons')
+        return rfc
+
+
+class MoralPersonUpdateRequest(BaseRequest):
+    legal_name: Optional[str] = None
+    rfc: Optional[Rfc] = None
+    legal_representatives: Optional[list[LegalRepresentative]] = None
+
+    @model_validator(mode="before")
+    @classmethod
+    def check_at_least_one_param(cls, values: DictStrAny) -> DictStrAny:
+        if not values:
+            raise ValueError('At least one parameter must be provided')
+        return values
+
+    @field_validator('rfc')
+    @classmethod
+    def validate_moral_rfc(cls, rfc: Optional[Rfc]) -> Optional[Rfc]:
+        if rfc is not None and len(rfc) != 12:
+            raise ValueError('RFC must be 12 characters for moral persons')
+        return rfc
+
+
+class OperatorRequest(BaseRequest):
+    name: str
+    email: EmailStr
+    phone: PhoneNumber
+    company_user_id: str
+    role: OperatorRole
+    status: OperatorStatus = OperatorStatus.active
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'name': 'Maria Lopez',
+                'email': 'maria.lopez@aceros.com',
+                'phone': '+525512345678',
+                'company_user_id': 'USWqY5cvkISJOxHyEKjAKf8w',
+                'role': 'operator',
+            }
+        },
+    )
+
+    @field_validator('email', mode='before')
+    @classmethod
+    def validate_email(cls, email: str) -> str:
+        return normalize_email(email)
+
+
+class OperatorUpdateRequest(BaseRequest):
+    name: Optional[str] = None
+    phone: Optional[PhoneNumber] = None
+    role: Optional[OperatorRole] = None
+    status: Optional[OperatorStatus] = None
+
+    @model_validator(mode="before")
+    @classmethod
+    def check_at_least_one_param(cls, values: DictStrAny) -> DictStrAny:
+        if not values:
+            raise ValueError('At least one parameter must be provided')
+        return values
+
+
+class OperatorLoginRequest(BaseRequest):
+    email: EmailStr
+    password: Annotated[Password, LogConfig(masked=True)]
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'email': 'maria.lopez@aceros.com',
+                'password': 'supersecret',
+            }
+        },
+    )
+
+    @field_validator('email', mode='before')
+    @classmethod
+    def validate_email(cls, email: str) -> str:
+        return normalize_email(email)
+
+
+class OperatorLoginResponse(BaseModel):
+    session_token: str
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'session_token': 'SEWqY5cvkISJOxHyEKjAKf8w',
+            }
+        },
+    )
+
+
 class PhoneVerificationAssociationRequest(BaseRequest):
     verification_id: str

cuenca_validations/version.py

@@ -1 +1 @@
-__version__ = '2.1.41.dev0'
+__version__ = '2.1.41.dev1'

{cuenca_validations-2.1.41.dev0.dist-info → cuenca_validations-2.1.41.dev1.dist-info}/METADATA

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

{cuenca_validations-2.1.41.dev0.dist-info → cuenca_validations-2.1.41.dev1.dist-info}/RECORD

@@ -4,27 +4,27 @@ 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=zXSnU5-EMbQZBD-PfFXgP4Z6G7cm7KFDWXB7Nie6WUk,2682
-cuenca_validations/version.py,sha256=ubLWpnM5zm6k0bIqWBrnYr4Msp7aeytwO3zKPd4HR98,28
-cuenca_validations/types/__init__.py,sha256=n4mpy0wj_WIElwNXeT2cN4en1yKX5NtK59eoOeKU4WM,5981
+cuenca_validations/version.py,sha256=8vBTEb00cimUGbORVDKZKFmy6McE_C2hEVctFO5ycwg,28
+cuenca_validations/types/__init__.py,sha256=xqc0H9XGx1Qe5FCkTgg5sAB9E0nw82M232SeZeO7Jww,6383
 cuenca_validations/types/card.py,sha256=UGzz8NTFAverUmdUKAK1oGHnOnjSNTpIRUm93vKSSGY,1295
-cuenca_validations/types/enums.py,sha256=xl-J2uQYhhjioJWewySHODM692P3SLUNX3sabt78aw4,20923
+cuenca_validations/types/enums.py,sha256=FNh-jMeRor-HHdlLYSkeOzEJWQt_rY7gcJ_xxnJ92BA,21095
 cuenca_validations/types/files.py,sha256=2CszbwF9ytXV9suFFwyDjYG4XxY8UhCjRw3HttVXXNw,269
 cuenca_validations/types/general.py,sha256=eYFYwyx_a4_J480GYpqW3DFbZabDFcUjvLRMQbShIUc,5622
 cuenca_validations/types/helpers.py,sha256=4veeLZbugHHqZk0ezSim978VhH6Vq8XTrEhe1eE_r3A,1531
 cuenca_validations/types/identities.py,sha256=j2xxh3UYHJe6IbAwr9yNXJkebTth_-g3SUmHeiPez8M,5513
 cuenca_validations/types/morals.py,sha256=davabh5hAnFVQyM7-yCyDaT5ewXnm0cr1BtqDIwzkX8,1833
 cuenca_validations/types/queries.py,sha256=mcliWtNb6QAst1phf3KYQ24vj90cxBAn6FDlC-WAhKo,6021
-cuenca_validations/types/requests.py,sha256=gJD0zI6ADvO_9FiWZ2zfSjtsHr-_B2ILhd4IFtpqLkE,26550
-cuenca_validations-2.1.41.dev0.dist-info/licenses/LICENSE,sha256=wR76FmxBbfnQpwELkkE5iMF8sFIafEMgXLTE4N4WPTc,1063
+cuenca_validations/types/requests.py,sha256=tYNEwgxOfkSBwliStTyQbEQkw4AM3YyL_eTlMytn3nI,30199
+cuenca_validations-2.1.41.dev1.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=fx2R7y6oQO8XeQzevJe826NuHkBgvtznZicomchB3Gg,899
-tests/test_requests.py,sha256=9kzuWBikfhrQqH7sJ-HQN9UCJ-Fph0MPL4j6q1RfI4o,4320
+tests/test_requests.py,sha256=UmGQ00D3VgFH0FveJjvW5BMsg0b7l3W0KFDGNFqY7W8,8926
 tests/test_statement.py,sha256=IOE0rRRBgBZSJv_FLaETEyn5NzzXKMNTqgjv99GX-68,1436
 tests/test_types.py,sha256=rPjqPGfPU73MSdbeJpoW_ai5TAO25hWSnQAt_H7ZIeI,23055
 tests/test_validators.py,sha256=Jjr9gWTT4cRntGiKvQK4fncqx3JkEuTWkKm1VqpRHTs,1829
-cuenca_validations-2.1.41.dev0.dist-info/METADATA,sha256=sMBxw8wEViatzoxLp2Q3fdHYza0uh5Tgd9rqvGU_Nxs,1600
-cuenca_validations-2.1.41.dev0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-cuenca_validations-2.1.41.dev0.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
-cuenca_validations-2.1.41.dev0.dist-info/RECORD,,
+cuenca_validations-2.1.41.dev1.dist-info/METADATA,sha256=bjW6vUS0InzJUjWld5Ifuj7j4XFcyz_6aTZu7qvU4kA,1600
+cuenca_validations-2.1.41.dev1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+cuenca_validations-2.1.41.dev1.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
+cuenca_validations-2.1.41.dev1.dist-info/RECORD,,

tests/test_requests.py

@@ -2,8 +2,19 @@ import pytest
 from pydantic import ValidationError
 from pydantic_extra_types.phone_numbers import PhoneNumber
 
-from cuenca_validations.types.enums import Country, VerificationType
+from cuenca_validations.types.enums import (
+    Country,
+    OperatorRole,
+    OperatorStatus,
+    VerificationType,
+)
 from cuenca_validations.types.requests import (
+    MoralPersonRequest,
+    MoralPersonUpdateRequest,
+    OperatorLoginRequest,
+    OperatorLoginResponse,
+    OperatorRequest,
+    OperatorUpdateRequest,
     PasswordResetRequest,
     UpdateTransferRequest,
     UserTOSAgreementRequest,
@@ -12,6 +23,144 @@ from cuenca_validations.types.requests import (
 )
 from cuenca_validations.typing import DictStrAny
 
+LEGAL_REPRESENTATIVE: DictStrAny = {
+    'names': 'Juan',
+    'first_surname': 'Perez',
+    'job': 'Director General',
+    'phone_number': '+525512345678',
+    'email_address': 'juan.perez@aceros.com',
+    'address': {
+        'street': 'Reforma',
+        'ext_number': '265',
+        'postal_code_id': 'PC2ygq9j2bS9-9tsuVawzErA',
+    },
+}
+
+MORAL_PERSON_REQUEST: DictStrAny = {
+    'legal_name': 'Aceros del Norte SA de CV',
+    'rfc': 'ADN850101ABC',
+    'legal_representatives': [LEGAL_REPRESENTATIVE],
+}
+
+
+def test_moral_person_request_valid() -> None:
+    req = MoralPersonRequest.model_validate(MORAL_PERSON_REQUEST)
+    assert req.legal_name == 'Aceros del Norte SA de CV'
+    assert req.rfc == 'ADN850101ABC'
+
+
+def test_moral_person_request_rejects_physical_rfc() -> None:
+    with pytest.raises(ValidationError) as ex:
+        MoralPersonRequest.model_validate(
+            {**MORAL_PERSON_REQUEST, 'rfc': 'GOCG650418TJ1'}
+        )
+    assert 'RFC must be 12 characters for moral persons' in str(ex.value)
+
+
+def test_moral_person_request_forbids_extra() -> None:
+    with pytest.raises(ValidationError) as ex:
+        MoralPersonRequest.model_validate(
+            {**MORAL_PERSON_REQUEST, 'foo': 'bar'}
+        )
+    assert 'Extra inputs are not permitted' in str(ex.value)
+
+
+def test_moral_person_update_requires_at_least_one_param() -> None:
+    with pytest.raises(ValueError) as ex:
+        MoralPersonUpdateRequest()
+    assert 'At least one parameter must be provided' in str(ex.value)
+
+
+def test_moral_person_update_valid() -> None:
+    req = MoralPersonUpdateRequest.model_validate({'legal_name': 'New name'})
+    assert req.legal_name == 'New name'
+
+
+def test_moral_person_update_accepts_moral_rfc() -> None:
+    req = MoralPersonUpdateRequest.model_validate({'rfc': 'ADN850101ABC'})
+    assert req.rfc == 'ADN850101ABC'
+
+
+def test_moral_person_update_rejects_physical_rfc() -> None:
+    with pytest.raises(ValidationError) as ex:
+        MoralPersonUpdateRequest.model_validate({'rfc': 'GOCG650418TJ1'})
+    assert 'RFC must be 12 characters for moral persons' in str(ex.value)
+
+
+def test_operator_request_valid() -> None:
+    req = OperatorRequest(
+        name='Maria Lopez',
+        email='Maria+Tag@Aceros.com',
+        phone=PhoneNumber('+525512345678'),
+        company_user_id='USWqY5cvkISJOxHyEKjAKf8w',
+        role=OperatorRole.operator,
+    )
+    assert req.email == 'maria@aceros.com'
+    assert req.status == OperatorStatus.active
+
+
+def test_operator_request_rejects_invalid_role() -> None:
+    with pytest.raises(ValidationError) as ex:
+        OperatorRequest.model_validate(
+            {
+                'name': 'Maria Lopez',
+                'email': 'maria@aceros.com',
+                'phone': '+525512345678',
+                'company_user_id': 'USWqY5cvkISJOxHyEKjAKf8w',
+                'role': 'admin',
+            }
+        )
+    assert 'role' in str(ex.value)
+
+
+def test_operator_update_requires_at_least_one_param() -> None:
+    with pytest.raises(ValueError) as ex:
+        OperatorUpdateRequest()
+    assert 'At least one parameter must be provided' in str(ex.value)
+
+
+def test_operator_update_valid() -> None:
+    req = OperatorUpdateRequest.model_validate({'name': 'New name'})
+    assert req.name == 'New name'
+
+
+def test_operator_login_request_valid() -> None:
+    req = OperatorLoginRequest.model_validate(
+        {
+            'email': 'Operator+Tag@Aceros.com',
+            'password': 'supersecret',
+        }
+    )
+    assert req.email == 'operator@aceros.com'
+
+
+def test_operator_login_request_rejects_short_password() -> None:
+    with pytest.raises(ValidationError) as ex:
+        OperatorLoginRequest.model_validate(
+            {
+                'email': 'operator@aceros.com',
+                'password': 'short',
+            }
+        )
+    assert 'password' in str(ex.value)
+
+
+def test_operator_login_request_forbids_extra() -> None:
+    with pytest.raises(ValidationError) as ex:
+        OperatorLoginRequest.model_validate(
+            {
+                'email': 'operator@aceros.com',
+                'password': 'supersecret',
+                'foo': 'bar',
+            }
+        )
+    assert 'Extra inputs are not permitted' in str(ex.value)
+
+
+def test_operator_login_response_valid() -> None:
+    resp = OperatorLoginResponse(session_token='SEWqY5cvkISJOxHyEKjAKf8w')
+    assert resp.session_token == 'SEWqY5cvkISJOxHyEKjAKf8w'
+
 
 @pytest.mark.parametrize('environment', ['api.stage', 'api.sandbox', 'api'])
 def test_file_cuenca_url(environment: str) -> None: