svc-infra 0.1.589__py3-none-any.whl → 0.1.706__py3-none-any.whl

svc_infra/apf_payments/provider/base.py

@@ -42,10 +42,14 @@ class ProviderAdapter(Protocol):
     async def ensure_customer(self, data: CustomerUpsertIn) -> CustomerOut:
         pass
 
-    async def attach_payment_method(self, data: PaymentMethodAttachIn) -> PaymentMethodOut:
+    async def attach_payment_method(
+        self, data: PaymentMethodAttachIn
+    ) -> PaymentMethodOut:
         pass
 
-    async def list_payment_methods(self, provider_customer_id: str) -> list[PaymentMethodOut]:
+    async def list_payment_methods(
+        self, provider_customer_id: str
+    ) -> list[PaymentMethodOut]:
         pass
 
     async def detach_payment_method(self, provider_method_id: str) -> PaymentMethodOut:
@@ -87,7 +91,9 @@ class ProviderAdapter(Protocol):
     async def pay_invoice(self, provider_invoice_id: str) -> InvoiceOut:
         pass
 
-    async def create_intent(self, data: IntentCreateIn, *, user_id: str | None) -> IntentOut:
+    async def create_intent(
+        self, data: IntentCreateIn, *, user_id: str | None
+    ) -> IntentOut:
         pass
 
     async def confirm_intent(self, provider_intent_id: str) -> IntentOut:
@@ -107,7 +113,9 @@ class ProviderAdapter(Protocol):
     ) -> dict[str, Any]:
         pass
 
-    async def capture_intent(self, provider_intent_id: str, *, amount: int | None) -> IntentOut:
+    async def capture_intent(
+        self, provider_intent_id: str, *, amount: int | None
+    ) -> IntentOut:
         pass
 
     async def list_intents(
@@ -150,7 +158,9 @@ class ProviderAdapter(Protocol):
     async def create_setup_intent(self, data: SetupIntentCreateIn) -> SetupIntentOut:
         pass
 
-    async def confirm_setup_intent(self, provider_setup_intent_id: str) -> SetupIntentOut:
+    async def confirm_setup_intent(
+        self, provider_setup_intent_id: str
+    ) -> SetupIntentOut:
         pass
 
     async def get_setup_intent(self, provider_setup_intent_id: str) -> SetupIntentOut:
@@ -169,7 +179,9 @@ class ProviderAdapter(Protocol):
     async def get_dispute(self, provider_dispute_id: str) -> DisputeOut:
         pass
 
-    async def submit_dispute_evidence(self, provider_dispute_id: str, evidence: dict) -> DisputeOut:
+    async def submit_dispute_evidence(
+        self, provider_dispute_id: str, evidence: dict
+    ) -> DisputeOut:
         pass
 
     # --- Balance & Payouts ---
@@ -186,7 +198,12 @@ class ProviderAdapter(Protocol):
 
     # --- Customers ---
     async def list_customers(
-        self, *, provider: str | None, user_id: str | None, limit: int, cursor: str | None
+        self,
+        *,
+        provider: str | None,
+        user_id: str | None,
+        limit: int,
+        cursor: str | None,
     ) -> tuple[list[CustomerOut], str | None]:
         """Optional: if not implemented, the service will list from local DB."""
         pass
@@ -203,7 +220,9 @@ class ProviderAdapter(Protocol):
     ) -> tuple[list[ProductOut], str | None]:
         pass
 
-    async def update_product(self, provider_product_id: str, data: ProductUpdateIn) -> ProductOut:
+    async def update_product(
+        self, provider_product_id: str, data: ProductUpdateIn
+    ) -> ProductOut:
         pass
 
     async def get_price(self, provider_price_id: str) -> PriceOut:
@@ -219,7 +238,9 @@ class ProviderAdapter(Protocol):
     ) -> tuple[list[PriceOut], str | None]:
         pass
 
-    async def update_price(self, provider_price_id: str, data: PriceUpdateIn) -> PriceOut:
+    async def update_price(
+        self, provider_price_id: str, data: PriceUpdateIn
+    ) -> PriceOut:
         pass
 
     # --- Subscriptions ---

svc_infra/apf_payments/provider/stripe.py

@@ -44,7 +44,7 @@ from .base import ProviderAdapter
 try:
     import stripe
 except Exception:  # pragma: no cover
-    stripe = None  # type: ignore
+    stripe = None  # type: ignore[assignment]
 
 
 async def _acall(fn, /, *args, **kwargs):
@@ -60,7 +60,9 @@ def _pi_to_out(pi) -> IntentOut:
         amount=int(pi.amount),
         currency=str(pi.currency).upper(),
         client_secret=getattr(pi, "client_secret", None),
-        next_action=NextAction(type=getattr(getattr(pi, "next_action", None), "type", None)),
+        next_action=NextAction(
+            type=getattr(getattr(pi, "next_action", None), "type", None)
+        ),
     )
 
 
@@ -134,7 +136,9 @@ def _sub_to_out(s) -> SubscriptionOut:
         quantity=int(qty or 0),
         cancel_at_period_end=bool(s.cancel_at_period_end),
         current_period_end=(
-            str(s.current_period_end) if getattr(s, "current_period_end", None) else None
+            str(s.current_period_end)
+            if getattr(s, "current_period_end", None)
+            else None
         ),
     )
 
@@ -163,7 +167,9 @@ def _dispute_to_out(d) -> DisputeOut:
         reason=getattr(d, "reason", None),
         status=d.status,
         evidence_due_by=(
-            str(d.evidence_details.get("due_by")) if getattr(d, "evidence_details", None) else None
+            str(d.evidence_details.get("due_by"))
+            if getattr(d, "evidence_details", None)
+            else None
         ),
         created_at=str(d.created) if getattr(d, "created", None) else None,
     )
@@ -193,7 +199,9 @@ class StripeAdapter(ProviderAdapter):
             raise RuntimeError("stripe SDK is not installed. pip install stripe")
         stripe.api_key = st.stripe.secret_key.get_secret_value()
         self._wh_secret = (
-            st.stripe.webhook_secret.get_secret_value() if st.stripe.webhook_secret else None
+            st.stripe.webhook_secret.get_secret_value()
+            if st.stripe.webhook_secret
+            else None
         )
 
     # -------- Customers --------
@@ -235,9 +243,14 @@ class StripeAdapter(ProviderAdapter):
         )
 
     async def list_customers(
-        self, *, provider: str | None, user_id: str | None, limit: int, cursor: str | None
+        self,
+        *,
+        provider: str | None,
+        user_id: str | None,
+        limit: int,
+        cursor: str | None,
     ) -> tuple[list[CustomerOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if cursor:
             params["starting_after"] = cursor
         # Stripe has no direct filter for our custom user_id; many teams store mapping in DB.
@@ -253,11 +266,15 @@ class StripeAdapter(ProviderAdapter):
             )
             for c in res.data
         ]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
     # -------- Payment Methods --------
-    async def attach_payment_method(self, data: PaymentMethodAttachIn) -> PaymentMethodOut:
+    async def attach_payment_method(
+        self, data: PaymentMethodAttachIn
+    ) -> PaymentMethodOut:
         pm = await _acall(
             stripe.PaymentMethod.attach,
             data.payment_method_token,
@@ -271,23 +288,35 @@ class StripeAdapter(ProviderAdapter):
                 invoice_settings={"default_payment_method": pm.id},
             )
             is_default = (
-                getattr(getattr(cust, "invoice_settings", None), "default_payment_method", None)
+                getattr(
+                    getattr(cust, "invoice_settings", None),
+                    "default_payment_method",
+                    None,
+                )
                 == pm.id
             )
         else:
             cust = await _acall(stripe.Customer.retrieve, data.customer_provider_id)
             is_default = (
-                getattr(getattr(cust, "invoice_settings", None), "default_payment_method", None)
+                getattr(
+                    getattr(cust, "invoice_settings", None),
+                    "default_payment_method",
+                    None,
+                )
                 == pm.id
             )
         return _pm_to_out(pm, is_default=is_default)
 
-    async def list_payment_methods(self, provider_customer_id: str) -> list[PaymentMethodOut]:
+    async def list_payment_methods(
+        self, provider_customer_id: str
+    ) -> list[PaymentMethodOut]:
         cust = await _acall(stripe.Customer.retrieve, provider_customer_id)
         default_pm = getattr(
             getattr(cust, "invoice_settings", None), "default_payment_method", None
         )
-        res = await _acall(stripe.PaymentMethod.list, customer=provider_customer_id, type="card")
+        res = await _acall(
+            stripe.PaymentMethod.list, customer=provider_customer_id, type="card"
+        )
         return [_pm_to_out(pm, is_default=(pm.id == default_pm)) for pm in res.data]
 
     async def detach_payment_method(self, provider_method_id: str) -> PaymentMethodOut:
@@ -312,7 +341,9 @@ class StripeAdapter(ProviderAdapter):
         )
         pm = await _acall(stripe.PaymentMethod.retrieve, provider_method_id)
         is_default = (
-            getattr(getattr(cust, "invoice_settings", None), "default_payment_method", None)
+            getattr(
+                getattr(cust, "invoice_settings", None), "default_payment_method", None
+            )
             == pm.id
         )
         return _pm_to_out(pm, is_default=is_default)
@@ -356,7 +387,9 @@ class StripeAdapter(ProviderAdapter):
 
     # -------- Products / Prices --------
     async def create_product(self, data: ProductCreateIn) -> ProductOut:
-        p = await _acall(stripe.Product.create, name=data.name, active=bool(data.active))
+        p = await _acall(
+            stripe.Product.create, name=data.name, active=bool(data.active)
+        )
         return _product_to_out(p)
 
     async def get_product(self, provider_product_id: str) -> ProductOut:
@@ -366,17 +399,21 @@ class StripeAdapter(ProviderAdapter):
     async def list_products(
         self, *, active: bool | None, limit: int, cursor: str | None
     ) -> tuple[list[ProductOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if active is not None:
             params["active"] = bool(active)
         if cursor:
             params["starting_after"] = cursor
         res = await _acall(stripe.Product.list, **params)
         items = [_product_to_out(p) for p in res.data]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
-    async def update_product(self, provider_product_id: str, data: ProductUpdateIn) -> ProductOut:
+    async def update_product(
+        self, provider_product_id: str, data: ProductUpdateIn
+    ) -> ProductOut:
         update: dict[str, Any] = {}
         if data.name is not None:
             update["name"] = data.name
@@ -415,7 +452,7 @@ class StripeAdapter(ProviderAdapter):
         limit: int,
         cursor: str | None,
     ) -> tuple[list[PriceOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if provider_product_id:
             params["product"] = provider_product_id
         if active is not None:
@@ -424,10 +461,14 @@ class StripeAdapter(ProviderAdapter):
             params["starting_after"] = cursor
         res = await _acall(stripe.Price.list, **params)
         items = [_price_to_out(p) for p in res.data]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
-    async def update_price(self, provider_price_id: str, data: PriceUpdateIn) -> PriceOut:
+    async def update_price(
+        self, provider_price_id: str, data: PriceUpdateIn
+    ) -> PriceOut:
         # Stripe allows toggling `active` and updating metadata, but not amount/currency/product.
         update: dict[str, Any] = {}
         if data.active is not None:
@@ -454,7 +495,9 @@ class StripeAdapter(ProviderAdapter):
     async def update_subscription(
         self, provider_subscription_id: str, data: SubscriptionUpdateIn
     ) -> SubscriptionOut:
-        s = await _acall(stripe.Subscription.retrieve, provider_subscription_id, expand=["items"])
+        s = await _acall(
+            stripe.Subscription.retrieve, provider_subscription_id, expand=["items"]
+        )
         items = s.items.data
         update_kwargs: dict[str, Any] = {"proration_behavior": data.proration_behavior}
         # update first item (simple plan model)
@@ -468,21 +511,27 @@ class StripeAdapter(ProviderAdapter):
             update_kwargs["items"] = [item_update]
         if data.cancel_at_period_end is not None:
             update_kwargs["cancel_at_period_end"] = bool(data.cancel_at_period_end)
-        s2 = await _acall(stripe.Subscription.modify, provider_subscription_id, **update_kwargs)
+        s2 = await _acall(
+            stripe.Subscription.modify, provider_subscription_id, **update_kwargs
+        )
         return _sub_to_out(s2)
 
     async def cancel_subscription(
         self, provider_subscription_id: str, at_period_end: bool = True
     ) -> SubscriptionOut:
         s = await _acall(
-            stripe.Subscription.cancel if not at_period_end else stripe.Subscription.modify,
+            stripe.Subscription.cancel
+            if not at_period_end
+            else stripe.Subscription.modify,
             provider_subscription_id,
             **({} if not at_period_end else {"cancel_at_period_end": True}),
         )
         return _sub_to_out(s)
 
     async def get_subscription(self, provider_subscription_id: str) -> SubscriptionOut:
-        s = await _acall(stripe.Subscription.retrieve, provider_subscription_id, expand=["items"])
+        s = await _acall(
+            stripe.Subscription.retrieve, provider_subscription_id, expand=["items"]
+        )
         return _sub_to_out(s)
 
     async def list_subscriptions(
@@ -493,7 +542,7 @@ class StripeAdapter(ProviderAdapter):
         limit: int,
         cursor: str | None,
     ) -> tuple[list[SubscriptionOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if customer_provider_id:
             params["customer"] = customer_provider_id
         if status:
@@ -502,7 +551,9 @@ class StripeAdapter(ProviderAdapter):
             params["starting_after"] = cursor
         res = await _acall(stripe.Subscription.list, **params)
         items = [_sub_to_out(s) for s in res.data]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
     # -------- Invoices --------
@@ -542,7 +593,8 @@ class StripeAdapter(ProviderAdapter):
         else:
             kwargs["unit_amount"] = int(data.unit_amount)
         await _acall(
-            stripe.InvoiceItem.create, **{k: v for k, v in kwargs.items() if v is not None}
+            stripe.InvoiceItem.create,
+            **{k: v for k, v in kwargs.items() if v is not None},
         )
         inv = await _acall(stripe.Invoice.retrieve, provider_invoice_id)
         return _inv_to_out(inv)
@@ -555,7 +607,7 @@ class StripeAdapter(ProviderAdapter):
         limit: int,
         cursor: str | None,
     ) -> tuple[list[InvoiceOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if customer_provider_id:
             params["customer"] = customer_provider_id
         if status:
@@ -564,7 +616,9 @@ class StripeAdapter(ProviderAdapter):
             params["starting_after"] = cursor
         res = await _acall(stripe.Invoice.list, **params)
         items = [_inv_to_out(inv) for inv in res.data]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
     async def get_invoice(self, provider_invoice_id: str) -> InvoiceOut:
@@ -577,13 +631,13 @@ class StripeAdapter(ProviderAdapter):
         params = {"customer": customer_provider_id}
         if subscription_id:
             params["subscription"] = subscription_id
-        inv = await _acall(stripe.Invoice.upcoming, **params)
+        inv = await _acall(stripe.Invoice.upcoming, **params)  # type: ignore[attr-defined]
         return _inv_to_out(inv)
 
     async def list_invoice_line_items(
         self, provider_invoice_id: str, *, limit: int, cursor: str | None
     ) -> tuple[list[InvoiceLineItemOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if cursor:
             params["starting_after"] = cursor
         res = await _acall(stripe.Invoice.list_lines, provider_invoice_id, **params)
@@ -602,22 +656,29 @@ class StripeAdapter(ProviderAdapter):
                     provider_price_id=price_id,
                 )
             )
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
     # -------- Intents --------
-    async def create_intent(self, data: IntentCreateIn, *, user_id: str | None) -> IntentOut:
+    async def create_intent(
+        self, data: IntentCreateIn, *, user_id: str | None
+    ) -> IntentOut:
         kwargs: dict[str, Any] = dict(
             amount=int(data.amount),
             currency=data.currency.lower(),
             description=data.description or None,
             capture_method="manual" if data.capture_method == "manual" else "automatic",
-            automatic_payment_methods={"enabled": True} if not data.payment_method_types else None,
+            automatic_payment_methods={"enabled": True}
+            if not data.payment_method_types
+            else None,
         )
         if data.payment_method_types:
             kwargs["payment_method_types"] = data.payment_method_types
         pi = await _acall(
-            stripe.PaymentIntent.create, **{k: v for k, v in kwargs.items() if v is not None}
+            stripe.PaymentIntent.create,
+            **{k: v for k, v in kwargs.items() if v is not None},
         )
         return _pi_to_out(pi)
 
@@ -648,7 +709,9 @@ class StripeAdapter(ProviderAdapter):
         pi = await _acall(stripe.PaymentIntent.retrieve, provider_intent_id)
         return _pi_to_out(pi)
 
-    async def capture_intent(self, provider_intent_id: str, *, amount: int | None) -> IntentOut:
+    async def capture_intent(
+        self, provider_intent_id: str, *, amount: int | None
+    ) -> IntentOut:
         kwargs = {}
         if amount is not None:
             kwargs["amount_to_capture"] = int(amount)
@@ -663,7 +726,7 @@ class StripeAdapter(ProviderAdapter):
         limit: int,
         cursor: str | None,
     ) -> tuple[list[IntentOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if customer_provider_id:
             params["customer"] = customer_provider_id
         if status:
@@ -672,13 +735,16 @@ class StripeAdapter(ProviderAdapter):
             params["starting_after"] = cursor
         res = await _acall(stripe.PaymentIntent.list, **params)
         items = [_pi_to_out(pi) for pi in res.data]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
     # ---- Setup Intents (off-session readiness) ----
     async def create_setup_intent(self, data: SetupIntentCreateIn) -> SetupIntentOut:
         si = await _acall(
-            stripe.SetupIntent.create, payment_method_types=data.payment_method_types or ["card"]
+            stripe.SetupIntent.create,
+            payment_method_types=data.payment_method_types or ["card"],
         )
         return SetupIntentOut(
             id=si.id,
@@ -686,10 +752,14 @@ class StripeAdapter(ProviderAdapter):
             provider_setup_intent_id=si.id,
             status=si.status,
             client_secret=getattr(si, "client_secret", None),
-            next_action=NextAction(type=getattr(getattr(si, "next_action", None), "type", None)),
+            next_action=NextAction(
+                type=getattr(getattr(si, "next_action", None), "type", None)
+            ),
         )
 
-    async def confirm_setup_intent(self, provider_setup_intent_id: str) -> SetupIntentOut:
+    async def confirm_setup_intent(
+        self, provider_setup_intent_id: str
+    ) -> SetupIntentOut:
         si = await _acall(stripe.SetupIntent.confirm, provider_setup_intent_id)
         return SetupIntentOut(
             id=si.id,
@@ -697,7 +767,9 @@ class StripeAdapter(ProviderAdapter):
             provider_setup_intent_id=si.id,
             status=si.status,
             client_secret=getattr(si, "client_secret", None),
-            next_action=NextAction(type=getattr(getattr(si, "next_action", None), "type", None)),
+            next_action=NextAction(
+                type=getattr(getattr(si, "next_action", None), "type", None)
+            ),
         )
 
     async def get_setup_intent(self, provider_setup_intent_id: str) -> SetupIntentOut:
@@ -708,7 +780,9 @@ class StripeAdapter(ProviderAdapter):
             provider_setup_intent_id=si.id,
             status=si.status,
             client_secret=getattr(si, "client_secret", None),
-            next_action=NextAction(type=getattr(getattr(si, "next_action", None), "type", None)),
+            next_action=NextAction(
+                type=getattr(getattr(si, "next_action", None), "type", None)
+            ),
         )
 
     # ---- 3DS/SCA resume ----
@@ -720,25 +794,29 @@ class StripeAdapter(ProviderAdapter):
     async def list_disputes(
         self, *, status: str | None, limit: int, cursor: str | None
     ) -> tuple[list[DisputeOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if status:
             params["status"] = status
         if cursor:
             params["starting_after"] = cursor
         res = await _acall(stripe.Dispute.list, **params)
         items = [_dispute_to_out(d) for d in res.data]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
     async def get_dispute(self, provider_dispute_id: str) -> DisputeOut:
         d = await _acall(stripe.Dispute.retrieve, provider_dispute_id)
         return _dispute_to_out(d)
 
-    async def submit_dispute_evidence(self, provider_dispute_id: str, evidence: dict) -> DisputeOut:
+    async def submit_dispute_evidence(
+        self, provider_dispute_id: str, evidence: dict
+    ) -> DisputeOut:
         d = await _acall(stripe.Dispute.modify, provider_dispute_id, evidence=evidence)
         # Some disputes require explicit submit call:
         try:
-            d = await _acall(stripe.Dispute.submit, provider_dispute_id)
+            d = await _acall(stripe.Dispute.submit, provider_dispute_id)  # type: ignore[attr-defined]
         except Exception:
             pass
         return _dispute_to_out(d)
@@ -750,7 +828,9 @@ class StripeAdapter(ProviderAdapter):
         def _bucket(entries):
             out = []
             for b in entries or []:
-                out.append({"currency": str(b.currency).upper(), "amount": int(b.amount)})
+                out.append(
+                    {"currency": str(b.currency).upper(), "amount": int(b.amount)}
+                )
             return out
 
         return BalanceSnapshotOut(
@@ -761,12 +841,14 @@ class StripeAdapter(ProviderAdapter):
     async def list_payouts(
         self, *, limit: int, cursor: str | None
     ) -> tuple[list[PayoutOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if cursor:
             params["starting_after"] = cursor
         res = await _acall(stripe.Payout.list, **params)
         items = [_payout_to_out(p) for p in res.data]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
     async def get_payout(self, provider_payout_id: str) -> PayoutOut:
@@ -777,14 +859,16 @@ class StripeAdapter(ProviderAdapter):
     async def list_refunds(
         self, *, provider_payment_intent_id: str | None, limit: int, cursor: str | None
     ) -> tuple[list[RefundOut], str | None]:
-        params = {"limit": int(limit)}
+        params: dict[str, Any] = {"limit": int(limit)}
         if provider_payment_intent_id:
             params["payment_intent"] = provider_payment_intent_id
         if cursor:
             params["starting_after"] = cursor
         res = await _acall(stripe.Refund.list, **params)
         items = [_refund_to_out(r) for r in res.data]
-        next_cursor = res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        next_cursor = (
+            res.data[-1].id if getattr(res, "has_more", False) and res.data else None
+        )
         return items, next_cursor
 
     async def get_refund(self, provider_refund_id: str) -> RefundOut:
@@ -810,7 +894,7 @@ class StripeAdapter(ProviderAdapter):
         }
         if data.timestamp:
             body["timestamp"] = int(data.timestamp)
-        rec = await _acall(stripe.UsageRecord.create, **body)
+        rec = await _acall(stripe.UsageRecord.create, **body)  # type: ignore[attr-defined]
         return UsageRecordOut(
             id=rec.id,
             quantity=int(rec.quantity),
@@ -825,19 +909,25 @@ class StripeAdapter(ProviderAdapter):
         # Stripe exposes *summaries* per period. We surface them as list results.
         sub_item = f.subscription_item
         if not sub_item and f.provider_price_id:
-            items = await _acall(stripe.SubscriptionItem.list, price=f.provider_price_id, limit=1)
+            items = await _acall(
+                stripe.SubscriptionItem.list, price=f.provider_price_id, limit=1
+            )
             sub_item = items.data[0].id if items.data else None
         if not sub_item:
             return [], None
-        params = {"limit": int(f.limit or 50)}
+        params: dict[str, Any] = {"limit": int(f.limit or 50)}
         if f.cursor:
             params["starting_after"] = f.cursor
-        res = await _acall(stripe.SubscriptionItem.list_usage_record_summaries, sub_item, **params)
-        items: list[UsageRecordOut] = []
+        res = await _acall(
+            stripe.SubscriptionItem.list_usage_record_summaries,  # type: ignore[attr-defined]
+            sub_item,
+            **params,
+        )
+        usage_records: list[UsageRecordOut] = []
         for s in res.data:
             # No record id in summaries—synthesize a stable id from period start.
             synthesized_id = f"{sub_item}:{getattr(s, 'period', {}).get('start')}"
-            items.append(
+            usage_records.append(
                 UsageRecordOut(
                     id=synthesized_id,
                     quantity=int(getattr(s, "total_usage", 0)),
@@ -848,15 +938,19 @@ class StripeAdapter(ProviderAdapter):
             )
         next_cursor = (
             res.data[-1].id
-            if getattr(res, "has_more", False) and res.data and hasattr(res.data[-1], "id")
+            if getattr(res, "has_more", False)
+            and res.data
+            and hasattr(res.data[-1], "id")
             else None
         )
-        return items, next_cursor
+        return usage_records, next_cursor
 
     async def get_usage_record(self, usage_record_id: str) -> UsageRecordOut:
         # Stripe has no direct "retrieve usage record by id" API.
         # You can reconstruct via list summaries or store records locally when creating.
-        raise NotImplementedError("Stripe does not support retrieving a single usage record by id")
+        raise NotImplementedError(
+            "Stripe does not support retrieving a single usage record by id"
+        )
 
     # -------- Webhooks --------
     async def verify_and_parse_webhook(