cuenca-validations 2.1.41.dev1__py3-none-any.whl → 2.1.41.dev3__py3-none-any.whl

cuenca_validations/types/__init__.py

@@ -60,15 +60,16 @@ __all__ = [
     'KYCValidationRequest',
     'KYCValidationSource',
     'Language',
+    'LegalPersonRequest',
+    'LegalPersonUpdateRequest',
     'LimitedWalletRequest',
     'MonthlyMovementsType',
     'MonthlySpendingType',
-    'MoralPersonRequest',
-    'MoralPersonUpdateRequest',
     'OperationalEventAction',
     'OperationalEventQuery',
     'OperatorLoginRequest',
     'OperatorLoginResponse',
+    'OperatorQuery',
     'OperatorRequest',
     'OperatorRole',
     'OperatorStatus',
@@ -90,8 +91,10 @@ __all__ = [
     'SavingRequest',
     'SavingUpdateRequest',
     'ServiceProviderCategory',
+    'SessionMetadata',
     'SessionQuery',
     'SessionRequest',
+    'SessionResponse',
     'SessionType',
     'State',
     'StatementQuery',
@@ -231,6 +234,7 @@ from .queries import (
     FileQuery,
     IdentityQuery,
     OperationalEventQuery,
+    OperatorQuery,
     PostalCodeQuery,
     QueryParams,
     SessionQuery,
@@ -258,9 +262,9 @@ from .requests import (
     FileUploadRequest,
     FraudFundsTransferRequest,
     KYCValidationRequest,
+    LegalPersonRequest,
+    LegalPersonUpdateRequest,
     LimitedWalletRequest,
-    MoralPersonRequest,
-    MoralPersonUpdateRequest,
     OperatorLoginRequest,
     OperatorLoginResponse,
     OperatorRequest,
@@ -272,7 +276,9 @@ from .requests import (
     QuestionnairesRequest,
     SavingRequest,
     SavingUpdateRequest,
+    SessionMetadata,
     SessionRequest,
+    SessionResponse,
     StrictTransferRequest,
     TOSRequest,
     TransferRequest,

cuenca_validations/types/enums.py

@@ -624,6 +624,7 @@ class WebhookEvent(str, Enum):
 class UserType(str, Enum):
     physical = 'physical'
     moral = 'moral'
+    legal_person = 'legal_person'
 
 
 class VerificationType(str, Enum):

cuenca_validations/types/queries.py

@@ -159,6 +159,10 @@ class OperationalEventQuery(QueryParams):
     action: Optional[OperationalEventAction] = None
 
 
+class OperatorQuery(QueryParams):
+    email: Optional[EmailStr] = None
+
+
 class BalanceEntryQuery(QueryParams):
     funding_instrument_uri: Optional[str] = None
     wallet_id: str = 'default'

cuenca_validations/types/requests.py

@@ -632,11 +632,29 @@ class UserLoginRequest(BaseRequest):
     )
 
 
+class SessionMetadata(BaseModel):
+    operator_id: Optional[str] = None
+    model_config = ConfigDict(extra='forbid')
+
+
+class SessionResponse(BaseModel):
+    id: str
+    created_at: dt.datetime
+    user_id: str
+    platform_id: str
+    expires_at: dt.datetime
+    type: SessionType
+    success_url: Optional[SerializableAnyUrl] = None
+    failure_url: Optional[SerializableAnyUrl] = None
+    metadata: Optional[SessionMetadata] = None
+
+
 class SessionRequest(BaseRequest):
     user_id: str
     type: SessionType
     success_url: Optional[SerializableAnyUrl] = None
     failure_url: Optional[SerializableAnyUrl] = None
+    metadata: Optional[SessionMetadata] = None
     model_config = ConfigDict(
         json_schema_extra={
             'example': {
@@ -899,7 +917,7 @@ class PartnerUpdateRequest(BaseRequest):
     shareholders: Optional[list[Shareholder]] = None
 
 
-class MoralPersonRequest(BaseRequest):
+class LegalPersonRequest(BaseRequest):
     legal_name: str
     rfc: Rfc
     legal_representatives: list[LegalRepresentative]
@@ -927,13 +945,13 @@ class MoralPersonRequest(BaseRequest):
 
     @field_validator('rfc')
     @classmethod
-    def validate_moral_rfc(cls, rfc: Rfc) -> Rfc:
+    def validate_legal_rfc(cls, rfc: Rfc) -> Rfc:
         if len(rfc) != 12:
-            raise ValueError('RFC must be 12 characters for moral persons')
+            raise ValueError('RFC must be 12 characters for legal persons')
         return rfc
 
 
-class MoralPersonUpdateRequest(BaseRequest):
+class LegalPersonUpdateRequest(BaseRequest):
     legal_name: Optional[str] = None
     rfc: Optional[Rfc] = None
     legal_representatives: Optional[list[LegalRepresentative]] = None
@@ -947,9 +965,9 @@ class MoralPersonUpdateRequest(BaseRequest):
 
     @field_validator('rfc')
     @classmethod
-    def validate_moral_rfc(cls, rfc: Optional[Rfc]) -> Optional[Rfc]:
+    def validate_legal_rfc(cls, rfc: Optional[Rfc]) -> Optional[Rfc]:
         if rfc is not None and len(rfc) != 12:
-            raise ValueError('RFC must be 12 characters for moral persons')
+            raise ValueError('RFC must be 12 characters for legal persons')
         return rfc
 
 

cuenca_validations/version.py

@@ -1 +1 @@
-__version__ = '2.1.41.dev1'
+__version__ = '2.1.41.dev3'

{cuenca_validations-2.1.41.dev1.dist-info → cuenca_validations-2.1.41.dev3.dist-info}/METADATA

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

{cuenca_validations-2.1.41.dev1.dist-info → cuenca_validations-2.1.41.dev3.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=8vBTEb00cimUGbORVDKZKFmy6McE_C2hEVctFO5ycwg,28
-cuenca_validations/types/__init__.py,sha256=xqc0H9XGx1Qe5FCkTgg5sAB9E0nw82M232SeZeO7Jww,6383
+cuenca_validations/version.py,sha256=7rZF6eOzQFUXn6Pbgu0bw7KT8TJkVbGcuHLpQ9WYpSA,28
+cuenca_validations/types/__init__.py,sha256=iBrQYsV3gnlA1HRdMZlkNcz1c1JI8OEfql7vf5-oHbQ,6511
 cuenca_validations/types/card.py,sha256=UGzz8NTFAverUmdUKAK1oGHnOnjSNTpIRUm93vKSSGY,1295
-cuenca_validations/types/enums.py,sha256=FNh-jMeRor-HHdlLYSkeOzEJWQt_rY7gcJ_xxnJ92BA,21095
+cuenca_validations/types/enums.py,sha256=c891k16TSvEYP05LX_4eh-upySsqPc6QSigEKjc5qAY,21129
 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=mcliWtNb6QAst1phf3KYQ24vj90cxBAn6FDlC-WAhKo,6021
-cuenca_validations/types/requests.py,sha256=tYNEwgxOfkSBwliStTyQbEQkw4AM3YyL_eTlMytn3nI,30199
-cuenca_validations-2.1.41.dev1.dist-info/licenses/LICENSE,sha256=wR76FmxBbfnQpwELkkE5iMF8sFIafEMgXLTE4N4WPTc,1063
+cuenca_validations/types/queries.py,sha256=ZakPAM9kiABA2qL-Z2z46GbFqaGXG4JKtqLn0ZTlW3Y,6094
+cuenca_validations/types/requests.py,sha256=MnONAIHdVitz_Hxv5xC4bhaTV7_UcA9o1xzR-_IEj5c,30683
+cuenca_validations-2.1.41.dev3.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=UmGQ00D3VgFH0FveJjvW5BMsg0b7l3W0KFDGNFqY7W8,8926
+tests/test_requests.py,sha256=TNLQSATFzqLSnAdcoyoR7I8hLF2hE5sNw9ccNT0PCj8,10124
 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.41.dev1.dist-info/METADATA,sha256=bjW6vUS0InzJUjWld5Ifuj7j4XFcyz_6aTZu7qvU4kA,1600
-cuenca_validations-2.1.41.dev1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-cuenca_validations-2.1.41.dev1.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
-cuenca_validations-2.1.41.dev1.dist-info/RECORD,,
+cuenca_validations-2.1.41.dev3.dist-info/METADATA,sha256=wxqSUinxW4YpyI0DHplzWP0EXLNkXiITT-FxUyxouhw,1600
+cuenca_validations-2.1.41.dev3.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+cuenca_validations-2.1.41.dev3.dist-info/top_level.txt,sha256=4233xdOs2HtuT-GFRjcDcwK0IwdwvWdczOtk0fPB6Gw,25
+cuenca_validations-2.1.41.dev3.dist-info/RECORD,,

tests/test_requests.py

@@ -6,16 +6,20 @@ from cuenca_validations.types.enums import (
     Country,
     OperatorRole,
     OperatorStatus,
+    SessionType,
     VerificationType,
 )
+from cuenca_validations.types.queries import OperatorQuery
 from cuenca_validations.types.requests import (
-    MoralPersonRequest,
-    MoralPersonUpdateRequest,
+    LegalPersonRequest,
+    LegalPersonUpdateRequest,
     OperatorLoginRequest,
     OperatorLoginResponse,
     OperatorRequest,
     OperatorUpdateRequest,
     PasswordResetRequest,
+    SessionMetadata,
+    SessionRequest,
     UpdateTransferRequest,
     UserTOSAgreementRequest,
     UserUpdateRequest,
@@ -36,55 +40,55 @@ LEGAL_REPRESENTATIVE: DictStrAny = {
     },
 }
 
-MORAL_PERSON_REQUEST: DictStrAny = {
+LEGAL_PERSON_REQUEST: DictStrAny = {
     'legal_name': 'Aceros del Norte SA de CV',
     'rfc': 'ADN850101ABC',
     'legal_representatives': [LEGAL_REPRESENTATIVE],
 }
 
 
-def test_moral_person_request_valid() -> None:
-    req = MoralPersonRequest.model_validate(MORAL_PERSON_REQUEST)
+def test_legal_person_request_valid() -> None:
+    req = LegalPersonRequest.model_validate(LEGAL_PERSON_REQUEST)
     assert req.legal_name == 'Aceros del Norte SA de CV'
     assert req.rfc == 'ADN850101ABC'
 
 
-def test_moral_person_request_rejects_physical_rfc() -> None:
+def test_legal_person_request_rejects_physical_rfc() -> None:
     with pytest.raises(ValidationError) as ex:
-        MoralPersonRequest.model_validate(
-            {**MORAL_PERSON_REQUEST, 'rfc': 'GOCG650418TJ1'}
+        LegalPersonRequest.model_validate(
+            {**LEGAL_PERSON_REQUEST, 'rfc': 'GOCG650418TJ1'}
         )
-    assert 'RFC must be 12 characters for moral persons' in str(ex.value)
+    assert 'RFC must be 12 characters for legal persons' in str(ex.value)
 
 
-def test_moral_person_request_forbids_extra() -> None:
+def test_legal_person_request_forbids_extra() -> None:
     with pytest.raises(ValidationError) as ex:
-        MoralPersonRequest.model_validate(
-            {**MORAL_PERSON_REQUEST, 'foo': 'bar'}
+        LegalPersonRequest.model_validate(
+            {**LEGAL_PERSON_REQUEST, 'foo': 'bar'}
         )
     assert 'Extra inputs are not permitted' in str(ex.value)
 
 
-def test_moral_person_update_requires_at_least_one_param() -> None:
+def test_legal_person_update_requires_at_least_one_param() -> None:
     with pytest.raises(ValueError) as ex:
-        MoralPersonUpdateRequest()
+        LegalPersonUpdateRequest()
     assert 'At least one parameter must be provided' in str(ex.value)
 
 
-def test_moral_person_update_valid() -> None:
-    req = MoralPersonUpdateRequest.model_validate({'legal_name': 'New name'})
+def test_legal_person_update_valid() -> None:
+    req = LegalPersonUpdateRequest.model_validate({'legal_name': 'New name'})
     assert req.legal_name == 'New name'
 
 
-def test_moral_person_update_accepts_moral_rfc() -> None:
-    req = MoralPersonUpdateRequest.model_validate({'rfc': 'ADN850101ABC'})
+def test_legal_person_update_accepts_legal_rfc() -> None:
+    req = LegalPersonUpdateRequest.model_validate({'rfc': 'ADN850101ABC'})
     assert req.rfc == 'ADN850101ABC'
 
 
-def test_moral_person_update_rejects_physical_rfc() -> None:
+def test_legal_person_update_rejects_physical_rfc() -> None:
     with pytest.raises(ValidationError) as ex:
-        MoralPersonUpdateRequest.model_validate({'rfc': 'GOCG650418TJ1'})
-    assert 'RFC must be 12 characters for moral persons' in str(ex.value)
+        LegalPersonUpdateRequest.model_validate({'rfc': 'GOCG650418TJ1'})
+    assert 'RFC must be 12 characters for legal persons' in str(ex.value)
 
 
 def test_operator_request_valid() -> None:
@@ -162,6 +166,37 @@ def test_operator_login_response_valid() -> None:
     assert resp.session_token == 'SEWqY5cvkISJOxHyEKjAKf8w'
 
 
+def test_operator_query_valid() -> None:
+    query = OperatorQuery.model_validate({'email': 'maria.lopez@aceros.com'})
+    assert str(query.email) == 'maria.lopez@aceros.com'
+
+
+def test_operator_query_forbids_extra() -> None:
+    with pytest.raises(ValidationError) as ex:
+        OperatorQuery.model_validate(
+            {'email': 'maria@aceros.com', 'foo': 'bar'}
+        )
+    assert 'Extra inputs are not permitted' in str(ex.value)
+
+
+def test_session_request_with_operator_metadata() -> None:
+    req = SessionRequest(
+        user_id='USWqY5cvkISJOxHyEKjAKf8w',
+        type=SessionType.registration,
+        metadata=SessionMetadata(operator_id='OPWqY5cvkISJOxHyEKjAKf8w'),
+    )
+    assert req.metadata is not None
+    assert req.metadata.operator_id == 'OPWqY5cvkISJOxHyEKjAKf8w'
+
+
+def test_session_request_metadata_forbids_extra() -> None:
+    with pytest.raises(ValidationError) as ex:
+        SessionMetadata.model_validate(
+            {'operator_id': 'OPWqY5cvkISJOxHyEKjAKf8w', 'foo': 'bar'}
+        )
+    assert 'Extra inputs are not permitted' in str(ex.value)
+
+
 @pytest.mark.parametrize('environment', ['api.stage', 'api.sandbox', 'api'])
 def test_file_cuenca_url(environment: str) -> None:
     request_data: DictStrAny = dict(