Ë
    Ú�þjyj  ã                   ó”  — d dl mZmZmZ d dlmZ d dlmZmZm	Z	m
Z
 d dlmZ d dlmZmZmZ d dlmZ d dlmZ d dlmZ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+m,Z, d d
l-m.Z. d dl/m0Z0 d dl1m2Z2  eddg¬«      Z3e3ji                  de2e5e      e
jl                  ¬«      dee7eedz  f    ee«      f   dee ee«      f   fd„«       Z8e3js                  de2e   e
jt                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   dee ee«      f   fd„«       Z;e3ji                  de2e   e
jl                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   fd„«       Z<e3j{                  de2e   e
jl                  ¬«      dededee7eedz  f    ee«      f   dee ee«      f   fd„«       Z>e3j                  de2d   e
jl                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   fd„«       Z@e3js                  de2e   e
jl                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   fd„«       ZAe3js                  d e2e   e
jl                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   fd!„«       ZBe3ji                  d"e2e5e      e
jl                  ¬«       e	d#d$d%¬&«       e	d d ¬'«      fdedee7eedz  f    ee«      f   dee ee«      f   d(eCd)eCf
d*„«       ZDe3ji                  d+e2e5e$      e
jl                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   fd,„«       ZEe3js                  d-e2eFeGef      e
jt                  ¬«      ded.eGde!dee7eedz  f    ee«      f   dee ee«      f   f
d/„«       ZHe3js                  d0e2eFeGef      e
jl                  ¬«      ded.eGdedee7eedz  f    ee«      f   dee ee«      f   f
d1„«       ZIe3j{                  d2e2eFeGef      e
jl                  ¬«      ded.eGde dee7eedz  f    ee«      f   dee ee«      f   f
d3„«       ZJe3j                  d4e2d   e
jl                  ¬«      ded.eGdee7eedz  f    ee«      f   dee ee«      f   fd5„«       ZKe3js                  d6e2eFeGef      e
jl                  ¬«      dede"dee7eedz  f    ee«      f   dee ee«      f   fd7„«       ZLe3js                  d8e2eFeGef      e
jl                  ¬«      ded.eGde#dee7eedz  f    ee«      f   dee ee«      f   f
d9„«       ZMe3j{                  d:e2eFeGef      e
jl                  ¬«      ded.eGdedee7eedz  f    ee«      f   dee ee«      f   f
d;„«       ZNe3js                  d<e2e'   e
jt                  ¬«      dede%dee7eedz  f    ee«      f   dee ee«      f   fd=„«       ZOe3ji                  d<e2e5e'      e
jl                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   fd>„«       ZPe3ji                  d?e2e'   e
jl                  ¬«      ded@edee7eedz  f    ee«      f   dee ee«      f   fdA„«       ZQe3j{                  d?e2e'   e
jl                  ¬«      ded@ede&dee7eedz  f    ee«      f   dee ee«      f   f
dB„«       ZRe3j                  d?e2d   e
jl                  ¬«      ded@edee7eedz  f    ee«      f   dee ee«      f   fdC„«       ZSe3ji                  dDe2e5e(      e
jl                  ¬«      ded@edee7eedz  f    ee«      f   dee ee«      f   fdE„«       ZTe3ji                  dFe2e5e*      e
jl                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   fdG„«       ZUe3js                  dFe2e*   e
jt                  ¬«      dede)dee7eedz  f    ee«      f   dee ee«      f   fdH„«       ZVe3ji                  dIe2e5e,      e
jl                  ¬«      dedee7eedz  f    ee«      f   dee ee«      f   fdJ„«       ZWe3js                  dKe2eFeGef      e
jl                  ¬«      dedLede+dee7eedz  f    ee«      f   dee ee«      f   f
dM„«       ZXy)Né    )Ú	AnnotatedÚAnyÚOptional)ÚUUID)Ú	APIRouterÚDependsÚQueryÚstatus)ÚAsyncSession)Úget_current_userÚget_current_tenantÚrequire_permission)Úget_db)ÚUser)ÚTenantÚTenantMember)ÚBotRegisterRequestÚBotUpdateRequestÚBotResponseÚBotDetailResponseÚBotUserResponseÚToggleModuleRequestÚToggleModuleTriggerRequestÚUpdateModuleConfigRequestÚInstallModuleRequestÚVerifyAdminRequestÚVerifyModuleRequestÚBotModuleResponseÚCreateRedeemCodeRequestÚUpdateRedeemCodeRequestÚRedeemCodeResponseÚRedeemLogResponseÚCreateBotFileRequestÚBotFileResponseÚReplySupportTicketRequestÚBotSupportTicketResponse)Ú
BotService)ÚBotModuleService)ÚApiResponsez/botszTelegram Bots Management)ÚprefixÚtagsÚ )Úresponse_modelÚstatus_codeÚtenant_contextNÚdbc              ƒ   ó�   K  — | \  }}t        |«      }|j                  |j                  ¬«      ƒ d {  –—† }t        d|¬«      S 7 Œ­w)N©Ú	tenant_idz"Tenant bots retrieved successfully©ÚmessageÚdata)r'   Ú	list_botsÚidr)   )r/   r0   ÚtenantÚ_ÚserviceÚbotss         ú+/root/telegram-saas/apps/api/routes/bots.pyÚlist_tenant_botsr>   &   sL   è ø€ ð
 �I€FˆAÜ˜‹n€GØ×"Ñ"¨V¯Y©YÐ"Ó7×7€DÜØ4Øôð ð 8ús   ‚0A²A³AÚreqÚcurrent_userc              ƒ   ó¤  K  — |\  }}t        |«      }|j                  |j                  | ¬«      ƒ d {  –—† }|j                  j	                  |j                  «      ƒ d {  –—† }t        d|j                  › d�t        |j                  |j                  |j                  |j                  |j                  |j                  |j                  r|j                  j                  nd |j                  r|j                  j                  nd|j                  r|j                  j                   ni ||j"                  |j$                  ¬«      ¬«      S 7 �Œ7 Œí­w)N)r3   r?   zBot @z registered successfullyF©r8   r3   ÚnameÚusernamer
   Údefault_localeÚwebhook_urlÚwebhook_activeÚsettingsÚtotal_usersÚ
created_atÚ
updated_atr4   )r'   Úregister_botr8   ÚrepoÚcount_bot_usersr)   rD   r   r3   rC   r
   rE   ÚwebhookrF   Ú	is_activerH   Úsettings_jsonrJ   rK   )	r?   r/   r@   r0   r9   r:   r;   ÚbotÚ
user_counts	            r=   rL   rL   4   sý   è ø€ ð �I€FˆAÜ˜‹n€GØ×$Ñ$¨v¯y©y¸cÐ$ÓB×
B€Cà—|‘|×3Ñ3°C·F±FÓ;×;€JÜØ˜Ÿ™�~Ð%=Ð>ÜØ�v‰vØ—m‘mØ—‘Ø—\‘\Ø—:‘:Ø×-Ñ-Ø36·;²;˜Ÿ™×/Ò/ÀDØ47·K²K˜3Ÿ;™;×0Ò0ÀUØ36·<²<�S—\‘\×/Ò/ÀRØ"Ø—~‘~Ø—~‘~ô
ôð ð Cùà;ús"   ‚1E³E´,EÁ EÁ!C+EÅEz	/{bot_id}Úbot_idc              ƒ   óˆ  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d {  –—† }|j                  j	                  |j                  «      ƒ d {  –—† }t        dt        |j                  |j                  |j                  |j                  |j                  |j                  |j                  r|j                  j                  nd |j                  r|j                  j                  nd|j                  r|j                  j                   ni ||j"                  |j$                  ¬«      ¬«      S 7 �Œ
7 Œß­w)Nr2   z"Bot details retrieved successfullyFrB   r4   )r'   Úget_botr8   rM   rN   r)   r   r3   rC   rD   r
   rE   rO   rF   rP   rH   rQ   rJ   rK   ©rT   r/   r0   r9   r:   r;   rR   rS   s           r=   Úget_bot_detailsrX   S   së   è ø€ ð �I€FˆAÜ˜‹n€GØ—‘ °&·)±)�Ó<×
<€CØ—|‘|×3Ñ3°C·F±FÓ;×;€JäØ4ÜØ�v‰vØ—m‘mØ—‘Ø—\‘\Ø—:‘:Ø×-Ñ-Ø36·;²;˜Ÿ™×/Ò/ÀDØ47·K²K˜3Ÿ;™;×0Ò0ÀUØ36·<²<�S—\‘\×/Ò/ÀRØ"Ø—~‘~Ø—~‘~ô
ôð ð =ùØ;ús"   ‚1E³D=´,EÁ E Á!CEÅ Ec              ƒ   óŠ  K  — |\  }}t        |«      }|j                  | |j                  |¬«      ƒ d {  –—† }|j                  j	                  |j                  «      ƒ d {  –—† }t        dt        |j                  |j                  |j                  |j                  |j                  |j                  |j                  r|j                  j                  nd |j                  r|j                  j                  nd|j                  r|j                  j                   ni ||j"                  |j$                  ¬«      ¬«      S 7 �Œ
7 Œß­w)N)rT   r3   r?   zBot updated successfullyFrB   r4   )r'   Ú
update_botr8   rM   rN   r)   r   r3   rC   rD   r
   rE   rO   rF   rP   rH   rQ   rJ   rK   )	rT   r?   r/   r0   r9   r:   r;   rR   rS   s	            r=   rZ   rZ   q   sñ   è ø€ ð �I€FˆAÜ˜‹n€GØ×"Ñ"¨&¸F¿I¹IÈ3Ð"ÓO×
O€CØ—|‘|×3Ñ3°C·F±FÓ;×;€JäØ*ÜØ�v‰vØ—m‘mØ—‘Ø—\‘\Ø—:‘:Ø×-Ñ-Ø36·;²;˜Ÿ™×/Ò/ÀDØ47·K²K˜3Ÿ;™;×0Ò0ÀUØ36·<²<�S—\‘\×/Ò/ÀRØ"Ø—~‘~Ø—~‘~ô
ôð ð PùØ;ús"   ‚2E´D>µ,EÁ!EÁ"CEÅEc              ƒ   ó’   K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d {  –—†  t        dd ¬«      S 7 Œ­w)N©rT   r3   zBot deleted successfullyr4   )r'   Ú
delete_botr8   r)   )rT   r/   r0   r9   r:   r;   s         r=   r]   r]   �   sP   è ø€ ð �I€FˆAÜ˜‹n€GØ
×
Ñ
 F°f·i±iÐ
Ó
@×@Ð@ÜØ*Øôð ð Aús   ‚1A³A´Az/{bot_id}/activatec              ƒ   ó@  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d {  –—† }|j                  j	                  |j                  «      ƒ d {  –—† }t        dt        |j                  |j                  |j                  |j                  |j                  |j                  |j                  r|j                  j                  nd |j                  r|j                  j                  nd||j                  |j                   ¬«      ¬«      S 7 Œæ7 Œ»­w)Nr\   zBot activated successfullyF©r8   r3   rC   rD   r
   rE   rF   rG   rI   rJ   rK   r4   )r'   Úactivate_botr8   rM   rN   r)   r   r3   rC   rD   r
   rE   rO   rF   rP   rJ   rK   rW   s           r=   r`   r`   Ÿ   sÚ   è ø€ ð �I€FˆAÜ˜‹n€GØ×$Ñ$¨F¸f¿i¹iÐ$ÓH×
H€CØ—|‘|×3Ñ3°C·F±FÓ;×;€JäØ,ÜØ�v‰vØ—m‘mØ—‘Ø—\‘\Ø—:‘:Ø×-Ñ-Ø36·;²;˜Ÿ™×/Ò/ÀDØ47·K²K˜3Ÿ;™;×0Ò0ÀUØ"Ø—~‘~Ø—~‘~ô
ôð ð IøØ;úó"   ‚1D³D´,DÁ DÁ!B:DÄDz/{bot_id}/deactivatec              ƒ   ó@  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d {  –—† }|j                  j	                  |j                  «      ƒ d {  –—† }t        dt        |j                  |j                  |j                  |j                  |j                  |j                  |j                  r|j                  j                  nd |j                  r|j                  j                  nd||j                  |j                   ¬«      ¬«      S 7 Œæ7 Œ»­w)Nr\   zBot deactivated successfullyFr_   r4   )r'   Údeactivate_botr8   rM   rN   r)   r   r3   rC   rD   r
   rE   rO   rF   rP   rJ   rK   rW   s           r=   rc   rc   ¼   sÚ   è ø€ ð �I€FˆAÜ˜‹n€GØ×&Ñ&¨fÀÇ	Á	Ð&ÓJ×
J€CØ—|‘|×3Ñ3°C·F±FÓ;×;€JäØ.ÜØ�v‰vØ—m‘mØ—‘Ø—\‘\Ø—:‘:Ø×-Ñ-Ø36·;²;˜Ÿ™×/Ò/ÀDØ47·K²K˜3Ÿ;™;×0Ò0ÀUØ"Ø—~‘~Ø—~‘~ô
ôð ð KøØ;úra   z/{bot_id}/userséd   é   iô  )ÚdefaultÚgeÚle)rf   rg   ÚlimitÚoffsetc           	   ƒ   ó.  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d {  –—†  |j                  j	                  | ||¬«      ƒ d {  –—† }t        d|D �	cg c]  }	t        j                  |	«      ‘Œ c}	¬«      S 7 ŒX7 Œ4c c}	w ­w)Nr2   )ri   rj   z Bot users retrieved successfullyr4   )r'   rV   r8   rM   Úget_bot_usersr)   r   Úmodel_validate)
rT   r/   r0   ri   rj   r9   r:   r;   ÚusersÚus
             r=   Úlist_bot_usersrp   Ù   sŠ   è ø€ ð �I€FˆAÜ˜‹n€Gà
�/‰/˜&¨F¯I©Iˆ/Ó
6×6Ð6à—,‘,×,Ñ,¨V¸5ÈÐ,ÓP×P€EÜØ2Ø9>Ö?°AŒo×,Ñ,¨QÕ/Ò?ôð ð 7øàPúò @ùs3   ‚1B³B´%BÁBÁBÁ(B
Â	BÂBÂBz/{bot_id}/modulesc              ƒ   ó  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | «      ƒ d{  –—† }t        d|D �cg c]  }t        di |¤Ž‘Œ c}¬«      S 7 ŒL7 Œ*c c}w ­w)zRLists all available modules and their activation/configuration state for this bot.r2   Nz"Bot modules retrieved successfullyr4   © )r'   rV   r8   r(   Úlist_bot_modulesr)   r   )	rT   r/   r0   r9   r:   Úbot_serviceÚmod_serviceÚmodulesÚms	            r=   rs   rs   ñ   s‹   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ×0Ñ0°Ó8×8€GÜØ4Ø.5Ö6¨ÔÑ$ !Ó$Ò6ôð ð	 ;øð 9úò 7ùs3   ‚1B	³B ´#B	ÁBÁB	Á&B
Á8	B	ÂB	ÂB	z%/{bot_id}/modules/{module_id}/installÚ	module_idc              ƒ   óD  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | ||j
                  ¬«      ƒ d{  –—† }	t        d|› d�|	j                  |	j                  |	j
                  dœ¬«      S 7 Œh7 Œ9­w)zFInstalls and activates a feature module on the specified Telegram Bot.r2   N©ÚconfigúModule 'z ' installed and activated on bot)rx   Ú
is_enabledr{   r4   )	r'   rV   r8   r(   Úinstall_moduler{   r)   rx   r}   ©
rT   rx   r?   r/   r0   r9   r:   rt   ru   Úmods
             r=   Úinstall_bot_moduler�     sž   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ×*Ñ*¨6°9ÀSÇZÁZÐ*ÓP×
P€CÜØ˜9˜+Ð%EÐFØŸ=™=¸¿¹ÐRU×R\ÑR\Ñ]ôð ð	 ;øð Qús!   ‚1B ³B´0B Á$BÁ%8B ÂB z$/{bot_id}/modules/{module_id}/togglec              ƒ   ób  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  |j                  | «      ƒ d{  –—† }t	        |«      }	d}
|j
                  r|	j                  | ||¬«      ƒ d{  –—† }
|	j                  | ||j
                  ¬«      ƒ d{  –—† }|j
                  rdnd}d|› d|› d	�}|
r;|
j                  d
«      s*d|› d|
j                  d«      xs |
j                  d«      › �}t        ||j                  |j
                  |
dœ¬«      S 7 Œó7 ŒÜ7 Œ©7 Œ…­w)zÄ
    Activates or deactivates a module on the bot.
    Directly controls backend execution of the module's triggers and commands.
    Automatically runs pre-flight verification on activation.
    r2   N)rT   Ú	raw_tokenrx   )r}   Ú	activatedÚdeactivatedr|   z' z successfullyÚokz%' activated with verification alert: ÚerrorÚwarning)rx   r}   Úverificationr4   )r'   rV   r8   Úget_raw_tokenr(   r}   Úverify_moduleÚtoggle_moduleÚgetr)   rx   )rT   rx   r?   r/   r0   r9   r:   rt   rƒ   ru   Úverification_resr€   Ú
status_strÚmsgs                 r=   Útoggle_bot_moduler‘     sY  è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:Ø!×/Ñ/°Ó7×7€Iä" 2Ó&€KØÐØ
‡~‚~Ø!,×!:Ñ!:ØØØð ";ó "
÷ 
Ðð ×)Ñ)¨&°)ÈÏÉÐ)ÓW×
W€CØ #§¢‘°M€Jà�Y�K˜r * ¨]Ð
;€CÙÐ 0× 4Ñ 4°TÔ :Ø˜˜Ð#HÐIY×I]ÑI]Ð^eÓIfò  JJÐjz×j~Ñj~ð  @Ió  kJð  IKð  LˆäØàŸ™ØŸ.™.Ø,ñ
ôð ð' ;øØ7øð

øð XúsF   ‚1D/³D'´D/ÁD)Á4D/ÂD+Â%D/Â'D-Â(B D/Ä)D/Ä+D/Ä-D/z$/{bot_id}/modules/{module_id}/configc              ƒ   ó¸  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  |j                  | «      ƒ d{  –—† }t	        |«      }	|	j                  | ||j                  ¬«      ƒ d{  –—† }
|	j                  | |||
j                  ¬«      ƒ d{  –—† }t        d|› d�|
j                  |
j                  |dœ¬«      S 7 Œž7 Œ‡7 ŒX7 Œ3­w)	zSUpdates configuration parameters for an installed bot module and verifies settings.r2   Nrz   )rT   rƒ   rx   r{   zConfiguration for module 'z' saved successfully)rx   r{   r‰   r4   )
r'   rV   r8   rŠ   r(   Úupdate_module_configr{   r‹   r)   rx   )rT   rx   r?   r/   r0   r9   r:   rt   rƒ   ru   r€   rŽ   s               r=   Úupdate_bot_module_configr”   E  sç   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:Ø!×/Ñ/°Ó7×7€Iä" 2Ó&€KØ×0Ñ0°¸È3Ï:É:Ð0ÓV×
V€Cð )×6Ñ6ØØØØ�z‰zð	 7ó ÷ Ðô Ø,¨Y¨KÐ7KÐLàŸ™Ø—j‘jØ,ñ
ôð ð ;øØ7øð WøðúsE   ‚1C³C´CÁCÁ0CÁ=CÁ>&CÂ$CÂ%.CÃCÃCÃCz/{bot_id}/modules/{module_id}c              ƒ   óè   K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | |«      ƒ d{  –—†  t        d|› d�d¬«      S 7 Œ:7 Œ­w)z)Uninstalls a feature module from the bot.r2   Nr|   z' uninstalled successfullyr4   )r'   rV   r8   r(   Úuninstall_moduler)   )rT   rx   r/   r0   r9   r:   rt   ru   s           r=   Úuninstall_bot_moduler—   h  s   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ
×
&Ñ
& v¨yÓ
9×9Ð9ÜØ˜9˜+Ð%?Ð@Øôð ð	 ;øð :ús!   ‚1A2³A.´$A2ÁA0ÁA2Á0A2z/{bot_id}/modules/verify-adminc              ƒ   ór  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  |j                  | «      ƒ d{  –—† }t	        |«      }|j                  | ||j                  d|j                  xs d¬«      ƒ d{  –—† }	|	j                  dd«      }
t        |
|	¬«      S 7 Œ}7 Œf7 Œ'­w)	z¨
    Verifies if the bot is added as an Administrator with required rights in a Channel or Group.
    Required by Force Join Guard and Logs & Forum Topics modules.
    r2   NTF)rT   rƒ   Úchat_idÚcheck_topicsÚ
test_topicr5   z"Admin verification check completedr4   )
r'   rV   r8   rŠ   r(   Úverify_bot_adminr™   r›   r�   r)   )rT   r?   r/   r0   r9   r:   rt   rƒ   ru   Úresultr�   s              r=   Úverify_bot_channel_adminrž   |  s¿   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:Ø!×/Ñ/°Ó7×7€Iä" 2Ó&€KØ×/Ñ/ØØØ—‘ØØ—>‘>Ò* Uð 0ó ÷ €Fð �*‰*�YÐ DÓ
E€CÜØØôð ð ;øØ7øðús4   ‚1B7³B1´B7ÁB3ÁA B7ÂB5Â$B7Â3B7Â5B7z$/{bot_id}/modules/{module_id}/verifyc              ƒ   ó  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  |j                  | «      ƒ d{  –—† }t	        |«      }	|j
                  }
|j                  rE|
€|	j                  | |«      ƒ d{  –—† }
|dk(  r|j                  |
d<   n|dk(  r|j                  |
d<   |	j                  | |||
|j                  xs d¬«      ƒ d{  –—† }t        |j                  d	d
«      |¬«      S 7 ŒÎ7 Œ·7 Œz7 Œ'­w)zÒ
    Performs comprehensive pre-flight verification on any bot module.
    For logs_tracker and force_join, checks Telegram API bot administrator rights,
    Telegram Forum Topics support, and permissions.
    r2   NÚlogs_trackerÚlog_channel_idÚ
force_joinÚchannel_usernameF)rT   rƒ   rx   r{   r›   r5   zModule verification completedr4   )r'   rV   r8   rŠ   r(   r{   r™   Úget_module_configr‹   r›   r)   r�   )rT   rx   r?   r/   r0   r9   r:   rt   rƒ   ru   r{   r�   s               r=   Úverify_bot_moduler¥   œ  s  è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:Ø!×/Ñ/°Ó7×7€Iä" 2Ó&€KØ�Z‰Z€FØ
‡{‚{Øˆ>Ø&×8Ñ8¸ÀÓK×KˆFØ˜Ò&Ø'*§{¡{ˆFÐ#Ò$Ø˜,Ò&Ø),¯©ˆFÐ%Ñ&à×,Ñ,ØØØØØ—>‘>Ò* Uð -ó ÷ €Fô Ø—
‘
˜9Ð&EÓFØôð ð) ;øØ7øð LøðúsF   ‚1D
³D´D
ÁDÁ>D
ÂDÂAD
Ã DÃ!"D
ÄD
ÄD
ÄD
z&/{bot_id}/modules/{module_id}/triggersc              ƒ   ó†  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | ||j
                  |j                  |j                  ¬«      ƒ d{  –—† }	t        d|› d�|	j                  |	j
                  |	j                  |	j                  dœ¬«      S 7 Œ‰7 ŒD­w)zÅ
    Independently controls the 3 interaction triggers for any module:
    1. Command execution (/command)
    2. Callback / inline keyboard button
    3. Persistent reply keyboard menu button
    r2   N)rT   rx   Úenable_commandÚenable_inline_buttonÚenable_menu_buttonzTrigger settings for 'z' updated successfully)rx   r§   r¨   r©   r4   )
r'   rV   r8   r(   Útoggle_module_triggersr§   r¨   r©   r)   rx   r   s
             r=   Úupdate_module_triggersr«   É  sÊ   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ×2Ñ2ØØØ×)Ñ)Ø ×5Ñ5Ø×1Ñ1ð 3ó ÷ €Cô Ø(¨¨Ð3IÐJàŸ™Ø!×0Ñ0Ø$'×$<Ñ$<Ø"%×"8Ñ"8ñ	
ôð ð ;øðús#   ‚1C³B=´ACÁ:B?Á;ACÂ?Cz/{bot_id}/redeem-codesc           
   ƒ   ó¼  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | |j
                  |j                  |j                  |j                  |j                  |j                  |j                  ¬«      ƒ d{  –—† }t        d|j
                  › d�t        j                  |«      ¬«      S 7 Œ¤7 Œ4­w)zGGenerates a promotional gift voucher / redeem code for bot subscribers.r2   N)rT   ÚcodeÚtitleÚreward_typeÚreward_valueÚmax_usesÚ
expires_atrP   zRedeem code 'z' generated successfullyr4   )r'   rV   r8   r(   Úcreate_redeem_coder­   r®   r¯   r°   r±   r²   rP   r)   r!   rm   )	rT   r?   r/   r0   r9   r:   rt   ru   Úcode_objs	            r=   Úcreate_bot_redeem_coderµ   ó  sÊ   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ ×3Ñ3ØØ�X‰XØ�i‰iØ—O‘OØ×%Ñ%Ø—‘Ø—>‘>Ø—-‘-ð 4ó 	÷ 	€Hô Ø §¡˜Ð.FÐGÜ×.Ñ.¨xÓ8ôð ð ;øð	ús"   ‚1C³C´A1CÂ%CÂ&3CÃCc           	   ƒ   ó*  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | «      ƒ d{  –—† }t        d|D �cg c]  }t        j                  |«      ‘Œ c}¬«      S 7 ŒV7 Œ4c c}w ­w)zBLists all active and expired redeem codes configured for this bot.r2   Nz#Redeem codes retrieved successfullyr4   )r'   rV   r8   r(   Úlist_redeem_codesr)   r!   rm   )	rT   r/   r0   r9   r:   rt   ru   ÚcodesÚcs	            r=   Úlist_bot_redeem_codesrº     s�   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ×/Ñ/°Ó7×7€EÜØ5Ø<AÖB°qÔ ×/Ñ/°Õ2ÒBôð ð	 ;øð 8úò Cùó3   ‚1B³B
´#BÁBÁBÁ&B
Â	BÂBÂBz /{bot_id}/redeem-codes/{code_id}Úcode_idc              ƒ   ó@  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | |«      ƒ d{  –—† }|st        t        j                  d¬«      ‚t        dt        j                  |«      ¬«      S 7 Œf7 ŒC­w)z2Retrieves full details for a specific redeem code.r2   NzRedeem code not found)r.   Údetailz"Redeem code retrieved successfullyr4   )r'   rV   r8   r(   Úget_redeem_codeÚHTTPExceptionr
   ÚHTTP_404_NOT_FOUNDr)   r!   rm   )	rT   r¼   r/   r0   r9   r:   rt   ru   r´   s	            r=   Úget_bot_redeem_coderÂ   #  s—   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ ×0Ñ0°¸ÓA×A€HÙÜ¬×(AÑ(AÐJaÔbÐbäØ4Ü×.Ñ.¨xÓ8ôð ð ;øð Bús"   ‚1B³B´$BÁBÁABÂBc              ƒ   ó(  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | ||j                  d¬«      «      ƒ d{  –—† }	t        dt        j                  |	«      ¬«      S 7 ŒZ7 Œ&­w)zGUpdates active state, max uses, expiry date, or title of a redeem code.r2   NT)Úexclude_unsetz Redeem code updated successfullyr4   )	r'   rV   r8   r(   Úupdate_redeem_codeÚ
model_dumpr)   r!   rm   )
rT   r¼   r?   r/   r0   r9   r:   rt   ru   Úupdateds
             r=   Úupdate_bot_redeem_coderÈ   :  sŽ   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ×2Ñ2°6¸7ÀCÇNÁNÐaeÀNÓDfÓg×g€GÜØ2Ü×.Ñ.¨wÓ7ôð ð	 ;øð hús!   ‚1B³B´5BÁ)BÁ*%BÂBc              ƒ   óà   K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | |«      ƒ d{  –—†  t        dd¬«      S 7 Œ67 Œ­w)z9Deletes a redeem code and its associated redemption logs.r2   Nz Redeem code deleted successfullyr4   )r'   rV   r8   r(   Údelete_redeem_coder)   )rT   r¼   r/   r0   r9   r:   rt   ru   s           r=   Údelete_bot_redeem_coderË   O  su   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ
×
(Ñ
(¨°Ó
9×9Ð9ÜØ2Øôð ð	 ;øð :ús!   ‚1A.³A*´$A.ÁA,ÁA.Á,A.z%/{bot_id}/redeem-codes/{code_id}/logsc           	   ƒ   ó,  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | |«      ƒ d{  –—† }t        d|D �	cg c]  }	t        j                  |	«      ‘Œ c}	¬«      S 7 ŒW7 Œ4c c}	w ­w)z8Lists all subscribers who claimed this promotional code.r2   Nz,Redemption audit logs retrieved successfullyr4   )r'   rV   r8   r(   Úlist_redeem_logsr)   r"   rm   )
rT   r¼   r/   r0   r9   r:   rt   ru   ÚlogsÚls
             r=   Úlist_code_redemption_logsrÐ   c  s‘   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ×-Ñ-¨f°gÓ>×>€DÜØ>Ø;?Ö@°aÔ×.Ñ.¨qÕ1Ò@ôð ð	 ;øð ?úò Aùs3   ‚1B³B´$BÁBÁBÁ'B
Â	BÂBÂBz/{bot_id}/filesc           	   ƒ   ó*  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | «      ƒ d{  –—† }t        d|D �cg c]  }t        j                  |«      ‘Œ c}¬«      S 7 ŒV7 Œ4c c}w ­w)z0Lists all files in the bot's digital file store.r2   Nz.Bot digital store files retrieved successfullyr4   )r'   rV   r8   r(   Úlist_bot_filesr)   r$   rm   )	rT   r/   r0   r9   r:   rt   ru   ÚfilesÚfs	            r=   rÒ   rÒ   w  sŽ   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ×,Ñ,¨VÓ4×4€EÜØ@Ø9>Ö?°AŒo×,Ñ,¨QÕ/Ò?ôð ð	 ;øð 5úò @ùr»   c           
   ƒ   ó   K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | |j
                  |j                  |j                  |j                  |j                  |j                  |j                  ¬«      ƒ d{  –—† }t        dt        j                  |«      ¬«      S 7 Œ–7 Œ&­w)z8Registers a new file/document in the digital file store.r2   N)rT   Úfile_idÚ	file_nameÚ	file_typeÚ	file_sizeÚaccess_typeÚcostÚunlock_codez*Digital store file registered successfullyr4   )r'   rV   r8   r(   Úcreate_bot_filerÖ   r×   rØ   rÙ   rÚ   rÛ   rÜ   r)   r$   rm   )	rT   r?   r/   r0   r9   r:   rt   ru   Úbot_files	            r=   rÝ   rÝ   Š  sº   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ ×0Ñ0ØØ—‘Ø—-‘-Ø—-‘-Ø—-‘-Ø—O‘OØ�X‰XØ—O‘Oð 1ó 	÷ 	€Hô Ø<Ü×+Ñ+¨HÓ5ôð ð ;øð	ús"   ‚1C³C
´A1CÂ%CÂ&%CÃCz/{bot_id}/support-ticketsc           	   ƒ   ó*  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  t        |«      }|j	                  | «      ƒ d{  –—† }t        d|D �cg c]  }t        j                  |«      ‘Œ c}¬«      S 7 ŒV7 Œ4c c}w ­w)z0Lists all customer support tickets for this bot.r2   Nz&Support tickets retrieved successfullyr4   )r'   rV   r8   r(   Úlist_support_ticketsr)   r&   rm   )	rT   r/   r0   r9   r:   rt   ru   ÚticketsÚts	            r=   Úlist_bot_support_ticketsrã   §  s�   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:ä" 2Ó&€KØ×4Ñ4°VÓ<×<€GÜØ8ØBIÖJ¸QÔ&×5Ñ5°aÕ8ÒJôð ð	 ;øð =úò Kùr»   z+/{bot_id}/support-tickets/{ticket_id}/replyÚ	ticket_idc              ƒ   ó0  K  — |\  }}t        |«      }|j                  | |j                  ¬«      ƒ d{  –—†  |j                  | «      ƒ d{  –—† }t	        |«      }	|	j                  | ||j                  |¬«      ƒ d{  –—† }
t        d|
¬«      S 7 Œ\7 ŒE7 Œ­w)zDSends an administrative support reply to the subscriber on Telegram.r2   N)rT   rä   Ú
reply_textrƒ   z.Support ticket reply sent to user successfullyr4   )r'   rV   r8   rŠ   r(   Úreply_support_ticketræ   r)   )rT   rä   r?   r/   r0   r9   r:   rt   rƒ   ru   Úress              r=   Úreply_bot_support_ticketré   º  s¢   è ø€ ð �I€FˆAÜ˜R“.€KØ
×
Ñ
˜f°·	±	Ð
Ó
:×:Ð:Ø!×/Ñ/°Ó7×7€Iä" 2Ó&€KØ×0Ñ0ØØØ—>‘>Øð	 1ó ÷ €Cô Ø@Øôð ð ;øØ7øðús3   ‚1B³B´BÁBÁ1BÁ>BÁ?BÂBÂB)YÚtypingr   r   r   Úuuidr   Úfastapir   r   r	   r
   Úsqlalchemy.ext.asyncior   Úapps.api.dependenciesr   r   r   Úinfrastructure.database.sessionr   Úmodules.identity.modelsr   Úmodules.tenants.modelsr   r   Úmodules.bots.schemasr   r   r   r   r   r   r   r   r   r   r   r   r   r    r!   r"   r#   r$   r%   r&   Úmodules.bots.servicer'   Úmodules.bots.modular_enginer(   Úshared.schemasr)   Úrouterr�   ÚlistÚHTTP_200_OKÚtupler>   ÚpostÚHTTP_201_CREATEDrL   rX   ÚpatchrZ   Údeleter]   r`   rc   Úintrp   rs   ÚdictÚstrr�   r‘   r”   r—   rž   r¥   r«   rµ   rº   rÂ   rÈ   rË   rÐ   rÒ   rÝ   rã   ré   rr   ó    r=   ú<module>r     s{  ðß +Ñ +Ý ß 5Ó 5Ý /ß ZÑ ZÝ 2Ý (ß 7÷÷ ÷ ÷ ÷ ó õ, ,Ý 8Ý &á	˜'Ð)CÐ(DÔ	E€ð ‡�ˆB˜{¨4°Ñ+<Ñ=È6×K]ÑK]€Ó^ð
Ø˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ð
à�,¡¨£Ð/Ñ0ò
ó _ð
ð ‡�ˆR Ð,=Ñ >ÈF×LcÑLc€ÓdðØ	ðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð ˜D¡'Ð*:Ó";Ð;Ñ<ðð 	�,¡¨£Ð/Ñ0ò	ó eðð< ‡�ˆK¨Ð4EÑ(FÐTZ×TfÑTf€ÓgðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó hðð: ‡�ˆk¨+Ð6GÑ*HÐV\×VhÑVh€ÓiðØðà	ðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ò	ó jðð< ‡�ˆ{¨;°tÑ+<È&×J\ÑJ\€Ó]ðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó ^ðð ‡�Ð!°+¸kÑ2JÐX^×XjÑXj€ÓkðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó lðð8 ‡�Ð#°KÀÑ4LÐZ`×ZlÑZl€ÓmðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó nðð8 ‡�Ð¨k¸$¸Ñ:OÑ.PÐ^d×^pÑ^p€Óqñ
 ˜s q¨SÔ1Ù  aÔ(ñØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ðð ð	ð
 òó rðð. ‡�Ð°¸DÐARÑ<SÑ0TÐbh×btÑbt€ÓuðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó vðð$ ‡�Ð4À[ÐQUÐVYÐ[^ÐV^ÑQ_ÑE`Ðnt÷  oFñ  oF€ó  GðØðàðð 
ðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ð	ð
 	�,¡¨£Ð/Ñ0òó Gðð( ‡�Ð3ÀKÐPTÐUXÐZ]ÐU]ÑP^ÑD_Ðms×mÑm€ó  Að(Øð(àð(ð 
ð(ð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ð	(ð
 	�,¡¨£Ð/Ñ0ò(ó Að(ðV ‡�Ð4À[ÐQUÐVYÐ[^ÐV^ÑQ_ÑE`Ðnt÷  oAñ  oA€ó  BðØðàðð 
#ðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ð	ð
 	�,¡¨£Ð/Ñ0òó BððD ‡�Ð.¸{È4Ñ?PÐ^d×^pÑ^p€ÓqðØðàðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ò	ó rðð& ‡�Ð-¸kÈ$ÈsÐTWÈxÉ.Ñ>YÐgm×gyÑgy€ÓzðØðà	ðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ò	ó {ðð> ‡�Ð3ÀKÐPTÐUXÐZ]ÐU]ÑP^ÑD_Ðms×mÑm€ó  Að%Øð%àð%ð 
ð%ð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ð	%ð
 	�,¡¨£Ð/Ñ0ò%ó Að%ðX ‡�Ð6À{ÐSWÐX[Ð]`ÐX`ÑSaÑGbÐpv÷  qCñ  qC€ó  Dð"Øð"àð"ð 
$ð"ð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ð	"ð
 	�,¡¨£Ð/Ñ0ò"ó Dð"ðR ‡�Ð%°kÐBTÑ6UÐci×czÑcz€Ó{ðØðà	 ðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ò	ó |ðð8 ‡�Ð$°[ÀÐFXÑAYÑ5ZÐhn×hzÑhz€Ó{ðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó |ðð$ ‡�Ð.¸{ÐK]Ñ?^Ðlr×l~Ñl~€ÓðØðàðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ò	ó @ðð, ‡�Ð0ÀÐM_ÑA`Ðnt÷  oAñ  oA€ó  BðØðàðð 
!ðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ð	ð
 	�,¡¨£Ð/Ñ0òó Bðð( ‡�Ð1À+ÈdÑBSÐag×asÑas€ÓtðØðàðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ò	ó uðð& ‡�Ð3ÀKÐPTÐUfÑPgÑDhÐv|÷  wIñ  wI€ó  JðØðàðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ò	ó Jðð& ‡�Ð¨k¸$¸Ñ:OÑ.PÐ^d×^pÑ^p€ÓqðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó rðð$ ‡�Ð¨{¸?Ñ/KÐY_×YpÑYp€ÓqðØðà	ðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0ò	ó rðð8 ‡�Ð'¸ÀDÐIaÑDbÑ8cÐqw÷  rDñ  rD€ó  EðØðà˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ðð 	�,¡¨£Ð/Ñ0òó Eðð$ ‡�Ð:È;ÐW[Ð\_ÐadÐ\dÑWeÑKfÐtz÷  uGñ  uG€ó  HðØðàðð 
#ðð ˜e F¨L¸4Ñ,?Ð$?Ñ@Á'ÐJ\ÓB]Ð]Ñ^ð	ð
 	�,¡¨£Ð/Ñ0òó Hñr  