cuenca-validations 2.1.31.dev1__py3-none-any.whl → 2.1.32.dev1__py3-none-any.whl

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/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, Self, 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: StrictPositiveInt | None = None
+    reason: NonEmptyStr | None = None
+    request_id: NonEmptyStr | None = None
+    requested_by: NonEmptyStr | None = 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: NonEmptyStr | None = None
+    amount: StrictPositiveInt | None = None
+    clave_rastreo: NonEmptyStr | None = None
+    reason_code: NonEmptyStr | None = None
+    message: NonEmptyStr | None = None
+    completed_at: dt.datetime
+
+    @model_validator(mode='after')
+    def validate_payload(self) -> Self:
+        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/version.py

@@ -1 +1 @@
-__version__ = '2.1.31.dev1'
+__version__ = '2.1.32.dev1'

{cuenca_validations-2.1.31.dev1.dist-info → cuenca_validations-2.1.32.dev1.dist-info}/METADATA

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

{cuenca_validations-2.1.31.dev1.dist-info → cuenca_validations-2.1.32.dev1.dist-info}/RECORD

@@ -4,8 +4,8 @@ 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=XkU16FsSKKjz0G9A4S-b9cWBXeznI_yz9kVIlEuDcs0,28
-cuenca_validations/types/__init__.py,sha256=llL7obyGbxbwmcyiSXX9ZZ5P1REbD9H2tOP34klwKYE,5519
+cuenca_validations/version.py,sha256=bKjtKPCh0nfbVnODHo_ttPR_qPm2Sq7b8X9RsEZfpdA,28
+cuenca_validations/types/__init__.py,sha256=Kds2j53zUHdjz8LtjDh8CG6d7CN2yTXs0tvi9VBLZ5U,5737
 cuenca_validations/types/card.py,sha256=UGzz8NTFAverUmdUKAK1oGHnOnjSNTpIRUm93vKSSGY,1295
 cuenca_validations/types/enums.py,sha256=f-qMUdxLZsAqRvEwh3EcUsB2K-loufvPzdcK0JFQ1JY,20586
 cuenca_validations/types/files.py,sha256=2CszbwF9ytXV9suFFwyDjYG4XxY8UhCjRw3HttVXXNw,269
@@ -14,17 +14,17 @@ cuenca_validations/types/helpers.py,sha256=4veeLZbugHHqZk0ezSim978VhH6Vq8XTrEhe1
 cuenca_validations/types/identities.py,sha256=j2xxh3UYHJe6IbAwr9yNXJkebTth_-g3SUmHeiPez8M,5513
 cuenca_validations/types/morals.py,sha256=davabh5hAnFVQyM7-yCyDaT5ewXnm0cr1BtqDIwzkX8,1833
 cuenca_validations/types/queries.py,sha256=iVr6Z8ahXon0rlqQLu7aqRY6WtRxkN-1C7A2zeVt2-4,5314
-cuenca_validations/types/requests.py,sha256=DZOxi1fWgruUvxt-3nNLKiV4IyiG7sG__pp_pl356dc,24064
-cuenca_validations-2.1.31.dev1.dist-info/licenses/LICENSE,sha256=wR76FmxBbfnQpwELkkE5iMF8sFIafEMgXLTE4N4WPTc,1063
+cuenca_validations/types/requests.py,sha256=Ct5C3k41YsqNPzBuj7m_lBAjaQviX5JSLddIQb9AXqU,26105
+cuenca_validations-2.1.32.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=0ERUPtTZz9ST1dMZM_Dm21BbyJQGN_elGR5pvJ_TE2w,3763
+tests/test_requests.py,sha256=lQgOPjLsogpMphl5wg--vxj9JF2DJF0A2DzQVG5dOEU,3072
 tests/test_statement.py,sha256=IOE0rRRBgBZSJv_FLaETEyn5NzzXKMNTqgjv99GX-68,1436
-tests/test_types.py,sha256=_gaLCEH-P_C6hC-NuIDwHmjReVspD6cpG6TtGlj5aec,21435
+tests/test_types.py,sha256=yh4VNab8goZVURop-ZxYdBHUNe7n6-ONbC1WxBYTxU8,23947
 tests/test_validators.py,sha256=Jjr9gWTT4cRntGiKvQK4fncqx3JkEuTWkKm1VqpRHTs,1829
-cuenca_validations-2.1.31.dev1.dist-info/METADATA,sha256=ToRsDABRN4qM8-RHY-1ANipMGA_gG1XtxrNuC-ozHDs,1600
-cuenca_validations-2.1.31.dev1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-cuenca_validations-2.1.31.dev1.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
-cuenca_validations-2.1.31.dev1.dist-info/RECORD,,
+cuenca_validations-2.1.32.dev1.dist-info/METADATA,sha256=v1o0DCoOVtAKNIg-DEkTTY7ThyrAqgFXW8CzOyNf-vs,1600
+cuenca_validations-2.1.32.dev1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cuenca_validations-2.1.32.dev1.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
+cuenca_validations-2.1.32.dev1.dist-info/RECORD,,

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():

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',
     [