feat(abonnement): client HTTP Frisbii (#90)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DRGb8NAMwaTZxUszSbaj4N

src/subscriptions/client.py

@@ -0,0 +1,80 @@
+import os
+
+import httpx
+
+# NB : base URL et schémas d'endpoints à confirmer dans la doc Frisbii lors de la
+# première intégration en environnement de test. Frisbii Billing/Pay s'appuie sur
+# l'API Reepay (api.reepay.com) ; ajuster FRISBII_API_BASE_URL si besoin.
+_DEFAULT_BASE_URL = "https://api.reepay.com"
+_TIMEOUT = 15.0
+
+
+class FrisbiiError(Exception):
+    def __init__(self, status_code: int, body):
+        super().__init__(f"Frisbii API error {status_code}: {body}")
+        self.status_code = status_code
+        self.body = body
+
+
+def _api_key() -> str:
+    return os.getenv("FRISBII_API_KEY", "")
+
+
+def _base_url() -> str:
+    return os.getenv("FRISBII_API_BASE_URL") or _DEFAULT_BASE_URL
+
+
+def _call(method: str, path: str, json: dict | None = None) -> dict:
+    resp = httpx.request(
+        method,
+        f"{_base_url()}{path}",
+        auth=(_api_key(), ""),
+        json=json,
+        timeout=_TIMEOUT,
+    )
+    if resp.status_code >= 400:
+        raise FrisbiiError(resp.status_code, resp.text)
+    return resp.json()
+
+
+def get_or_create_customer(handle: str, email: str) -> dict:
+    try:
+        return _call("GET", f"/v1/customer/{handle}")
+    except FrisbiiError as exc:
+        if exc.status_code != 404:
+            raise
+        return _call("POST", "/v1/customer", json={"handle": handle, "email": email})
+
+
+def create_subscription_session(
+    plan_handle: str,
+    customer_handle: str,
+    accept_url: str,
+    cancel_url: str,
+    no_trial: bool = False,
+) -> str:
+    prepare = {"plan": plan_handle, "customer": customer_handle}
+    if no_trial:
+        prepare["no_trial"] = True
+    data = _call(
+        "POST",
+        "/v1/session/subscription",
+        json={
+            "accept_url": accept_url,
+            "cancel_url": cancel_url,
+            "prepare_subscription": prepare,
+        },
+    )
+    return data["url"]
+
+
+def cancel_subscription(subscription_handle: str) -> dict:
+    return _call("POST", f"/v1/subscription/{subscription_handle}/cancel")
+
+
+def get_subscription(subscription_handle: str) -> dict:
+    return _call("GET", f"/v1/subscription/{subscription_handle}")
+
+
+def get_plan(plan_handle: str) -> dict:
+    return _call("GET", f"/v1/plan/{plan_handle}")