Ë
    ¬dýjc2  ã                   óð
  — d dl Z d dlmZmZ d dl mZ d dlmZmZmZm	Z	m
Z
mZmZ d dlmZ d dlmZmZ d dlmZ d dlmZ d d	lmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z) d d
l*m+Z+ d dl,m-Z- d dl.m/Z/m0Z0  eddg¬«      Z1e1je                  dee3e       ejh                  ¬«      dee ee«      f   fd„«       Z5e1je                  dee$   ejh                  ¬«      dee6e/e0dz  f    ee«      f   dee ee«      f   fd„«       Z7e1jq                  dee   ejr                  ¬«      dedee6e/e0dz  f    ee«      f   dee ee«      f   fd„«       Z:e1jq                  dee   ejh                  ¬«      dedee6e/e0dz  f    ee«      f   dee ee«      f   fd„«       Z;e1jq                  dee   ejh                  ¬«      dedee6e/e0dz  f    ee«      f   dee ee«      f   fd„«       Z<e1jq                  dee   ejh                  ¬«      de&dee6e/e0dz  f    ee«      f   dee ee«      f   fd„«       Z=e1jq                  d ee$   ejh                  ¬«      dedee6e/e0dz  f    ee«      f   dee ee«      f   fd!„«       Z>e1jq                  d"ee$   ejh                  ¬«      dedee6e/e0dz  f    ee«      f   dee ee«      f   fd#„«       Z?e1je                  d$ee3e      ejh                  ¬«      dee6e/e0dz  f    ee«      f   dee ee«      f   fd%„«       Z@e1je                  d&ee   ejh                  ¬«      d'edee6e/e0dz  f    ee«      f   dee ee«      f   fd(„«       ZAe1je                  d)eejh                  ¬*«      d'edee6e/e0dz  f    ee«      f   dee ee«      f   fd+„«       ZBe1jq                  d,ee#   ejh                  ¬«      de"dee6e/e0dz  f    ee«      f   dee ee«      f   fd-„«       ZCe1je                  d.ee(   ejh                  ¬«      dee6e/e0dz  f    ee«      f   dee ee«      f   fd/„«       ZDe1je                  d0ee3e)      ejh                  ¬«      dee6e/e0dz  f    ee«      f   dee ee«      f   fd1„«       ZEe1jq                  d2ee   ejh                  ¬«      de'dee6e/e0dz  f    ee«      f   dee ee«      f   fd3„«       ZFe1je                  d4ee!   ejh                  ¬«      dee6e/e0dz  f    ee«      f   dee ee«      f   fd5„«       ZGe1je                  d6ee%   ejh                  ¬«      dee6e/e0dz  f    ee«      f   dee ee«      f   fd7„«       ZHy)8é    N)Ú	AnnotatedÚOptional)ÚUUID)Ú	APIRouterÚDependsÚHeaderÚHTTPExceptionÚQueryÚResponseÚstatus)ÚAsyncSession)Úget_current_tenantÚget_current_user)ÚApiResponse)Úget_db)ÚCancelSubscriptionRequestÚCheckoutOrderRequestÚCheckoutOrderResponseÚCouponValidationResponseÚDowngradeSubscriptionRequestÚInvoiceResponseÚPaymentVerificationRequestÚPaymentVerificationResponseÚPayWithWalletRequestÚPlanResponseÚReferralResponseÚRefundRequestÚRefundResponseÚSubscriptionResponseÚTenantUsageResponseÚUpgradeSubscriptionRequestÚValidateCouponRequestÚWalletResponseÚWalletTransactionResponse)ÚBillingService)ÚUser)ÚTenantÚTenantMemberz/billingzSaaS Billing & Subscriptions)ÚprefixÚtagsz/plans)Úresponse_modelÚstatus_codeÚdbc              ƒ   ón   K  — t        | «      }|j                  «       ƒ d{  –—† }t        d|¬«      S 7 Œ­w)z>Lists available commercial tiers and their entitlement quotas.Nz&Available subscription plans retrieved©ÚmessageÚdata)r%   Ú
list_plansr   )r-   ÚserviceÚplanss      ú./root/telegram-saas/apps/api/routes/billing.pyr2   r2   %   s;   è ø€ ô
 ˜RÓ €GØ×$Ñ$Ó&×&€EÜØ8Øôð ð 'ús   ‚5¡3¢5z/subscriptionÚtenant_contextc              ƒ   óŽ   K  — | \  }}t        |«      }|j                  |j                  «      ƒ d{  –—† }t        d|¬«      S 7 Œ­w)zNRetrieves current subscription status, period dates, and grace period details.NzTenant subscription retrievedr/   )r%   Úget_tenant_subscriptionÚidr   )r6   r-   ÚtenantÚ_r3   Úsubs         r5   r8   r8   2   sJ   è ø€ ð �I€FˆAÜ˜RÓ €GØ×/Ñ/°·	±	Ó:×
:€CÜØ/Øôð ð ;úó   ‚/A±A²Az	/checkoutÚreqc              ƒ   ó�   K  — |\  }}t        |«      }|j                  |j                  | «      ƒ d{  –—† }t        d|¬«      S 7 Œ­w)zPCreates a payment order with Razorpay or Stripe, applying promotional discounts.Nz#Checkout order created successfullyr/   )r%   Úcreate_checkout_orderr9   r   ©r>   r6   r-   r:   r;   r3   Úorders          r5   r@   r@   A   sM   è ø€ ð �I€FˆAÜ˜RÓ €GØ×/Ñ/°·	±	¸3Ó?×?€EÜØ5Øôð ð @úó   ‚0A²A³Az/checkout/verifyc              ƒ   ó¤   K  — |\  }}t        |«      }|j                  |j                  | «      ƒ d{  –—† }t        |j                  |¬«      S 7 Œ­w)z˜
    Server-side cryptographic payment verification.
    Validates gateway signatures and activates subscription. Never trusts client claims alone.
    Nr/   )r%   Úverify_and_activate_paymentr9   r   r0   ©r>   r6   r-   r:   r;   r3   Úresults          r5   Úverify_paymentrH   Q   sQ   è ø€ ð �I€FˆAÜ˜RÓ €GØ×6Ñ6°v·y±yÀ#ÓF×F€FÜØ—‘Øôð ð Gús   ‚0A²A³Az/wallet/payc              ƒ   óÎ   K  — |\  }}t        |«      }|j                  |j                  | j                  | j                  «      ƒ d{  –—† }t        |j                  |¬«      S 7 Œ­w)z7Pay subscription directly using prepaid wallet balance.Nr/   )r%   Úpay_with_walletr9   Úplan_idÚcoupon_coder   r0   rF   s          r5   rJ   rJ   d   s[   è ø€ ð �I€FˆAÜ˜RÓ €GØ×*Ñ*¨6¯9©9°c·k±kÀ3Ç?Á?ÓS×S€FÜØ—‘Øôð ð Tús   ‚AA%ÁA#ÁA%z/subscription/upgradec              ƒ   óÐ   K  — |\  }}t        |«      }|j                  |j                  | j                  | j                  | j
                  «      ƒ d{  –—† }t        d|¬«      S 7 Œ­w)zEUpgrades subscription calculating prorated credit for remaining days.Nz*Upgrade order created with prorated creditr/   )r%   Úupgrade_subscriptionr9   Únew_plan_idÚproviderrL   r   rA   s          r5   rN   rN   t   sc   è ø€ ð �I€FˆAÜ˜RÓ €GØ×.Ñ.Ø�	‰	�3—?‘? C§L¡L°#·/±/ó÷ €Eô Ø<Øôð ðús   ‚AA&ÁA$ÁA&z/subscription/downgradec              ƒ   óº   K  — |\  }}t        |«      }|j                  |j                  | j                  | j                  «      ƒ d{  –—† }t        d|¬«      S 7 Œ­w)z@Downgrades subscription after validating active resource limits.Nz$Subscription downgraded successfullyr/   )r%   Údowngrade_subscriptionr9   rO   Ú	immediater   ©r>   r6   r-   r:   r;   r3   r<   s          r5   rR   rR   †   sW   è ø€ ð �I€FˆAÜ˜RÓ €GØ×.Ñ.¨v¯y©y¸#¿/¹/È3Ï=É=ÓY×
Y€CÜØ6Øôð ð Zús   ‚AAÁAÁAz/subscription/cancelc              ƒ   ó¤   K  — |\  }}t        |«      }|j                  |j                  | j                  «      ƒ d{  –—† }t	        d|¬«      S 7 Œ­w)zACancels subscription either immediately or at current period end.Nz$Subscription cancellation registeredr/   )r%   Úcancel_subscriptionr9   rS   r   rT   s          r5   rV   rV   –   sQ   è ø€ ð �I€FˆAÜ˜RÓ €GØ×+Ñ+¨F¯I©I°s·}±}ÓE×
E€CÜØ6Øôð ð Fús   ‚:A¼A½Az	/invoicesc              ƒ   óŽ   K  — | \  }}t        |«      }|j                  |j                  «      ƒ d{  –—† }t        d|¬«      S 7 Œ­w)z4Lists historical and active invoices for the tenant.NzInvoices retrievedr/   )r%   Úlist_invoicesr9   r   )r6   r-   r:   r;   r3   Úinvoicess         r5   rX   rX   ¦   sJ   è ø€ ð �I€FˆAÜ˜RÓ €GØ×*Ñ*¨6¯9©9Ó5×5€HÜØ$Øôð ð 6úr=   z/invoices/{invoice_id}Ú
invoice_idc              ƒ   ó�   K  — |\  }}t        |«      }|j                  |j                  | «      ƒ d{  –—† }t        d|¬«      S 7 Œ­w)z-Fetches details of a specific tenant invoice.NzInvoice detail retrievedr/   )r%   Úget_invoicer9   r   )rZ   r6   r-   r:   r;   r3   Úinvoices          r5   r\   r\   µ   sL   è ø€ ð �I€FˆAÜ˜RÓ €GØ×'Ñ'¨¯	©	°:Ó>×>€GÜØ*Øôð ð ?úrC   z/invoices/{invoice_id}/html)Úresponse_classr,   c              ƒ   óä   K  — |\  }}t        |«      }|j                  j                  | |j                  «      ƒ d{  –—† }|st	        dd¬«      ‚|j                  |«      }t        |d¬«      S 7 Œ1­w)z1Renders a print-ready, professional HTML invoice.Né”  zInvoice not found©r,   Údetailz	text/html)ÚcontentÚ
media_type)r%   ÚrepoÚget_invoice_by_idr9   r	   Úrender_invoice_htmlr   )rZ   r6   r-   r:   r;   r3   ÚinvÚhtml_contents           r5   rg   rg   Å   sl   è ø€ ð �I€FˆAÜ˜RÓ €GØ—‘×.Ñ.¨z¸6¿9¹9ÓE×
E€CÙÜ¨Ð4GÔHÐHØ×.Ñ.¨sÓ3€LÜ˜L°[ÔAÐAð	 Fús   ‚:A0¼A.½2A0z/refundsc              ƒ   ó�   K  — |\  }}t        |«      }|j                  |j                  | «      ƒ d{  –—† }t        d|¬«      S 7 Œ­w)z1Processes partial or full refund on a paid order.NzRefund processed successfullyr/   )r%   Úprocess_refundr9   r   )r>   r6   r-   r:   r;   r3   Úrefunds          r5   rk   rk   Õ   sL   è ø€ ð �I€FˆAÜ˜RÓ €GØ×)Ñ)¨&¯)©)°SÓ9×9€FÜØ/Øôð ð :úrC   z/walletc           	   ƒ   ó^  K  — | \  }}t        |«      }|j                  j                  |j                  «      ƒ d{  –—† }t	        dt        |j                  |j                  dk(  rd|j                  dz  d›�nd|j                  dz  d›�|j                  |j                  ¬«      ¬	«      S 7 Œo­w)
z1Retrieves tenant's prepaid credit wallet balance.NzWallet balance retrievedÚINRu   â‚¹éd   z.2fú$)ÚbalanceÚbalance_formattedÚcurrencyÚ	is_frozenr/   )	r%   ÚwalletsÚget_or_create_walletr9   r   r#   rq   rs   rt   )r6   r-   r:   r;   r3   Úwallets         r5   Úget_wallet_balancerx   å   s¨   è ø€ ð �I€FˆAÜ˜RÓ €GØ—?‘?×7Ñ7¸¿	¹	ÓB×B€FÜØ*ÜØ—N‘NØBHÇ/Á/ÐUZÒBZ  F§N¡N°SÑ$8¸Ð#=Ñ>ÐbcÐdj×drÑdrÐuxÑdxÐy|Ðc}Ð`~Ø—_‘_Ø×&Ñ&ô	
ôð ð Cús   ‚9B-»B+¼A0B-z/wallet/transactionsc           	   ƒ   óî   K  — | \  }}t        |«      }|j                  j                  |j                  «      ƒ d{  –—† }t	        d|D �cg c]  }t        j                  |«      ‘Œ c}¬«      S 7 Œ2c c}w ­w)z@Retrieves immutable ledger entries with cryptographic checksums.Nz$Wallet transactions ledger retrievedr/   )r%   ru   Úget_transactionsr9   r   r$   Úmodel_validate)r6   r-   r:   r;   r3   ÚtxsÚts          r5   Úget_wallet_transactionsr~   ù   sk   è ø€ ð �I€FˆAÜ˜RÓ €GØ—‘×0Ñ0°·±Ó;×
;€CÜØ6ØCFÖG¸aÔ'×6Ñ6°qÕ9ÒGôð ð <úò Hùs!   ‚9A5»A.¼A5Á
A0
Á&	A5Á0A5z/coupons/validatec              ƒ   ó*  K  — |\  }}t        |«      }|j                  j                  | j                  «      ƒ d{  –—† }|st	        dd¬«      ‚|j
                  j                  | j                  |j                  |j                  «      ƒ d{  –—† \  }}}	}
|rt        d|j                  |	z
  «      n|j                  }t        |
t        || j                  j                  «       |r|j                  nd|r|j                  nd|	||
¬«      ¬«      S 7 ŒÓ7 Œƒ­w)	z:Validates coupon code eligibility and calculates discount.Nr`   zPlan not foundra   r   Únone)Úis_validÚcodeÚdiscount_typeÚdiscount_valueÚdiscount_amountÚfinal_amountr0   r/   )r%   re   Úget_plan_by_idrK   r	   ÚcouponsÚvalidate_couponr‚   r9   Úprice_amountÚmaxr   r   Úupperrƒ   r„   )r>   r6   r-   r:   r;   r3   Úplanr�   ÚcouponÚdiscountr0   r†   s               r5   r‰   r‰     sù   è ø€ ð �I€FˆAÜ˜RÓ €GØ—‘×,Ñ,¨S¯[©[Ó9×9€DÙÜ¨Ð4DÔEÐEà07·±×0OÑ0OØ�‰�$—'‘'˜4×,Ñ,ó1÷ +Ñ'€Hˆf�h ñ <D”3�q˜$×+Ñ+¨hÑ6Ô7È×IZÑIZ€LäØÜ%ØØ—‘—‘Ó!Ù28˜&×.Ò.¸fÙ4:˜6×0Ò0ÀØ$Ø%Øô
ôð ð :øð+ús#   ‚9D»D¼ADÂDÂBDÄDz
/referralsc           	   ƒ   ó  K  — | \  }}t        |«      }|j                  j                  |j                  «      ƒ d{  –—† \  }}dt	        |j                  «      dd j                  «       › �}t        dt        |d|› �||¬«      ¬«      S 7 ŒM­w)z4Retrieves tenant's referral link and rewards earned.NzREF-é   zReferral stats retrievedz*https://dashboard.domain.com/register?ref=)Úreferral_codeÚreferral_linkÚtotal_referredÚtotal_rewarded_creditsr/   )r%   re   Úcount_tenant_referralsr9   ÚstrrŒ   r   r   )r6   r-   r:   r;   r3   Ú	total_refÚtotal_rewardsÚref_codes           r5   Úget_referrals_statsr›   (  s‘   è ø€ ð �I€FˆAÜ˜RÓ €GØ%,§\¡\×%HÑ%HÈÏÉÓ%S×SÑ€Iˆ}Ø”c˜&Ÿ)™)“n R aÐ(×.Ñ.Ó0Ð1Ð2€HÜØ*ÜØ"ØFÀxÀjÐQØ$Ø#0ô	
ôð ð  Tús   ‚9B»B	¼ABz/usagec              ƒ   ó´   K  — | \  }}t        |«      }|j                  j                  |j                  «      ƒ d{  –—† }t	        dt        di |¤Ž¬«      S 7 Œ­w)z1Returns active consumption vs entitlement limits.Nz-Tenant usage and entitlement limits retrievedr/   © )r%   ÚentitlementsÚget_tenant_limits_and_usager9   r   r    )r6   r-   r:   r;   r3   Úusages         r5   Úget_tenant_usage_and_limitsr¡   =  sY   è ø€ ð �I€FˆAÜ˜RÓ €GØ×&Ñ&×BÑBÀ6Ç9Á9ÓM×M€EÜØ?Ü Ñ) 5Ñ)ôð ð Nús   ‚9A»A¼A)IÚuuidÚtypingr   r   r   Úfastapir   r   r   r	   r
   r   r   Úsqlalchemy.ext.asyncior   Úapps.api.dependenciesr   r   Úshared.schemasr   Úinfrastructure.database.sessionr   Úmodules.billing.schemasr   r   r   r   r   r   r   r   r   r   r   r   r   r   r    r!   r"   r#   r$   Úmodules.billing.servicer%   Úmodules.identity.modelsr&   Úmodules.tenants.modelsr'   r(   ÚrouterÚgetÚlistÚHTTP_200_OKr2   Útupler8   ÚpostÚHTTP_201_CREATEDr@   rH   rJ   rN   rR   rV   rX   r\   rg   rk   rx   r~   r‰   r›   r¡   r�   ó    r5   ú<module>rµ      sú  ðÛ ß &Ý ß V× VÑ VÝ /ß FÝ &Ý 2÷÷ ÷ ÷ ÷ ñ õ* 3Ý (ß 7á	˜*Ð,JÐ+KÔ	L€ð ‡�ˆH [°°lÑ1CÑ%DÐRX×RdÑRd€Óeð	Ø�,¡¨£Ð/Ñ0ò	ó fð	ð ‡�ˆO¨KÐ8LÑ,MÐ[a×[mÑ[m€ÓnðØ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðà�,¡¨£Ð/Ñ0òó oðð ‡�ˆ[¨Ð5JÑ)KÐY_×YpÑYp€ÓqðØ	ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó rðð ‡�Ð°Ð<WÑ0XÐfl×fxÑfx€ÓyðØ	#ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó zðð$ ‡�ˆ]¨;Ð7RÑ+SÐag×asÑas€ÓtðØ	ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó uðð ‡�Ð$°[ÐAVÑ5WÐek×ewÑew€ÓxðØ	#ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó yðð" ‡�Ð&°{ÐCWÑ7XÐfl×fxÑfx€ÓyðØ	%ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó zðð ‡�Ð#°KÐ@TÑ4UÐci×cuÑcu€ÓvðØ	"ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó wðð ‡�ˆK¨°D¸Ñ4IÑ(JÐX^×XjÑXj€ÓkðØ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðà�,¡¨£Ð/Ñ0òó lðð ‡�Ð$°[ÀÑ5QÐ_e×_qÑ_q€ÓrðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó sðð ‡�Ð)¸(ÐPV×PbÑPb€ÓcðBØðBà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðBð 	�,¡¨£Ð/Ñ0òBó dðBð ‡�ˆZ¨°NÑ(CÐQW×QcÑQc€ÓdðØ	ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó eðð ‡�ˆI k°.Ñ&AÈv×OaÑOa€ÓbðØ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðà�,¡¨£Ð/Ñ0òó cðð& ‡�Ð"°;¸tÐD]Ñ?^Ñ3_Ðms×mÑm€ó  AðØ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðà�,¡¨£Ð/Ñ0òó Aðð ‡�Ð °Ð=UÑ1VÐdj×dvÑdv€ÓwðØ	ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó xðð> ‡�ˆL¨Ð5EÑ)FÐTZ×TfÑTf€ÓgðØ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðà�,¡¨£Ð/Ñ0òó hðð( ‡�ˆH [Ð1DÑ%EÐSY×SeÑSe€ÓfðØ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðà�,¡¨£Ð/Ñ0òó gñr´   