cuenca-validations 2.1.35.dev2__tar.gz → 2.1.36.dev0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/PKG-INFO +1 -1
  2. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/__init__.py +8 -2
  3. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/enums.py +8 -0
  4. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/queries.py +0 -2
  5. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/requests.py +20 -15
  6. cuenca_validations-2.1.36.dev0/cuenca_validations/version.py +1 -0
  7. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations.egg-info/PKG-INFO +1 -1
  8. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/tests/test_requests.py +0 -29
  9. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/tests/test_types.py +57 -33
  10. cuenca_validations-2.1.35.dev2/cuenca_validations/version.py +0 -1
  11. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/LICENSE +0 -0
  12. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/README.md +0 -0
  13. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/__init__.py +0 -0
  14. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/card_bins.py +0 -0
  15. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/errors.py +0 -0
  16. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/py.typed +0 -0
  17. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/card.py +0 -0
  18. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/files.py +0 -0
  19. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/general.py +0 -0
  20. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/helpers.py +0 -0
  21. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/identities.py +0 -0
  22. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/types/morals.py +0 -0
  23. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/typing.py +0 -0
  24. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations/validators.py +0 -0
  25. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations.egg-info/SOURCES.txt +0 -0
  26. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations.egg-info/dependency_links.txt +0 -0
  27. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations.egg-info/requires.txt +0 -0
  28. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/cuenca_validations.egg-info/top_level.txt +0 -0
  29. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/setup.cfg +0 -0
  30. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/setup.py +0 -0
  31. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/tests/__init__.py +0 -0
  32. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/tests/test_card.py +0 -0
  33. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/tests/test_errors.py +0 -0
  34. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/tests/test_helpers.py +0 -0
  35. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/tests/test_statement.py +0 -0
  36. {cuenca_validations-2.1.35.dev2 → cuenca_validations-2.1.36.dev0}/tests/test_validators.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: cuenca_validations
3
- Version: 2.1.35.dev2
3
+ Version: 2.1.36.dev0
4
4
  Summary: Cuenca common validations
5
5
  Home-page: https://github.com/cuenca-mx/cuenca-validations
6
6
  Author: Cuenca
@@ -44,6 +44,10 @@ __all__ = [
44
44
  'FileBatchUploadRequest',
45
45
  'FileRequest',
46
46
  'FileUploadRequest',
47
+ 'FraudFundsTransferErrorResponse',
48
+ 'FraudFundsTransferReasonCode',
49
+ 'FraudFundsTransferRequest',
50
+ 'FraudFundsTransferSuccessResponse',
47
51
  'Gender',
48
52
  'IncomeType',
49
53
  'IssuerNetwork',
@@ -91,7 +95,6 @@ __all__ = [
91
95
  'TransferNetwork',
92
96
  'TransferQuery',
93
97
  'TransferRequest',
94
- 'UpdateTransferRequest',
95
98
  'UserCardNotification',
96
99
  'UserCredentialRequest',
97
100
  'UserCredentialUpdateRequest',
@@ -144,6 +147,7 @@ from .enums import (
144
147
  EventType,
145
148
  FileExtension,
146
149
  FileFormat,
150
+ FraudFundsTransferReasonCode,
147
151
  Gender,
148
152
  IncomeType,
149
153
  IssuerNetwork,
@@ -231,6 +235,9 @@ from .requests import (
231
235
  FileBatchUploadRequest,
232
236
  FileRequest,
233
237
  FileUploadRequest,
238
+ FraudFundsTransferErrorResponse,
239
+ FraudFundsTransferRequest,
240
+ FraudFundsTransferSuccessResponse,
234
241
  KYCValidationRequest,
235
242
  LimitedWalletRequest,
236
243
  PartnerRequest,
@@ -244,7 +251,6 @@ from .requests import (
244
251
  StrictTransferRequest,
245
252
  TOSRequest,
246
253
  TransferRequest,
247
- UpdateTransferRequest,
248
254
  UserCredentialRequest,
249
255
  UserCredentialUpdateRequest,
250
256
  UserListsRequest,
@@ -79,6 +79,14 @@ class TransactionStatus(str, Enum):
79
79
  failed = 'failed'
80
80
 
81
81
 
82
+ class FraudFundsTransferReasonCode(str, Enum):
83
+ user_not_found = 'USER_NOT_FOUND'
84
+ user_not_fraud_blocked = 'USER_NOT_FRAUD_BLOCKED'
85
+ insufficient_funds = 'INSUFFICIENT_FUNDS'
86
+ clabe_invalid = 'CLABE_INVALID'
87
+ internal_error = 'INTERNAL_ERROR'
88
+
89
+
82
90
  class TransferNetwork(str, Enum):
83
91
  internal = 'internal'
84
92
  spei = 'spei'
@@ -40,7 +40,6 @@ class QueryParams(BaseModel):
40
40
  ]
41
41
  limit: Optional[PositiveInt] = None
42
42
  user_id: Optional[str] = None
43
- ids: Optional[list[str]] = Field(default=None, max_length=MAX_PAGE_SIZE)
44
43
  created_before: Optional[dt.datetime] = None
45
44
  created_after: Optional[dt.datetime] = None
46
45
  related_transaction: Optional[str] = None
@@ -158,7 +157,6 @@ class UserQuery(QueryParams):
158
157
  phone_number: Optional[str] = None
159
158
  email_address: Optional[EmailStr] = None
160
159
  status: Optional[UserStatus] = None
161
- is_blocked: Optional[bool] = None
162
160
  identity_uri: Optional[str] = None
163
161
  has_curp_document: Optional[bool] = None
164
162
  clabe: Optional[Clabe] = None
@@ -29,6 +29,7 @@ from ..types.enums import (
29
29
  Country,
30
30
  EcommerceIndicator,
31
31
  FileExtension,
32
+ FraudFundsTransferReasonCode,
32
33
  Gender,
33
34
  IncomeType,
34
35
  IssuerNetwork,
@@ -45,7 +46,6 @@ from ..types.enums import (
45
46
  State,
46
47
  TermsOfService,
47
48
  TrackDataMethod,
48
- TransactionStatus,
49
49
  TransactionTokenValidationStatus,
50
50
  UserCardNotification,
51
51
  UserStatus,
@@ -155,20 +155,6 @@ class StrictTransferRequest(BaseTransferRequest):
155
155
  )
156
156
 
157
157
 
158
- class UpdateTransferRequest(BaseRequest):
159
- status: TransactionStatus
160
-
161
- @field_validator('status')
162
- @classmethod
163
- def validate_status(cls, status: TransactionStatus) -> TransactionStatus:
164
- if status not in (
165
- TransactionStatus.succeeded,
166
- TransactionStatus.failed,
167
- ):
168
- raise ValueError('status must be succeeded or failed')
169
- return status
170
-
171
-
172
158
  class CardUpdateRequest(BaseRequest):
173
159
  status: Optional[CardStatus] = None
174
160
  pin_block: Optional[str] = None
@@ -324,6 +310,25 @@ class WalletTransactionRequest(BaseRequest):
324
310
  amount: StrictPositiveInt
325
311
 
326
312
 
313
+ class FraudFundsTransferRequest(BaseRequest):
314
+ request_id: NonEmptyStr
315
+ user_id: NonEmptyStr
316
+ clabe: Clabe
317
+ amount: Optional[StrictPositiveInt] = None
318
+ concepto: Optional[NonEmptyStr] = None
319
+
320
+
321
+ class FraudFundsTransferSuccessResponse(BaseRequest):
322
+ transaction_id: NonEmptyStr
323
+ amount: StrictPositiveInt
324
+ clave_rastreo: NonEmptyStr
325
+
326
+
327
+ class FraudFundsTransferErrorResponse(BaseRequest):
328
+ reason_code: FraudFundsTransferReasonCode
329
+ message: NonEmptyStr
330
+
331
+
327
332
  class FraudValidationRequest(BaseModel):
328
333
  amount: StrictPositiveInt
329
334
  merchant_name: str
@@ -0,0 +1 @@
1
+ __version__ = '2.1.36.dev0'
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: cuenca_validations
3
- Version: 2.1.35.dev2
3
+ Version: 2.1.36.dev0
4
4
  Summary: Cuenca common validations
5
5
  Home-page: https://github.com/cuenca-mx/cuenca-validations
6
6
  Author: Cuenca
@@ -5,7 +5,6 @@ from pydantic_extra_types.phone_numbers import PhoneNumber
5
5
  from cuenca_validations.types.enums import VerificationType
6
6
  from cuenca_validations.types.requests import (
7
7
  PasswordResetRequest,
8
- UpdateTransferRequest,
9
8
  UserTOSAgreementRequest,
10
9
  UserUpdateRequest,
11
10
  VerificationRequest,
@@ -95,31 +94,3 @@ def test_user_update_request_normalizes_email() -> None:
95
94
  def test_user_update_request_normalizes_phone() -> None:
96
95
  req = UserUpdateRequest(phone_number=PhoneNumber('+116504401222'))
97
96
  assert req.phone_number == '+16504401222'
98
-
99
-
100
- @pytest.mark.parametrize('status', ['succeeded', 'failed'])
101
- def test_update_transfer_request_valid_status(status: str) -> None:
102
- req = UpdateTransferRequest.model_validate({'status': status})
103
- assert req.status == status
104
- assert req.model_dump() == {'status': status}
105
-
106
-
107
- @pytest.mark.parametrize('status', ['created', 'submitted', 'in_review'])
108
- def test_update_transfer_request_invalid_status(status: str) -> None:
109
- with pytest.raises(ValidationError) as ex:
110
- UpdateTransferRequest.model_validate({'status': status})
111
- assert 'status' in str(ex.value)
112
-
113
-
114
- def test_update_transfer_request_missing_status() -> None:
115
- with pytest.raises(ValidationError) as ex:
116
- UpdateTransferRequest.model_validate({})
117
- assert 'status' in str(ex.value)
118
-
119
-
120
- def test_update_transfer_request_forbids_extra() -> None:
121
- with pytest.raises(ValidationError) as ex:
122
- UpdateTransferRequest.model_validate(
123
- {'status': 'succeeded', 'foo': 'bar'}
124
- )
125
- assert 'Extra inputs are not permitted' in str(ex.value)
@@ -12,6 +12,10 @@ from pydantic.fields import FieldInfo
12
12
 
13
13
  from cuenca_validations.types import (
14
14
  CardQuery,
15
+ FraudFundsTransferErrorResponse,
16
+ FraudFundsTransferReasonCode,
17
+ FraudFundsTransferRequest,
18
+ FraudFundsTransferSuccessResponse,
15
19
  JSONEncoder,
16
20
  QueryParams,
17
21
  SantizedDict,
@@ -247,39 +251,6 @@ def test_user_query_rejects_invalid(field, value):
247
251
  UserQuery(**{field: value})
248
252
 
249
253
 
250
- def test_user_query_accepts_ids_and_is_blocked():
251
- query = UserQuery(ids=['US1', 'US2'], is_blocked=True)
252
- assert query.ids == ['US1', 'US2']
253
- assert query.is_blocked is True
254
- dumped = query.model_dump(exclude_none=True)
255
- assert dumped['ids'] == ['US1', 'US2']
256
- assert dumped['is_blocked'] is True
257
- assert isinstance(dumped['ids'], list)
258
-
259
-
260
- def test_query_params_accepts_ids():
261
- query = QueryParams(ids=['US1', 'US2'])
262
- assert query.ids == ['US1', 'US2']
263
-
264
-
265
- def test_user_query_rejects_ids_over_limit():
266
- with pytest.raises(ValidationError):
267
- UserQuery(ids=[f'US{i}' for i in range(101)])
268
-
269
-
270
- def test_user_query_ids_empty_list_ok():
271
- query = UserQuery(ids=[])
272
- assert query.ids == []
273
- assert 'ids' in query.model_dump(exclude_none=True)
274
-
275
-
276
- def test_user_query_ids_none_excluded_from_dump():
277
- query = UserQuery()
278
- dumped = query.model_dump(exclude_none=True)
279
- assert 'ids' not in dumped
280
- assert 'is_blocked' not in dumped
281
-
282
-
283
254
  def test_exclude_none_in_dict():
284
255
  request = ApiKeyUpdateRequest(user_id='US123')
285
256
  assert request.model_dump() == dict(user_id='US123')
@@ -669,6 +640,59 @@ def test_bank_account_validation_clabe_request():
669
640
  assert BankAccountValidationRequest(account_number='646180157098510917')
670
641
 
671
642
 
643
+ def test_fraud_funds_transfer_models():
644
+ request = FraudFundsTransferRequest(
645
+ request_id='f0a2b3-request-hash',
646
+ user_id='US123',
647
+ clabe='646180157098510917',
648
+ amount=10000,
649
+ concepto=' Devolución fraude ',
650
+ )
651
+
652
+ assert request.concepto == 'Devolución fraude'
653
+ assert request.model_dump() == {
654
+ 'request_id': 'f0a2b3-request-hash',
655
+ 'user_id': 'US123',
656
+ 'clabe': '646180157098510917',
657
+ 'amount': 10000,
658
+ 'concepto': 'Devolución fraude',
659
+ }
660
+
661
+ request_full_balance = FraudFundsTransferRequest(
662
+ request_id='f0a2b3-request-hash',
663
+ user_id='US123',
664
+ clabe='646180157098510917',
665
+ )
666
+
667
+ assert request_full_balance.model_dump() == {
668
+ 'request_id': 'f0a2b3-request-hash',
669
+ 'user_id': 'US123',
670
+ 'clabe': '646180157098510917',
671
+ }
672
+
673
+ success = FraudFundsTransferSuccessResponse(
674
+ transaction_id='SP123',
675
+ amount=10000,
676
+ clave_rastreo='CUENCA123',
677
+ )
678
+
679
+ assert success.model_dump() == {
680
+ 'transaction_id': 'SP123',
681
+ 'amount': 10000,
682
+ 'clave_rastreo': 'CUENCA123',
683
+ }
684
+
685
+ error = FraudFundsTransferErrorResponse(
686
+ reason_code=FraudFundsTransferReasonCode.insufficient_funds,
687
+ message='Fondos insuficientes',
688
+ )
689
+
690
+ assert error.model_dump() == {
691
+ 'reason_code': 'INSUFFICIENT_FUNDS',
692
+ 'message': 'Fondos insuficientes',
693
+ }
694
+
695
+
672
696
  @pytest.mark.parametrize(
673
697
  'input_data',
674
698
  [
@@ -1 +0,0 @@
1
- __version__ = '2.1.35.dev2'