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

cuenca_validations/types/__init__.py

@@ -1,6 +1,9 @@
 __all__ = [
     'AccountUseType',
     'AccountQuery',
+    'AccountRequest',
+    'AccountUpdateRequest',
+    'AccountValidationStatus',
     'Address',
     'AgentQuery',
     'AgentRequest',
@@ -60,6 +63,16 @@ __all__ = [
     'LimitedWalletRequest',
     'MonthlyMovementsType',
     'MonthlySpendingType',
+    'MoralPersonRequest',
+    'MoralPersonUpdateRequest',
+    'OperationalEventAction',
+    'OperationalEventQuery',
+    'OperatorLoginRequest',
+    'OperatorLoginResponse',
+    'OperatorRequest',
+    'OperatorRole',
+    'OperatorStatus',
+    'OperatorUpdateRequest',
     'PartnerRequest',
     'PartnerUpdateRequest',
     'PasswordResetRequest',
@@ -129,6 +142,7 @@ __all__ = [
 from .card import StrictPaymentCardNumber
 from .enums import (
     AccountUseType,
+    AccountValidationStatus,
     AuthorizerTransaction,
     BankAccountStatus,
     CardErrorType,
@@ -155,6 +169,9 @@ from .enums import (
     Language,
     MonthlyMovementsType,
     MonthlySpendingType,
+    OperationalEventAction,
+    OperatorRole,
+    OperatorStatus,
     PlatformType,
     PosCapability,
     Profession,
@@ -213,6 +230,7 @@ from .queries import (
     EventQuery,
     FileQuery,
     IdentityQuery,
+    OperationalEventQuery,
     PostalCodeQuery,
     QueryParams,
     SessionQuery,
@@ -226,6 +244,8 @@ from .queries import (
     WalletTransactionQuery,
 )
 from .requests import (
+    AccountRequest,
+    AccountUpdateRequest,
     AgentRequest,
     ApiKeyUpdateRequest,
     BankAccountValidationRequest,
@@ -239,6 +259,12 @@ from .requests import (
     FraudFundsTransferRequest,
     KYCValidationRequest,
     LimitedWalletRequest,
+    MoralPersonRequest,
+    MoralPersonUpdateRequest,
+    OperatorLoginRequest,
+    OperatorLoginResponse,
+    OperatorRequest,
+    OperatorUpdateRequest,
     PartnerRequest,
     PartnerUpdateRequest,
     PasswordResetRequest,

cuenca_validations/types/enums.py

@@ -744,3 +744,25 @@ class RequiredAction(str, Enum):
     level_up_required = 'level_up_required'
     level_up_invitation = 'level_up_invitation'
     fix_documents = 'fix_documents'
+
+
+class AccountValidationStatus(str, Enum):
+    verified = 'verified'
+    pending = 'pending'
+
+
+class OperationalEventAction(str, Enum):
+    account_created = 'account_created'
+    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/queries.py

@@ -22,6 +22,7 @@ from .enums import (
     CardType,
     EventType,
     KYCFileType,
+    OperationalEventAction,
     SessionType,
     TermsOfService,
     TransferNetwork,
@@ -153,6 +154,11 @@ class AccountQuery(QueryParams):
     account_number: Optional[str] = None
 
 
+class OperationalEventQuery(QueryParams):
+    actor_id: Optional[str] = None
+    action: Optional[OperationalEventAction] = None
+
+
 class BalanceEntryQuery(QueryParams):
     funding_instrument_uri: Optional[str] = None
     wallet_id: str = 'default'

cuenca_validations/types/requests.py

@@ -18,6 +18,7 @@ from pydantic_extra_types.coordinate import Coordinate
 
 from ..types.enums import (
     AccountUseType,
+    AccountValidationStatus,
     AuthorizerTransaction,
     CardDesign,
     CardFundingType,
@@ -36,6 +37,8 @@ from ..types.enums import (
     KYCValidationSource,
     MonthlyMovementsType,
     MonthlySpendingType,
+    OperatorRole,
+    OperatorStatus,
     PlatformType,
     PosCapability,
     Profession,
@@ -735,6 +738,39 @@ class LimitedWalletRequest(BaseRequest):
     allowed_rfc: Optional[Rfc] = None
 
 
+class AccountRequest(BaseRequest):
+    name: StrictStr
+    account_number: Clabe
+    alias: Optional[StrictStr] = None
+    curp: Optional[Curp] = None
+    rfc: Optional[Rfc] = None
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'name': 'Aceros del Norte SA de CV',
+                'account_number': '072691004495711499',
+                'alias': 'Proveedor acero',
+            }
+        },
+    )
+
+
+class AccountUpdateRequest(BaseRequest):
+    name: Optional[StrictStr] = None
+    alias: Optional[StrictStr] = None
+    validation_status: Optional[AccountValidationStatus] = None
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'alias': 'Fletes',
+                'validation_status': 'verified',
+            }
+        },
+    )
+
+
 class PlatformRequest(BaseModel):
     name: str
     rfc: Optional[str] = None
@@ -863,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.40.dev1'
+__version__ = '2.1.41.dev1'

{cuenca_validations-2.1.40.dev1.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.40.dev1
+Version: 2.1.41.dev1
 Summary: Cuenca common validations
 Home-page: https://github.com/cuenca-mx/cuenca-validations
 Author: Cuenca

{cuenca_validations-2.1.40.dev1.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=LohH5SxufNPCO5YL43h7ZLVtYCgNt7XPXELraQblkJo,28
-cuenca_validations/types/__init__.py,sha256=EyusEtrFFMlzswaFIU5DbcGAQQy2VnF2yRdc_yYIf2o,5711
+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=lR54AWnM85-b8EOlhNaAhXLu1UiBVBbuV4f-LjChD1c,20614
+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=KnS_jbuUn5k1dZhliEyFxvttfZ22w0hO5x4qTsZR2g0,5862
-cuenca_validations/types/requests.py,sha256=dqGC-gjovMDv0bJUCXjU2c2PbtEZoayQYD9Ygun1Np8,25687
-cuenca_validations-2.1.40.dev1.dist-info/licenses/LICENSE,sha256=wR76FmxBbfnQpwELkkE5iMF8sFIafEMgXLTE4N4WPTc,1063
+cuenca_validations/types/queries.py,sha256=mcliWtNb6QAst1phf3KYQ24vj90cxBAn6FDlC-WAhKo,6021
+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.40.dev1.dist-info/METADATA,sha256=tdkqJ4UnFFUuzPSDy9tsm-ndN3Gf3gg3a9GlMKsoYb0,1600
-cuenca_validations-2.1.40.dev1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-cuenca_validations-2.1.40.dev1.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
-cuenca_validations-2.1.40.dev1.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: