boxd 0.1.2__tar.gz → 0.1.2.dev13__tar.gz

{boxd-0.1.2/src/boxd.egg-info → boxd-0.1.2.dev13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.1.2
+Version: 0.1.2.dev13
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT

{boxd-0.1.2 → boxd-0.1.2.dev13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "boxd"
-version = "0.1.2"
+version = "0.1.2.dev13"
 description = "Python SDK for the boxd cloud VM platform"
 readme = "README.md"
 license = "MIT"

{boxd-0.1.2 → boxd-0.1.2.dev13}/src/boxd/__init__.py

@@ -21,6 +21,7 @@ For the async API::
 """
 
 from ._sync import (
+    BillingService,
     Box,
     BoxService,
     Compute,
@@ -31,6 +32,7 @@ from ._sync import (
     TemplateService,
     TokenService,
 )
+from .billing import Billing, Plan
 from .exec import ExecResult, ExecProcess, StreamReader, StreamWriter
 from .types import (
     BoxConfig,
@@ -84,6 +86,10 @@ __all__ = [
     "DomainService",
     "NetworkService",
     "TokenService",
+    "BillingService",
+    # Billing types
+    "Billing",
+    "Plan",
     # Exec primitives
     "ExecResult",
     "ExecProcess",

{boxd-0.1.2 → boxd-0.1.2.dev13}/src/boxd/_sync.py

@@ -393,6 +393,38 @@ class TokenService(_SyncBase):
         self._run(self._async.revoke(jti))
 
 
+class BillingService(_SyncBase):
+    """Subscription billing (synchronous API)."""
+
+    def __init__(self, async_service, loop: asyncio.AbstractEventLoop) -> None:
+        from .billing import BillingService as AsyncBillingService
+
+        self._async: AsyncBillingService = async_service
+        self._loop = loop
+
+    def list_plans(self):
+        return self._run(self._async.list_plans())
+
+    def status(self):
+        return self._run(self._async.status())
+
+    def create_checkout_session(
+        self,
+        shape: str,
+        success_url: str = "",
+        cancel_url: str = "",
+    ) -> str:
+        return self._run(
+            self._async.create_checkout_session(shape, success_url, cancel_url)
+        )
+
+    def create_billing_portal_session(self, return_url: str = "") -> str:
+        return self._run(self._async.create_billing_portal_session(return_url))
+
+    def change_shape(self, shape: str):
+        return self._run(self._async.change_shape(shape))
+
+
 class Compute(_SyncBase):
     """Main client for the boxd API (synchronous API).
 
@@ -429,6 +461,7 @@ class Compute(_SyncBase):
         self.domain = DomainService(self._async.domain, self._loop)
         self.network = NetworkService(self._async.network, self._loop)
         self.token = TokenService(self._async.token, self._loop)
+        self.billing = BillingService(self._async.billing, self._loop)
 
     def whoami(self) -> WhoamiResult:
         """Return information about the authenticated user."""

boxd-0.1.2.dev13/src/boxd/billing.py

@@ -0,0 +1,146 @@
+"""BillingService — list plans, check status, and manage subscriptions."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+from ._generated import api_pb2
+from ._utils import GrpcCaller
+
+if TYPE_CHECKING:
+    from .client import Compute
+
+
+@dataclass
+class Plan:
+    """One row of the static plan catalog."""
+
+    tier: str
+    """``'free'`` or ``'individual'``."""
+
+    shape: str
+    """``'2x8'`` | ``'4x16'`` | ``'8x32'`` | ``'16x64'``."""
+
+    monthly_eur: int
+    """Price in EUR cents (e.g. ``4000`` for €40/mo)."""
+
+    lookup_key: str
+    """Stripe ``lookup_key`` for this plan (``'individual-<shape>'``)."""
+
+    description: str
+    vcpu: int
+    memory_bytes: int
+
+
+@dataclass
+class Billing:
+    """Current billing state for the authenticated user."""
+
+    tier: str
+    """``'free'`` or ``'individual'``."""
+
+    shape: str
+    """``'2x8'`` | ``'4x16'`` | ``'8x32'`` | ``'16x64'``."""
+
+    subscription_status: str
+    """``'active'`` | ``'trialing'`` | ``'past_due'`` | ``'canceled'``."""
+
+    stripe_customer_id: str
+    """Empty string when the user has never upgraded."""
+
+    stripe_subscription_id: str
+    """Empty string when on the free tier."""
+
+    past_due_since: int
+    """Unix timestamp of payment failure; ``0`` when not past due."""
+
+    max_vms: int
+    """Effective quota at the current shape."""
+
+
+class BillingService(GrpcCaller):
+    """Subscription billing: list plans, get current status, drive checkout
+    and the Customer Portal hand-off, swap shapes in-place.
+
+    Usage::
+
+        plans = await c.billing.list_plans()
+        current = await c.billing.status()
+        if current.tier == "free":
+            url = await c.billing.create_checkout_session("4x16")
+            print(f"Upgrade at: {url}")
+    """
+
+    def __init__(self, client: Compute) -> None:
+        self._client = client
+
+    async def list_plans(self) -> list[Plan]:
+        """Return the static plan catalog (the same one the website renders)."""
+        resp = await self._call("ListPlans", api_pb2.ListPlansRequest())
+        return [
+            Plan(
+                tier=p.tier,
+                shape=p.shape,
+                monthly_eur=p.monthly_eur,
+                lookup_key=p.lookup_key,
+                description=p.description,
+                vcpu=p.vcpu,
+                memory_bytes=p.memory_bytes,
+            )
+            for p in resp.plans
+        ]
+
+    async def status(self) -> Billing:
+        """Read the current billing state for the authenticated user."""
+        resp = await self._call("GetBilling", api_pb2.GetBillingRequest())
+        b = resp.billing
+        return Billing(
+            tier=b.tier,
+            shape=b.shape,
+            subscription_status=b.subscription_status,
+            stripe_customer_id=b.stripe_customer_id,
+            stripe_subscription_id=b.stripe_subscription_id,
+            past_due_since=b.past_due_since,
+            max_vms=b.max_vms,
+        )
+
+    async def create_checkout_session(
+        self,
+        shape: str,
+        success_url: str = "",
+        cancel_url: str = "",
+    ) -> str:
+        """Free → paid upgrade. Returns the Stripe Checkout URL — open it in
+        a browser to complete the upgrade. The subscription becomes active
+        via webhook on completion (14-day trial, EU VAT, quantity=1)."""
+        resp = await self._call(
+            "CreateCheckoutSession",
+            api_pb2.CreateCheckoutSessionRequest(
+                shape=shape,
+                success_url=success_url,
+                cancel_url=cancel_url,
+            ),
+        )
+        return resp.checkout_url
+
+    async def create_billing_portal_session(self, return_url: str = "") -> str:
+        """Open Stripe Customer Portal for payment-method updates, invoice
+        history, and self-cancel. Returns a short-lived URL."""
+        resp = await self._call(
+            "CreateBillingPortalSession",
+            api_pb2.CreateBillingPortalSessionRequest(return_url=return_url),
+        )
+        return resp.portal_url
+
+    async def change_shape(self, shape: str) -> Billing:
+        """In-place subscription swap to a different shape. Prorated by Stripe.
+        Returns the post-swap billing state (echoed from Stripe)."""
+        resp = await self._call(
+            "ChangeShape",
+            api_pb2.ChangeShapeRequest(shape=shape),
+        )
+        # Server returns just shape + status; fold into a Billing-shaped view
+        # by re-reading status. Simpler than mirroring two slightly different
+        # response types in the public surface.
+        return await self.status()

{boxd-0.1.2 → boxd-0.1.2.dev13}/src/boxd/client.py

@@ -16,6 +16,7 @@ from .disks import DiskService
 from .domains import DomainService
 from .errors import AuthenticationError, from_grpc_error
 from .networks import NetworkService
+from .billing import BillingService
 from .templates import TemplateService
 from .tokens import TokenService
 from .types import ConfigResult, WhoamiResult
@@ -104,6 +105,7 @@ class Compute:
         self.domain = DomainService(self)
         self.network = NetworkService(self)
         self.token = TokenService(self)
+        self.billing = BillingService(self)
 
     async def _ensure_channel(self) -> api_pb2_grpc.BoxdApiStub:
         """Lazily create the gRPC channel and return the stub."""

{boxd-0.1.2 → boxd-0.1.2.dev13/src/boxd.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.1.2
+Version: 0.1.2.dev13
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT

{boxd-0.1.2 → boxd-0.1.2.dev13}/src/boxd.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ src/boxd/_utils.py
 src/boxd/_version_check.py
 src/boxd/aio.py
 src/boxd/auth.py
+src/boxd/billing.py
 src/boxd/box.py
 src/boxd/boxes.py
 src/boxd/client.py