nonecap 0.3.0__tar.gz → 0.4.0__tar.gz

{nonecap-0.3.0 → nonecap-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonecap
-Version: 0.3.0
+Version: 0.4.0
 Summary: Official Python client for the NoneCap hCaptcha solving API.
 Project-URL: Homepage, https://nonecap.com
 Project-URL: Documentation, https://nonecap.com/api-reference
@@ -210,7 +210,8 @@ ok = submit_to_the_site_you_are_automating(solve.token)
 nc.feedback.report(
     solve.id,
     outcome="accepted" if ok else "rejected",
-    reason=None if ok else "session invalidated",  # optional, freeform
+    reason=None if ok else "session invalidated",  # optional, the code your target returned
+    context=None if ok else "3rd retry, rotating residential pool",  # optional, anything you think would help us diagnose it
 )
 ```
 
@@ -219,7 +220,7 @@ At volume, buffer the verdicts and flush them in one call. Reports over 500 are
 ```python
 batch = nc.feedback.report_many([
     {"solve_id": "solve_01J...", "outcome": "accepted"},
-    {"solve_id": "solve_01J...", "outcome": "rejected", "reason": "..."},
+    {"solve_id": "solve_01J...", "outcome": "rejected", "reason": "...", "context": "..."},
 ])
 
 # Items resolve independently, so the call succeeds even when some are

{nonecap-0.3.0 → nonecap-0.4.0}/README.md

@@ -179,7 +179,8 @@ ok = submit_to_the_site_you_are_automating(solve.token)
 nc.feedback.report(
     solve.id,
     outcome="accepted" if ok else "rejected",
-    reason=None if ok else "session invalidated",  # optional, freeform
+    reason=None if ok else "session invalidated",  # optional, the code your target returned
+    context=None if ok else "3rd retry, rotating residential pool",  # optional, anything you think would help us diagnose it
 )
 ```
 
@@ -188,7 +189,7 @@ At volume, buffer the verdicts and flush them in one call. Reports over 500 are
 ```python
 batch = nc.feedback.report_many([
     {"solve_id": "solve_01J...", "outcome": "accepted"},
-    {"solve_id": "solve_01J...", "outcome": "rejected", "reason": "..."},
+    {"solve_id": "solve_01J...", "outcome": "rejected", "reason": "...", "context": "..."},
 ])
 
 # Items resolve independently, so the call succeeds even when some are

{nonecap-0.3.0 → nonecap-0.4.0}/src/nonecap/_client.py

@@ -133,17 +133,17 @@ def _list_params(
 
 def _feedback_fields(
     outcome: FeedbackOutcome,
-    estado: Optional[bool],
     reason: Optional[str],
+    context: Optional[str],
     reported_at: Union[str, datetime, None],
 ) -> dict[str, Any]:
     """The body of one report. A ``datetime`` is sent as an ISO string; pass a
     timezone-aware one, since the server reads a naive timestamp as its own."""
     body: dict[str, Any] = {"outcome": outcome}
-    if estado is not None:
-        body["estado"] = estado
     if reason is not None:
         body["reason"] = reason
+    if context is not None:
+        body["context"] = context
     if reported_at is not None:
         body["reported_at"] = (
             reported_at.isoformat() if isinstance(reported_at, datetime) else reported_at
@@ -159,8 +159,8 @@ def _feedback_chunks(reports: Sequence[FeedbackReport]) -> Iterator[list[dict[st
                 "solve_id": report["solve_id"],
                 **_feedback_fields(
                     report["outcome"],
-                    report.get("estado"),
                     report.get("reason"),
+                    report.get("context"),
                     report.get("reported_at"),
                 ),
             }
@@ -511,8 +511,8 @@ class Feedbacks:
         solve_id: str,
         *,
         outcome: FeedbackOutcome,
-        estado: Optional[bool] = None,
         reason: Optional[str] = None,
+        context: Optional[str] = None,
         reported_at: Union[str, datetime, None] = None,
     ) -> Feedback:
         """Report one solve's downstream outcome and return what was recorded.
@@ -527,7 +527,7 @@ class Feedbacks:
         payload = self._client._request(
             "POST",
             f"/v1/solves/{solve_id}/feedback",
-            json=_feedback_fields(outcome, estado, reason, reported_at),
+            json=_feedback_fields(outcome, reason, context, reported_at),
         )
         return Feedback._from_dict(payload)
 
@@ -1012,8 +1012,8 @@ class AsyncFeedbacks:
         solve_id: str,
         *,
         outcome: FeedbackOutcome,
-        estado: Optional[bool] = None,
         reason: Optional[str] = None,
+        context: Optional[str] = None,
         reported_at: Union[str, datetime, None] = None,
     ) -> Feedback:
         """Report one solve's downstream outcome and return what was recorded.
@@ -1026,7 +1026,7 @@ class AsyncFeedbacks:
         payload = await self._client._request(
             "POST",
             f"/v1/solves/{solve_id}/feedback",
-            json=_feedback_fields(outcome, estado, reason, reported_at),
+            json=_feedback_fields(outcome, reason, context, reported_at),
         )
         return Feedback._from_dict(payload)
 

{nonecap-0.3.0 → nonecap-0.4.0}/src/nonecap/_types.py

@@ -135,15 +135,18 @@ class FeedbackReport(_FeedbackReportRequired, total=False):
     """One verdict to report, as passed to ``client.feedback.report_many``.
 
     ``solve_id`` is the id from ``solves.create`` / ``solve()``, and must be
-    your own solve that produced a token. ``estado`` is the raw downstream
-    boolean when your target has one (OSIPTEL's ``estado``: ``False`` =
-    accepted); the API rejects an item whose ``estado`` disagrees with its
-    ``outcome``. ``reason`` is freeform and truncated to 512 chars server-side.
-    ``reported_at`` is advisory only — the server stamps its own timestamps.
+    your own solve that produced a token. ``reason`` is the code or message your
+    target gave you when it refused the token (e.g. ``"invalid-response"``),
+    truncated to 512 chars server-side. ``context`` is optional free text with no
+    schema — anything about the attempt you think would help us diagnose it,
+    truncated to 2000 chars. Neither is parsed; they are what a human reads when
+    you raise a ticket, and they carry the half of a rejection NoneCap cannot
+    observe on its own. ``reported_at`` is advisory only — the server stamps its
+    own timestamps.
     """
 
-    estado: Optional[bool]
     reason: Optional[str]
+    context: Optional[str]
     reported_at: Union[str, datetime, None]
 
 
@@ -154,8 +157,8 @@ class Feedback:
     object: str
     solve_id: str
     outcome: FeedbackOutcome
-    estado: Optional[bool]
     reason: Optional[str]
+    context: Optional[str]
     reported_at: Optional[str]
     report_count: int
     """How many times this solve's verdict has been written. 1 on first report."""
@@ -168,8 +171,8 @@ class Feedback:
             object=data.get("object", "feedback"),
             solve_id=data["solve_id"],
             outcome=data["outcome"],
-            estado=data.get("estado"),
             reason=data.get("reason"),
+            context=data.get("context"),
             reported_at=data.get("reported_at"),
             report_count=int(data.get("report_count", 1)),
             created_at=data.get("created_at", ""),

nonecap-0.4.0/src/nonecap/_version.py

@@ -0,0 +1 @@
+__version__ = "0.4.0"

{nonecap-0.3.0 → nonecap-0.4.0}/tests/test_feedback.py

@@ -33,8 +33,8 @@ def feedback_payload(**overrides: Any) -> dict[str, Any]:
         "object": "feedback",
         "solve_id": "solve_1",
         "outcome": "accepted",
-        "estado": None,
         "reason": None,
+        "context": None,
         "reported_at": None,
         "report_count": 1,
         "created_at": "2026-08-01T00:00:00Z",
@@ -67,32 +67,33 @@ def batch_payload(request: httpx.Request) -> httpx.Response:
 
 class TestReport:
     def test_posts_to_the_solves_feedback_path(self) -> None:
-        script = Script((200, feedback_payload(outcome="rejected", estado=True)))
+        script = Script((200, feedback_payload(outcome="rejected", context="3rd retry")))
         nc = client_for(script)
         result = nc.feedback.report(
-            "solve_1", outcome="rejected", estado=True, reason="documento no vigente"
+            "solve_1", outcome="rejected", reason="invalid-response", context="3rd retry"
         )
 
         assert script.requests[0].method == "POST"
         assert script.requests[0].url.path == "/v1/solves/solve_1/feedback"
         assert script.body_of(0) == {
             "outcome": "rejected",
-            "estado": True,
-            "reason": "documento no vigente",
+            "reason": "invalid-response",
+            "context": "3rd retry",
         }
         assert result.outcome == "rejected"
-        assert result.estado is True
+        assert result.context == "3rd retry"
 
     def test_omits_fields_the_caller_left_unset(self) -> None:
         script = Script((200, feedback_payload()))
         client_for(script).feedback.report("solve_1", outcome="accepted")
         assert script.body_of(0) == {"outcome": "accepted"}
 
-    def test_sends_estado_false(self) -> None:
-        # `if estado:` would drop the accepted signal — the one that matters.
-        script = Script((200, feedback_payload(estado=False)))
-        client_for(script).feedback.report("solve_1", outcome="accepted", estado=False)
-        assert script.body_of(0) == {"outcome": "accepted", "estado": False}
+    def test_sends_an_empty_context(self) -> None:
+        # `if context:` would drop an empty string, which is a deliberate "I have
+        # nothing to add" rather than an omission. Only None means unset.
+        script = Script((200, feedback_payload(context="")))
+        client_for(script).feedback.report("solve_1", outcome="accepted", context="")
+        assert script.body_of(0) == {"outcome": "accepted", "context": ""}
 
     def test_serializes_a_datetime_reported_at(self) -> None:
         script = Script((200, feedback_payload()))
@@ -123,8 +124,8 @@ class TestReportMany:
         script = Script(batch_payload)
         batch = client_for(script).feedback.report_many(
             [
-                {"solve_id": "solve_1", "outcome": "accepted", "estado": False},
-                {"solve_id": "solve_2", "outcome": "rejected", "estado": True},
+                {"solve_id": "solve_1", "outcome": "accepted"},
+                {"solve_id": "solve_2", "outcome": "rejected", "context": "3rd retry"},
             ]
         )
 
@@ -132,8 +133,8 @@ class TestReportMany:
         assert script.requests[0].url.path == "/v1/feedback"
         assert script.body_of(0) == {
             "feedback": [
-                {"solve_id": "solve_1", "outcome": "accepted", "estado": False},
-                {"solve_id": "solve_2", "outcome": "rejected", "estado": True},
+                {"solve_id": "solve_1", "outcome": "accepted"},
+                {"solve_id": "solve_2", "outcome": "rejected", "context": "3rd retry"},
             ]
         }
         assert batch.recorded == 2

{nonecap-0.3.0 → nonecap-0.4.0}/tests/typing_assertions.py

@@ -56,10 +56,10 @@ async def positive_cases_async() -> None:
 
 def feedback_cases() -> None:
     _f: Feedback = nc.feedback.report("solve_1", outcome="accepted")
-    nc.feedback.report("solve_1", outcome="rejected", estado=True, reason="why")
+    nc.feedback.report("solve_1", outcome="rejected", reason="why", context="ctx")
     reports: list[FeedbackReport] = [
         {"solve_id": "solve_1", "outcome": "accepted"},
-        {"solve_id": "solve_2", "outcome": "rejected", "estado": True, "reason": "why"},
+        {"solve_id": "solve_2", "outcome": "rejected", "reason": "why", "context": "ctx"},
     ]
     _b: FeedbackBatch = nc.feedback.report_many(reports)
     # An unknown outcome must not type-check.

nonecap-0.3.0/src/nonecap/_version.py

@@ -1 +0,0 @@
-__version__ = "0.3.0"