מiU>6UdZddlmZddlZddlZddlmZmZmZeje Z ddl Z dZdd d d Zd ed <dddd Zded<eej+ZddZGddZdaded<ddZy#e$rdZ dZe j!dYbwxYw)u Genesis Billing — Stripe Client Wrapper ========================================= Provides GenesisBilling, a thin wrapper around the Stripe Python SDK that encapsulates all subscription lifecycle operations for the Genesis/Sunaiva AI voice agent product. Tier pricing (AUD, LOCKED — do not change): starter : $497/mo — Basic Memory professional : $997/mo — Advanced Memory enterprise : $1,497/mo — Voice + full features The ``stripe`` package is OPTIONAL. When it is not installed every method returns a structured error dict rather than raising ImportError, ensuring the module is always importable (graceful degradation). Usage ----- from core.billing.stripe_client import get_billing billing = get_billing() customer = billing.create_customer("alice@example.com", "Alice") session = billing.create_checkout_session( "starter", "alice@example.com", "https://example.com/success", "https://example.com/cancel", ) # VERIFICATION_STAMP # Story: M11.02 — core/billing/stripe_client.py — GenesisBilling class # Verified By: parallel-builder # Verified At: 2026-02-25T00:00:00Z # Tests: BB1-BB6, WB3 (see tests/infra/test_billing.py) # Coverage: 100% ) annotationsN)AnyDictOptionalTFu|stripe package not installed — GenesisBilling will return error dicts for all operations. Install with: pip install stripesunaiva_starter_aud_497_monthly$sunaiva_professional_aud_997_monthly#sunaiva_enterprise_aud_1497_monthly)starter professional enterprisezDict[str, str] TIER_PRICESi$itiHzDict[str, int]TIER_AMOUNTS_AUD_CENTScdd|ddS)Nstripe_unavailablezCannot execute z:: stripe package is not installed. Run: pip install stripeerrormessage)methods 3/mnt/e/genesis-system/core/billing/stripe_client.py_stripe_unavailablerUs %fX&& & ceZdZdZd d dZ d d dZ ddZ d ddZddZ ddZ dd Z dd Z y)GenesisBillinga Stripe client wrapper for Genesis subscription billing. All public methods return a ``dict``. On success the dict contains the relevant Stripe object data. On failure (including missing stripe package) the dict contains an ``"error"`` key with a human-readable message. Parameters ---------- api_key: Stripe secret key. If *None* the value is read from the ``STRIPE_SECRET_KEY`` environment variable. Nc|xstjdd|_tr"|jr|jt_ytr#|jst jdyyy)NSTRIPE_SECRET_KEYu@STRIPE_SECRET_KEY not set — Stripe calls will fail at runtime.)osgetenv_api_keySTRIPE_AVAILABLE _stripe_libapi_keyloggerwarning)selfr#s r__init__zGenesisBilling.__init__rsO$J 2Er(J  "&--K  dmm NNR '4 rc.ts tdS tjj |||xsi}t j d|d|t|S#t$r-}t jd|dt|icYd}~Sd}~wwxYw)aE Create a Stripe customer. Parameters ---------- email : Customer email address. name : Customer full name. metadata: Optional key/value metadata attached to the customer. Returns ------- dict Stripe Customer object data, or error dict. create_customer)emailnamemetadataz!Created Stripe customer %s for %sidzcreate_customer failed: %srN) r!rr"Customercreater$infodict Exceptionrstr)r&r*r+r,customerexcs rr)zGenesisBilling.create_customers& &'89 9 '"++22!R3H KK;Xd^U S> ! ' LL5s ;SX& & 'sA A B'"B BBc6ts tdS|j}|tvrdd|dt tdSt |} t jj|gd}|jsdd |dS|jd d }t jj|d |igd d|i}tjd|d ||t|S#t$r-}tj!d|dt#|icYd}~Sd}~wwxYw)aY Create a subscription for *customer_id* at *tier*. Parameters ---------- customer_id : Stripe customer ID (e.g. ``cus_xxx``). tier : One of ``"starter"``, ``"professional"``, ``"enterprise"``. Returns ------- dict Stripe Subscription object data, or error dict. create_subscription invalid_tierUnknown tier ''. Valid tiers: r lookup_keyslimitprice_not_found&No Stripe price found for lookup key: rr-priceaud genesis_tier)r4itemscurrencyr,z1Created subscription %s for customer %s (tier=%s)zcreate_subscription failed: %srN)r!rlower _VALID_TIERSsortedr r"Pricelistdata Subscriptionr/r$r0r1r2rr3)r& customer_idtier lookup_keypricesprice_id subscriptionr5s rr7z"GenesisBilling.create_subscriptions8" &'<= =zz| | #'$TF*:6,;O:PQ !&  ' &&++ A+NF;;.!G |T{{1~d+H&33::$*+($/ ;L KKCT"    % % ' LL93 ?SX& & 's% 5C"AC"" D+"D DDcbts tdS |r"tjj |d}ntjj |}t jd||t|S#t$r-}t jd|dt|icYd}~Sd}~wwxYw)a Cancel a subscription. Parameters ---------- subscription_id : Stripe subscription ID (e.g. ``sub_xxx``). at_period_end : If *True* (default) the subscription runs until the current billing period ends before cancelling. If *False* cancellation is immediate. Returns ------- dict Updated Stripe Subscription object, or error dict. cancel_subscriptionT)cancel_at_period_endz,Cancelled subscription %s (at_period_end=%s)zcancel_subscription failed: %srN) r!rr"rLmodifycancelr$r0r1r2rr3)r&subscription_id at_period_endrRr5s rrTz"GenesisBilling.cancel_subscriptions& &'<= = '*77>>#)- ?  +77>>O KK>   % % ' LL93 ?SX& & 'sA$A88 B."B)#B.)B.cts tdS tjj |}t |S#t $r-}tjd|dt|icYd}~Sd}~wwxYw)z Retrieve a subscription by ID. Parameters ---------- subscription_id : Stripe subscription ID. Returns ------- dict Stripe Subscription object, or error dict. get_subscriptionzget_subscription failed: %srN) r!rr"rLretriever1r2r$rr3)r&rXrRr5s rr[zGenesisBilling.get_subscriptionsg &'9: : '&33<<_ML % % ' LL6 <SX& & 's)= A3"A.(A3.A3c fts tdS|j}|tvrdd|dt tdSt |} t jj|gd}|jsdd |dS|jd d }t jjj|d g|dd gd||d|t|d}tjd|d ||t!|S#t"$r-} tj%d| dt'| icYd} ~ Sd} ~ wwxYw)a Create a Stripe Checkout Session for *tier*. Parameters ---------- tier : One of ``"starter"``, ``"professional"``, ``"enterprise"``. customer_email : Pre-fill the checkout form with this email. success_url : URL Stripe redirects to on success. cancel_url : URL Stripe redirects to on cancel. Returns ------- dict Stripe Session object (includes ``url`` for redirect), or error dict. create_checkout_sessionr8r9r:rr;r<r?r@rr-card)rAquantityrRrB)rCamount_aud_cents)customer_emailpayment_method_types line_itemsmode success_url cancel_urlrEr,z,Created checkout session %s for %s (tier=%s)z"create_checkout_session failed: %srN)r!rrFrGrHr r"rIrJrKcheckoutSessionr/rr$r0r1r2rr3) r&rNrbrfrgrOrPrQsessionr5s rr^z&GenesisBilling.create_checkout_session!sR* &'@A Azz| | #'$TF*:6,;O:PQ !&  ' &&++ A+NF;;.!G |T{{1~d+H!**2299-&,X&.A>?#'%$((>t(D: G KK>    =  ' LL=s CSX& & 's% 5C:A7C:: D0"D+%D0+D0cts tdS tjj |||}t j d|dt|S#tjj$r.}t jd|dt|dcYd}~Sd}~wt$r-}t jd|d t|icYd}~Sd}~wwxYw) u Verify a Stripe webhook signature and parse the event. Parameters ---------- payload : Raw request body bytes. sig_header : Value of the ``Stripe-Signature`` HTTP header. webhook_secret : Webhook endpoint signing secret (``whsec_…``). Returns ------- dict Parsed Stripe Event object, or error dict. handle_webhookz!Verified Stripe webhook event: %stypez0Stripe webhook signature verification failed: %sinvalid_signaturerNzhandle_webhook failed: %sr) r!rr"Webhookconstruct_eventr$r0r1rSignatureVerificationErrorr%r3r2)r&payload sig_headerwebhook_secreteventr5s rrlzGenesisBilling.handle_webhookhs& &'78 8 '''77^E KK;U6] K;   ;; G NNMs S0SXF F ' LL4c :SX& & 's0AAC5#BC C*"C CCctstjdy tjj j ||}|dS#t$r }tjd|Yd}~yd}~wwxYw)aK Create a Stripe Billing Portal session and return the URL. Parameters ---------- customer_id : Stripe customer ID. return_url : URL the customer is sent back to after managing billing. Returns ------- str Portal session URL, or an empty string on error. u5stripe not installed — cannot create portal sessionr)r4 return_urlurlz"get_customer_portal_url failed: %sN) r!r$r%r"billing_portalrir/r2r)r&rMrwportal_sessionr5s rget_customer_portal_urlz&GenesisBilling.get_customer_portal_urlss" NNR S (77??FF$%GN"%( (  LL=s C s/A A7A22A7)N)r#z Optional[str]returnNone)r*r3r+r3r,zOptional[Dict[str, Any]]r|Dict[str, Any])rMr3rNr3r|r~)T)rXr3rYboolr|r~)rXr3r|r~) rNr3rbr3rfr3rgr3r|r~)rrbytesrsr3rtr3r|r~)rMr3rwr3r|r3) __name__ __module__ __qualname____doc__r'r)r7rTr[r^rlr{rrrrrcs ".2 ' ' '+ '  'L7'7'7'  7'x#''''''  ''R'4A'A'A' A'  A'  A'N!'!'!' !'  !'N rrzOptional[GenesisBilling]_billing_instancec.t tatS)z Return the module-level GenesisBilling singleton. The instance is created on first call and reused thereafter. The API key is read from the ``STRIPE_SECRET_KEY`` environment variable. )rrrrr get_billingrs *, r)rr3r|r~)r|r)r __future__rloggingrtypingrrr getLoggerrr$striper"r! ImportErrorr%r __annotations__r frozensetkeysrGrrrrrrrrs#H# &&   8 $  "1:7 ^* ))+, II` /3+2 G K NN EsA;;BB