imperal-sdk 5.4.0__tar.gz → 5.4.2__tar.gz

{imperal_sdk-5.4.0 → imperal_sdk-5.4.2}/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `imperal-sdk` are documented here.
 
+## 5.4.1 — 2026-06-16 — BillingClient resume + cancel_at_period_end
+
+Additive — **nothing to migrate**.
+
+### Added
+- `ctx.billing.resume_subscription()` — undoes a pending cancel-at-period-end
+  (POST `/v1/billing/resume`); returns the gateway result dict
+  (`{status, plan, expires_at, cancel_at_period_end}`). Surfaces errors.
+- `SubscriptionInfo.cancel_at_period_end: bool` (defaults `False`) —
+  `get_subscription()` now maps it from the gateway response so extensions can
+  show whether an active subscription is set to cancel at period end.
+
+`BillingProtocol` 17 → 18 methods.
+
 ## 5.4.0 — 2026-06-16 — BillingClient portal + full Webbee parity
 
 Additive — **nothing to migrate**.

{imperal_sdk-5.4.0 → imperal_sdk-5.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imperal-sdk
-Version: 5.4.0
+Version: 5.4.2
 Summary: SDK for building Imperal Cloud extensions
 Author: Valentin Scerbacov, Imperal, Inc.
 License-Expression: AGPL-3.0-or-later

{imperal_sdk-5.4.0 → imperal_sdk-5.4.2}/sdk_claims.json

@@ -1,5 +1,5 @@
 {
-  "_sdk_version": "5.4.0",
+  "_sdk_version": "5.4.2",
   "constants": {
     "max_call_depth": {
       "counts_root": true,

{imperal_sdk-5.4.0 → imperal_sdk-5.4.2}/src/imperal_sdk/__init__.py

@@ -1,7 +1,7 @@
 """Imperal Cloud SDK — build extensions for the Imperal platform."""
 from typing import TYPE_CHECKING
 
-__version__ = "5.4.0"
+__version__ = "5.4.2"
 
 # 5.2.2 (2026-06-11): the package root resolves its public surface lazily
 # (PEP 562). The eager imports pulled the HTTP transport (Context / client

{imperal_sdk-5.4.0 → imperal_sdk-5.4.2}/src/imperal_sdk/billing/client.py

@@ -35,6 +35,7 @@ class SubscriptionInfo:
     status: str
     started_at: str | None = None
     expires_at: str | None = None
+    cancel_at_period_end: bool = False
 
 
 class BillingClient:
@@ -108,6 +109,7 @@ class BillingClient:
                     status=data.get("status", "unknown"),
                     started_at=data.get("started_at"),
                     expires_at=data.get("expires_at"),
+                    cancel_at_period_end=bool(data.get("cancel_at_period_end", False)),
                 )
         except Exception as e:
             log.warning("Billing get_subscription failed: %s", e)
@@ -316,6 +318,26 @@ class BillingClient:
             resp.raise_for_status()
             return resp.json() if resp.content else {}
 
+    async def resume_subscription(self, user: Any = None) -> dict:
+        """Undo a pending cancel-at-period-end. Surfaces errors. Returns the
+        gateway result dict ({status, plan, expires_at, cancel_at_period_end})."""
+        async with httpx.AsyncClient() as client:
+            resp = await client.post(f"{self._gateway_url}/v1/billing/resume",
+                                     headers=self._headers(), timeout=15)
+            resp.raise_for_status()
+            return resp.json() if resp.content else {}
+
+    async def renew_subscription(self, user: Any = None) -> dict:
+        """Renew an EXPIRED subscription for the same plan — charges the saved
+        default card for one fresh period and restores access immediately.
+        Surfaces errors (402 no-card / SCA, 409 not-expired). Returns the
+        gateway result dict ({status, plan, expires_at, payment_intent_id})."""
+        async with httpx.AsyncClient() as client:
+            resp = await client.post(f"{self._gateway_url}/v1/billing/renew",
+                                     headers=self._headers(), timeout=20)
+            resp.raise_for_status()
+            return resp.json() if resp.content else {}
+
     async def update_billing_profile(self, profile: dict, user: Any = None) -> bool:
         """Surfaces errors. profile keys: name/company/vat/country."""
         async with httpx.AsyncClient() as client:

{imperal_sdk-5.4.0 → imperal_sdk-5.4.2}/src/imperal_sdk/context.py

@@ -62,6 +62,8 @@ class BillingProtocol(Protocol):
     async def get_auto_topup(self, user: Any = None): ...
     async def set_auto_topup(self, enabled: bool, threshold_pct: int = 10, recharge_tokens: int = 20000, payment_method_id: str = "", user: Any = None) -> bool: ...
     async def cancel_subscription(self, user: Any = None) -> dict: ...
+    async def resume_subscription(self, user: Any = None) -> dict: ...
+    async def renew_subscription(self, user: Any = None) -> dict: ...
     async def update_billing_profile(self, profile: dict, user: Any = None) -> bool: ...
 
 

{imperal_sdk-5.4.0 → imperal_sdk-5.4.2}/tests/fixtures/contract/kernel-contract.sample.json

@@ -40,6 +40,8 @@
       "list_payments",
       "list_plans",
       "remove_payment_method",
+      "renew_subscription",
+      "resume_subscription",
       "set_auto_topup",
       "set_default_payment_method",
       "topup",
@@ -137,6 +139,10 @@
       "fields": {},
       "source": "gateway_spec (auth-gateway billing/stripe_router.py::create_portal_session)"
     },
+    "POST /v1/billing/resume": {
+      "fields": {},
+      "source": "gateway_spec (auth-gateway billing/router.py::resume)"
+    },
     "POST /v1/billing/topup": {
       "fields": {
         "price_cents": {

{imperal_sdk-5.4.0 → imperal_sdk-5.4.2}/tests/test_billing.py

@@ -184,6 +184,42 @@ async def test_cancel_subscription_posts_and_returns_dict():
     assert req.headers["X-Acting-User"] == "imp_u_x"
 
 
+@respx.mock
+async def test_resume_subscription_posts_and_returns_dict():
+    route = respx.post(f"{_GW}/v1/billing/resume").mock(return_value=httpx.Response(200,
+        json={"status": "active", "plan": "pro", "expires_at": "2026-08-01",
+              "cancel_at_period_end": False}))
+    c = BillingClient(gateway_url=_GW, service_token="svc", user_id="imp_u_x")
+    res = await c.resume_subscription()
+    assert res == {"status": "active", "plan": "pro", "expires_at": "2026-08-01",
+                   "cancel_at_period_end": False}
+    req = route.calls.last.request
+    assert req.url.path == "/v1/billing/resume"
+    assert req.headers["X-Service-Token"] == "svc"
+    assert req.headers["X-Acting-User"] == "imp_u_x"
+
+
+@respx.mock
+async def test_get_subscription_parses_cancel_at_period_end():
+    respx.get(f"{_GW}/v1/billing/internal/subscription/imp_u_x").mock(
+        return_value=httpx.Response(200, json={"plan": "pro", "status": "active",
+            "started_at": "2026-01-01T00:00:00", "expires_at": "2026-08-01",
+            "cancel_at_period_end": True}))
+    c = BillingClient(gateway_url=_GW, service_token="svc", user_id="imp_u_x")
+    sub = await c.get_subscription()
+    assert sub.plan == "pro" and sub.status == "active"
+    assert sub.cancel_at_period_end is True
+
+
+@respx.mock
+async def test_get_subscription_defaults_cancel_at_period_end_false():
+    respx.get(f"{_GW}/v1/billing/internal/subscription/imp_u_x").mock(
+        return_value=httpx.Response(200, json={"plan": "free", "status": "active"}))
+    c = BillingClient(gateway_url=_GW, service_token="svc", user_id="imp_u_x")
+    sub = await c.get_subscription()
+    assert sub.cancel_at_period_end is False
+
+
 @respx.mock
 async def test_update_billing_profile_puts_profile():
     route = respx.put(f"{_GW}/v1/billing/profile").mock(return_value=httpx.Response(200,