From 8bc98aea4f0f5228fb63063a154ec79a454d3ec5 Mon Sep 17 00:00:00 2001
From: Jackson Makinda
+
+ Integration that simplifies access to M-Pesa's OpenAPI for developers to build applications/ software by providing easy access to services like Customer to Business (C2B), Query, and more.Node pesa
+
+
+
+
+ Report Bug + Β· + Request Feature +
+ +## π§ Documentation Take a look at the [API docs here](https://openpesa.github.io/pesa-js/). -## Getting Started + +## π Getting Started 1. **Sign up for OpenAPI Portal** β Before you begin, you need to sign up for an account and retrieve your credentials. @@ -32,11 +48,10 @@ Take a look at the [API docs here](https://openpesa.github.io/pesa-js/). 1. **Using the SDK** β The best way to become familiar with how to use the SDK is to read the [User Guide](https://openpesa.github.io/pesa-js/). -## Usage - -### Quick Examples +## πΌ Usage ```js + import { Pesa } from '@openpesa/pesa-js'; // Populate the credentials @@ -61,19 +76,18 @@ pesa.c2b(data) .catch((e) => { console.log('err: ' + e); }); + ``` -### Testing +## π§ͺ Test ```bash -npm test -``` -## Opening Issues +npm test -If you have a feature request or you encounter a bug, please file an issue on [our issue tracker on GitHub](https://github.com/openpesa/pesa-js/issues). +``` -## Road Map +## πΊοΈ Road Map 1. Validate data input using Regex before the API call. 2. If fields are not provided then generate a random string for "input_ThirdPartyConversationID" and "input_TransactionReference" @@ -82,18 +96,23 @@ If you have a feature request or you encounter a bug, please file an issue on [o 5. Validate Secret Keys length and format. 6. Allow user use custom sessionID on any/each transaction. (Portal allow for seesion with several hours of validity) 7. Add and improve documentation and examples(example will include expressjs app) -8. +## π Changelog + +Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. + +## π€ Contributing + +Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. -### Security +## π Security Vulnerabilities -If you discover any security-related issues, please email [alphaolomi@gmail.com](mailto:alphaolomi@gmail.com) instead of using the issue tracker. +Please review [our security policy](../../security/policy) on how to report security vulnerabilities. -## Credits +## π₯ Credits -- [Openpesa](https://github.com/openpesa) - [All Contributors](../../contributors) -## License +## π License The MIT License (MIT). Please see [License File](LICENSE.md) for more information. diff --git a/img/banner/header-dark.png b/img/banner/header-dark.png new file mode 100644 index 0000000000000000000000000000000000000000..36c63439f288c1da1e08cae2d90bd8f991ba119c GIT binary patch literal 186360 zcmX_nRY03t({+orKyfctC>q?|3GO7g6?Y00x8m;ZE(z}L?#11m;!>o@&w0=J{)^n? zYG(GDHEXZgPpFcDBnr}Jq<8P$p-4-KtGs*nk@MX-DioJd#eEW(YY8RPd(lllI|;p=^Hm!tO5I*4XD2D2?F}+>5LiH&KOj z#c3N3Nj>sC=@8E;wC8EO<1iEdj=C$1ZL)5BEPd(pH1JwKHJ#Hd(Zv>3)b89^ zo)${ho>DZ%5X5cR>Ol*4Xm1OwH0>)Md~_)B36EYoUBqBsS;(8Qyw6xZ3Am;bSlf1v zTjyjZcgMdPlG}@^?Jf~@S(wJVO{=2W4`Q$U%4w!69+QPpYP37n7ojW0ZL+-AZ!DML zHibWEi4*LB0Tc%ASMbn|-qDEndaoaIqYDqJT~?0Q3b5F1%lAO`HY1SOnbBXIhD)6! z6>MG^p0-DfrfiGAN-Q+Q**8(796C(U;QL;;IC)+yDufCzU`r!#ZB5NTk54n*F%jRk zC$7kY<<5f#<|yEZ>W9J)>iUXw(5JoM$_62qH1eR@?qiZ+8g0di{5{%ZQe8x4|L-66 z*s{cSBUQ@}4>^vn+a&Jgc<_?P_>eyz)W7BcQ+YeKHUEG87=i=iPPgq5gi8}yRU+jF zf9GPDU;CzfB;W !K5x zQPp$W?WXl zlH~=c_`js{vpT*nK64kK-qwr8pPuXmuu9~y*dPw)KJ|V6;lR#Aj(@o)V+Ak&O(6#m zMO%pY1iVlv6t@g{BfQU%v(V{J;nzYB4kP`&`zLm^sPO3C6)JJE&99A4)=)GU@uSoD zdbfN8L#%&dJ+Q4!gFDcrv52@#70;Tw6z!1x?bfSslre|NomF7d5KxN>sXER(ZQ>x) zX&8usGQx R@)!JK#2zMP~^enM=xF&pLneTD602Z zC8oMNcx-?0fsa;hxLek0rp|&233aO)60D35E!4B7P7foqmIc+e_TPfJPyeH_SHIK5 z3VL@SlT g#tw=af zjm7%NlEky5hHz#Qk;lTAS|SivN(U`iy &~@cZu9(AchCHQI%Amf0iF(SmA>Ne0>R47KYP!( z$!v3Gav%kmLE1xi^M};kqQ_dXsmJ4}3Mii!l|50w5Ox |RudBE$2zh-7xkUl;q-qeC9gHR!UW~I3Q&0M8 zH~*m-K?;bHr-3> c9H*xx4q_7WqV)onI+F4aY`B`d6QVuvt}qDB>uh*EMTul}iUcrknyyI8bWs0zL~6 z&hSgc=ny&Jhz;>CNz8vWM%^}cov#|LFp2p$cqX-keAv(6VoaKJ%_R&ai+(EDn~BuW z$e;V_kpRDE4*-hS{Q+SQ{m5n9ggmj~<(S70UQH6s)c7XG;v9io;>wyVSp*uK4-4cI zzbwy7%1^~!`;koa;)ae0j2>XKZ{*)+ss)};%86w~ZJmI`HjPJG_1EHqtJ|{ly;Hzq zbB)3U6jqFF%c+q<(gI^efzg=Kkrd%PyBnsb|1uu@11jW64bX$IIi;x;AM2haN6HMa zXjP;tRi*h9`S+K+ `&Xcvp*_m8$_)Fx8B0Pe1{O)| zP-FU!)hDUcNkO;XDFuV;p){<~h;+^9^3ewTs%$(p09xPWR1Ie&p_WfhlcwnR!zK;x zNdEK-_#-tbu=CSRMM&X%3~h*z$Apw#^CA#Ef-i-j8t#^ECq|Y?!@w*z |koOA{ zDjaak^7E|p3=+Tsg2hsl`M`lo3ujZU+wuXAA`3(Ay)6m-+kqiP{ULWP3vWzMd}l<* zkqt+@u)&qiEU7TB?$<+JK<|W0-WYUSsrsk%)WuC6m2AxJTI-(Kun`TTPNg`~&=;j9 z#ujpiZ_%}6My&3`c_754_A_b|;-ZKou9AOm>&^gCCg3*s@y#<;@=`*UvIyGn5TBxY zbFxVHxB2TBDbMggQFOQzu%OfA=veDYbI8jqZgc6h6#5`1o1uwT<#ds*T-I4JT>AEt zap}gN56XCnVx_A5FkbtjzT9?lMp~>|8@tWyKg_>@EBv`yl9j2{#p=$@x%g3%{0y9B zd71TsbwGC)k0#0K2qy@Ip3ZwhZD^oU9i)G?0@`1#3DaKasjmavgk6+4aIYe;py98+ ztb30wLiVD=rd6WY!84rEBcB*`dOmaD(}d=1)cXW y^`wy0Z`W5J*g*F&Z7B7+1B zKHDkIJSKHZA0j_n|k+r$3RGvnp1sG)op|@5ec*JK%ibO6jYYWiluI zFloSl?#(>XxY{{+9c#IAEEYkvp2nx_4{6TOsSnK-1lpMS8#56vu7Ehw=*fgAw!u-v z7e F%me#mXOgBO=epkjX{y{l-cz)Rr}Ovg(>97d0_!;s!fz+J7^&S;o@g-o2=GS z>J1+86P7ycE!1w6CbL=_2Lv8BE|aWaUt}wXG0AO(S4PT5==z|wT{r&giJtk}XLHo~ zgCw{VsGbnO{>3{0=KO#njb2!x&R01=8Vmz)YGcK~=X?t+n%~RPAk!B5u4=KKE4Ru{ zMdny1$$FR#2)cH5aj0yHe7y?hHZ(70BN&`XUunrIxq-hF7d$H_WJEO9I4!$asvWw= zH`!*JvS=;WCo_>>Pcw>(qc56Z9=2L`2HXJ6RwrNr(WK5O|23C`Y8Ux9ePlMsc$5=4 zk>>bj5o36lDLiqH9=RDGX`!&m%k;Mk9VK(R3ET?r&0Z(&OsWuRPBU?X-7+cnW*Iai zt(KJ5+6v4hX%V$%a=1}Uc4eaS7ZlK(j*xaSGamuPLnigKdABXx0OH--9c&UC8b?fG z*B-zo$?K3#5#@yiA;L;PO7AwFbBRt7dDnk39nbI06t(d@(;|ZTZWEr-Cl$ZGOsBDC zyKMF8uM^ekMhurE%iVtc!MGhGns1UI+R;1V9jZiaJ2q3EQKHnJbuO0FtfHs#QfJ9j z20!cEhQNZJ;ofwR2Y9CKC`@d{zE_j|fHY=yX+^rTmxn`lk5b&foJOExXwTE9v=gt> z9LHT#-Vs2i^`hq1Fr&-YJ8e{JNcbP}n~tPP?DBzW(+RC8$3yUeoVg3$-LA6-eM 6uA?Ci4-v4)w>)+v_znW~jZG^MaAlA;|~ zO@`f)BCr5jA>wZ|l@+@P`RXU+_+Bb?7SU?JGD^KGckF{{u#~5o2QVV}ZoTbBJTrOX z+sLn@iq?`X(a~`TTla6asP^l{5kr7RFqAnh^}YL$1@*kmBzDA>@I38q?{tF| zu$(Vb-6?Tx(0Ptx+V4SI;_dwHYKbicI|=>vcF|jB5N<9N_{S4dYLH<-v@A^TO#IDm zJAUXIv`;>FB(*>i8)!LCma!<8e+0-h36u};2*N69SDorg$Q9r%G3aH8GjCi=iawZz zg+0>dbDdw|3M|=gBi3p!rl1GQv^|v^?oUOe+wpz g z-y8SpnYyP4ol}n?M`>3&MMs5z-yX3tx@-a#DT}q7aFq>)RI#ElL<3%mE_$zI9dwrK zL2UMOQCf0*IWflDgO}t@MJDt`9W$56e^AZ_SF-%65~&78FX~UAcGlXkI!qzt(!c+( z*C^z3o68~xJYO97_Tsi(SV7nnU`kjBn3Qec%|t&JmzRLnU>LP{eCfMtQnGTdFlsUe z1`-8}aD8Bb*hh&*JBTv2$&kA=v6)Bg!mHz^|m{&b! z&aG#-FQ}EFEnN^D$328&>58a(kT?@oR3<>$5Vfw1mwyej1B8+JpeH}zHf+nZ0G rqsi oq%LDXs8HMFA;xn}5;Jw@9}yV(7U2>68lm zx(?E3WDspKEWY0 V{M zXXE3G>{|JH`kta(DD(&%Q`ZGUnoh!_5??o4I0-!V>> vn$4A^|rgv zRg=~99oLgDN}u&9SJ~d=DAcNGoNB3;(qLwkI3o q~FljM(9bU52}&QfzIE;;23bLJzGZc-u&gTqZ@S)AuXmw#7fA<9ct zf+&AsO8w4ZWCt*?6o4COa-H!mMG6bS;Ryw$D6GQKcVF47#b|TBBC23vqY52&X6zn9 zsM!9o>=a=1G89=X2V5cd@3P7mPE7C<#Y`Xi*Xb#T>1z!~;(_Yxh>)@~Up*b`PF49h zsDYK$S?ne}Rk}%&d-mBwJpzA1x(}(r?S (kub7`dM8xbi#g;T;8-}St?M= z7T7HQ9#PzDc%sf{qTJ)Ws>_g QRk_qa5ro;a6JJCbqfws&%X-xa&bjQu~SF zq)N!v_-yy8{0pDu*vSis`b zpL(m_s84E=M#`vQ_Z|EFLXu9sy>crJ}%@9dbPsqne8Bw@^S_ z6Ybf3!qzp|I2iL;3W`zT0m+`&vzstRJ!>}0unO-aC`_VKY6r)lV^2>Yof2Uz{?HVi zZS>D@%tvgr*Ep_AhlG6TbiwoKFAJ1If)mrU<7-n&vx++}rb`(~B2wTNmG(NZ_AoNX z<4)cO{ZG~74W0O(CfX^2q6Fo(q!A$&8T6dCs^nQ+2htI~tm+1EmlxTIR3vPp=gU;| z7Lc`rMN<%IQYc`4;3U05=}mFKe>*==D%xF->{W%Fboh58;CBEsy@e#UYBt6`MbER> zqeyjt2|H( _3=56jzu!dVC)W}(^><$stL{A#OaTq z;_bu@wEbfEo3W
zDc&n(f3&T!>ho`b{;r9>F1;5^GM0fT_N#QzZVtu6bpaBxiKON&N$kHvxU@RY+AaD0 zzpFqn3 Ti9Wr{~67 zh;~`s6tc;IEF5mLQq%O0R7Y~x`LivHDZbd)hDBMcay*IqU4yFG5!nu;-9&iNmk?6< zb*oFsf}+SPUCIAKmZ}zvrB6#9p#}3lqyxYX+YSWI5N(Q|60?8uhz2l@0-v!91p8O5 zj1;g;gCEO^d6O_y(EEN{6BEE=YKUg1MU)tZ9-%wT&2;6cv2Q5wb8ew*PUR>wq?i+L zp%RC)q{)n_-G;y&Rk_A8i1S+Z(_TYPPMq{Wi#YLs#bdbrRX6b4cD1rR4y`u}dau $>orh*3K28(4z~}bkG8}Y5(!}+3>CUUSLU=2{f(m zIF&%Mj;m948lvVJg?%!l$AZL^tFJ!vh XD591f`UEaDzDDFJ1)1l|Q>@`KDLBR1WsVjP=q>bH@YHR@;8wYQ zbrbx8Rg9YXdLs%{Ysv}f-BRT=T$0jWzb)qNPuJx57DZlaJnZ@ByvbCoLz0(!Iyuz= z7t3%y2g!!@zt9+zsg&k#MiNJRbXop#R5aSs#~B~3jD7CZOZ0ZZ05x>N_T9hh<9VLu zfOXV^gS32Vkpde*o^=*c*tenCjDDkP*>8#}BeT`1w<^}x+8)rwlhwM~)M1_Ft*sRZ z`dxE|0|B7lJfn}wrKRoqsIn3feAOvMlXghgaNxb9x&y~nd}#9;x8$^s#m%qxJfLk@ zGzYp_7|sJGLGGY|`o>$K%Bzx5ZWQa}n0JvD?B|}0Mqu#$enwj>Xva3@-0kHK)T%PB z92~sY|F6c2qJ1`_!8DHkDx}PLV2d0t`y_OE=k_Hv1#gA#&(i8E5Of9QRP`a>OkI>T zBZnNot~pYm=f$tY_Um>S7@UJ8-^4^RN7D)i*vlyMT>n(nq1wXwMKIAn-JKW5N$;ni zMmm76=t^&7nV_3zJ#5&f+W(AlrA3>U^QB;pB9c~`V`a|e!z~X;Tr{FXK} z=qU) _Sv{uJX}O8OU0`UHoE*8j!&2AZUJKa2@WSefyY1R9#8YDiMWw; z?O>yGvXyjHXw*thY_h53VWU#X&hCHL9V6;h1oxMC0b3M)?BD cEs!ACRcb4VB>;peP=z#RIs)~%}RAjh&@j&q(g_UBS9R8Mkgo6Ekvf+ZfpZ1T# z2e2g1md~3d 3C{)r*#!5fyAR|>SQ}>YeLf0Gs_OG|$?!Ey&O3`?6vRF&`_p^hI(6B{%IJJT zo1r>;+?nT7rK2juVv?KqENJ6;SWZ&v&SYmp5d_XZztqBOH^Tx(DkxL=9G-& FVcv>|C!{=s1*(DWFF4{a!eTwj9Au|6{TXd#5% zAN?w@_|o?{j{6hJ>^`TSdW U9ywl2h zn4-x=eL_w*oDB(|ZDkbl?YnTd$Z4a49)T|p`$K3@s8ZZFql?^yWOi?=K+WqrNihT? z);ryC(M;~C#JIR|QE?UFw0XaUB^tM?_mKY{c~R|ulPq}}5)gJ{%7^cbt!I3}mj|A4 z^<#LSlyU&S-Bz$F^P0bdNp~DSKYM2zNULz$NKEI4SLr<#NExKGgHhUZjfNb=F0Wo* zG7NbrlbYKv>GMMe+IqZgRT)1KF5T?&X<6FzgNbs9u0KA-9wH=#JveMG#9HejIW}XN zJ>OR^e(5SPYCSAF?Q5~r(d<4VgAmHNpdpH^f7A=p%Ch{R^K8U-H)z-~T|en9{Lf_I zNf#c{#n9n|uj-$WKK)X?I|;&oY!~Kp%H|@#pu!AOLUch`x}P4;AxbCXe387E*ikKP zI9K2JT8ao$v0wQML2b3$M7v;&yFZ!!2>m?so28uFFh6Yh8ck;!5zG~SR5fum=xk&6 zjy4xM?G@Ysh@D~qKHA)viz#`#ksT=!EICKAWs9OqRMZR=a$qW5&%_$?hxtRC^yes) ziUIA}52Inr%{~95-LI$~>ZqAwYWT!0No+T l^o5T7@fs{!)Z=RsqjLqHt%rK8Ygr6 zD;vcy<>7;BA1pq`c6KQjcS})6E=9afNRfJSb2YD$N%n*PzY)n5j^J6!RHxjPS3ozr zxNGBN?EI+aj#v)OT2nc(wGZuW$D7lhnx&sLYEz b!KN z{~@szy@>{bZ9__BccOBlK9rfDWQiKZnAj}{TXWzbqTEjt?9kHMv)krt7GjQx=7Ae5 ze7Gs*rRxMx`aZEOFEJTKKWR5lx{_NR7%$yK%KRP-9>E>NWnyCS!wcqrn0^r1bxT(F z9r_Q;5P6{tax_f0)fcwuEQJ-yDt{z-16%CTz@U&vl30a*a5FC4s~+41j9#xFj9;ZD zIqU(wjlC~Qb7K*33JVNQWJ+=O?1#I<^UcRI8!0HrNE1i0cphl5cW8Q_5a@c4x6*0q z?_8no8x;89=lrFWeRbxnxAf5KXungHro>X|%F8#g5LM}<-TZEW&oKWH=@uiqy>8;5 zsmnWdzp~B!&vYNiA}U5GcQB#6hiBJY7gsEXECRbCOGg8XM$xLBa(cOc@({>@6;k=7 z)P5 i `87Ov61Q|^ zbX3}jTVk0Uyn nD-=I<-R;7+lwf`P~$uJeX HOlk_PsVNBRM0s zAtXFwLG;KszVe9VvYq^T7SUa@Pj_nc0WIuHv$$`f2~(Au@P-` z@`Hj}pRNwJjd0xaa(d`1auMHS=~2GQE9X?NJ@jf1WF#u4wc;rAbs3`?1g@`P*aeV? z;DoE;G-$U@h8$On$XQM$>;DNGigR4{$%oiwHPPMP|FEEHzdIOGqc}UizeyCe6i1f4 zdvnna8>V!}M{aH7B-6?l@==+~TFs?l6tDXdw>V0#msYgAOFfmGb0sA!6_1|6?22Hp zClk|`tVk!xZR7YBvmK0FLg>EYD|ceEZt18i463|3#adFxr>W5#%V8SvR^4%X`?x}i ziS|ge9uzaf8yngijbo7tR4dngvyV^&Ku+--zcoLJuznP;hk>NAHwkBJ{7v&iiobwr zWXR1d#;!b1Z1Y8NZ@?b9n8m8;IJ2*&%&zp&>wT~Dqn>deb;8k$u^TJeI f{QlV0TTi16N&SQ;!5X1UZn$ Q%}Z?PCz>oG#jMFU37TyUJzjg|W-ZA&jN+WiDYO;k zl;MP;)arp%=H&|ArK3z*IQW(>XX@N;-YTQoH;Z&8DqX!NZ4j>fB>*Ve)MSBk)l8RI zWNmXEPV1%GHg*(7=rV=vaUOG?vXbe1*K5je{Zmb$f!M^~g(%(^0=I}=v4w_sI3EOR z(Q|>(f`U9vCsq=2xvB7~UB3GjJ#-BJ7qyyTD`A?-HJRiU&iDDFk+~KPy!-Kp^*n!* zefLi#%ufW`)g?+pznJ-ZGZ }C0rqcl5K`goo_&zU4Y4g92Xl3`-T>vpcz?SOL*>0#3B5{SDIgb4zmIQ07 z1wO1p0F2^d1F*~hk7_-EwKG<={itXyE2Xp8o}JUP!F-FA+eAoBe=ZNCv>LK*WLS6= z5yCLAgwIQLnMU?hZ*p6NUu!j&5f(4j0A!dki8>!nC`bptK|XW|w@liEwx3X D2ws)s8hh@PC zXJT(oVTy>vCIUs2A5X P##jhsAW{PQf$=4SZWop&>K(qi(anAmk(hnZnK3GR)2v2quLR|TGlvFmSi zZDT!8C`-^(rO*G2ac3`#4#Wuy{mK1hXuW((tN;@;u5XM*2~p1;>*%&?s`yekW6n+2 zybcU+ME9(d#lR>wef8unpLPN(lPlK`(~u=9^RN-Nz&O7z2|N~+d;0C%x6cm8#{-tD zQO@U6W!0IA+|^}xd*#WXA>$2shW$?0bf>0#qkdJ3K|eon$dT$w(HGIMci=hpp{Tv` zA-(e^E^Z_3l4pTDUfSK^%Cb8d^Cz+bbp+uXDTGx#fVEO!|6g{e=Nr!XX?rOjLcD&k z2E2jNvC+;!%qhyi&`pWTssw!^QzeadV`W RJ5U) z{Sv`@oavV?Vn3ZyX?dzt>Tw$6HLtw 1`&s&~o9zU{utx8_kN?bhVn-223^{@i=~pK0vslPinhaY4 z;Oocu&wQXJ|K<2X+yR8AFNWmFEB^a=J2gi}=ZQ?)ai3@9Yn(sSckw8|EBs#By@&RQ z#WV2S=)a~?2 EOr~e_cuBDE9sa>9q+<^et2=}_HV=4c zUZR}I3tBjn!Gb53k0_;flTCAjU59ZJed&OiDIsKeDG0cC8{tW?+(c5Fj5?V4HJh*$ zl^Dry4jl9U_V4H#DQ?qB&V|j!Mq?T0Z6n|nn{*%Bax$Q2p`Btl%R=A$8+y*X3FXQx z0W*q4pxb1f@2od3%Z5Q>kza{F-t7Wx0)+6OIW{oEZ-1&?sX@bOV7_St3#7^wb_!GX z#KY3WaiS=YinxZcOP$lNIMboqI}9yw(aesjIIYrbQMaImWq$97R{I`u#VL{dGEM`_ zjj)vU_~=0>Y#U|cr-kC~y=9fnJ`Or3zxn(+jOw{s9h!v?U`7saefW=tX79$-;lHZJ zftHmHQ67~wF_+-2-+yNTJr C~t)J-GQKxRkR#v-z0T~BWC)$S2RR#-6 z6H1|-U0S`HVdfH;;a~ z6v(AYsN4Q)SQXKPnb-^7!05MYgQ~qs>|w`RI3>dER|eW5|BQ+>kd53;6V?@bcX7ag z?8R^+^-uu}#>UlJMDsw;Q!}=^v1UZUSQ?_nT&$XBEAygzk7~Lurzs|+LNbVc;t@yw zAK4Fy=*9?DN_JNVl}aXGT@pA=&V`}?9`I$MYg9K3b&-k0`x6SM0vMIRisw=FkN#Ec z<<1bX+9QGXva0(G*>E lllCC7eU&g%rrF)Va zcV>G&!j=dmZYaG=b%~Y<0L$S^jm^yOiuF2nnD{NA9DdQUQF`HAzjb98raUpH9ss0> zw3Y}l+zehSy|(dx5*fsVjZa 1g;T67r%@!11KD|e%|Sy;f~iC zl{qLGW|oi3Q;HNjAIjB>O;)?iOMp6c!UwYo;Yx92?$-yCjG5TFOv@;Umrf3#5c$BW zLsSMT JjhK@CqxoLq`HICm@0muyq1eleg#x|pMFWv^{tM52I1$4t;L>j=eXYl z0jF?UwJK1|4+hvVEA{pg_R=)VQ$*_b1&W(ZHP $(EENeWtNCxnun|tIbWe}^?XyXsb2Q;k zHK}bTr1gJX{R#Gw8efmKs^H(S*-Tbxo1g&fZk*% gz~{Y{(=^xt%?re(G`Zk=$&*b(I^ubYqux2g^Cd{BmwMH0 z!?8vu0cIMwbha)_zt3$ZVWyWsX{4*_avQ3I{!ZGkGB&~QNX#nphLZ)F8yk7>=T#xC zQXkYc_$9(R2ZSjZ0iL9OYbvD6F;a?j+%rsqi_e^BQXG4qW*0@QiI8E{FsvQ;TrJiV zA2F^Y80fEDEU)cVTDaQwR|8AeUz+5nOO$75lrD$b&OA2>qg^|qS$h8Uqmtc~V*XXh zW)fN7C-s|VJuH|%P@eAzxG;`x Q;{Yb#sH&l zRWdkkZobc%4|zaYRRL }ZJILH zB?4bvri9w!ZaQlCF&I15JVX;uIaq^_jTB@WT6Gr;VLgUMU 4KXsVK?uM|8 xBq5(z7}Y^Qr Cj~N<^BixhnoUMcM^1X+;H`L`bhz|+QBcA7T0FAbi_XoZ4Prv4(orBO~3*_D4WqP zO1Z9Nr{u+p$LR<4gOeE8ftcan*h1moL%AoV4se^^5kF OIClRW!MuM(4t6#<%wYIYru}jRRXt(l6KjkZzaQS(iR0pRR2wFmEHGt} z0GtC+nz6wS2=P}PnLGOpU(82==hl=X2{`D `HB9Z!!?EnwKUviefwxMwqWfp9 z*b|t Fb^A6kY#w6+&wJ{+>~kdOdB;F$cs+q z5vT(Cd>1s}@Y~LbCV{##!Z7EhM679>B=2GAg>lrTuu8Nza1IWC-yab*|MT%1D9{F9 zIbWqst4gY(xmwz8$U^<`bB|mBv#2(=>XLk>-=M4UIn-SH(DgJ6TL7I0$bK#y5{cm# zMbA-9@JJK;;(yy7n=4Z<0J^50?$}Hzp660fCadgqi5f67gpYXFf6>ZP=@bF?4hexi z$(S6**VHqth5RG!3g$6|2&tk&g2OV-#cbqYEALcQtRIs+0n9+SC$ajr0zZMwy^N~b z(zx&L%k#-g4H5Pw=v92O7T1q*64IDIlnc16v~w-eSf-puRUDtA3gBYwg?~et2&?k) zu03fax26cU<&x2%&}we1s`X*PMXhW#h31*h$ FV2Bk~E<>D| z7-vlI!r=%N1NmoaNM$QDh#41W$Q}P53t;A`P^&33%LQ1jl)^c$6eGM$$vtyR=y)N= z{ujVf9T!Bu%Z0Q`ra0kq=A+XjOMG^SF&{FU7&9@o5h`%0adS*^f#PU=u8xm9YLKe` zT7@>JH9;dIBLrST&y-ev(*FG}%d!lfIIoUgWYdY9yFGQ=ipR^a_x*TrqZ zw*E_rev08#UV4FPb8ML~?djL;IqKxh;S}E>?_R88I5FL2+ZdI5l~Sd=<-)whyOhwR z_8kO_dKqaM+>t6ZHx{g#rA#X*7nxKe%Ezp{cL>3ZdXhN|vxF1fN+a%)&6tOaslO+- zcSs;*>u%-LI^igbFhf`iB_g+;3R${&kOFENh{CZ|m$ehgEdH~AHxkW!Rq^rfmwXFz zkf@T5ut*$k?8&ONUJ@A5!e9JBr#$ZSF=ev`)C^Q8K 5I=X(-NrhZBWcUUa3ZxF|jR%!u{7l0^h<&m{GQc;ke<7R7thu zpx^Se3eFpd^|Ivt5+oHA>WY7T8Nb#y%aXTaZPF!WSmzuPl<}fuu-pmp#E;TeChX?{ zNEQPDccit*coSh|^2x8GY__QHq}4KDwbG{9d02GS(`TtC3QYFi>zZ#!uTlRWO;;J! z*4lIn1zNngL-F7c2=1=Mp}4zSAy~0OaSiTHaCa{*#a&voxV!YreeeDL@F#1rp68sI zIU{@a);V!wQ&g`SE%wuF&|%OzdBuG *hsLt(%3j>>EsK`X2T&G_n+@$kz#lQ=V7-@_dMCfdm0rr?lNdXhKq83kWbD+t z&Fv4MEe#v;EYF86fAX^fa};7-doCCwvsybz&lZ_FbAQR@M=U?&0T?W9v?n72<7>iK zhx-~g9Xjakg$Oz@V>b|Q$Iml9X*#)+?gUzW)L9D6B=8ENskO;an@P1qDW6YB7O`LT ziZd-&VG8e9kG2BnQr2Z7^4sH6uoo-}O*%MbtaJ@1GCfq?zjalWQbc(^i8(~Bzo%#W z7!qeEIrpiTy1r KYT&l |c`V2US z?PIjwqH}?Xo4L5PMtSr29c*}9zUtWAp>~q@Mwu1_Mvs^j&@)UzIj6NgeY7?pasT_a zPTIU$Wl*#TEheO$Q|~n_;$WXzp^L_zg}0CJ>laZ(d7tw&7*T|nits<;9B9V*qCXWA zaR!%<^O{Vxgk(|<2bGe72_GLJe2BK(6~F3R1cj2@^lG~d{F_mY7X;Ns8HQEhm1sK^ z))eP8rR+iBwm72=KcLkZ<}bb7i@L%yP`TcFrzPuD{9yUTALq<=$iQ(7tsBHq+;!Ov zP7cTs7fZAN)Ov=_q)U+(H@nv(ghlIRK_QA(A|{W^-XmMdqCts__ShOEetJps7Yd}P zLD6t7 tJ*Xx^H0l$A! z%D34{V0<3_J{+O>v%!%j8leCc{FIG2!_MnbUBb9>YT6Fl^C(y!7TjcN+0h75nkieq zE( LRhl31uqq!-j9r@*?))2SX>e;I;Khgl8*>@g zg_Klt49N!!6 !ojeW7Qr(&W&Dm%uTk!FsYN(i z=vLAyR}Yj6LlYMwnphH^^Q*u`VD>eXLWU|M22?~*U6fFizfPPPW(zF3;0cG1oQQQv zVWzSlbOy2b5ClgAC$>CV+tzWUsE`h;xX&TN!o`$0AjrJacHVqkn<)qU=$ZMhKW$hO z7qxngl&_7@_UEAJ^czw-&3{V_ t$XqQoyv8*sR}vywp>dsWBaN;Yt|Fw`sFr$|>Zk7UYj+{lT&-7Y+N#0KK0P^* zn8;%7l52uIo =;)Qs z7&VrIBBlJ~qjZ=*v+G32+Ln!HX~@Y9g5}+Jvrt~5f2CMt(eUlBC9C*OY)D4+iv7g1 zZJzE%Ti1>&Z>2N?mH1wDm5fkng66C(HRrHkr)93}eI_JQY=fWC!?yL*rTUm(Iq1H2 zmaYgDocqwhtY8PDJPIuuK`^KhD0;`(SsIX*yeVft0VtC$^MRLF_}pL9fK4w%&RSSX z|5ley5US}~`s|=9+9?eJj=tgh^EzU?%f24;aRPfrAB%L}BI=x5WghyS+@t|6_1|`o zkOU55+I9mncvV4L>0T*|3)C1jTrco5kk|nm% ?vx0SU#6^;8cb5|g-l3U+d zr}=B(G2Uujk~8Ume0ngp*hEg+&0R=s;r(nI=aOv@fA_;wVxqMf@MNe!z1k!MBc@Ke zbWtM&u`=N(^)Ezq6qQPrBW_Q5_K^p^VR QOrCV}I=- zc`z;7zdnYQ8y-{<#Dgh`Y3&v-<~qsz!1z(qT_wf?oQ`p`Q z5Svz4h%tJdQck^=q&;J%3o0^C)!UWL#>bwI$wLt=M)R?wv{aL=>Wi}@)}UUab(sE8 zcXX@YiNETj@P#W9QFjy*w|vUIP!Uxx2*}O)2S+9S^6}+UIyV{PSW_k0W!BQ(>!;~) z>|uT)=;H+Ng`}_)1{Z{#6dO4mFua`V#^Mfkl-2mNXvyy-eMOro72Y8aCn;q58zn&j zo`oazz~)9$#Wstc>$sdNy%xgSR`Q4LBt7$SpL8J|;Q_)->;AzSVR-g>ygb=ZQ^R7A zuy%L~kVf0B@T^Ltefmr?RUp&rX{{{&epcETrF +4m1#s!Zlu_Dh#V{v-l_D+-B`3e$@p?xJGI76JZFYZ#J=S?q{lIXONELI%* znZ5_-c9CdP$5#^}=@D^XOl+dq&njoj?Xm$M#|xOpyIV_PV(gP|ptG#hT!`e hyYOu*PLYv_`B@9 zIECLoqnIkURY8Ju^tyH2x}bRZmbvQ gGoTZ`zu$rZqrgr0cMa_;2;~ zgN|0ywErYF7%&^f2gt#T;Jf4&K6}?Geyx*K+4$hrE3 ifQsguQ{XJsM7>_To{bj*AHb##7O2@^#v?`(spiG{ufuGZds zE}gj!dSEMr145RcTw3&!DuW)O$|6EWZ^oE{r`{(ePX)tzYli# zwD7(WZm!8onm4T}I6vGW9SBz(=Rigo;vU383VYZEumE5m&F95ou_-uTKeKK(s$mX0 z9DKHAMj}3LJ@t3VDHkNw%nCMj5Zq0=%SF7Gbka^vcq~KGxE{WWrz++qJNcIZ9Phy} zL1a`B(>%?^OaqM-HCud}Uxo*bwaDWvOf E>OPfU`?~<`f%4~KHm5h9m#goa z_9N<0yflriu{1Z3(M3XUbS|ro-$&BZoHV&wn@_~A{y`-DxAs5&kPeW2(?OJuyOiW_ zdzkZwlhj1G+FDZX0a$X7$m)Kw# j!=kL_Alw4UJ-@tbD%tF+lwcg^Y +j?w-i1?;`8m#S5j zT4}g1w!!eE*W)0Es9SAnFH;_pFnnnkOXQNyf2nwqFn$|={u;`#$e!mNgXO21>{NfU zPUEL&7QC{HW+aIP#ZTRUmCR1hNBf+F8TIn-hd$d9fo9^6Lcf9vSCs)u zS320@r^xN%%D_?AFxvmhizBoA&wr%bJL0eOUswDtUcC=NJv5R$#vX8o@6pF3bu-V8 z++7U;%ihjKYiZhsNMJ^!vTDUf4^W;?X!%YQJT3PLrDyUF6&trowMBMh?g$^JalO6e z;aE7SLA;_{v=f=j3B1P?ruG*o0IBR?XeQZW``9Znvt#H>MZuj^Qw&5wERGvTKxcWc z+NLN@HNq(^?rdVvsUTizY%iLB5HXCLUJOM9=7C}V3wLHM!gLYy)}8~$r3AlpVs;*p zX~ACnnGAJYK+0i_mFrgZpS;wbgYmvGy$v)_)E(D|Z#;ZCzzN)g_tk4Oi8n56Ne7#P ze&=aM=@6Al;-0Hc)p(IDENQC7PxX6W7|TbUlYb2D@Fd TRT$HD(9{9h)&VKp@u6SX_2RlortltMo9h$`^*SrYxX&MC+96;GWrm`YH8KP z{Li{S)KPGAsd9zxjL94gonkq^3jS&sz)>*m;~OR2IL0agtG(0kPj7cNwEO-`zUj}O zKg2jmuMmxpy1wr=UnNR!#*GCg2xw2ORAVh0{BOt>nt_#GW;3$HZ_RIvTKyoPMNY1* z8-rfSA*Yibh=J9@A0J^*6+qL+z>y1z;p0q`!uBCXxj$}maVjzo7f@DQYwI^vy3$qW zGX-7$%n3inq0rJGhtQy$Dt+}h-_lE&T=Wuy^Ka5i)Dub DGH`kd zt+o~1{qx^*$F?je`9_>ta^ZEyb;eGjl0BIan_icSIm4Zwx}hJPk;$IX+JYRHCRkdK zx3Dl(H|@ls#72%jsd1D^)EVxQ@6+2L1!EsyaBr^~C>H&6QndoEoWyqdyV1;evpTWz zrUo0Y+prqBO&l|>lzke~Q5Holy)oLLhUeg}ZbmG{PM5JAUO5Wx=;HBW+e4{eb04x- z?#L%Xu#nNA;Cqj5T^dJgbaJdQ=G(A~3r;T_A&T-W6k`9bwTDbu_zvu(w0cUVm}(KC zPso%3ASPZyjvni?3ArQ%34tM=IcoAro<;&m1^RH1vHX%sX?5!+%aLb6<&rEle2$w@ zv}INuF-Yo!iTbAfXB}3wiXcE}IgKvMq6SH@i-ONELACD4m+21XG`V$^O%lr}&hrSF zbm2bi$g%g987btdwtB<0VRi=5b?fPP@(a}VkK!EdrQ)Y>c+2vEd(U}lEr;LhzxVKe zbD$&{l)O0`umy%e4~M8uaKiG*>&M4fSFgPY;Xb)*V3M%GIx;(ty-i-8>|^g+0b1Ou z4WJsDnBCNMJI_n^Y|4v54jU16M3&jlR0Di?Lg2s-#n!4V^v>A57o`=`IgoK4VWmBu zO}c@?%>v=@`=6uT4B5$^7>xD!jHnrf0XD#k -MH?F9y@4r54p z1yQw!HELI9L7^_H<{JklMBSxYWj(lS$7D&noO!D7HZS;r<(g`YWZ4wtW7>8a;U-F{ z=W_bsk1}p{$wFx#Gnx$?oKxy`=W55D>}pjG%8)c93W{A5xsk<(8;w0#3^Fg?>AbIx zii@NgKB|N8WF^E|t&$aK5?HO|U5kUx#+}1}oxpyYK@G)S7}SM`(4h ykP1w zLHwt{cT)qXfb+S@RdZLap-^+97@A-Dn6x$U*B5^!xlJ3j-m*Zd4(m^hE#sl-WxUeE z5+7obn=@<>&!qKOok#}g#z-zz?9{%c9dsior{$Qna?c+*9^2Zq#o~QeHZyvs_K#Ed z<7i&A-%%@^)(a>V2%KE7VPI3^R!JaNS4S$#u|Z|^7U8Q`N2i#-oRxJ5M#Q O_w}`ggvjSB#GOO`nCK`>WNsz{Sxl?mfUyA7aNKA%JM~OHMMTY9(KL0{ z&@yt^Xm{zeZOv~+t*a%>YMMD_37?(s$LzE Vx73}3gK!ue)dAn9Ppa9Gsh zdwfFJzo~{2@1~^7%Kf^=dE(hG-M@@rxkq2`$r0Y)>_SpF 43xYO#lP%uUUd4E{jI+6W;c3$M z#d)+kMQvvCP;OF^eS?plt*Ukmro@cIU)p16>(@DUds-_7UEW1N^w;Ah6y`6!$(Og) z>+IySUbJz#-7g~Yjr7zNivK%X+evq+3pf33y^ y|jD1Fqnuhg1YP+Ki-m zr+3-z(G(cQ{Wg |)J{@-2!`_s+E*{ YRf!Je86d1S=X3 36n8Cm zuwh5 !jd?@nta0AG&eH0pX! zi76Dfnruo-sq0PR-G7SC ;HSfDxu oLdDNXE*aH^)5%5+Ajon5cw68n|MH-f2b45&!Tf0SfnhwZ7kxSvs5utcTExe zY g?g;%ET6wlj<^3F_`viHoDW9T>Ay22P8l0MMQw?%wMVxV|f z1TZ^{IM}kO0Q@May0|p2##2DNMF%*IdiBP84iMG{Vh^d;*L;KOln#2YUJPBZ@(c;^ z#`TI#jVS+$wzzC?ca$|V=NbDxT+Vfo{?lPrX=Mjv2pTuUaP_XHQCmGauR$sJ-;zXM zAt~JSi-u#wJzl2%0&*1)?-vZ=LsOAGKI_zJ<6b9y2M|~Iq*BP9aHz+L72!qYu_0*_ z$as_V{j{hRyC9(@Hto1L+mB(Ej=4UyDmrKQC>Sug%xHJHN<&_Q5c$ko*jOdXKz@B( ztU+@UEB|g&72mi#Jh{f4OfRRI>xHEZ-l9r3S`;MHKZ?Ztb_nrX*6JVAiqUMM>pfTQ zAT|5-H}t%=Ez_)2^d*8?eog?~jxv2t$7N`b3(8l&efjkC-NT6dwl=DJT@*fl!t`!1 zu~tM<#=m#74*{x +sT@z8CPsp$m9lxLf=}BD8+QzyN#n=Llsc)A6S3kSd`PA10Cbg z0^8h#mbCG?MiYGT=R<{V%A4SnG%Fj~rAn2y>hdLvva7j~WN^RE@5X4!MnVMQS#ThS z;xQ4GZFK4Sk)>3+%Gt5Rp{cj6)=IQ76cdlLoyr##sd>jdu95U^lv3jawZ=ai#i^+| zarZ_4dt2Jc9jvQKxgFJt%{rhRCsb-RMNPPo*nve^eqv1NZ8`Pq{3!J=HXc1`OzA=@ zr1o~0i-V4V!`Kce0K8e(W=ccEz64je)X*k-p{@f0zI +mi8Xq{EQO^EUg3Y(9 zCyn|+6Q(tCUyK#C;!7vzxwY$+X-b$O8(GptQ0rg2N}ZBkj@>9;ByY z>e@2qCO#7klS9Oz&0>-g9rcdzIt|>*YhI< 70tE1d{Zy)oID@R?tCQ>tF?MdqHwSROs?6}lOm%T}t7t56I7rJe+zKcZm zw@;n&mVuiPi^OhItqdL1!RL+|u?070G7e}#@Nbp}4 MLl8DQDdKkr0`!Y03Gq!inF+OPaG zws_E3!VQE*`E9~}Y&umcK?ch1cx$~5=}8(Y3D8ZTckG(Cm*bH&pFF3S0s`<5n`O|D zA!$Q940q7+CAAd(CByla#MBQka>k|d+qOh)Gnck_UfFWA3mU)7Jr1gU?M!eIJJdj# z5LU9Owp&>6&iw82v}{3a%(Qt<*K#+_wN~}!(3|1Q+i$k^jhdxd&Zdu$pI>~vCTxtc zfEhnNhKEe6B!^EU;VI%AZwD35!?~5IAm~X^Ll!tdBi Z hTq8Zpu4_( z2$d$6at2qulTvRr&)!=G2~1)~(@$)wV@xV8kY{(IT>PopG(I@>?Nx4ht1TVa{8LgB z=?o5l{ytc@62)s>=^*Eg<&&f3iVHfSuJ=k_b`;|$@Z%ekRi;LWx}R#zS^)(*AqT^j z(c!xJh g{(RQeitq;&A&7 z#fOX$S_?W}%SK_{!{o~y!tvb8hO++iMQ!p 4C zu<&kfjlsYo=lm16U4QmIW*XF3ojBqRtc-g9Vz9)}$E@!U_{lp2X93BrpiUl*iHH=! ze*<2HvVoLp1w+{ZAS2^y&dvOf+TZc1RPVGy)K|#~p%quk4Y74_9>4m$zdCu=OKaCJ zKxB+Ofkom4w!vPbO O<2|`@7F|5VNYm1@?I*tN%o!mBCernN9^8G07xVGx#Ku*ve({e;?#cE z-LB)?0L^!c$*6COSkd3>GQBJS;;?&a(an_xGY7)P{1z@Ch*grP>W?(qt?6Zdeeg12 z=Q?&;Ej#*Kc_$uP=+2LKIA|=S)&v&`&f&m9Hh^1q`n>)5(4p%54ujIH?7E~u&DCjs z9v=DdEO0xG<6JvBmRbc7J6avM2llpH{FV6?^iD1j-T}4v**2c<9hXjer%cgw1o7a; zH@_aRajo(cv@#iMCL}q}IR;aoZ2X hq>EM_NRGfRm>!Lk|9&oUuLz? zk*N=urC(g#%+05awQ`9LCKGzK0Ui0|B@GJBJ-LeRCBM@$As5vZt2h5PT(Hq@+U$3y z(n){!sjFm~cq!xujggqSvwa2y57>|}5|`p_tznBmkLF+Ix#%PS#f55LgCY(ScGCYo zmL9}_T>=r*Vpp^pJADQ%VFvs`tK$fQZjHugL58TqJk~G; 055zOkR#D zO=#L$e0PxHj@a|)tUi=$(6}V;n4)f{+L(-w0z^kjhEM+ExMi0_CkaCJOMxMQbNB>4 z=21g NZ&S=CcF^D7 z8U1y3qM+|nB>U-9KW-zLG*vJXTL#y#t#IVXnW%4&WFmO^=nxEAgb+DO qDZ~qX) zO$}po{P%T}Y`vstaEN5|)ojD@&BVeWGoysZzbMrmewRkkbK$9^)Rd?~PQ`N-BbCKm zRWZac>`0q9*#-T{B<`umQ6Db1WJmeydz_ybzsn?nl`HZe4(*1fhb@wdBW@h9i5RH; zsxHjmS~m8D&Xr!{HrP7^m5`M){@R_Xay=tgAZLkgpafeO$yM1@eR=mIik{KaMlOv_ z1%Jpm;`lSu&_KRwH}?$Dw0xk!vbuI|L`w0u+v^Q0R)3)QvQtaUdq2pv(6LRyj&AF; zlHv`1WIo>%kWD!88_3;nT-Ca0++d1;6Cz%_Beg7c>}Gk!+`b)y547;IqY;g2fHl95 zq?QaJUjH;ln5#m(p}dyTrRI&H;5T2b(^1ZeHBOyT;(rl?af(VxQ?(JnT7fBBvf0_a zGLz>4*=h{2omTOirn(@t%a*2g4u^Ee5&=IBqh55Igofa}v_USj^4{~8myJ0tXj%Gv z@^_i#I2sDULf(M-?4HMfazdZg@A zq(~&KCp8cMQV2W=tB0{aNeJT{thF#K
{d{xTig9sfowoPi`v*r4nc} hnbyLvW@$)O-OSyPbyvD43)Vz3ak#KdoL3u{Gd9N(A-6S_UWa8ZVzP~6} z45`1=idaNuLetN^sAhd?;dmu96_T@2A8i3>+Z%XC^`2tiI6d-E`!ZKyfy*(dtn;V= zbmPa+W$xh-d~xY35eH;bV6u%_dQ0bG`9^97Pb+3YqMVCist2==lspRK+FWt9-$eCW zgCVK;no6ocuprydYjh2mA6m8X*|L{WEo)D5Gt6Ea&A2#y_ci#k(`>%@wjPnxoSyUD z91||(ze$exj2FQGkQf_t1zSTUny;kH*awaXn^01MjBCft!&0ja(u8v*KX-h| UhZs8UXn5%@!_t6X;S$e?JhQ|^)@f`+}S3hPuh z8VbRXj&<`Yf-n6SQ1^hZ)NSCh@ECLAei-3eha@cf!Q>wNZz?ixC2cVoiGp?{ F+-QZ$VWXfy)TL%qG)@xzf#c=qA>?4WMRhg8 zwAdi@?UfcB2swvVnmQAS>BZ#*K@=T#0*^OxLvvEGhcQu-Di!F^X=z=7U3kliq+jeZ zHaGSOoVl`d!>R3+5NBT-sXiHo?^DmBzhuX3*`&fY!BinIA~K6Ot6{dHzTNO?)TG1F zyWqAHIR;9c4JtJ&9_wQp;+{^IT-Kr~#~~tXTMn`)#j;aV!m5i?$jH=Z!7V{4y%4=j zY&QFTKTVqW@3`I7p#^BEF%%Q4N*pKs{-##3Tb?~bEz!`UGo5_@Aahw=qcgmL=WVZw zM&`xj9(BpVjYGNITbLN5Ls1!v26_^LCA2|dyYRFeA(W Nn&58~saNYvwwalN z(y;U(b&vk{5v`W8U82J9gee}_AHvq2Y{+4FI`Sr)f4(-qM|qnije5!oGS%{(sEJ7g zSMr*RzQQmZ#8Ctvyj9DbCo;IG^fUKC(Kw@#@)LS0Y{^Eu2XKQwe#{kFR=Zc9bD=d* zr@2`dVJ&Q)hR|NEqWh6(l6F)Rn{N8o^$ptdCjjz_<&Z>f#qmNzvpn2J4gi eq!Xi|I&O1EF0z3^qF4Ev@1hQgeV( zlQ!PyWh~i(czp^`o4P8oLt9US+5>i2TV|iHlkevRIc2x|-_idA_n7uLCd5Vd0aXF` zy3A8}!(3)Cb={kMm%oGHZ*7{}+V!&mv@vN4L86_O;X%Q~6zLR6ubUs9IcdBER<7!S zNf;>#EQaDtWTs&+(b@^q&X5ZET6jZeC^P7=Pt~%9H&wUUCXHRmZ#_q&Da}GxD5XKr z2QG)T5l0;azBCJrn8RZ$1<{IVGVVNZxUjG4>mU)NrLCmgMu5`>e;y;4HOXp54>YSI z;Mz_c_fP8{I0%*#McmTwb{Y@5S&SpdZFxy%8Egp!u MujhjnQ(AI_o3Wua{d-$K~O4G^bIl68;`i+QQfC~rjKK4=~{Z#zQxWXn|+FU z77+lgG^r<}J3v~afP*eMe^BLY#|leqXTzT?e(3HRG+GSL-<+$4J|(LOEOul#z&PJ& zda7wMS6!e th6jEk&+YcT46T`4>iqKRfI-#08*#$m=IFm{vGN>OK;GT>% z_0`u*CZ8lK (dqx_|B z)Z9r=#e)MGHJrTeNV8Jahn%Ym;;%)!EZ%XaRL$Qi!Y|E;8M;|z@WVOc<2T@~i}|Pu zY^ym|yWJ%*SZa_EB^@6%Hd&aJk!T`ulPMC5`f_yS=VdMNB-RhSBuv49U|*mi3XCX~ z4QgM`Gw9TwEPKPrOT*-BaVSJ;8`b=FkM18lPpGw-g!pjU8c5YEQS@h{>jSA8gI~0X zpU>euVe!wHUj)QxgA)jXm_N+UjOD+agz7|~junLfQ|Ndpgg?1e3=uv7S!_ob Zb{}MJXKdKm?TrxtRCr_=wkob7FnXnw~#5 zAH?3?8Y3_jF+}F*FbIu>dG3Y|tEJ?v7%ME%_F1|Wx|&}lsg^DdEXGcwbjWwY(~>H= zTjlp9AZd5deYX7vE7G^{#frWEeJgual&wRyY9a?;wpN!&eg7RTw0Wyxr03EoYqp66 zdH1=go(1f4D4K0(hO)cNUzMvzgk;WNwGz7qv;8Gpmts*qJ476;`Z`%!eu)Gwpr3^b zk#sm%M2ABRxvbc{rg$s3OgHkYFIkf*H$iqv>4lk1vI@PDP6Lj-xn#J!!2;Hmqec47 zhz*hV6gTC>pP% MtdOut=JSk}8^$9p-Z;x84 zE61FII>g$c?inS@7Hrj#+W0|(OS#$=oaRK?z3>06Rb2BFdA!BhYT&m$X0_sf$f(P3 z?piqYMDHtS*i~{$L~>#(PAY;x``oFZQp8_0jJ==@2ZNnw!(^7ZP*sdOcvS8%yFZA< zV#BkZmJ|MD9Gu!Z@ffA>IO?Q2-
cs6mL #bR1!a zLj|I5x%nWqcE99JZ@4&`$$&Szr>a6<#y?b2+P<%wFB43+151JAEt`E~_;Y?cVfVw; zFGmH~awW`G#>PlwH#L-_6I#aaw(9N$* `sTy;<2XZ&dqdRpTFAhh2{W4x+6I zs+ErXh_z8MYieg|W@w3@g35K`5MU+^3faGHd5;EEqBjT3E*OsoK+Lg?wf4aR>DtLQ zKtN@0J$9q`sX;t@T4ySP>{Efx1X2KeNJ`X<>{=HP2>rygotd$M4r()EEPb`M2p^^H zS0BaC%?T{tBKigl$z&(8#3?be@4N_J=0U7xFllb*xKR9DP##*RhoHy^vb=@vPo=^{ z9N(5sh}G+_U&y^g2c$uQ)zsD(ND*UEvtSkTN6R547%3I|tf%TQI3@`&)jKp>ynO_} zh_1XeIy(-z)DK04^`<0Qgz^c!W{hiv^Kam*E1JnZ?xDj=QC$6Ap&I5l2WSwe9I2k# zN9IxYK>%XxO69-1dai%Su+NA!v26o?vC3oWDg}bJbEyL4cz{Al7C$1tW5L<18dfTu zkM~?;{AHY!FS+E^bwJF*8%Lc9ARVf;4(g*QJSvNqw2L^LdO~7UrEd0;VkmMyYh=3g zV7`gIn2uxM0|YHCme?#30AVTjKWz@8UPzOKEV0$N&2K~iBt=GIyzf~YQGc(c4Z@HE z3PI!XSD>36ZC8A_PpAE?qisq(fCvfQGxwN?uuP8_f3L52qm7=$xO8H9Zk{AwdD+H` zSMS3WYC0;^_GrpE$1Q!^qtK5>!^nnVu|n*%?tb<;&p;Zaz-k>SkNOqN4V (CT?`C*d^XN~07R^<+ThPaZF~axr~|#sszxa+cit%XRbHgp&|uaJ zOtoFl@dxLsQ%f(}1qR(hfaWMMTDB#HhL0phgeIf%0YNsux?l{aWrG0(P-8F}Xx2 zLA#Pw9>CPMMJ3IM>G4|T{}tlfAlb-LEY0*24SQV4Cyz*eql!H tnj(m z;SA;Qud4ZxlVSNUJbFL&(AE58l=(}F`kn0>nVTmA(@JkJsd4qf^gk})^G%4Bl3?K4 zV;K=?=%%A>FyutS{L_@C645Xx+;AHB1&npIZ$I%ErN=CoQ{q`Ic3R_}J}pyDnLQLM z(M!c8o4@h_w>t@9y?cFUzUlW{r+p&!bQ!wk#ecn=Thc_YTKTIhdgJZk>fGPFdGPGG zUD(=}cc*~E-!BtYEXICiqZQXwDNh^2WI2b3F6Wn?r4Zf5&QX1=dTnj$oay0sO?+g$ zCX_;(<&A-(&(e2Kwo93k7~T`a|Fa)Tf+0=$T++O`mKFD;sQ%e^6P(dZ)AgSZ5nXkw z#_=wz$xJ1f`rk9m&n6{Xbi8ZrqEM#xb(4mw&HGf~i5jVb$=z~uBHGCRJf;tHdl%P< zKNe8zb|q-&c6D-P-i>H~9n#pB?lWcM! eKp_Y_Ces~BB>jD9Ykj1|R0uVC9a z