cuenca-validations 2.1.35.dev1__py3-none-any.whl → 2.1.36.dev0__py3-none-any.whl

cuenca_validations/types/__init__.py

@@ -44,6 +44,10 @@ __all__ = [
     'FileBatchUploadRequest',
     'FileRequest',
     'FileUploadRequest',
+    'FraudFundsTransferErrorResponse',
+    'FraudFundsTransferReasonCode',
+    'FraudFundsTransferRequest',
+    'FraudFundsTransferSuccessResponse',
     'Gender',
     'IncomeType',
     'IssuerNetwork',
@@ -91,7 +95,6 @@ __all__ = [
     'TransferNetwork',
     'TransferQuery',
     'TransferRequest',
-    'UpdateTransferRequest',
     'UserCardNotification',
     'UserCredentialRequest',
     'UserCredentialUpdateRequest',
@@ -144,6 +147,7 @@ from .enums import (
     EventType,
     FileExtension,
     FileFormat,
+    FraudFundsTransferReasonCode,
     Gender,
     IncomeType,
     IssuerNetwork,
@@ -231,6 +235,9 @@ from .requests import (
     FileBatchUploadRequest,
     FileRequest,
     FileUploadRequest,
+    FraudFundsTransferErrorResponse,
+    FraudFundsTransferRequest,
+    FraudFundsTransferSuccessResponse,
     KYCValidationRequest,
     LimitedWalletRequest,
     PartnerRequest,
@@ -244,7 +251,6 @@ from .requests import (
     StrictTransferRequest,
     TOSRequest,
     TransferRequest,
-    UpdateTransferRequest,
     UserCredentialRequest,
     UserCredentialUpdateRequest,
     UserListsRequest,

cuenca_validations/types/enums.py

@@ -79,6 +79,14 @@ class TransactionStatus(str, Enum):
     failed = 'failed'
 
 
+class FraudFundsTransferReasonCode(str, Enum):
+    user_not_found = 'USER_NOT_FOUND'
+    user_not_fraud_blocked = 'USER_NOT_FRAUD_BLOCKED'
+    insufficient_funds = 'INSUFFICIENT_FUNDS'
+    clabe_invalid = 'CLABE_INVALID'
+    internal_error = 'INTERNAL_ERROR'
+
+
 class TransferNetwork(str, Enum):
     internal = 'internal'
     spei = 'spei'

cuenca_validations/types/queries.py

@@ -154,11 +154,9 @@ class WalletTransactionQuery(QueryParams):
 
 
 class UserQuery(QueryParams):
-    ids: Optional[list[str]] = Field(default=None, max_length=MAX_PAGE_SIZE)
     phone_number: Optional[str] = None
     email_address: Optional[EmailStr] = None
     status: Optional[UserStatus] = None
-    is_blocked: Optional[bool] = None
     identity_uri: Optional[str] = None
     has_curp_document: Optional[bool] = None
     clabe: Optional[Clabe] = None

cuenca_validations/types/requests.py

@@ -29,6 +29,7 @@ from ..types.enums import (
     Country,
     EcommerceIndicator,
     FileExtension,
+    FraudFundsTransferReasonCode,
     Gender,
     IncomeType,
     IssuerNetwork,
@@ -45,7 +46,6 @@ from ..types.enums import (
     State,
     TermsOfService,
     TrackDataMethod,
-    TransactionStatus,
     TransactionTokenValidationStatus,
     UserCardNotification,
     UserStatus,
@@ -155,20 +155,6 @@ class StrictTransferRequest(BaseTransferRequest):
     )
 
 
-class UpdateTransferRequest(BaseRequest):
-    status: TransactionStatus
-
-    @field_validator('status')
-    @classmethod
-    def validate_status(cls, status: TransactionStatus) -> TransactionStatus:
-        if status not in (
-            TransactionStatus.succeeded,
-            TransactionStatus.failed,
-        ):
-            raise ValueError('status must be succeeded or failed')
-        return status
-
-
 class CardUpdateRequest(BaseRequest):
     status: Optional[CardStatus] = None
     pin_block: Optional[str] = None
@@ -324,6 +310,25 @@ class WalletTransactionRequest(BaseRequest):
     amount: StrictPositiveInt
 
 
+class FraudFundsTransferRequest(BaseRequest):
+    request_id: NonEmptyStr
+    user_id: NonEmptyStr
+    clabe: Clabe
+    amount: Optional[StrictPositiveInt] = None
+    concepto: Optional[NonEmptyStr] = None
+
+
+class FraudFundsTransferSuccessResponse(BaseRequest):
+    transaction_id: NonEmptyStr
+    amount: StrictPositiveInt
+    clave_rastreo: NonEmptyStr
+
+
+class FraudFundsTransferErrorResponse(BaseRequest):
+    reason_code: FraudFundsTransferReasonCode
+    message: NonEmptyStr
+
+
 class FraudValidationRequest(BaseModel):
     amount: StrictPositiveInt
     merchant_name: str

cuenca_validations/version.py

@@ -1 +1 @@
-__version__ = '2.1.35.dev1'
+__version__ = '2.1.36.dev0'

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

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

{cuenca_validations-2.1.35.dev1.dist-info → cuenca_validations-2.1.36.dev0.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=nehrKsi9oeYCeBpz_prNpJ9bhEoP4YSvF7CPsJE8Bvk,28
-cuenca_validations/types/__init__.py,sha256=RPS1vCWZe3JWfLg_9njQw-ubDR_JhosNCVSzA3Ue4L0,5575
+cuenca_validations/version.py,sha256=ZTTZbKLgrsc7eKRxJttcvmfXh67hnvcRwc_ZNNFFnTk,28
+cuenca_validations/types/__init__.py,sha256=hvnj0A-oxSr6hBxuAELHhoHeE6VvXZ2QXIRO7Sw3EeA,5809
 cuenca_validations/types/card.py,sha256=UGzz8NTFAverUmdUKAK1oGHnOnjSNTpIRUm93vKSSGY,1295
-cuenca_validations/types/enums.py,sha256=f-qMUdxLZsAqRvEwh3EcUsB2K-loufvPzdcK0JFQ1JY,20586
+cuenca_validations/types/enums.py,sha256=we9to83E3QGcx29rKXVGCPkAmB7T9r1YcGu58dvkamQ,20847
 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=GlG1vquSeYY12cTTLjAQYiZJWqUf5NqwY3kdcAly8Ok,5429
-cuenca_validations/types/requests.py,sha256=PJ_JETvzGD3XsyHUiNMf_3yYbm8lKyymG1cHTcjazmY,24458
-cuenca_validations-2.1.35.dev1.dist-info/licenses/LICENSE,sha256=wR76FmxBbfnQpwELkkE5iMF8sFIafEMgXLTE4N4WPTc,1063
+cuenca_validations/types/queries.py,sha256=iVr6Z8ahXon0rlqQLu7aqRY6WtRxkN-1C7A2zeVt2-4,5314
+cuenca_validations/types/requests.py,sha256=-PmmTHNGHXKq4wf5qN3tUMgczlsHmS8DUyx5vlY3bCE,24544
+cuenca_validations-2.1.36.dev0.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=3XMx2A-BK21g1Exm4RTVm6eKTOzeZH-8FzKJXQmmMmA,4141
+tests/test_requests.py,sha256=lQgOPjLsogpMphl5wg--vxj9JF2DJF0A2DzQVG5dOEU,3072
 tests/test_statement.py,sha256=IOE0rRRBgBZSJv_FLaETEyn5NzzXKMNTqgjv99GX-68,1436
-tests/test_types.py,sha256=6QM18hn3X9YiFWdgZ4PQ76Tzz3U3vwwxBMGo6oI-j44,22290
+tests/test_types.py,sha256=xPBOWsz-VFT8CxfwCAulLshkZKZkIJTjZP40GxwsLgI,23019
 tests/test_validators.py,sha256=Jjr9gWTT4cRntGiKvQK4fncqx3JkEuTWkKm1VqpRHTs,1829
-cuenca_validations-2.1.35.dev1.dist-info/METADATA,sha256=GU1NSq3fXnWKkcLmLC4ROV8mgFWC97PxxycvdbpvVGY,1600
-cuenca_validations-2.1.35.dev1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-cuenca_validations-2.1.35.dev1.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
-cuenca_validations-2.1.35.dev1.dist-info/RECORD,,
+cuenca_validations-2.1.36.dev0.dist-info/METADATA,sha256=VuMgdvHupkIGPO8H-y5rCOjT9H_hSjhzQ129_VHvIOU,1600
+cuenca_validations-2.1.36.dev0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cuenca_validations-2.1.36.dev0.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
+cuenca_validations-2.1.36.dev0.dist-info/RECORD,,

tests/test_requests.py

@@ -5,7 +5,6 @@ from pydantic_extra_types.phone_numbers import PhoneNumber
 from cuenca_validations.types.enums import VerificationType
 from cuenca_validations.types.requests import (
     PasswordResetRequest,
-    UpdateTransferRequest,
     UserTOSAgreementRequest,
     UserUpdateRequest,
     VerificationRequest,
@@ -95,31 +94,3 @@ def test_user_update_request_normalizes_email() -> None:
 def test_user_update_request_normalizes_phone() -> None:
     req = UserUpdateRequest(phone_number=PhoneNumber('+116504401222'))
     assert req.phone_number == '+16504401222'
-
-
-@pytest.mark.parametrize('status', ['succeeded', 'failed'])
-def test_update_transfer_request_valid_status(status: str) -> None:
-    req = UpdateTransferRequest.model_validate({'status': status})
-    assert req.status == status
-    assert req.model_dump() == {'status': status}
-
-
-@pytest.mark.parametrize('status', ['created', 'submitted', 'in_review'])
-def test_update_transfer_request_invalid_status(status: str) -> None:
-    with pytest.raises(ValidationError) as ex:
-        UpdateTransferRequest.model_validate({'status': status})
-    assert 'status' in str(ex.value)
-
-
-def test_update_transfer_request_missing_status() -> None:
-    with pytest.raises(ValidationError) as ex:
-        UpdateTransferRequest.model_validate({})
-    assert 'status' in str(ex.value)
-
-
-def test_update_transfer_request_forbids_extra() -> None:
-    with pytest.raises(ValidationError) as ex:
-        UpdateTransferRequest.model_validate(
-            {'status': 'succeeded', 'foo': 'bar'}
-        )
-    assert 'Extra inputs are not permitted' in str(ex.value)

tests/test_types.py

@@ -12,6 +12,10 @@ from pydantic.fields import FieldInfo
 
 from cuenca_validations.types import (
     CardQuery,
+    FraudFundsTransferErrorResponse,
+    FraudFundsTransferReasonCode,
+    FraudFundsTransferRequest,
+    FraudFundsTransferSuccessResponse,
     JSONEncoder,
     QueryParams,
     SantizedDict,
@@ -247,34 +251,6 @@ def test_user_query_rejects_invalid(field, value):
         UserQuery(**{field: value})
 
 
-def test_user_query_accepts_ids_and_is_blocked():
-    query = UserQuery(ids=['US1', 'US2'], is_blocked=True)
-    assert query.ids == ['US1', 'US2']
-    assert query.is_blocked is True
-    dumped = query.model_dump(exclude_none=True)
-    assert dumped['ids'] == ['US1', 'US2']
-    assert dumped['is_blocked'] is True
-    assert isinstance(dumped['ids'], list)
-
-
-def test_user_query_rejects_ids_over_limit():
-    with pytest.raises(ValidationError):
-        UserQuery(ids=[f'US{i}' for i in range(101)])
-
-
-def test_user_query_ids_empty_list_ok():
-    query = UserQuery(ids=[])
-    assert query.ids == []
-    assert 'ids' in query.model_dump(exclude_none=True)
-
-
-def test_user_query_ids_none_excluded_from_dump():
-    query = UserQuery()
-    dumped = query.model_dump(exclude_none=True)
-    assert 'ids' not in dumped
-    assert 'is_blocked' not in dumped
-
-
 def test_exclude_none_in_dict():
     request = ApiKeyUpdateRequest(user_id='US123')
     assert request.model_dump() == dict(user_id='US123')
@@ -664,6 +640,59 @@ def test_bank_account_validation_clabe_request():
     assert BankAccountValidationRequest(account_number='646180157098510917')
 
 
+def test_fraud_funds_transfer_models():
+    request = FraudFundsTransferRequest(
+        request_id='f0a2b3-request-hash',
+        user_id='US123',
+        clabe='646180157098510917',
+        amount=10000,
+        concepto='  Devolución fraude  ',
+    )
+
+    assert request.concepto == 'Devolución fraude'
+    assert request.model_dump() == {
+        'request_id': 'f0a2b3-request-hash',
+        'user_id': 'US123',
+        'clabe': '646180157098510917',
+        'amount': 10000,
+        'concepto': 'Devolución fraude',
+    }
+
+    request_full_balance = FraudFundsTransferRequest(
+        request_id='f0a2b3-request-hash',
+        user_id='US123',
+        clabe='646180157098510917',
+    )
+
+    assert request_full_balance.model_dump() == {
+        'request_id': 'f0a2b3-request-hash',
+        'user_id': 'US123',
+        'clabe': '646180157098510917',
+    }
+
+    success = FraudFundsTransferSuccessResponse(
+        transaction_id='SP123',
+        amount=10000,
+        clave_rastreo='CUENCA123',
+    )
+
+    assert success.model_dump() == {
+        'transaction_id': 'SP123',
+        'amount': 10000,
+        'clave_rastreo': 'CUENCA123',
+    }
+
+    error = FraudFundsTransferErrorResponse(
+        reason_code=FraudFundsTransferReasonCode.insufficient_funds,
+        message='Fondos insuficientes',
+    )
+
+    assert error.model_dump() == {
+        'reason_code': 'INSUFFICIENT_FUNDS',
+        'message': 'Fondos insuficientes',
+    }
+
+
 @pytest.mark.parametrize(
     'input_data',
     [