PTHMINT-108: Add coverage for scoped auth changes

Author: zulquer

.coveragerc

@@ -4,3 +4,4 @@ source =
     tests
 omit =
   env/
+  examples/

tests/multisafepay/unit/api/base/test_unit_decorator.py

@@ -15,3 +15,94 @@ def test_initialization_with_empty_dependencies():
     """Test the initialization of a Decorator object with empty dependencies."""
     decorator = Decorator()
     assert decorator.get_dependencies() == {}
+
+
+def test_adapt_costs_with_valid_data() -> None:
+    """Adapt costs from a list of cost dictionaries."""
+    decorator = Decorator(dependencies={"key": "value"})
+    costs = [{"amount": 100, "description": "Shipping"}]
+    result = decorator.adapt_costs(costs)
+    assert result is decorator
+    assert "costs" in decorator.get_dependencies()
+
+
+def test_adapt_costs_with_none() -> None:
+    """Skip costs adaptation when input is None."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_costs(None)
+    assert "costs" not in decorator.get_dependencies()
+
+
+def test_adapt_custom_info_with_valid_data() -> None:
+    """Adapt custom info from dictionary."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_custom_info({"custom_1": "val1"})
+    assert "custom_info" in decorator.get_dependencies()
+
+
+def test_adapt_customer_with_valid_data() -> None:
+    """Adapt customer from dictionary."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_customer({"first_name": "John", "last_name": "Doe"})
+    assert "customer" in decorator.get_dependencies()
+
+
+def test_adapt_payment_details_with_valid_data() -> None:
+    """Adapt payment details from dictionary."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_payment_details({"type": "VISA"})
+    assert "payment_details" in decorator.get_dependencies()
+
+
+def test_adapt_payment_methods_with_valid_data() -> None:
+    """Adapt payment methods from list of dictionaries."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_payment_methods([{"type": "VISA"}])
+    assert "payment_methods" in decorator.get_dependencies()
+
+
+def test_adapt_shopping_cart_with_valid_data() -> None:
+    """Adapt shopping cart from dictionary."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_shopping_cart({"items": []})
+    assert "shopping_cart" in decorator.get_dependencies()
+
+
+def test_adapt_related_transactions_with_valid_data() -> None:
+    """Adapt related transactions from list of dictionaries."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_related_transactions(
+        [{"transaction_id": 123, "order_id": "order-1"}],
+    )
+    assert "related_transactions" in decorator.get_dependencies()
+
+
+def test_adapt_checkout_options_with_valid_data() -> None:
+    """Adapt checkout options from dictionary."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_checkout_options({})
+    assert "checkout_options" in decorator.get_dependencies()
+
+
+def test_adapt_order_adjustment_with_valid_data() -> None:
+    """Adapt order adjustment from dictionary."""
+    decorator = Decorator(dependencies={})
+    decorator.adapt_order_adjustment({"total_adjustment": 0})
+    assert "order_adjustment" in decorator.get_dependencies()
+
+
+def test_chaining_multiple_adapters() -> None:
+    """Chain multiple adapt calls and get all dependencies."""
+    deps = (
+        Decorator(dependencies={"status": "completed"})
+        .adapt_costs([{"amount": 10}])
+        .adapt_custom_info({"custom_1": "a"})
+        .adapt_payment_details({"type": "VISA"})
+        .adapt_payment_methods([{"type": "VISA"}])
+        .get_dependencies()
+    )
+    assert "costs" in deps
+    assert "custom_info" in deps
+    assert "payment_details" in deps
+    assert "payment_methods" in deps
+    assert deps["status"] == "completed"

tests/multisafepay/unit/api/path/capture/__init__.py

@@ -0,0 +1 @@
+"""Unit tests for capture path package."""

tests/multisafepay/unit/api/path/capture/test_unit_capture_manager.py

@@ -0,0 +1,83 @@
+# Copyright (c) MultiSafepay, Inc. All rights reserved.
+
+# This file is licensed under the Open Software License (OSL) version 3.0.
+# For a copy of the license, see the LICENSE.txt file in the project root.
+
+# See the DISCLAIMER.md file for disclaimer details.
+
+"""Unit tests for CaptureManager.capture_reservation_cancel behavior."""
+
+from unittest.mock import MagicMock
+
+from multisafepay.api.base.response.api_response import ApiResponse
+from multisafepay.api.base.response.custom_api_response import (
+    CustomApiResponse,
+)
+from multisafepay.api.paths.capture.capture_manager import CaptureManager
+from multisafepay.api.paths.capture.request.capture_request import (
+    CaptureRequest,
+)
+from multisafepay.api.paths.capture.response.capture import CancelReservation
+
+ORDER_ID = "capture-order-1"
+
+
+def _build_capture_api_response() -> ApiResponse:
+    return ApiResponse(
+        headers={},
+        status_code=200,
+        body={
+            "success": True,
+            "data": {
+                "order_id": ORDER_ID,
+                "success": True,
+                "transaction_id": "txn-001",
+            },
+        },
+    )
+
+
+def _build_empty_capture_response() -> ApiResponse:
+    return ApiResponse(
+        headers={},
+        status_code=200,
+        body={"success": True, "data": {}},
+    )
+
+
+def test_capture_reservation_cancel_sends_patch_and_parses() -> None:
+    """Send PATCH to json/capture/{order_id} and parse CancelReservation."""
+    client = MagicMock()
+    client.create_patch_request.return_value = _build_capture_api_response()
+
+    request = CaptureRequest(status="cancelled", reason="test")
+
+    manager = CaptureManager(client)
+    response = manager.capture_reservation_cancel(
+        order_id=ORDER_ID,
+        capture_request=request,
+    )
+
+    called_endpoint = client.create_patch_request.call_args.args[0]
+
+    assert isinstance(response, CustomApiResponse)
+    assert isinstance(response.get_data(), CancelReservation)
+    assert response.get_data().order_id == ORDER_ID
+    assert f"json/capture/{ORDER_ID}" == called_endpoint
+
+
+def test_capture_reservation_cancel_empty_data() -> None:
+    """Return None data when body data is empty."""
+    client = MagicMock()
+    client.create_patch_request.return_value = _build_empty_capture_response()
+
+    request = CaptureRequest(status="cancelled", reason="test")
+
+    manager = CaptureManager(client)
+    response = manager.capture_reservation_cancel(
+        order_id=ORDER_ID,
+        capture_request=request,
+    )
+
+    assert isinstance(response, CustomApiResponse)
+    assert response.get_data() is None

tests/multisafepay/unit/api/path/orders/manager/test_unit_cancel_transaction.py

@@ -0,0 +1,119 @@
+# Copyright (c) MultiSafepay, Inc. All rights reserved.
+
+# This file is licensed under the Open Software License (OSL) version 3.0.
+# For a copy of the license, see the LICENSE.txt file in the project root.
+
+# See the DISCLAIMER.md file for disclaimer details.
+
+"""Unit tests for OrderManager.cancel_transaction behavior."""
+
+from unittest.mock import MagicMock
+
+from multisafepay.api.base.response.api_response import ApiResponse
+from multisafepay.api.base.response.custom_api_response import (
+    CustomApiResponse,
+)
+from multisafepay.api.paths.orders.order_id.cancel.request.cancel_transaction_request import (
+    CancelTransactionRequest,
+)
+from multisafepay.api.paths.orders.order_id.cancel.response.cancel_transaction import (
+    CancelTransaction,
+)
+from multisafepay.api.paths.orders.order_manager import OrderManager
+from multisafepay.client.client import Client
+from multisafepay.client.credential_resolver import AuthScope
+
+ORDER_ID = "cloud-pos-cancel-1"
+TERMINAL_GROUP_ID = "Default"
+
+
+def _build_cancel_api_response() -> ApiResponse:
+    return ApiResponse(
+        headers={},
+        status_code=200,
+        body={
+            "success": True,
+            "data": {
+                "status": "void",
+                "financial_status": "void",
+                "created": "2026-01-01T00:00:00",
+                "modified": "2026-01-01T00:00:01",
+            },
+        },
+    )
+
+
+def test_cancel_transaction_with_terminal_group_scope() -> None:
+    """Use terminal-group auth scope when terminal_group_id is provided."""
+    client = MagicMock()
+    client.create_post_request.return_value = _build_cancel_api_response()
+
+    manager = OrderManager(client)
+    response = manager.cancel_transaction(
+        cancel_transaction_request=ORDER_ID,
+        terminal_group_id=TERMINAL_GROUP_ID,
+    )
+
+    called_auth_scope = client.create_post_request.call_args.kwargs[
+        "auth_scope"
+    ]
+
+    assert isinstance(response, CustomApiResponse)
+    assert isinstance(response.get_data(), CancelTransaction)
+    assert response.get_data().status == "void"
+    assert called_auth_scope == AuthScope(
+        scope=Client.AUTH_SCOPE_TERMINAL_GROUP,
+        group_id=TERMINAL_GROUP_ID,
+    )
+
+
+def test_cancel_transaction_without_terminal_group_scope() -> None:
+    """Omit auth scope when terminal_group_id is not provided."""
+    client = MagicMock()
+    client.create_post_request.return_value = _build_cancel_api_response()
+
+    manager = OrderManager(client)
+    response = manager.cancel_transaction(
+        cancel_transaction_request=ORDER_ID,
+    )
+
+    called_auth_scope = client.create_post_request.call_args.kwargs[
+        "auth_scope"
+    ]
+
+    assert isinstance(response, CustomApiResponse)
+    assert called_auth_scope is None
+
+
+def test_cancel_transaction_accepts_request_object() -> None:
+    """Accept CancelTransactionRequest as input instead of raw string."""
+    client = MagicMock()
+    client.create_post_request.return_value = _build_cancel_api_response()
+
+    request = CancelTransactionRequest(order_id=ORDER_ID)
+
+    manager = OrderManager(client)
+    response = manager.cancel_transaction(
+        cancel_transaction_request=request,
+        terminal_group_id=TERMINAL_GROUP_ID,
+    )
+
+    called_endpoint = client.create_post_request.call_args.args[0]
+
+    assert isinstance(response, CustomApiResponse)
+    assert ORDER_ID in called_endpoint
+    assert called_endpoint.endswith("/cancel")
+
+
+def test_cancel_transaction_encodes_order_id() -> None:
+    """Verify order ID with special chars is encoded in the endpoint."""
+    client = MagicMock()
+    client.create_post_request.return_value = _build_cancel_api_response()
+
+    manager = OrderManager(client)
+    manager.cancel_transaction(
+        cancel_transaction_request="order/special&chars",
+    )
+
+    called_endpoint = client.create_post_request.call_args.args[0]
+    assert "order%2Fspecial%26chars" in called_endpoint