cuenca-validations 2.1.31.dev1__tar.gz → 2.1.32.dev0__tar.gz

{cuenca_validations-2.1.31.dev1 → cuenca_validations-2.1.32.dev0}/PKG-INFO

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

{cuenca_validations-2.1.31.dev1 → cuenca_validations-2.1.32.dev0}/cuenca_validations/types/__init__.py

@@ -44,6 +44,9 @@ __all__ = [
     'FileBatchUploadRequest',
     'FileRequest',
     'FileUploadRequest',
+    'FraudFundsTransferAcceptedResponse',
+    'FraudFundsTransferRequest',
+    'FraudFundsTransferResultEvent',
     'Gender',
     'IncomeType',
     'IssuerNetwork',
@@ -230,6 +233,9 @@ from .requests import (
     FileBatchUploadRequest,
     FileRequest,
     FileUploadRequest,
+    FraudFundsTransferAcceptedResponse,
+    FraudFundsTransferRequest,
+    FraudFundsTransferResultEvent,
     KYCValidationRequest,
     LimitedWalletRequest,
     PartnerRequest,

{cuenca_validations-2.1.31.dev1 → cuenca_validations-2.1.32.dev0}/cuenca_validations/types/requests.py

@@ -1,7 +1,7 @@
 import datetime as dt
-from typing import Annotated, Any, Optional, Union
+from typing import Annotated, Any, Literal, Optional, Union
 
-from clabe import Clabe
+from clabe import Clabe, validate_clabe
 from pydantic import (
     BaseModel,
     ConfigDict,
@@ -309,6 +309,69 @@ class WalletTransactionRequest(BaseRequest):
     amount: StrictPositiveInt
 
 
+class FraudFundsTransferRequest(BaseRequest):
+    user_id: NonEmptyStr
+    clabe: Clabe
+    concepto: NonEmptyStr
+    amount: Optional[StrictPositiveInt] = None
+    reason: Optional[NonEmptyStr] = None
+    request_id: Optional[NonEmptyStr] = None
+    requested_by: Optional[NonEmptyStr] = None
+
+    @field_validator('clabe', mode='before')
+    @classmethod
+    def validate_clabe_format(cls, clabe: str) -> str:
+        if not validate_clabe(clabe):
+            raise ValueError('La CLABE ingresada no es valida')
+        return clabe
+
+
+class FraudFundsTransferAcceptedResponse(BaseRequest):
+    request_id: NonEmptyStr
+    status: Literal['queued']
+
+
+class FraudFundsTransferResultEvent(BaseRequest):
+    schema_version: NonEmptyStr
+    event_type: Literal[
+        'fraud_funds_transfer.succeeded',
+        'fraud_funds_transfer.failed',
+    ]
+    request_id: NonEmptyStr
+    user_id: NonEmptyStr
+    transaction_id: Optional[NonEmptyStr] = None
+    amount: Optional[StrictPositiveInt] = None
+    clave_rastreo: Optional[NonEmptyStr] = None
+    reason_code: Optional[NonEmptyStr] = None
+    message: Optional[NonEmptyStr] = None
+    completed_at: dt.datetime
+
+    @model_validator(mode='after')
+    def validate_payload(self) -> 'FraudFundsTransferResultEvent':
+        if self.event_type == 'fraud_funds_transfer.succeeded':
+            required = {
+                'transaction_id': self.transaction_id,
+                'amount': self.amount,
+            }
+            missing = [
+                field for field, value in required.items() if value is None
+            ]
+            if missing:
+                raise ValueError(
+                    f'{", ".join(missing)} required for succeeded event'
+                )
+            return self
+
+        required = {
+            'reason_code': self.reason_code,
+            'message': self.message,
+        }
+        missing = [field for field, value in required.items() if value is None]
+        if missing:
+            raise ValueError(f'{", ".join(missing)} required for failed event')
+        return self
+
+
 class FraudValidationRequest(BaseModel):
     amount: StrictPositiveInt
     merchant_name: str

cuenca_validations-2.1.32.dev0/cuenca_validations/version.py

@@ -0,0 +1 @@
+__version__ = '2.1.32.dev0'

{cuenca_validations-2.1.31.dev1 → cuenca_validations-2.1.32.dev0}/cuenca_validations.egg-info/PKG-INFO

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

{cuenca_validations-2.1.31.dev1 → cuenca_validations-2.1.32.dev0}/tests/test_requests.py

@@ -1,5 +1,3 @@
-from typing import Optional
-
 import pytest
 from pydantic import ValidationError
 from pydantic_extra_types.phone_numbers import PhoneNumber
@@ -40,44 +38,15 @@ def test_file_cuenca_url_invalid() -> None:
         UserTOSAgreementRequest(**request_data)
 
 
-_VALID_COORDINATE = (19.432607, -99.133209)
-
-
-@pytest.mark.parametrize(
-    ('payload', 'expected_dump'),
-    [
-        pytest.param(
-            {'location': _VALID_COORDINATE},
-            {
-                'location': {
-                    'latitude': 19.432607,
-                    'longitude': -99.133209,
-                },
-            },
-            id='serializes',
-        ),
-        pytest.param(
-            {},
-            None,
-            id='missing_location',
-        ),
-        pytest.param(
-            {'location': (91.0, 0.0)},
-            None,
-            id='bad_coordinate',
-        ),
-    ],
-)
-def test_password_reset_request(
-    payload: DictStrAny,
-    expected_dump: Optional[DictStrAny],
-) -> None:
-    if expected_dump is None:
-        with pytest.raises(ValidationError):
-            PasswordResetRequest.model_validate(payload)
-    else:
-        req = PasswordResetRequest.model_validate(payload)
-        assert req.model_dump() == expected_dump
+def test_password_reset_request_serializes() -> None:
+    payload: DictStrAny = {'location': (19.432607, -99.133209)}
+    req = PasswordResetRequest.model_validate(payload)
+    assert req.model_dump() == {
+        'location': {
+            'latitude': 19.432607,
+            'longitude': -99.133209,
+        },
+    }
 
 
 def test_update_user_requires_at_least_one_param():

{cuenca_validations-2.1.31.dev1 → cuenca_validations-2.1.32.dev0}/tests/test_types.py

@@ -12,6 +12,9 @@ from pydantic.fields import FieldInfo
 
 from cuenca_validations.types import (
     CardQuery,
+    FraudFundsTransferAcceptedResponse,
+    FraudFundsTransferRequest,
+    FraudFundsTransferResultEvent,
     JSONEncoder,
     QueryParams,
     SantizedDict,
@@ -636,6 +639,96 @@ def test_bank_account_validation_clabe_request():
     assert BankAccountValidationRequest(account_number='646180157098510917')
 
 
+def test_fraud_funds_transfer_models():
+    request = FraudFundsTransferRequest(
+        user_id='US123',
+        clabe='646180157098510917',
+        concepto='  fondos fraude  ',
+        amount=100,
+        request_id='REQ123',
+    )
+
+    assert request.concepto == 'fondos fraude'
+    assert request.model_dump() == {
+        'user_id': 'US123',
+        'clabe': '646180157098510917',
+        'concepto': 'fondos fraude',
+        'amount': 100,
+        'request_id': 'REQ123',
+    }
+
+    response = FraudFundsTransferAcceptedResponse(
+        request_id='REQ123',
+        status='queued',
+    )
+
+    assert response.status == 'queued'
+
+    succeeded_event = FraudFundsTransferResultEvent(
+        schema_version='1.0',
+        event_type='fraud_funds_transfer.succeeded',
+        request_id='REQ123',
+        user_id='US123',
+        transaction_id='TR123',
+        amount=100,
+        clave_rastreo='RASTREO123',
+        completed_at=now,
+    )
+
+    assert succeeded_event.transaction_id == 'TR123'
+
+    failed_event = FraudFundsTransferResultEvent(
+        schema_version='1.0',
+        event_type='fraud_funds_transfer.failed',
+        request_id='REQ123',
+        user_id='US123',
+        reason_code='insufficient_funds',
+        message='Insufficient funds',
+        completed_at=now,
+    )
+
+    assert failed_event.reason_code == 'insufficient_funds'
+
+
+def test_fraud_funds_transfer_request_invalid_clabe():
+    with pytest.raises(ValidationError) as ex:
+        FraudFundsTransferRequest(
+            user_id='US123',
+            clabe='not-a-clabe',
+            concepto='fondos fraude',
+        )
+
+    assert 'La CLABE ingresada no es valida' in str(ex.value)
+
+
+@pytest.mark.parametrize(
+    'event_type,expected_error',
+    [
+        (
+            'fraud_funds_transfer.succeeded',
+            'transaction_id, amount required for succeeded event',
+        ),
+        (
+            'fraud_funds_transfer.failed',
+            'reason_code, message required for failed event',
+        ),
+    ],
+)
+def test_fraud_funds_transfer_result_event_requires_payload(
+    event_type, expected_error
+):
+    with pytest.raises(ValidationError) as ex:
+        FraudFundsTransferResultEvent(
+            schema_version='1.0',
+            event_type=event_type,
+            request_id='REQ123',
+            user_id='US123',
+            completed_at=now,
+        )
+
+    assert expected_error in str(ex.value)
+
+
 @pytest.mark.parametrize(
     'input_data',
     [

cuenca_validations-2.1.31.dev1/cuenca_validations/version.py

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