cuenca-validations 2.1.46__py3-none-any.whl → 2.1.48.dev0__py3-none-any.whl

cuenca_validations/types/__init__.py

@@ -67,6 +67,7 @@ __all__ = [
     'LegalPersonRequest',
     'LegalPersonUpdateRequest',
     'OperatorLoginRequest',
+    'OperatorLoginUpdateRequest',
     'OperatorQuery',
     'OperatorRequest',
     'OperatorRole',
@@ -82,6 +83,7 @@ __all__ = [
     'Profession',
     'QueryParams',
     'ReferencedClabeRequest',
+    'RejectTransferOrderRequest',
     'LegalRfc',
     'Rfc',
     'QuestionnairesRequest',
@@ -106,6 +108,11 @@ __all__ = [
     'TransactionQuery',
     'TransactionStatus',
     'TransferNetwork',
+    'TransferOrderLineRequest',
+    'TransferOrderLineStatus',
+    'TransferOrderQuery',
+    'TransferOrderRequest',
+    'TransferOrderStatus',
     'TransferQuery',
     'TransferRequest',
     'UpdateTransferRequest',
@@ -184,6 +191,8 @@ from .enums import (
     TrackDataMethod,
     TransactionStatus,
     TransferNetwork,
+    TransferOrderLineStatus,
+    TransferOrderStatus,
     UserCardNotification,
     UserStatus,
     UserType,
@@ -238,6 +247,7 @@ from .queries import (
     StatementQuery,
     TOSQuery,
     TransactionQuery,
+    TransferOrderQuery,
     TransferQuery,
     UserQuery,
     UsersTOSQuery,
@@ -263,6 +273,7 @@ from .requests import (
     LegalPersonUpdateRequest,
     LimitedWalletRequest,
     OperatorLoginRequest,
+    OperatorLoginUpdateRequest,
     OperatorRequest,
     OperatorUpdateRequest,
     PartnerRequest,
@@ -271,11 +282,14 @@ from .requests import (
     PlatformRequest,
     QuestionnairesRequest,
     ReferencedClabeRequest,
+    RejectTransferOrderRequest,
     SavingRequest,
     SavingUpdateRequest,
     SessionRequest,
     StrictTransferRequest,
     TOSRequest,
+    TransferOrderLineRequest,
+    TransferOrderRequest,
     TransferRequest,
     UpdateTransferRequest,
     UserCredentialRequest,

cuenca_validations/types/enums.py

@@ -761,3 +761,17 @@ class OperatorRole(str, Enum):
 class OperatorStatus(str, Enum):
     active = 'active'
     deactivated = 'deactivated'
+
+
+class TransferOrderStatus(str, Enum):
+    created = 'created'
+    authorizing = 'authorizing'
+    authorized = 'authorized'
+    rejected = 'rejected'
+    expired = 'expired'
+
+
+class TransferOrderLineStatus(str, Enum):
+    pending = 'pending'
+    invalid = 'invalid'
+    submitted = 'submitted'

cuenca_validations/types/queries.py

@@ -25,6 +25,7 @@ from .enums import (
     SessionType,
     TermsOfService,
     TransferNetwork,
+    TransferOrderStatus,
     UserStatus,
 )
 from .general import NormalizedName
@@ -233,3 +234,7 @@ class TOSQuery(QueryParams):
 
 class UsersTOSQuery(QueryParams):
     type: TermsOfService
+
+
+class TransferOrderQuery(QueryParams):
+    status: Optional[TransferOrderStatus] = None

cuenca_validations/types/requests.py

@@ -993,6 +993,16 @@ class OperatorLoginRequest(BaseRequest):
         return normalize_email(email)
 
 
+class OperatorLoginUpdateRequest(BaseRequest):
+    """Complete operator login by verifying the emailed OTP code."""
+
+    code: StrictStr
+
+    model_config = ConfigDict(
+        json_schema_extra={'example': {'code': '123456'}},
+    )
+
+
 class ReferencedClabeRequest(BaseRequest):
     legal_person_id: str
     allowed_curp_rfc: Union[Curp, Rfc]
@@ -1009,3 +1019,90 @@ class ReferencedClabeRequest(BaseRequest):
 
 class PhoneVerificationAssociationRequest(BaseRequest):
     verification_id: str
+
+
+MAX_TRANSFER_ORDER_BATCH_LINES = 5000
+MAX_TRANSFER_ORDER_EXPIRATION_HOURS = 24 * 7
+
+
+class TransferOrderLineRequest(BaseRequest):
+    account_number: str
+    recipient_name: str
+    amount: int
+    descriptor: str
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'account_number': '646180157034181180',
+                'recipient_name': 'Doroteo Arango',
+                'amount': 100_00,
+                'descriptor': 'Mezcal, pulque y tequila',
+            }
+        },
+    )
+
+
+class TransferOrderRequest(BaseRequest):
+    account_number: Optional[str] = None
+    recipient_name: Optional[str] = None
+    amount: Optional[int] = None
+    descriptor: Optional[str] = None
+    idempotency_key: str
+    user_id: Optional[str] = None
+    items: Optional[list[TransferOrderLineRequest]] = None
+    expires_in_hours: Optional[int] = Field(
+        default=None,
+        gt=0,
+        le=MAX_TRANSFER_ORDER_EXPIRATION_HOURS,
+    )
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'account_number': '646180157034181180',
+                'recipient_name': 'Doroteo Arango',
+                'amount': 100_00,
+                'descriptor': 'Mezcal, pulque y tequila',
+                'idempotency_key': 'UNIQUE-KEY-003',
+                'user_id': 'USWqY5cvkISJOxHyEKjAKf8w',
+            }
+        },
+    )
+
+    @model_validator(mode='after')
+    def require_unitario_or_batch(self) -> 'TransferOrderRequest':
+        has_items = bool(self.items)
+        has_flat = all(
+            (
+                self.account_number is not None,
+                self.recipient_name is not None,
+                self.amount is not None,
+                self.descriptor is not None,
+            )
+        )
+        if has_items == has_flat:
+            raise ValueError(
+                'Provide either a single transfer (account_number, '
+                'recipient_name, amount, descriptor) or items[] for a batch, '
+                'not both'
+            )
+        if self.items is not None:
+            if len(self.items) > MAX_TRANSFER_ORDER_BATCH_LINES:
+                raise ValueError(
+                    'Batch exceeds maximum of '
+                    f'{MAX_TRANSFER_ORDER_BATCH_LINES} lines'
+                )
+            if len(self.items) == 0:
+                raise ValueError('items must not be empty')
+        return self
+
+
+class RejectTransferOrderRequest(BaseRequest):
+    rejection_reason: str
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {'rejection_reason': 'Monto incorrecto'},
+        },
+    )

cuenca_validations/version.py

@@ -1 +1 @@
-__version__ = '2.1.46'
+__version__ = '2.1.48.dev0'

{cuenca_validations-2.1.46.dist-info → cuenca_validations-2.1.48.dev0.dist-info}/METADATA

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

{cuenca_validations-2.1.46.dist-info → cuenca_validations-2.1.48.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=qrVkFn9wN3ixgGNyDIl37hQmWG1KAb99ogbPdgnvZUc,23
-cuenca_validations/types/__init__.py,sha256=VmGxElYrSqQAb1jGT90s4b_63km_iFuEryQDJ-47y5M,6361
+cuenca_validations/version.py,sha256=sASQTkqyEonq314x5AyyyiBSthTdrHeFL3tD1aNL-yI,28
+cuenca_validations/types/__init__.py,sha256=-xNuGHXmkzEcWsBK6Y48cnFYeLAACBrn6ZAYeQv3LzA,6771
 cuenca_validations/types/card.py,sha256=UGzz8NTFAverUmdUKAK1oGHnOnjSNTpIRUm93vKSSGY,1295
-cuenca_validations/types/enums.py,sha256=w-7dMR_Dg3mcmwn7A16Dy1oq-DUycVNg6CPOQ5UQog8,20960
+cuenca_validations/types/enums.py,sha256=8PgHV_BAaaO_lwFggeAswuUupcjysPOWZnyNzYoR4Dc,21256
 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=rFbvV70VS2AnSQ6ZGT5NUr0yYzKgIiGronHjnMStF0c,6019
-cuenca_validations/types/requests.py,sha256=wUVHN20YG5bsJ4QVIkrPYyLEpVfibbf_3kkL55hjgrs,29678
-cuenca_validations-2.1.46.dist-info/licenses/LICENSE,sha256=wR76FmxBbfnQpwELkkE5iMF8sFIafEMgXLTE4N4WPTc,1063
+cuenca_validations/types/queries.py,sha256=yJZGW3p6uWGaBm6mjDp7KBgg7oLh0CUlAJeeVLRzowk,6134
+cuenca_validations/types/requests.py,sha256=-1QE3tFwX5LhKyRXlNryZKQ2KTsu_QRQAcZiRrDEt7o,32553
+cuenca_validations-2.1.48.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=SXumnZ602n5KrOLJlh41SvBQNyIvNUwr7yVeYKEUr-g,6992
+tests/test_requests.py,sha256=mjH-VbU_jCdgjQPAalTcJo76iL6tSBnmyengiAY-M20,8671
 tests/test_statement.py,sha256=IOE0rRRBgBZSJv_FLaETEyn5NzzXKMNTqgjv99GX-68,1436
 tests/test_types.py,sha256=rPjqPGfPU73MSdbeJpoW_ai5TAO25hWSnQAt_H7ZIeI,23055
 tests/test_validators.py,sha256=Jjr9gWTT4cRntGiKvQK4fncqx3JkEuTWkKm1VqpRHTs,1829
-cuenca_validations-2.1.46.dist-info/METADATA,sha256=I-ruo3wsej_4x82WCracwJOQCMOyL9k7fvT3iC-w0UM,1595
-cuenca_validations-2.1.46.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-cuenca_validations-2.1.46.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
-cuenca_validations-2.1.46.dist-info/RECORD,,
+cuenca_validations-2.1.48.dev0.dist-info/METADATA,sha256=hefgQaOl2YwGK7Z3FBq5b0OPYBw8IEFay_KLV0r95XU,1600
+cuenca_validations-2.1.48.dev0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+cuenca_validations-2.1.48.dev0.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
+cuenca_validations-2.1.48.dev0.dist-info/RECORD,,

tests/test_requests.py

@@ -9,10 +9,13 @@ from cuenca_validations.types.enums import (
 )
 from cuenca_validations.types.queries import OperatorQuery
 from cuenca_validations.types.requests import (
+    MAX_TRANSFER_ORDER_BATCH_LINES,
     OperatorLoginRequest,
+    OperatorLoginUpdateRequest,
     OperatorRequest,
     OperatorUpdateRequest,
     PasswordResetRequest,
+    TransferOrderRequest,
     UpdateTransferRequest,
     UserTOSAgreementRequest,
     UserUpdateRequest,
@@ -90,6 +93,19 @@ def test_operator_login_request_forbids_extra() -> None:
     assert 'Extra inputs are not permitted' in str(ex.value)
 
 
+def test_operator_login_update_request_valid() -> None:
+    req = OperatorLoginUpdateRequest.model_validate({'code': '123456'})
+    assert req.code == '123456'
+
+
+def test_operator_login_update_request_forbids_extra() -> None:
+    with pytest.raises(ValidationError) as ex:
+        OperatorLoginUpdateRequest.model_validate(
+            {'code': '123456', 'foo': 'bar'}
+        )
+    assert 'Extra inputs are not permitted' in str(ex.value)
+
+
 def test_operator_query_valid() -> None:
     query = OperatorQuery.model_validate({'email': 'maria.lopez@aceros.com'})
     assert str(query.email) == 'maria.lopez@aceros.com'
@@ -218,3 +234,36 @@ def test_update_transfer_request_forbids_extra() -> None:
             {'status': 'succeeded', 'foo': 'bar'}
         )
     assert 'Extra inputs are not permitted' in str(ex.value)
+
+
+def test_transfer_order_request_shape() -> None:
+    line = {
+        'account_number': '646180157034181180',
+        'recipient_name': 'Doroteo Arango',
+        'amount': 100_00,
+        'descriptor': 'Mezcal',
+    }
+    single = TransferOrderRequest.model_validate(
+        {**line, 'idempotency_key': 'single'}
+    )
+    assert single.items is None
+    batch = TransferOrderRequest.model_validate(
+        {'idempotency_key': 'batch', 'items': [line]}
+    )
+    assert batch.items is not None
+
+    with pytest.raises(ValidationError, match='not both'):
+        TransferOrderRequest.model_validate(
+            {**line, 'idempotency_key': 'both', 'items': [line]}
+        )
+    with pytest.raises(ValidationError, match='items must not be empty'):
+        TransferOrderRequest.model_validate(
+            {**line, 'idempotency_key': 'empty', 'items': []}
+        )
+    with pytest.raises(ValidationError, match='Batch exceeds maximum'):
+        TransferOrderRequest.model_validate(
+            {
+                'idempotency_key': 'too-many',
+                'items': [line] * (MAX_TRANSFER_ORDER_BATCH_LINES + 1),
+            }
+        )