cuenca 2.2.0.dev3__tar.gz → 2.2.2__tar.gz

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuenca
-Version: 2.2.0.dev3
+Version: 2.2.2
 Summary: Cuenca API Client
 Home-page: https://github.com/cuenca-mx/cuenca-python
 Author: Cuenca
@@ -16,7 +16,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.32.0
-Requires-Dist: cuenca-validations>=2.1.27
+Requires-Dist: cuenca-validations>=2.1.34
 Requires-Dist: pydantic-extra-types>=2.10.0
 Dynamic: author
 Dynamic: author-email

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/cuenca/__init__.py

@@ -1,5 +1,7 @@
 __all__ = [
     '__version__',
+    'Agent',
+    'AgentVerification',
     'ApiKey',
     'Account',
     'Arpc',
@@ -53,6 +55,8 @@ __all__ = [
 from . import http
 from .resources import (
     Account,
+    Agent,
+    AgentVerification,
     ApiKey,
     Arpc,
     BalanceEntry,

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/cuenca/resources/__init__.py

@@ -1,4 +1,6 @@
 __all__ = [
+    'Agent',
+    'AgentVerification',
     'ApiKey',
     'Account',
     'Arpc',
@@ -47,6 +49,8 @@ __all__ = [
 ]
 
 from .accounts import Account
+from .agent_verifications import AgentVerification
+from .agents import Agent
 from .api_keys import ApiKey
 from .arpc import Arpc
 from .balance_entries import BalanceEntry
@@ -96,6 +100,8 @@ from .whatsapp_transfers import WhatsappTransfer
 
 # avoid circular imports
 resource_classes = [
+    Agent,
+    AgentVerification,
     ApiKey,
     Account,
     Arpc,

cuenca-2.2.2/cuenca/resources/agent_verifications.py

@@ -0,0 +1,37 @@
+import datetime as dt
+from typing import ClassVar
+
+from cuenca_validations.types.identities import PhoneNumber
+from pydantic import ConfigDict
+
+from ..http import Session, session as global_session
+from .base import Creatable
+
+
+class AgentVerification(Creatable):
+    _resource: ClassVar = 'agent_verifications'
+
+    created_at: dt.datetime
+    user_id: str
+    platform_id: str
+    phone_number: PhoneNumber
+    pairing_code: str
+    deactivated_at: dt.datetime
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'id': 'AVjTtPH1mhT65GEgOeomJ4DQ',
+                'created_at': '2026-06-25T22:50:08.495768',
+                'user_id': 'USMP3EPgI4T4CPFyVmXUPi8A',
+                'platform_id': 'PTZbBlk__kQt-wfwzP5nwA9A',
+                'phone_number': '+525512345678',
+                'pairing_code': 'OJC37W',
+                'deactivated_at': '2026-06-25T22:55:08.495779',
+            }
+        }
+    )
+
+    @classmethod
+    def create(cls, session: Session = global_session) -> 'AgentVerification':
+        return cls._create(session=session)

cuenca-2.2.2/cuenca/resources/agents.py

@@ -0,0 +1,52 @@
+import datetime as dt
+from typing import ClassVar, Optional
+
+from cuenca_validations.types import AgentQuery, AgentRequest, PhoneNumber
+from cuenca_validations.typing import DictStrAny
+from pydantic import ConfigDict, Field
+
+from ..http import Session, session as global_session
+from .base import Creatable, Queryable
+
+
+class Agent(Creatable, Queryable):
+    _resource: ClassVar = 'agents'
+    _query_params: ClassVar = AgentQuery
+
+    created_at: dt.datetime
+    user_id: str
+    platform_id: str
+    agent_verification_id: str
+    session_id: str
+    device_info: DictStrAny = Field(default_factory=dict)
+    deactivated_at: Optional[dt.datetime] = None
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'id': 'AG1G6Bm0oGQOCRjTDaeFSsyA',
+                'created_at': '2026-06-27T01:56:42.613781',
+                'user_id': 'USMP3EPgI4T4CPFyVmXUPi8A',
+                'platform_id': 'PTZbBlk__kQt-wfwzP5nwA9A',
+                'agent_verification_id': 'AV7A1FLC7MSnqKcb7oAkiQxA',
+                'session_id': 'SSH0M5yteyRHas-PmfT9pu9w',
+                'device_info': {'client': 'cursor', 'os': 'macOS'},
+            }
+        }
+    )
+
+    @classmethod
+    def create(
+        cls,
+        pairing_code: str,
+        phone_number: PhoneNumber,
+        device_info: Optional[DictStrAny] = None,
+        *,
+        session: Session = global_session,
+    ) -> 'Agent':
+        req = AgentRequest(
+            pairing_code=pairing_code,
+            phone_number=phone_number,
+            device_info=device_info or {},
+        )
+        return cls._create(session=session, **req.model_dump())

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/cuenca/resources/password_resets.py

@@ -27,8 +27,14 @@ class PasswordReset(Creatable):
                 'id': 'PRNEUInh69SuKXXmK95sROwQ',
                 'platform_id': 'PT-1234567890',
                 'flow_id': '123e4567-e89b-12d3-a456-426614174000',
-                'status': 'created',
+                'status': 'succeeded',
+                'provider_url': (
+                    'https://dashboard.metamap.com/identity/'
+                    'identity-id/verification/verification-id'
+                ),
                 'created_at': '2026-05-06T14:15:22Z',
+                'updated_at': '2026-05-06T14:18:22Z',
+                'deactivated_at': '2026-05-06T14:20:22Z',
             }
         }
     )

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/cuenca/resources/transfers.py

@@ -2,20 +2,23 @@ import datetime as dt
 from typing import ClassVar, Optional, cast
 
 from cuenca_validations.types import (
+    TransactionStatus,
     TransferNetwork,
     TransferQuery,
     TransferRequest,
+    UpdateTransferRequest,
 )
 from cuenca_validations.typing import DictStrAny
 from requests import HTTPError
 
 from ..exc import CuencaException
+from ..http import Session, session as global_session
 from .accounts import Account
-from .base import Creatable, Transaction
+from .base import Creatable, Transaction, Updateable
 from .resources import retrieve_uri
 
 
-class Transfer(Transaction, Creatable):
+class Transfer(Transaction, Creatable, Updateable):
     _resource: ClassVar = 'transfers'
     _query_params: ClassVar = TransferQuery
 
@@ -71,6 +74,17 @@ class Transfer(Transaction, Creatable):
         )
         return cls._create(**req.model_dump())
 
+    @classmethod
+    def update(
+        cls,
+        transfer_id: str,
+        status: TransactionStatus,
+        *,
+        session: Session = global_session,
+    ) -> 'Transfer':
+        req = UpdateTransferRequest(status=status)
+        return cls._update(transfer_id, session=session, **req.model_dump())
+
     @classmethod
     def create_many(cls, requests: list[TransferRequest]) -> DictStrAny:
         transfers: DictStrAny = dict(submitted=[], errors=[])

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/cuenca/version.py

@@ -1,3 +1,3 @@
-__version__ = '2.2.0.dev3'
+__version__ = '2.2.2'
 CLIENT_VERSION = __version__
 API_VERSION = '2020-03-19'

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/cuenca.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuenca
-Version: 2.2.0.dev3
+Version: 2.2.2
 Summary: Cuenca API Client
 Home-page: https://github.com/cuenca-mx/cuenca-python
 Author: Cuenca
@@ -16,7 +16,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.32.0
-Requires-Dist: cuenca-validations>=2.1.27
+Requires-Dist: cuenca-validations>=2.1.34
 Requires-Dist: pydantic-extra-types>=2.10.0
 Dynamic: author
 Dynamic: author-email

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/cuenca.egg-info/SOURCES.txt

@@ -16,6 +16,8 @@ cuenca/http/__init__.py
 cuenca/http/client.py
 cuenca/resources/__init__.py
 cuenca/resources/accounts.py
+cuenca/resources/agent_verifications.py
+cuenca/resources/agents.py
 cuenca/resources/api_keys.py
 cuenca/resources/arpc.py
 cuenca/resources/balance_entries.py
@@ -72,6 +74,7 @@ tests/http/conftest.py
 tests/http/test_client.py
 tests/resources/__init__.py
 tests/resources/test_accounts.py
+tests/resources/test_agents.py
 tests/resources/test_api_keys.py
 tests/resources/test_arpc.py
 tests/resources/test_balance_entries.py

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/cuenca.egg-info/requires.txt

@@ -1,3 +1,3 @@
 requests>=2.32.0
-cuenca-validations>=2.1.27
+cuenca-validations>=2.1.34
 pydantic-extra-types>=2.10.0

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/setup.py

@@ -24,7 +24,7 @@ setup(
     python_requires='>=3.9',
     install_requires=[
         'requests>=2.32.0',
-        'cuenca-validations>=2.1.27',
+        'cuenca-validations>=2.1.34',
         'pydantic-extra-types>=2.10.0',
     ],
     classifiers=[

cuenca-2.2.2/tests/resources/test_agents.py

@@ -0,0 +1,22 @@
+import pytest
+
+from cuenca.http.client import Session
+from cuenca.resources import Agent, AgentVerification
+
+
+@pytest.mark.vcr
+def test_agent_create():
+    verification = AgentVerification.create()  # Created by user in APP
+    agent_session = Session()
+    agent_session.configure(sandbox=True)
+    agent = Agent.create(
+        pairing_code=verification.pairing_code,
+        phone_number=verification.phone_number,
+        device_info={'client': 'cursor', 'os': 'macOS'},
+        session=agent_session,
+    )
+    assert agent.id
+    assert agent.agent_verification_id == verification.id
+    assert agent.session_id
+    assert agent.user_id
+    assert agent.platform_id

{cuenca-2.2.0.dev3 → cuenca-2.2.2}/tests/resources/test_transfers.py

@@ -130,3 +130,33 @@ def test_invalid_params():
     with pytest.raises(ValidationError) as e:
         Transfer.one(invalid_param='invalid_param')
     assert 'Extra inputs are not permitted' in str(e)
+
+
+@pytest.mark.vcr
+def test_transfers_update_succeeded():
+    transfer = Transfer.update('TR01', status=TransactionStatus.succeeded)
+    assert transfer.id == 'TR01'
+    assert transfer.status == TransactionStatus.succeeded
+
+
+@pytest.mark.vcr
+def test_transfers_update_failed():
+    transfer = Transfer.update('TR02', status=TransactionStatus.failed)
+    assert transfer.id == 'TR02'
+    assert transfer.status == TransactionStatus.failed
+
+
+@pytest.mark.parametrize(
+    'invalid_status',
+    [
+        TransactionStatus.created,
+        TransactionStatus.submitted,
+        TransactionStatus.in_review,
+        'cancelled',
+        'approve',
+        'reject',
+    ],
+)
+def test_transfers_update_rejects_invalid_status(invalid_status):
+    with pytest.raises(ValidationError):
+        Transfer.update('TR03', status=invalid_status)