cuenca-validations 2.1.38.dev2__tar.gz → 2.1.39.dev1__tar.gz

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/PKG-INFO

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

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/cuenca_validations/types/__init__.py

@@ -2,13 +2,16 @@ __all__ = [
     'AccountUseType',
     'AccountQuery',
     'Address',
+    'AgentQuery',
+    'AgentRequest',
+    'AgentStatus',
+    'AgentUpdateRequest',
     'ApiKeyQuery',
     'ApiKeyUpdateRequest',
     'AuthorizerTransaction',
     'BalanceEntryQuery',
     'BankAccountValidationQuery',
     'BankAccountValidationRequest',
-    'BankCode',
     'PostalCodeQuery',
     'UsersTOSQuery',
     'TOSQuery',
@@ -46,7 +49,6 @@ __all__ = [
     'FileRequest',
     'FileUploadRequest',
     'FraudFundsTransferRequest',
-    'FraudFundsTransferTipoPago',
     'Gender',
     'IncomeType',
     'IssuerNetwork',
@@ -129,6 +131,7 @@ __all__ = [
 from .card import StrictPaymentCardNumber
 from .enums import (
     AccountUseType,
+    AgentStatus,
     AuthorizerTransaction,
     BankAccountStatus,
     CardErrorType,
@@ -147,7 +150,6 @@ from .enums import (
     EventType,
     FileExtension,
     FileFormat,
-    FraudFundsTransferTipoPago,
     Gender,
     IncomeType,
     IssuerNetwork,
@@ -178,7 +180,6 @@ from .enums import (
 )
 from .files import BatchFileMetadata
 from .general import (
-    BankCode,
     JSONEncoder,
     LogConfig,
     SantizedDict,
@@ -204,6 +205,7 @@ from .identities import (
 )
 from .queries import (
     AccountQuery,
+    AgentQuery,
     ApiKeyQuery,
     BalanceEntryQuery,
     BankAccountValidationQuery,
@@ -227,6 +229,8 @@ from .queries import (
     WalletTransactionQuery,
 )
 from .requests import (
+    AgentRequest,
+    AgentUpdateRequest,
     ApiKeyUpdateRequest,
     BankAccountValidationRequest,
     BeneficiaryRequest,

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/cuenca_validations/types/enums.py

@@ -1,4 +1,4 @@
-from enum import Enum, IntEnum
+from enum import Enum
 
 
 class CardNetwork(str, Enum):
@@ -589,6 +589,13 @@ class SessionType(str, Enum):
     account_entries = 'session.account_entries'
     download_file = 'session.download_file'
     upload_file = 'session.upload_file'
+    agent = 'session.agent'
+
+
+class AgentStatus(str, Enum):
+    created = 'created'
+    succeeded = 'succeeded'
+    failed = 'failed'
 
 
 class WebhookObject(str, Enum):
@@ -743,9 +750,3 @@ class RequiredAction(str, Enum):
     level_up_required = 'level_up_required'
     level_up_invitation = 'level_up_invitation'
     fix_documents = 'fix_documents'
-
-
-class FraudFundsTransferTipoPago(IntEnum):
-    participante_participante = 7
-    devolucion_especial_ordenes_aceptadas_acreditadas = 23
-    devolucion_extemporanea_especial_ordenes_acreditadas = 24

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/cuenca_validations/types/general.py

@@ -2,7 +2,6 @@ import json
 from dataclasses import dataclass
 from typing import Annotated, Any, Optional
 
-from clabe import BANK_NAMES
 from pydantic import (
     AfterValidator,
     AnyUrl,
@@ -42,19 +41,6 @@ NormalizedName = Annotated[
 ]
 
 
-def validate_bank_code(bank_code: str) -> str:
-    if bank_code not in BANK_NAMES:
-        raise ValueError('Not a valid bank code')
-    return bank_code
-
-
-BankCode = Annotated[
-    str,
-    StringConstraints(strip_whitespace=True),
-    AfterValidator(validate_bank_code),
-]
-
-
 class SantizedDict(dict):
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/cuenca_validations/types/queries.py

@@ -15,6 +15,7 @@ from pydantic import (
 from ..typing import DictStrAny
 from ..validators import sanitize_dict
 from .enums import (
+    AgentStatus,
     BankAccountStatus,
     CardFundingType,
     CardIssuer,
@@ -193,6 +194,10 @@ class SessionQuery(QueryParams):
     type: SessionType
 
 
+class AgentQuery(QueryParams):
+    status: Optional[AgentStatus] = None
+
+
 class FileQuery(QueryParams):
     type: Optional[KYCFileType] = None
     id: Optional[str] = None

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/cuenca_validations/types/requests.py

@@ -1,7 +1,7 @@
 import datetime as dt
 from typing import Annotated, Any, Optional, Union
 
-from clabe import Clabe
+from clabe import BANK_NAMES, Clabe
 from pydantic import (
     BaseModel,
     ConfigDict,
@@ -18,6 +18,7 @@ from pydantic_extra_types.coordinate import Coordinate
 
 from ..types.enums import (
     AccountUseType,
+    AgentStatus,
     AuthorizerTransaction,
     CardDesign,
     CardFundingType,
@@ -29,7 +30,6 @@ from ..types.enums import (
     Country,
     EcommerceIndicator,
     FileExtension,
-    FraudFundsTransferTipoPago,
     Gender,
     IncomeType,
     IssuerNetwork,
@@ -67,7 +67,6 @@ from .card import (
     StrictPaymentCardNumber,
 )
 from .general import (
-    BankCode,
     LogConfig,
     NonEmptyStr,
     SerializableAnyUrl,
@@ -329,17 +328,21 @@ class WalletTransactionRequest(BaseRequest):
 class FraudFundsTransferRequest(BaseRequest):
     user_id: NonEmptyStr
     clabe: Optional[Clabe] = None
-    bank_code: Optional[BankCode] = None
-    tipo_pago: Optional[FraudFundsTransferTipoPago] = None
+    bank_code: Optional[str] = None
     amount: Optional[StrictPositiveInt] = None
     concepto: Optional[NonEmptyStr] = None
 
+    @field_validator('bank_code')
+    @classmethod
+    def validate_bank_code(cls, bank_code: Optional[str]) -> Optional[str]:
+        if bank_code is not None and bank_code not in BANK_NAMES:
+            raise ValueError('Not a valid bank code')
+        return bank_code
+
     @model_validator(mode='after')
     def validate_destination(self) -> 'FraudFundsTransferRequest':
         if self.clabe is None and self.bank_code is None:
             raise ValueError('clabe or bank_code required')
-        if self.bank_code is not None and self.tipo_pago is None:
-            raise ValueError('tipo_pago required when using bank_code')
         return self
 
 
@@ -643,6 +646,45 @@ class SessionRequest(BaseRequest):
     )
 
 
+class AgentRequest(BaseRequest):
+    phone_number: PhoneNumber
+    device_info: DictStrAny = Field(default_factory=dict)
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'phone_number': '+525512345678',
+                'device_info': {'client': 'cursor', 'os': 'macOS'},
+            }
+        }
+    )
+
+    @field_validator('phone_number', mode='before')
+    @classmethod
+    def normalize_phone(cls, v: PhoneNumber) -> str:
+        return normalize_phone_number(str(v))
+
+
+class AgentUpdateRequest(BaseRequest):
+    pairing_code: Optional[str] = None
+    status: AgentStatus
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'pairing_code': 'ABC-123',
+                'status': 'succeeded',
+            }
+        }
+    )
+
+    @model_validator(mode='after')
+    def validate_update(self) -> 'AgentUpdateRequest':
+        if self.status == AgentStatus.created:
+            raise ValueError('Invalid status')
+        if self.status == AgentStatus.succeeded and not self.pairing_code:
+            raise ValueError('pairing_code is required')
+        return self
+
+
 class EndpointRequest(BaseRequest):
     url: SerializableHttpUrl
     events: Optional[list[WebhookEvent]] = None

cuenca_validations-2.1.39.dev1/cuenca_validations/version.py

@@ -0,0 +1 @@
+__version__ = '2.1.39.dev1'

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/cuenca_validations.egg-info/PKG-INFO

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

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/tests/test_requests.py

@@ -2,6 +2,7 @@ import pytest
 from pydantic import ValidationError
 from pydantic_extra_types.phone_numbers import PhoneNumber
 
+from cuenca_validations.types import AgentStatus, AgentUpdateRequest
 from cuenca_validations.types.enums import VerificationType
 from cuenca_validations.types.requests import (
     PasswordResetRequest,
@@ -123,3 +124,18 @@ def test_update_transfer_request_forbids_extra() -> None:
             {'status': 'succeeded', 'foo': 'bar'}
         )
     assert 'Extra inputs are not permitted' in str(ex.value)
+
+
+def test_agent_update_request_rejects_created_status() -> None:
+    with pytest.raises(ValidationError) as exc:
+        AgentUpdateRequest(
+            pairing_code='ABC-123',
+            status=AgentStatus.created,
+        )
+    assert 'Invalid status' in str(exc.value)
+
+
+def test_agent_update_request_succeeded_requires_pairing_code() -> None:
+    with pytest.raises(ValidationError) as exc:
+        AgentUpdateRequest(status=AgentStatus.succeeded)
+    assert 'pairing_code is required' in str(exc.value)

{cuenca_validations-2.1.38.dev2 → cuenca_validations-2.1.39.dev1}/tests/test_types.py

@@ -675,73 +675,19 @@ def test_bank_account_validation_clabe_request():
     assert BankAccountValidationRequest(account_number='646180157098510917')
 
 
-@pytest.mark.parametrize(
-    'data, expected_dump',
-    [
-        (
-            dict(
-                user_id='US123',
-                clabe='646180157098510917',
-                amount=10000,
-                concepto='  Devolución fraude  ',
-            ),
-            dict(
-                user_id='US123',
-                clabe='646180157098510917',
-                amount=10000,
-                concepto='Devolución fraude',
-            ),
-        ),
-        (
-            dict(user_id='US123', clabe='646180157098510917'),
-            dict(user_id='US123', clabe='646180157098510917'),
-        ),
-        *[
-            (
-                dict(
-                    user_id='US123',
-                    bank_code='40012',
-                    tipo_pago=tipo_pago,
-                    amount=5000,
-                ),
-                dict(
-                    user_id='US123',
-                    bank_code='40012',
-                    tipo_pago=tipo_pago,
-                    amount=5000,
-                ),
-            )
-            for tipo_pago in (7, 23, 24)
-        ],
-    ],
-)
-def test_fraud_funds_transfer_request(data, expected_dump):
-    request = FraudFundsTransferRequest(**data)
-    assert request.model_dump() == expected_dump
+def test_fraud_funds_transfer_request():
+    assert FraudFundsTransferRequest(
+        user_id='US123',
+        bank_code='40012',
+    ).model_dump() == {'user_id': 'US123', 'bank_code': '40012'}
 
+    with pytest.raises(ValidationError) as exc:
+        FraudFundsTransferRequest(user_id='US123')
+    assert 'clabe or bank_code required' in str(exc.value)
 
-@pytest.mark.parametrize(
-    'data, expected_error',
-    [
-        (dict(user_id='US123'), 'clabe or bank_code required'),
-        (
-            dict(user_id='US123', bank_code='40012'),
-            'tipo_pago required when using bank_code',
-        ),
-        (
-            dict(user_id='US123', bank_code='40012', tipo_pago=1),
-            'Input should be 7, 23 or 24',
-        ),
-        (
-            dict(user_id='US123', bank_code='99999', tipo_pago=7),
-            'Not a valid bank code',
-        ),
-    ],
-)
-def test_fraud_funds_transfer_request_invalid(data, expected_error):
     with pytest.raises(ValidationError) as exc:
-        FraudFundsTransferRequest(**data)
-    assert expected_error in str(exc.value)
+        FraudFundsTransferRequest(user_id='US123', bank_code='99999')
+    assert 'Not a valid bank code' in str(exc.value)
 
 
 @pytest.mark.parametrize(

cuenca_validations-2.1.38.dev2/cuenca_validations/version.py

@@ -1 +0,0 @@
-__version__ = '2.1.38.dev2'