From 67556e2ad7edf96c2d742e1da8990b919f385008 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Wed, 13 May 2026 11:53:08 +0300 Subject: [PATCH 01/24] feat(dashboard): init next.js app with required packages (#1) Scaffold Next.js 16 app with App Router and Tailwind v4. Add Prisma, Zod, TanStack Query v5, Framer Motion, D3, google-auth-library, jsonwebtoken. Document env vars in .env.example. Closes Week 1 AC 1. --- dashboard/.gitignore | 43 + dashboard/app/favicon.ico | Bin 0 -> 25931 bytes dashboard/app/globals.css | 26 + dashboard/app/layout.tsx | 33 + dashboard/app/page.tsx | 65 + dashboard/eslint.config.mjs | 18 + dashboard/next.config.ts | 7 + dashboard/package-lock.json | 8697 ++++++++++++++++++++++++++++++++ dashboard/package.json | 36 + dashboard/postcss.config.mjs | 7 + dashboard/prisma.config.ts | 14 + dashboard/prisma/schema.prisma | 14 + dashboard/public/file.svg | 1 + dashboard/public/globe.svg | 1 + dashboard/public/next.svg | 1 + dashboard/public/vercel.svg | 1 + dashboard/public/window.svg | 1 + dashboard/tsconfig.json | 34 + 18 files changed, 8999 insertions(+) create mode 100644 dashboard/.gitignore create mode 100644 dashboard/app/favicon.ico create mode 100644 dashboard/app/globals.css create mode 100644 dashboard/app/layout.tsx create mode 100644 dashboard/app/page.tsx create mode 100644 dashboard/eslint.config.mjs create mode 100644 dashboard/next.config.ts create mode 100644 dashboard/package-lock.json create mode 100644 dashboard/package.json create mode 100644 dashboard/postcss.config.mjs create mode 100644 dashboard/prisma.config.ts create mode 100644 dashboard/prisma/schema.prisma create mode 100644 dashboard/public/file.svg create mode 100644 dashboard/public/globe.svg create mode 100644 dashboard/public/next.svg create mode 100644 dashboard/public/vercel.svg create mode 100644 dashboard/public/window.svg create mode 100644 dashboard/tsconfig.json diff --git a/dashboard/.gitignore b/dashboard/.gitignore new file mode 100644 index 0000000..45254b6 --- /dev/null +++ b/dashboard/.gitignore @@ -0,0 +1,43 @@ +# See https://help.github.com/articles/ignoring-files/ for more about ignoring files. + +# dependencies +/node_modules +/.pnp +.pnp.* +.yarn/* +!.yarn/patches +!.yarn/plugins +!.yarn/releases +!.yarn/versions + +# testing +/coverage + +# next.js +/.next/ +/out/ + +# production +/build + +# misc +.DS_Store +*.pem + +# debug +npm-debug.log* +yarn-debug.log* +yarn-error.log* +.pnpm-debug.log* + +# env files (can opt-in for committing if needed) +.env* + +# vercel +.vercel + +# typescript +*.tsbuildinfo +next-env.d.ts + +/app/generated/prisma diff --git a/dashboard/app/favicon.ico b/dashboard/app/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..718d6fea4835ec2d246af9800eddb7ffb276240c GIT binary patch literal 25931 zcmeHv30#a{`}aL_*G&7qml|y<+KVaDM2m#dVr!KsA!#An?kSQM(q<_dDNCpjEux83 zLb9Z^XxbDl(w>%i@8hT6>)&Gu{h#Oeyszu?xtw#Zb1mO{pgX9699l+Qppw7jXaYf~-84xW z)w4x8?=youko|}Vr~(D$UXIbiXABHh`p1?nn8Po~fxRJv}|0e(BPs|G`(TT%kKVJAdg5*Z|x0leQq0 zkdUBvb#>9F()jo|T~kx@OM8$9wzs~t2l;K=woNssA3l6|sx2r3+kdfVW@e^8e*E}v zA1y5{bRi+3Z`uD3{F7LgFJDdvm;nJilkzDku>BwXH(8ItVCXk*-lSJnR?-2UN%hJ){&rlvg`CDTj z)Bzo!3v7Ou#83zEDEFcKt(f1E0~=rqeEbTnMvWR#{+9pg%7G8y>u1OVRUSoox-ovF z2Ydma(;=YuBY(eI|04{hXzZD6_f(v~H;C~y5=DhAC{MMS>2fm~1H_t2$56pc$NH8( z5bH|<)71dV-_oCHIrzrT`2s-5w_+2CM0$95I6X8p^r!gHp+j_gd;9O<1~CEQQGS8) zS9Qh3#p&JM-G8rHekNmKVewU;pJRcTAog68KYo^dRo}(M>36U4Us zfgYWSiHZL3;lpWT=zNAW>Dh#mB!_@Lg%$ms8N-;aPqMn+C2HqZgz&9~Eu z4|Kp<`$q)Uw1R?y(~S>ePdonHxpV1#eSP1B;Ogo+-Pk}6#0GsZZ5!||ev2MGdh}_m z{DeR7?0-1^zVs&`AV6Vt;r3`I`OI_wgs*w=eO%_#7Kepl{B@xiyCANc(l zzIyd4y|c6PXWq9-|KM8(zIk8LPk(>a)zyFWjhT!$HJ$qX1vo@d25W<fvZQ2zUz5WRc(UnFMKHwe1| zWmlB1qdbiA(C0jmnV<}GfbKtmcu^2*P^O?MBLZKt|As~ge8&AAO~2K@zbXelK|4T<{|y4`raF{=72kC2Kn(L4YyenWgrPiv z@^mr$t{#X5VuIMeL!7Ab6_kG$&#&5p*Z{+?5U|TZ`B!7llpVmp@skYz&n^8QfPJzL z0G6K_OJM9x+Wu2gfN45phANGt{7=C>i34CV{Xqlx(fWpeAoj^N0Biu`w+MVcCUyU* zDZuzO0>4Z6fbu^T_arWW5n!E45vX8N=bxTVeFoep_G#VmNlQzAI_KTIc{6>c+04vr zx@W}zE5JNSU>!THJ{J=cqjz+4{L4A{Ob9$ZJ*S1?Ggg3klFp!+Y1@K+pK1DqI|_gq z5ZDXVpge8-cs!o|;K73#YXZ3AShj50wBvuq3NTOZ`M&qtjj#GOFfgExjg8Gn8>Vq5 z`85n+9|!iLCZF5$HJ$Iu($dm?8~-ofu}tEc+-pyke=3!im#6pk_Wo8IA|fJwD&~~F zc16osQ)EBo58U7XDuMexaPRjU@h8tXe%S{fA0NH3vGJFhuyyO!Uyl2^&EOpX{9As0 zWj+P>{@}jxH)8|r;2HdupP!vie{sJ28b&bo!8`D^x}TE$%zXNb^X1p@0PJ86`dZyj z%ce7*{^oo+6%&~I!8hQy-vQ7E)0t0ybH4l%KltWOo~8cO`T=157JqL(oq_rC%ea&4 z2NcTJe-HgFjNg-gZ$6!Y`SMHrlj}Etf7?r!zQTPPSv}{so2e>Fjs1{gzk~LGeesX%r(Lh6rbhSo_n)@@G-FTQy93;l#E)hgP@d_SGvyCp0~o(Y;Ee8{ zdVUDbHm5`2taPUOY^MAGOw*>=s7=Gst=D+p+2yON!0%Hk` zz5mAhyT4lS*T3LS^WSxUy86q&GnoHxzQ6vm8)VS}_zuqG?+3td68_x;etQAdu@sc6 zQJ&5|4(I?~3d-QOAODHpZ=hlSg(lBZ!JZWCtHHSj`0Wh93-Uk)_S%zsJ~aD>{`A0~ z9{AG(e|q3g5B%wYKRxiL2Y$8(4w6bzchKuloQW#e&S3n+P- z8!ds-%f;TJ1>)v)##>gd{PdS2Oc3VaR`fr=`O8QIO(6(N!A?pr5C#6fc~Ge@N%Vvu zaoAX2&(a6eWy_q&UwOhU)|P3J0Qc%OdhzW=F4D|pt0E4osw;%<%Dn58hAWD^XnZD= z>9~H(3bmLtxpF?a7su6J7M*x1By7YSUbxGi)Ot0P77`}P3{)&5Un{KD?`-e?r21!4vTTnN(4Y6Lin?UkSM z`MXCTC1@4A4~mvz%Rh2&EwY))LeoT=*`tMoqcEXI>TZU9WTP#l?uFv+@Dn~b(>xh2 z;>B?;Tz2SR&KVb>vGiBSB`@U7VIWFSo=LDSb9F{GF^DbmWAfpms8Sx9OX4CnBJca3 zlj9(x!dIjN?OG1X4l*imJNvRCk}F%!?SOfiOq5y^mZW)jFL@a|r-@d#f7 z2gmU8L3IZq0ynIws=}~m^#@&C%J6QFo~Mo4V`>v7MI-_!EBMMtb%_M&kvAaN)@ZVw z+`toz&WG#HkWDjnZE!6nk{e-oFdL^$YnbOCN}JC&{$#$O27@|Tn-skXr)2ml2~O!5 zX+gYoxhoc7qoU?C^3~&!U?kRFtnSEecWuH0B0OvLodgUAi}8p1 zrO6RSXHH}DMc$&|?D004DiOVMHV8kXCP@7NKB zgaZq^^O<7PoKEp72kby@W0Z!Y*Ay{&vfg#C&gG@YVR9g?FEocMUi1gSN$+V+ayF45{a zuDZDTN}mS|;BO%gEf}pjBfN2-gIrU#G5~cucA;dokXW89%>AyXJJI z9X4UlIWA|ZYHgbI z5?oFk@A=Ik7lrEQPDH!H+b`7_Y~aDb_qa=B2^Y&Ow41cU=4WDd40dp5(QS-WMN-=Y z9g;6_-JdNU;|6cPwf$ak*aJIcwL@1n$#l~zi{c{EW?T;DaW*E8DYq?Umtz{nJ&w-M zEMyTDrC&9K$d|kZe2#ws6)L=7K+{ zQw{XnV6UC$6-rW0emqm8wJoeZK)wJIcV?dST}Z;G0Arq{dVDu0&4kd%N!3F1*;*pW zR&qUiFzK=@44#QGw7k1`3t_d8&*kBV->O##t|tonFc2YWrL7_eqg+=+k;!F-`^b8> z#KWCE8%u4k@EprxqiV$VmmtiWxDLgnGu$Vs<8rppV5EajBXL4nyyZM$SWVm!wnCj-B!Wjqj5-5dNXukI2$$|Bu3Lrw}z65Lc=1G z^-#WuQOj$hwNGG?*CM_TO8Bg-1+qc>J7k5c51U8g?ZU5n?HYor;~JIjoWH-G>AoUP ztrWWLbRNqIjW#RT*WqZgPJXU7C)VaW5}MiijYbABmzoru6EmQ*N8cVK7a3|aOB#O& zBl8JY2WKfmj;h#Q!pN%9o@VNLv{OUL?rixHwOZuvX7{IJ{(EdPpuVFoQqIOa7giLVkBOKL@^smUA!tZ1CKRK}#SSM)iQHk)*R~?M!qkCruaS!#oIL1c z?J;U~&FfH#*98^G?i}pA{ z9Jg36t4=%6mhY(quYq*vSxptes9qy|7xSlH?G=S@>u>Ebe;|LVhs~@+06N<4CViBk zUiY$thvX;>Tby6z9Y1edAMQaiH zm^r3v#$Q#2T=X>bsY#D%s!bhs^M9PMAcHbCc0FMHV{u-dwlL;a1eJ63v5U*?Q_8JO zT#50!RD619#j_Uf))0ooADz~*9&lN!bBDRUgE>Vud-i5ck%vT=r^yD*^?Mp@Q^v+V zG#-?gKlr}Eeqifb{|So?HM&g91P8|av8hQoCmQXkd?7wIJwb z_^v8bbg`SAn{I*4bH$u(RZ6*xUhuA~hc=8czK8SHEKTzSxgbwi~9(OqJB&gwb^l4+m`k*Q;_?>Y-APi1{k zAHQ)P)G)f|AyjSgcCFps)Fh6Bca*Xznq36!pV6Az&m{O8$wGFD? zY&O*3*J0;_EqM#jh6^gMQKpXV?#1?>$ml1xvh8nSN>-?H=V;nJIwB07YX$e6vLxH( zqYwQ>qxwR(i4f)DLd)-$P>T-no_c!LsN@)8`e;W@)-Hj0>nJ-}Kla4-ZdPJzI&Mce zv)V_j;(3ERN3_@I$N<^|4Lf`B;8n+bX@bHbcZTopEmDI*Jfl)-pFDvo6svPRoo@(x z);_{lY<;);XzT`dBFpRmGrr}z5u1=pC^S-{ce6iXQlLGcItwJ^mZx{m$&DA_oEZ)B{_bYPq-HA zcH8WGoBG(aBU_j)vEy+_71T34@4dmSg!|M8Vf92Zj6WH7Q7t#OHQqWgFE3ARt+%!T z?oLovLVlnf?2c7pTc)~cc^($_8nyKwsN`RA-23ed3sdj(ys%pjjM+9JrctL;dy8a( z@en&CQmnV(()bu|Y%G1-4a(6x{aLytn$T-;(&{QIJB9vMox11U-1HpD@d(QkaJdEb zG{)+6Dos_L+O3NpWo^=gR?evp|CqEG?L&Ut#D*KLaRFOgOEK(Kq1@!EGcTfo+%A&I z=dLbB+d$u{sh?u)xP{PF8L%;YPPW53+@{>5W=Jt#wQpN;0_HYdw1{ksf_XhO4#2F= zyPx6Lx2<92L-;L5PD`zn6zwIH`Jk($?Qw({erA$^bC;q33hv!d!>%wRhj# zal^hk+WGNg;rJtb-EB(?czvOM=H7dl=vblBwAv>}%1@{}mnpUznfq1cE^sgsL0*4I zJ##!*B?=vI_OEVis5o+_IwMIRrpQyT_Sq~ZU%oY7c5JMIADzpD!Upz9h@iWg_>>~j zOLS;wp^i$-E?4<_cp?RiS%Rd?i;f*mOz=~(&3lo<=@(nR!_Rqiprh@weZlL!t#NCc zO!QTcInq|%#>OVgobj{~ixEUec`E25zJ~*DofsQdzIa@5^nOXj2T;8O`l--(QyU^$t?TGY^7#&FQ+2SS3B#qK*k3`ye?8jUYSajE5iBbJls75CCc(m3dk{t?- zopcER9{Z?TC)mk~gpi^kbbu>b-+a{m#8-y2^p$ka4n60w;Sc2}HMf<8JUvhCL0B&Btk)T`ctE$*qNW8L$`7!r^9T+>=<=2qaq-;ll2{`{Rg zc5a0ZUI$oG&j-qVOuKa=*v4aY#IsoM+1|c4Z)<}lEDvy;5huB@1RJPquU2U*U-;gu z=En2m+qjBzR#DEJDO`WU)hdd{Vj%^0V*KoyZ|5lzV87&g_j~NCjwv0uQVqXOb*QrQ zy|Qn`hxx(58c70$E;L(X0uZZ72M1!6oeg)(cdKO ze0gDaTz+ohR-#d)NbAH4x{I(21yjwvBQfmpLu$)|m{XolbgF!pmsqJ#D}(ylp6uC> z{bqtcI#hT#HW=wl7>p!38sKsJ`r8}lt-q%Keqy%u(xk=yiIJiUw6|5IvkS+#?JTBl z8H5(Q?l#wzazujH!8o>1xtn8#_w+397*_cy8!pQGP%K(Ga3pAjsaTbbXJlQF_+m+-UpUUent@xM zg%jqLUExj~o^vQ3Gl*>wh=_gOr2*|U64_iXb+-111aH}$TjeajM+I20xw(((>fej-@CIz4S1pi$(#}P7`4({6QS2CaQS4NPENDp>sAqD z$bH4KGzXGffkJ7R>V>)>tC)uax{UsN*dbeNC*v}#8Y#OWYwL4t$ePR?VTyIs!wea+ z5Urmc)X|^`MG~*dS6pGSbU+gPJoq*^a=_>$n4|P^w$sMBBy@f*Z^Jg6?n5?oId6f{ z$LW4M|4m502z0t7g<#Bx%X;9<=)smFolV&(V^(7Cv2-sxbxopQ!)*#ZRhTBpx1)Fc zNm1T%bONzv6@#|dz(w02AH8OXe>kQ#1FMCzO}2J_mST)+ExmBr9cva-@?;wnmWMOk z{3_~EX_xadgJGv&H@zK_8{(x84`}+c?oSBX*Ge3VdfTt&F}yCpFP?CpW+BE^cWY0^ zb&uBN!Ja3UzYHK-CTyA5=L zEMW{l3Usky#ly=7px648W31UNV@K)&Ub&zP1c7%)`{);I4b0Q<)B}3;NMG2JH=X$U zfIW4)4n9ZM`-yRj67I)YSLDK)qfUJ_ij}a#aZN~9EXrh8eZY2&=uY%2N0UFF7<~%M zsB8=erOWZ>Ct_#^tHZ|*q`H;A)5;ycw*IcmVxi8_0Xk}aJA^ath+E;xg!x+As(M#0=)3!NJR6H&9+zd#iP(m0PIW8$ z1Y^VX`>jm`W!=WpF*{ioM?C9`yOR>@0q=u7o>BP-eSHqCgMDj!2anwH?s%i2p+Q7D zzszIf5XJpE)IG4;d_(La-xenmF(tgAxK`Y4sQ}BSJEPs6N_U2vI{8=0C_F?@7<(G; zo$~G=8p+076G;`}>{MQ>t>7cm=zGtfbdDXm6||jUU|?X?CaE?(<6bKDYKeHlz}DA8 zXT={X=yp_R;HfJ9h%?eWvQ!dRgz&Su*JfNt!Wu>|XfU&68iRikRrHRW|ZxzRR^`eIGt zIeiDgVS>IeExKVRWW8-=A=yA`}`)ZkWBrZD`hpWIxBGkh&f#ijr449~m`j6{4jiJ*C!oVA8ZC?$1RM#K(_b zL9TW)kN*Y4%^-qPpMP7d4)o?Nk#>aoYHT(*g)qmRUb?**F@pnNiy6Fv9rEiUqD(^O zzyS?nBrX63BTRYduaG(0VVG2yJRe%o&rVrLjbxTaAFTd8s;<<@Qs>u(<193R8>}2_ zuwp{7;H2a*X7_jryzriZXMg?bTuegABb^87@SsKkr2)0Gyiax8KQWstw^v#ix45EVrcEhr>!NMhprl$InQMzjSFH54x5k9qHc`@9uKQzvL4ihcq{^B zPrVR=o_ic%Y>6&rMN)hTZsI7I<3&`#(nl+3y3ys9A~&^=4?PL&nd8)`OfG#n zwAMN$1&>K++c{^|7<4P=2y(B{jJsQ0a#U;HTo4ZmWZYvI{+s;Td{Yzem%0*k#)vjpB zia;J&>}ICate44SFYY3vEelqStQWFihx%^vQ@Do(sOy7yR2@WNv7Y9I^yL=nZr3mb zXKV5t@=?-Sk|b{XMhA7ZGB@2hqsx}4xwCW!in#C zI@}scZlr3-NFJ@NFaJlhyfcw{k^vvtGl`N9xSo**rDW4S}i zM9{fMPWo%4wYDG~BZ18BD+}h|GQKc-g^{++3MY>}W_uq7jGHx{mwE9fZiPCoxN$+7 zrODGGJrOkcPQUB(FD5aoS4g~7#6NR^ma7-!>mHuJfY5kTe6PpNNKC9GGRiu^L31uG z$7v`*JknQHsYB!Tm_W{a32TM099djW%5e+j0Ve_ct}IM>XLF1Ap+YvcrLV=|CKo6S zb+9Nl3_YdKP6%Cxy@6TxZ>;4&nTneadr z_ES90ydCev)LV!dN=#(*f}|ZORFdvkYBni^aLbUk>BajeWIOcmHP#8S)*2U~QKI%S zyrLmtPqb&TphJ;>yAxri#;{uyk`JJqODDw%(Z=2`1uc}br^V%>j!gS)D*q*f_-qf8&D;W1dJgQMlaH5er zN2U<%Smb7==vE}dDI8K7cKz!vs^73o9f>2sgiTzWcwY|BMYHH5%Vn7#kiw&eItCqa zIkR2~Q}>X=Ar8W|^Ms41Fm8o6IB2_j60eOeBB1Br!boW7JnoeX6Gs)?7rW0^5psc- zjS16yb>dFn>KPOF;imD}e!enuIniFzv}n$m2#gCCv4jM#ArwlzZ$7@9&XkFxZ4n!V zj3dyiwW4Ki2QG{@i>yuZXQizw_OkZI^-3otXC{!(lUpJF33gI60ak;Uqitp74|B6I zgg{b=Iz}WkhCGj1M=hu4#Aw173YxIVbISaoc z-nLZC*6Tgivd5V`K%GxhBsp@SUU60-rfc$=wb>zdJzXS&-5(NRRodFk;Kxk!S(O(a0e7oY=E( zAyS;Ow?6Q&XA+cnkCb{28_1N8H#?J!*$MmIwLq^*T_9-z^&UE@A(z9oGYtFy6EZef LrJugUA?W`A8`#=m literal 0 HcmV?d00001 diff --git a/dashboard/app/globals.css b/dashboard/app/globals.css new file mode 100644 index 0000000..a2dc41e --- /dev/null +++ b/dashboard/app/globals.css @@ -0,0 +1,26 @@ +@import "tailwindcss"; + +:root { + --background: #ffffff; + --foreground: #171717; +} + +@theme inline { + --color-background: var(--background); + --color-foreground: var(--foreground); + --font-sans: var(--font-geist-sans); + --font-mono: var(--font-geist-mono); +} + +@media (prefers-color-scheme: dark) { + :root { + --background: #0a0a0a; + --foreground: #ededed; + } +} + +body { + background: var(--background); + color: var(--foreground); + font-family: Arial, Helvetica, sans-serif; +} diff --git a/dashboard/app/layout.tsx b/dashboard/app/layout.tsx new file mode 100644 index 0000000..976eb90 --- /dev/null +++ b/dashboard/app/layout.tsx @@ -0,0 +1,33 @@ +import type { Metadata } from "next"; +import { Geist, Geist_Mono } from "next/font/google"; +import "./globals.css"; + +const geistSans = Geist({ + variable: "--font-geist-sans", + subsets: ["latin"], +}); + +const geistMono = Geist_Mono({ + variable: "--font-geist-mono", + subsets: ["latin"], +}); + +export const metadata: Metadata = { + title: "Create Next App", + description: "Generated by create next app", +}; + +export default function RootLayout({ + children, +}: Readonly<{ + children: React.ReactNode; +}>) { + return ( + + {children} + + ); +} diff --git a/dashboard/app/page.tsx b/dashboard/app/page.tsx new file mode 100644 index 0000000..3f36f7c --- /dev/null +++ b/dashboard/app/page.tsx @@ -0,0 +1,65 @@ +import Image from "next/image"; + +export default function Home() { + return ( +
+
+ Next.js logo +
+

+ To get started, edit the page.tsx file. +

+

+ Looking for a starting point or more instructions? Head over to{" "} + + Templates + {" "} + or the{" "} + + Learning + {" "} + center. +

+
+ +
+
+ ); +} diff --git a/dashboard/eslint.config.mjs b/dashboard/eslint.config.mjs new file mode 100644 index 0000000..05e726d --- /dev/null +++ b/dashboard/eslint.config.mjs @@ -0,0 +1,18 @@ +import { defineConfig, globalIgnores } from "eslint/config"; +import nextVitals from "eslint-config-next/core-web-vitals"; +import nextTs from "eslint-config-next/typescript"; + +const eslintConfig = defineConfig([ + ...nextVitals, + ...nextTs, + // Override default ignores of eslint-config-next. + globalIgnores([ + // Default ignores of eslint-config-next: + ".next/**", + "out/**", + "build/**", + "next-env.d.ts", + ]), +]); + +export default eslintConfig; diff --git a/dashboard/next.config.ts b/dashboard/next.config.ts new file mode 100644 index 0000000..e9ffa30 --- /dev/null +++ b/dashboard/next.config.ts @@ -0,0 +1,7 @@ +import type { NextConfig } from "next"; + +const nextConfig: NextConfig = { + /* config options here */ +}; + +export default nextConfig; diff --git a/dashboard/package-lock.json b/dashboard/package-lock.json new file mode 100644 index 0000000..cef1d24 --- /dev/null +++ b/dashboard/package-lock.json @@ -0,0 +1,8697 @@ +{ + "name": "dashboard", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "dashboard", + "version": "0.1.0", + "dependencies": { + "@prisma/client": "^7.8.0", + "@tanstack/react-query": "^5.100.10", + "d3": "^7.9.0", + "framer-motion": "^12.38.0", + "google-auth-library": "^10.6.2", + "jsonwebtoken": "^9.0.3", + "next": "16.2.6", + "prisma": "^7.8.0", + "react": "19.2.4", + "react-dom": "19.2.4", + "zod": "^4.4.3" + }, + "devDependencies": { + "@tailwindcss/postcss": "^4", + "@types/d3": "^7.4.3", + "@types/jsonwebtoken": "^9.0.10", + "@types/node": "^20", + "@types/react": "^19", + "@types/react-dom": "^19", + "eslint": "^9", + "eslint-config-next": "16.2.6", + "tailwindcss": "^4", + "typescript": "^5" + } + }, + "node_modules/@alloc/quick-lru": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz", + "integrity": "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz", + "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.28.5", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/compat-data": { + "version": "7.29.3", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.3.tgz", + "integrity": "sha512-LIVqM46zQWZhj17qA8wb4nW/ixr2y1Nw+r1etiAWgRM6U1IqP+LNhL1yg440jYZR72jCWcWbLWzIosH+uP1fqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/core": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.0.tgz", + "integrity": "sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.29.0", + "@babel/generator": "^7.29.0", + "@babel/helper-compilation-targets": "^7.28.6", + "@babel/helper-module-transforms": "^7.28.6", + "@babel/helpers": "^7.28.6", + "@babel/parser": "^7.29.0", + "@babel/template": "^7.28.6", + "@babel/traverse": "^7.29.0", + "@babel/types": "^7.29.0", + "@jridgewell/remapping": "^2.3.5", + "convert-source-map": "^2.0.0", + "debug": "^4.1.0", + "gensync": "^1.0.0-beta.2", + "json5": "^2.2.3", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/babel" + } + }, + "node_modules/@babel/generator": { + "version": "7.29.1", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.1.tgz", + "integrity": "sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.0", + "@babel/types": "^7.29.0", + "@jridgewell/gen-mapping": "^0.3.12", + "@jridgewell/trace-mapping": "^0.3.28", + "jsesc": "^3.0.2" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets": { + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.28.6.tgz", + "integrity": "sha512-JYtls3hqi15fcx5GaSNL7SCTJ2MNmjrkHXg4FSpOA/grxK8KwyZ5bubHsCq8FXCkua6xhuaaBit+3b7+VZRfcA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.28.6", + "@babel/helper-validator-option": "^7.27.1", + "browserslist": "^4.24.0", + "lru-cache": "^5.1.1", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-globals": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz", + "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-imports": { + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.28.6.tgz", + "integrity": "sha512-l5XkZK7r7wa9LucGw9LwZyyCUscb4x37JWTPz7swwFE/0FMQAGpiWUZn8u9DzkSBWEcK25jmvubfpw2dnAMdbw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/traverse": "^7.28.6", + "@babel/types": "^7.28.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-transforms": { + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.6.tgz", + "integrity": "sha512-67oXFAYr2cDLDVGLXTEABjdBJZ6drElUSI7WKp70NrpyISso3plG9SAGEF6y7zbha/wOzUByWWTJvEDVNIUGcA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.28.6", + "@babel/helper-validator-identifier": "^7.28.5", + "@babel/traverse": "^7.28.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", + "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-option": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz", + "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helpers": { + "version": "7.29.2", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.2.tgz", + "integrity": "sha512-HoGuUs4sCZNezVEKdVcwqmZN8GoHirLUcLaYVNBK2J0DadGtdcqgr3BCbvH8+XUo4NGjNl3VOtSjEKNzqfFgKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/template": "^7.28.6", + "@babel/types": "^7.29.0" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.3", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.3.tgz", + "integrity": "sha512-b3ctpQwp+PROvU/cttc4OYl4MzfJUWy6FZg+PMXfzmt/+39iHVF0sDfqay8TQM3JA2EUOyKcFZt75jWriQijsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.0" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/template": { + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz", + "integrity": "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.28.6", + "@babel/parser": "^7.28.6", + "@babel/types": "^7.28.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.0.tgz", + "integrity": "sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.29.0", + "@babel/generator": "^7.29.0", + "@babel/helper-globals": "^7.28.0", + "@babel/parser": "^7.29.0", + "@babel/template": "^7.28.6", + "@babel/types": "^7.29.0", + "debug": "^4.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz", + "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@electric-sql/pglite": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@electric-sql/pglite/-/pglite-0.4.1.tgz", + "integrity": "sha512-mZ9NzzUSYPOCnxHH1oAHPRzoMFJHY472raDKwXl/+6oPbpdJ7g8LsCN4FSaIIfkiCKHhb3iF/Zqo3NYxaIhU7Q==", + "license": "Apache-2.0" + }, + "node_modules/@electric-sql/pglite-socket": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/@electric-sql/pglite-socket/-/pglite-socket-0.1.1.tgz", + "integrity": "sha512-p2hoXw3Z3LQHwTeikdZNsFBOvXGqKY2hk51BBw+8NKND8eoH+8LFOtW9Z8CQKmTJ2qqGYu82ipqiyFZOTTXNfw==", + "license": "Apache-2.0", + "bin": { + "pglite-server": "dist/scripts/server.js" + }, + "peerDependencies": { + "@electric-sql/pglite": "0.4.1" + } + }, + "node_modules/@electric-sql/pglite-tools": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/@electric-sql/pglite-tools/-/pglite-tools-0.3.1.tgz", + "integrity": "sha512-C+T3oivmy9bpQvSxVqXA1UDY8cB9Eb9vZHL9zxWwEUfDixbXv4G3r2LjoTdR33LD8aomR3O9ZXEO3XEwr/cUCA==", + "license": "Apache-2.0", + "peerDependencies": { + "@electric-sql/pglite": "0.4.1" + } + }, + "node_modules/@emnapi/core": { + "version": "1.10.0", + "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.10.0.tgz", + "integrity": "sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/wasi-threads": "1.2.1", + "tslib": "^2.4.0" + } + }, + "node_modules/@emnapi/runtime": { + "version": "1.10.0", + "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz", + "integrity": "sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==", + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@emnapi/wasi-threads": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.1.tgz", + "integrity": "sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.9.1", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", + "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/config-array": { + "version": "0.21.2", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.2.tgz", + "integrity": "sha512-nJl2KGTlrf9GjLimgIru+V/mzgSK0ABCDQRvxw5BjURL7WfH5uoWmizbH7QB6MmnMBd8cIC9uceWnezL1VZWWw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/object-schema": "^2.1.7", + "debug": "^4.3.1", + "minimatch": "^3.1.5" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/config-helpers": { + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.2.tgz", + "integrity": "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/core": { + "version": "0.17.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz", + "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@types/json-schema": "^7.0.15" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/eslintrc": { + "version": "3.3.5", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.5.tgz", + "integrity": "sha512-4IlJx0X0qftVsN5E+/vGujTRIFtwuLbNsVUe7TO6zYPDR1O6nFwvwhIKEKSrl6dZchmYBITazxKoUYOjdtjlRg==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^6.14.0", + "debug": "^4.3.2", + "espree": "^10.0.1", + "globals": "^14.0.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.1", + "minimatch": "^3.1.5", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint/js": { + "version": "9.39.4", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.4.tgz", + "integrity": "sha512-nE7DEIchvtiFTwBw4Lfbu59PG+kCofhjsKaCWzxTpt4lfRjRMqG6uMBzKXuEcyXhOHoUp9riAm7/aWYGhXZ9cw==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + } + }, + "node_modules/@eslint/object-schema": { + "version": "2.1.7", + "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", + "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/plugin-kit": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.1.tgz", + "integrity": "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0", + "levn": "^0.4.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@hono/node-server": { + "version": "1.19.11", + "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-1.19.11.tgz", + "integrity": "sha512-dr8/3zEaB+p0D2n/IUrlPF1HZm586qgJNXK1a9fhg/PzdtkK7Ksd5l312tJX2yBuALqDYBlG20QEbayqPyxn+g==", + "license": "MIT", + "engines": { + "node": ">=18.14.1" + }, + "peerDependencies": { + "hono": "^4" + } + }, + "node_modules/@humanfs/core": { + "version": "0.19.2", + "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.2.tgz", + "integrity": "sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanfs/types": "^0.15.0" + }, + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/node": { + "version": "0.16.8", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.8.tgz", + "integrity": "sha512-gE1eQNZ3R++kTzFUpdGlpmy8kDZD/MLyHqDwqjkVQI0JMdI1D51sy1H958PNXYkM2rAac7e5/CnIKZrHtPh3BQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanfs/core": "^0.19.2", + "@humanfs/types": "^0.15.0", + "@humanwhocodes/retry": "^0.4.0" + }, + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/types": { + "version": "0.15.0", + "resolved": "https://registry.npmjs.org/@humanfs/types/-/types-0.15.0.tgz", + "integrity": "sha512-ZZ1w0aoQkwuUuC7Yf+7sdeaNfqQiiLcSRbfI08oAxqLtpXQr9AIVX7Ay7HLDuiLYAaFPu8oBYNq/QIi9URHJ3Q==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/retry": { + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", + "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@img/colour": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz", + "integrity": "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=18" + } + }, + "node_modules/@img/sharp-darwin-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.5.tgz", + "integrity": "sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-darwin-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.5.tgz", + "integrity": "sha512-YNEFAF/4KQ/PeW0N+r+aVVsoIY0/qxxikF2SWdp+NRkmMB7y9LBZAVqQ4yhGCm/H3H270OSykqmQMKLBhBJDEw==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-libvips-darwin-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.4.tgz", + "integrity": "sha512-zqjjo7RatFfFoP0MkQ51jfuFZBnVE2pRiaydKJ1G/rHZvnsrHAOcQALIi9sA5co5xenQdTugCvtb1cuf78Vf4g==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-darwin-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.4.tgz", + "integrity": "sha512-1IOd5xfVhlGwX+zXv2N93k0yMONvUlANylbJw1eTah8K/Jtpi15KC+WSiaX/nBmbm2HxRM1gZ0nSdjSsrZbGKg==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-arm": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.4.tgz", + "integrity": "sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==", + "cpu": [ + "arm" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.4.tgz", + "integrity": "sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-ppc64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.4.tgz", + "integrity": "sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==", + "cpu": [ + "ppc64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-riscv64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.2.4.tgz", + "integrity": "sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==", + "cpu": [ + "riscv64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-s390x": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.4.tgz", + "integrity": "sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==", + "cpu": [ + "s390x" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.4.tgz", + "integrity": "sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linuxmusl-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.4.tgz", + "integrity": "sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linuxmusl-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.4.tgz", + "integrity": "sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-linux-arm": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.5.tgz", + "integrity": "sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==", + "cpu": [ + "arm" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.5.tgz", + "integrity": "sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-ppc64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.5.tgz", + "integrity": "sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==", + "cpu": [ + "ppc64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-ppc64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-riscv64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.34.5.tgz", + "integrity": "sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==", + "cpu": [ + "riscv64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-riscv64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-s390x": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.5.tgz", + "integrity": "sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==", + "cpu": [ + "s390x" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-s390x": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.5.tgz", + "integrity": "sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-linuxmusl-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.5.tgz", + "integrity": "sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-linuxmusl-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.5.tgz", + "integrity": "sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-wasm32": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.5.tgz", + "integrity": "sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==", + "cpu": [ + "wasm32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT", + "optional": true, + "dependencies": { + "@emnapi/runtime": "^1.7.0" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.5.tgz", + "integrity": "sha512-WQ3AgWCWYSb2yt+IG8mnC6Jdk9Whs7O0gxphblsLvdhSpSTtmu69ZG1Gkb6NuvxsNACwiPV6cNSZNzt0KPsw7g==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-ia32": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.5.tgz", + "integrity": "sha512-FV9m/7NmeCmSHDD5j4+4pNI8Cp3aW+JvLoXcTUo0IqyjSfAZJ8dIUmijx1qaJsIiU+Hosw6xM5KijAWRJCSgNg==", + "cpu": [ + "ia32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.5.tgz", + "integrity": "sha512-+29YMsqY2/9eFEiW93eqWnuLcWcufowXewwSNIT6UwZdUUCrM3oFjMWH/Z6/TMmb4hlFenmfAVbpWeup2jryCw==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.13", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/remapping": { + "version": "2.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz", + "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "dev": true, + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.31", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@kurkle/color": { + "version": "0.3.4", + "resolved": "https://registry.npmjs.org/@kurkle/color/-/color-0.3.4.tgz", + "integrity": "sha512-M5UknZPHRu3DEDWoipU6sE8PdkZ6Z/S+v4dD+Ke8IaNlpdSQah50lz1KtcFBa2vsdOnwbbnxJwVM4wty6udA5w==", + "license": "MIT" + }, + "node_modules/@napi-rs/wasm-runtime": { + "version": "0.2.12", + "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-0.2.12.tgz", + "integrity": "sha512-ZVWUcfwY4E/yPitQJl481FjFo3K22D6qF0DuFH6Y/nbnE11GY5uguDxZMGXPQ8WQ0128MXQD7TnfHyK4oWoIJQ==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/core": "^1.4.3", + "@emnapi/runtime": "^1.4.3", + "@tybys/wasm-util": "^0.10.0" + } + }, + "node_modules/@next/env": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/env/-/env-16.2.6.tgz", + "integrity": "sha512-gd8HoHN4ufj73WmR3JmVolrpJR47ILK6LouP5xElPglaVxir6e1a7VzvTvDWkOoPXT9rkkTzyCxBu4yeZfZwcw==", + "license": "MIT" + }, + "node_modules/@next/eslint-plugin-next": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/eslint-plugin-next/-/eslint-plugin-next-16.2.6.tgz", + "integrity": "sha512-Z8l6o4JWKUl755x4R+wogD86KPeU+Ckw4K+SYG4kHeOJtRenDeK+OSbGcqZpDtbwn9DsJVdir2UxmwXuinUbUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-glob": "3.3.1" + } + }, + "node_modules/@next/swc-darwin-arm64": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-16.2.6.tgz", + "integrity": "sha512-ZJGkkcNfYgrrMkqOdZ7zoLa1TOy0qpcMfk/z4Mh/FKUz40gVO+HNQWqmLxf67Z5WB64DRp0dhEbyHfel+6sJUg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@next/swc-darwin-x64": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-16.2.6.tgz", + "integrity": "sha512-v/YLBHIY132Ced3puBJ7YJKw1lqsCrgcNo2aRJlCEyQrrCeRJlvGlnmxhPxNQI3KE3N1DN5r9TPNPvka3nq5RQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@next/swc-linux-arm64-gnu": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-16.2.6.tgz", + "integrity": "sha512-RPOvqlYBbcQjkz9VQQDZ2T2bARIjXZV1KFlt+V2Mr6SW/e4I9fcKsaA0hdyf2FHoTlsV2xnBd5Y912rP/1Ce6w==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@next/swc-linux-arm64-musl": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-16.2.6.tgz", + "integrity": "sha512-URUTu1+dMkxJsPFgm+OeEvq9wf5sujw0EvgYy80TDGHTSLTnIHeqb0Eu8A3sC95IRgjejQL+kC4mw+4yPxiAXA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@next/swc-linux-x64-gnu": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-16.2.6.tgz", + "integrity": "sha512-DOj182mPV8G3UkrayLoREM5YEYI+Dk5wv7Ox9xl1fFibAELEsFD0lDPfHIeILlutMMfdyhlzYPELG3peuKaurw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@next/swc-linux-x64-musl": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-16.2.6.tgz", + "integrity": "sha512-HKQ5SP/V/ub73UvF7n/zeJlxk2kLmtL7Wzrg4WfmkjmNos5onJ2tKu7yZOPdL18A6Svfn3max29ym+ry7NkK4g==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@next/swc-win32-arm64-msvc": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-16.2.6.tgz", + "integrity": "sha512-LZXpTlPyS5v7HhSmnvsLGP3iIYgYOBnc8r8ArlT55sGHV89bR2HlDdBjWQ+PY6SJMmk8TuVGFuxalnP3k/0Dwg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@next/swc-win32-x64-msvc": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.2.6.tgz", + "integrity": "sha512-F0+4i0h9J6C4eE3EAPWsoCk7UW/dbzOjyzxY0qnDUOYFu6FFmdZ6l97/XdV3/Nz3VYyO7UWjyEJUXkGqcoXfMA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nolyfill/is-core-module": { + "version": "1.0.39", + "resolved": "https://registry.npmjs.org/@nolyfill/is-core-module/-/is-core-module-1.0.39.tgz", + "integrity": "sha512-nn5ozdjYQpUCZlWGuxcJY/KpxkWQs4DcbMCmKojjyrYDEAGy4Ce19NN4v5MduafTwJlbKc99UA8YhSVqq9yPZA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.4.0" + } + }, + "node_modules/@prisma/client": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/client/-/client-7.8.0.tgz", + "integrity": "sha512-HFp3Dawv/3sU3JtlPha90IB+48lS7zHiH4LKZPjmcE8YH5P9DOXGPvo8dqOtO7MqLDd1p2hOWMcFlRT1DMblHw==", + "license": "Apache-2.0", + "dependencies": { + "@prisma/client-runtime-utils": "7.8.0" + }, + "engines": { + "node": "^20.19 || ^22.12 || >=24.0" + }, + "peerDependencies": { + "prisma": "*", + "typescript": ">=5.4.0" + }, + "peerDependenciesMeta": { + "prisma": { + "optional": true + }, + "typescript": { + "optional": true + } + } + }, + "node_modules/@prisma/client-runtime-utils": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/client-runtime-utils/-/client-runtime-utils-7.8.0.tgz", + "integrity": "sha512-5NQZztQ0oY/ADFkmd9gPuweH5A1/CCY8YQPorLLO0Mu6a87mY5gsnDkzmFmIHs9NFaLnZojzgddFVN4RpKYrdw==", + "license": "Apache-2.0" + }, + "node_modules/@prisma/config": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/config/-/config-7.8.0.tgz", + "integrity": "sha512-HFESzd9rx2ZQxlK+TL7tu1HPvCqrHiL6LCxYykI2c34mvaUuIVVl3lYuicJD/MNnzgPnyeBEMlK4WTomJCV5jw==", + "license": "Apache-2.0", + "dependencies": { + "c12": "3.3.4", + "deepmerge-ts": "7.1.5", + "effect": "3.20.0", + "empathic": "2.0.0" + } + }, + "node_modules/@prisma/debug": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/debug/-/debug-7.8.0.tgz", + "integrity": "sha512-p+QZReysDUqXC+mk17q9a+Y/qzh4c2KYliDK30buYUyfrGeTGSyfmc0AIrJRhZJrLHhRiJa9Au/J72h3C+szvA==", + "license": "Apache-2.0" + }, + "node_modules/@prisma/dev": { + "version": "0.24.3", + "resolved": "https://registry.npmjs.org/@prisma/dev/-/dev-0.24.3.tgz", + "integrity": "sha512-ffHlQuKXZiaDt9Go0OnCTdJZrHxK0k7omJKNV86/VjpsXu5EIHZLK0T7JSWgvNlJwh56kW9JFu9v0qJciFzepg==", + "license": "ISC", + "dependencies": { + "@electric-sql/pglite": "0.4.1", + "@electric-sql/pglite-socket": "0.1.1", + "@electric-sql/pglite-tools": "0.3.1", + "@hono/node-server": "1.19.11", + "@prisma/get-platform": "7.2.0", + "@prisma/query-plan-executor": "7.2.0", + "@prisma/streams-local": "0.1.2", + "foreground-child": "3.3.1", + "get-port-please": "3.2.0", + "hono": "^4.12.8", + "http-status-codes": "2.3.0", + "pathe": "2.0.3", + "proper-lockfile": "4.1.2", + "remeda": "2.33.4", + "std-env": "3.10.0", + "valibot": "1.2.0", + "zeptomatch": "2.1.0" + } + }, + "node_modules/@prisma/engines": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/engines/-/engines-7.8.0.tgz", + "integrity": "sha512-jx3rCnNNrt5uzbkKlegtQ2GZHxSlihMCzutgT/BP6UIDF1r9tDI39hV/0T/cHZgzJ3ELbuQPXlVZy+Y1n0pcgw==", + "hasInstallScript": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.8.0", + "@prisma/engines-version": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "@prisma/fetch-engine": "7.8.0", + "@prisma/get-platform": "7.8.0" + } + }, + "node_modules/@prisma/engines-version": { + "version": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "resolved": "https://registry.npmjs.org/@prisma/engines-version/-/engines-version-7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a.tgz", + "integrity": "sha512-fJPQxCkLgA5EayWaW8eArgCvjJ+N+Kz3VyeNKMEeYiQC4alNkxRKFVAGxv/ZUzuJISKqdw+zGeDbS6mn6RCPOA==", + "license": "Apache-2.0" + }, + "node_modules/@prisma/engines/node_modules/@prisma/get-platform": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/get-platform/-/get-platform-7.8.0.tgz", + "integrity": "sha512-WlxgRGnolL8VH2EmkH1R/DkKNr/mVdS3G2h42IZFFZ3eUrH9OT6t73kIOSlkkrv50wG123Iq8d96ufv5LlZktw==", + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.8.0" + } + }, + "node_modules/@prisma/fetch-engine": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/fetch-engine/-/fetch-engine-7.8.0.tgz", + "integrity": "sha512-gwB0Euiz/DDRyxFRpLXYlK3RfaZUj1c5dAYMuhZYfApg7arknJlcb9bIsOHDppJmbqYaVA+yBIiFMDBfprsNPQ==", + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.8.0", + "@prisma/engines-version": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "@prisma/get-platform": "7.8.0" + } + }, + "node_modules/@prisma/fetch-engine/node_modules/@prisma/get-platform": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/get-platform/-/get-platform-7.8.0.tgz", + "integrity": "sha512-WlxgRGnolL8VH2EmkH1R/DkKNr/mVdS3G2h42IZFFZ3eUrH9OT6t73kIOSlkkrv50wG123Iq8d96ufv5LlZktw==", + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.8.0" + } + }, + "node_modules/@prisma/get-platform": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/@prisma/get-platform/-/get-platform-7.2.0.tgz", + "integrity": "sha512-k1V0l0Td1732EHpAfi2eySTezyllok9dXb6UQanajkJQzPUGi3vO2z7jdkz67SypFTdmbnyGYxvEvYZdZsMAVA==", + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.2.0" + } + }, + "node_modules/@prisma/get-platform/node_modules/@prisma/debug": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/@prisma/debug/-/debug-7.2.0.tgz", + "integrity": "sha512-YSGTiSlBAVJPzX4ONZmMotL+ozJwQjRmZweQNIq/ER0tQJKJynNkRB3kyvt37eOfsbMCXk3gnLF6J9OJ4QWftw==", + "license": "Apache-2.0" + }, + "node_modules/@prisma/query-plan-executor": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/@prisma/query-plan-executor/-/query-plan-executor-7.2.0.tgz", + "integrity": "sha512-EOZmNzcV8uJ0mae3DhTsiHgoNCuu1J9mULQpGCh62zN3PxPTd+qI9tJvk5jOst8WHKQNwJWR3b39t0XvfBB0WQ==", + "license": "Apache-2.0" + }, + "node_modules/@prisma/streams-local": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/@prisma/streams-local/-/streams-local-0.1.2.tgz", + "integrity": "sha512-l49yTxKKF2odFxaAXTmwmkBKL3+bVQ1tFOooGifu4xkdb9NMNLxHj27XAhTylWZod8I+ISGM5erU1xcl/oBCtg==", + "license": "Apache-2.0", + "dependencies": { + "ajv": "^8.12.0", + "better-result": "^2.7.0", + "env-paths": "^3.0.0", + "proper-lockfile": "^4.1.2" + }, + "engines": { + "bun": ">=1.3.6", + "node": ">=22.0.0" + } + }, + "node_modules/@prisma/streams-local/node_modules/ajv": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz", + "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/@prisma/streams-local/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/@prisma/studio-core": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@prisma/studio-core/-/studio-core-0.27.3.tgz", + "integrity": "sha512-AADjNFPdsrglxHQVTmHFqv6DuKQZ5WY4p5/gVFY017twvNrSwpLJ9lqUbYYxEu2W7nbvVxTZA8deJ8LseNALsw==", + "license": "Apache-2.0", + "dependencies": { + "@radix-ui/react-toggle": "1.1.10", + "chart.js": "4.5.1" + }, + "engines": { + "node": "^20.19 || ^22.12 || >=24.0", + "pnpm": "8" + }, + "peerDependencies": { + "@types/react": "^18.0.0 || ^19.0.0", + "react": "^18.0.0 || ^19.0.0", + "react-dom": "^18.0.0 || ^19.0.0" + } + }, + "node_modules/@radix-ui/primitive": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/@radix-ui/primitive/-/primitive-1.1.3.tgz", + "integrity": "sha512-JTF99U/6XIjCBo0wqkU5sK10glYe27MRRsfwoiq5zzOEZLHU3A3KCMa5X/azekYRCJ0HlwI0crAXS/5dEHTzDg==", + "license": "MIT" + }, + "node_modules/@radix-ui/react-compose-refs": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@radix-ui/react-compose-refs/-/react-compose-refs-1.1.2.tgz", + "integrity": "sha512-z4eqJvfiNnFMHIIvXP3CY57y2WJs5g2v3X0zm9mEJkrkNv4rDxu+sg9Jh8EkXyeqBkB7SOcboo9dMVqhyrACIg==", + "license": "MIT", + "peerDependencies": { + "@types/react": "*", + "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@radix-ui/react-primitive": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/@radix-ui/react-primitive/-/react-primitive-2.1.3.tgz", + "integrity": "sha512-m9gTwRkhy2lvCPe6QJp4d3G1TYEUHn/FzJUtq9MjH46an1wJU+GdoGC5VLof8RX8Ft/DlpshApkhswDLZzHIcQ==", + "license": "MIT", + "dependencies": { + "@radix-ui/react-slot": "1.2.3" + }, + "peerDependencies": { + "@types/react": "*", + "@types/react-dom": "*", + "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", + "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + }, + "@types/react-dom": { + "optional": true + } + } + }, + "node_modules/@radix-ui/react-slot": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/@radix-ui/react-slot/-/react-slot-1.2.3.tgz", + "integrity": "sha512-aeNmHnBxbi2St0au6VBVC7JXFlhLlOnvIIlePNniyUNAClzmtAUEY8/pBiK3iHjufOlwA+c20/8jngo7xcrg8A==", + "license": "MIT", + "dependencies": { + "@radix-ui/react-compose-refs": "1.1.2" + }, + "peerDependencies": { + "@types/react": "*", + "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@radix-ui/react-toggle": { + "version": "1.1.10", + "resolved": "https://registry.npmjs.org/@radix-ui/react-toggle/-/react-toggle-1.1.10.tgz", + "integrity": "sha512-lS1odchhFTeZv3xwHH31YPObmJn8gOg7Lq12inrr0+BH/l3Tsq32VfjqH1oh80ARM3mlkfMic15n0kg4sD1poQ==", + "license": "MIT", + "dependencies": { + "@radix-ui/primitive": "1.1.3", + "@radix-ui/react-primitive": "2.1.3", + "@radix-ui/react-use-controllable-state": "1.2.2" + }, + "peerDependencies": { + "@types/react": "*", + "@types/react-dom": "*", + "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", + "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + }, + "@types/react-dom": { + "optional": true + } + } + }, + "node_modules/@radix-ui/react-use-controllable-state": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/@radix-ui/react-use-controllable-state/-/react-use-controllable-state-1.2.2.tgz", + "integrity": "sha512-BjasUjixPFdS+NKkypcyyN5Pmg83Olst0+c6vGov0diwTEo6mgdqVR6hxcEgFuh4QrAs7Rc+9KuGJ9TVCj0Zzg==", + "license": "MIT", + "dependencies": { + "@radix-ui/react-use-effect-event": "0.0.2", + "@radix-ui/react-use-layout-effect": "1.1.1" + }, + "peerDependencies": { + "@types/react": "*", + "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@radix-ui/react-use-effect-event": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/@radix-ui/react-use-effect-event/-/react-use-effect-event-0.0.2.tgz", + "integrity": "sha512-Qp8WbZOBe+blgpuUT+lw2xheLP8q0oatc9UpmiemEICxGvFLYmHm9QowVZGHtJlGbS6A6yJ3iViad/2cVjnOiA==", + "license": "MIT", + "dependencies": { + "@radix-ui/react-use-layout-effect": "1.1.1" + }, + "peerDependencies": { + "@types/react": "*", + "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@radix-ui/react-use-layout-effect": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@radix-ui/react-use-layout-effect/-/react-use-layout-effect-1.1.1.tgz", + "integrity": "sha512-RbJRS4UWQFkzHTTwVymMTUv8EqYhOp8dOOviLj2ugtTiXRaRQS7GLGxZTLL1jWhMeoSCf5zmcZkqTl9IiYfXcQ==", + "license": "MIT", + "peerDependencies": { + "@types/react": "*", + "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@rtsao/scc": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@rtsao/scc/-/scc-1.1.0.tgz", + "integrity": "sha512-zt6OdqaDoOnJ1ZYsCYGt9YmWzDXl4vQdKTyJev62gFhRGKdx7mcT54V9KIjg+d2wi9EXsPvAPKe7i7WjfVWB8g==", + "dev": true, + "license": "MIT" + }, + "node_modules/@standard-schema/spec": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz", + "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==", + "license": "MIT" + }, + "node_modules/@swc/helpers": { + "version": "0.5.15", + "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.15.tgz", + "integrity": "sha512-JQ5TuMi45Owi4/BIMAJBoSQoOJu12oOk/gADqlcUL9JEdHB8vyjUSsxqeNXnmXHjYKMi2WcYtezGEEhqUI/E2g==", + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.8.0" + } + }, + "node_modules/@tailwindcss/node": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/node/-/node-4.3.0.tgz", + "integrity": "sha512-aFb4gUhFOgdh9AXo4IzBEOzBkkAxm9VigwDJnMIYv3lcfXCJVesNfbEaBl4BNgVRyid92AmdviqwBUBRKSeY3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/remapping": "^2.3.5", + "enhanced-resolve": "^5.21.0", + "jiti": "^2.6.1", + "lightningcss": "1.32.0", + "magic-string": "^0.30.21", + "source-map-js": "^1.2.1", + "tailwindcss": "4.3.0" + } + }, + "node_modules/@tailwindcss/oxide": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide/-/oxide-4.3.0.tgz", + "integrity": "sha512-F7HZGBeN9I0/AuuJS5PwcD8xayx5ri5GhjYUDBEVYUkexyA/giwbDNjRVrxSezE3T250OU2K/wp/ltWx3UOefg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 20" + }, + "optionalDependencies": { + "@tailwindcss/oxide-android-arm64": "4.3.0", + "@tailwindcss/oxide-darwin-arm64": "4.3.0", + "@tailwindcss/oxide-darwin-x64": "4.3.0", + "@tailwindcss/oxide-freebsd-x64": "4.3.0", + "@tailwindcss/oxide-linux-arm-gnueabihf": "4.3.0", + "@tailwindcss/oxide-linux-arm64-gnu": "4.3.0", + "@tailwindcss/oxide-linux-arm64-musl": "4.3.0", + "@tailwindcss/oxide-linux-x64-gnu": "4.3.0", + "@tailwindcss/oxide-linux-x64-musl": "4.3.0", + "@tailwindcss/oxide-wasm32-wasi": "4.3.0", + "@tailwindcss/oxide-win32-arm64-msvc": "4.3.0", + "@tailwindcss/oxide-win32-x64-msvc": "4.3.0" + } + }, + "node_modules/@tailwindcss/oxide-android-arm64": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-android-arm64/-/oxide-android-arm64-4.3.0.tgz", + "integrity": "sha512-TJPiq67tKlLuObP6RkwvVGDoxCMBVtDgKkLfa/uyj7/FyxvQwHS+UOnVrXXgbEsfUaMgiVvC4KbJnRr26ho4Ng==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-darwin-arm64": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-arm64/-/oxide-darwin-arm64-4.3.0.tgz", + "integrity": "sha512-oMN/WZRb+SO37BmUElEgeEWuU8E/HXRkiODxJxLe1UTHVXLrdVSgfaJV7pSlhRGMSOiXLuxTIjfsF3wYvz8cgQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-darwin-x64": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-x64/-/oxide-darwin-x64-4.3.0.tgz", + "integrity": "sha512-N6CUmu4a6bKVADfw77p+iw6Yd9Q3OBhe0veaDX+QazfuVYlQsHfDgxBrsjQ/IW+zywL8mTrNd0SdJT/zgtvMdA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-freebsd-x64": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-freebsd-x64/-/oxide-freebsd-x64-4.3.0.tgz", + "integrity": "sha512-zDL5hBkQdH5C6MpqbK3gQAgP80tsMwSI26vjOzjJtNCMUo0lFgOItzHKBIupOZNQxt3ouPH7RPhvNhiTfCe5CQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm-gnueabihf": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm-gnueabihf/-/oxide-linux-arm-gnueabihf-4.3.0.tgz", + "integrity": "sha512-R06HdNi7A7OEoMsf6d4tjZ71RCWnZQPHj2mnotSFURjNLdBC+cIgXQ7l81CqeoiQftjf6OOblxXMInMgN2VzMA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm64-gnu": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-gnu/-/oxide-linux-arm64-gnu-4.3.0.tgz", + "integrity": "sha512-qTJHELX8jetjhRQHCLilkVLmybpzNQAtaI/gaoVoidn/ufbNDbAo8KlK2J+yPoc8wQxvDxCmh/5lr8nC1+lTbg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm64-musl": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-musl/-/oxide-linux-arm64-musl-4.3.0.tgz", + "integrity": "sha512-Z6sukiQsngnWO+l39X4pPbiWT81IC+PLKF+PHxIlyZbGNb9MODfYlXEVlFvej5BOZInWX01kVyzeLvHsXhfczQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-x64-gnu": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-gnu/-/oxide-linux-x64-gnu-4.3.0.tgz", + "integrity": "sha512-DRNdQRpSGzRGfARVuVkxvM8Q12nh19l4BF/G7zGA1oe+9wcC6saFBHTISrpIcKzhiXtSrlSrluCfvMuledoCTQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-x64-musl": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-musl/-/oxide-linux-x64-musl-4.3.0.tgz", + "integrity": "sha512-Z0IADbDo8bh6I7h2IQMx601AdXBLfFpEdUotft86evd/8ZPflZe9COPO8Q1vw+pfLWIUo9zN/JGZvwuAJqduqg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-wasm32-wasi/-/oxide-wasm32-wasi-4.3.0.tgz", + "integrity": "sha512-HNZGOUxEmElksYR7S6sC5jTeNGpobAsy9u7Gu0AskJ8/20FR9GqebUyB+HBcU/ax6BHuiuJi+Oda4B+YX6H1yA==", + "bundleDependencies": [ + "@napi-rs/wasm-runtime", + "@emnapi/core", + "@emnapi/runtime", + "@tybys/wasm-util", + "@emnapi/wasi-threads", + "tslib" + ], + "cpu": [ + "wasm32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/core": "^1.10.0", + "@emnapi/runtime": "^1.10.0", + "@emnapi/wasi-threads": "^1.2.1", + "@napi-rs/wasm-runtime": "^1.1.4", + "@tybys/wasm-util": "^0.10.1", + "tslib": "^2.8.1" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@tailwindcss/oxide-win32-arm64-msvc": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.3.0.tgz", + "integrity": "sha512-Pe+RPVTi1T+qymuuRpcdvwSVZjnll/f7n8gBxMMh3xLTctMDKqpdfGimbMyioqtLhUYZxdJ9wGNhV7MKHvgZsQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-win32-x64-msvc": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-x64-msvc/-/oxide-win32-x64-msvc-4.3.0.tgz", + "integrity": "sha512-Mvrf2kXW/yeW/OTezZlCGOirXRcUuLIBx/5Y12BaPM7wJoryG6dfS/NJL8aBPqtTEx/Vm4T4vKzFUcKDT+TKUA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/postcss": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@tailwindcss/postcss/-/postcss-4.3.0.tgz", + "integrity": "sha512-Jm05Tjx+9yCLGv5qw1c+84Psds8MnyrEQYCB+FFk2lgGiUjlRqdxke4mVTuYrj2xnVZqKim2Apr5ySuQRYAw/w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@alloc/quick-lru": "^5.2.0", + "@tailwindcss/node": "4.3.0", + "@tailwindcss/oxide": "4.3.0", + "postcss": "^8.5.10", + "tailwindcss": "4.3.0" + } + }, + "node_modules/@tanstack/query-core": { + "version": "5.100.10", + "resolved": "https://registry.npmjs.org/@tanstack/query-core/-/query-core-5.100.10.tgz", + "integrity": "sha512-8UR0yJR+GiQ40m3lPhUr0xbfAupe6GSQiksSBSa9SM2NjezFyxXCIA69/lz8cSoNKZLrw1/PktIyQBJcVeMi3w==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + } + }, + "node_modules/@tanstack/react-query": { + "version": "5.100.10", + "resolved": "https://registry.npmjs.org/@tanstack/react-query/-/react-query-5.100.10.tgz", + "integrity": "sha512-FLaZf2RCrA/Zgp4aiu5tG3TyasTRO7aZ99skxQpr3Hg/zXOhu6yq5FZCYQ/tRaJtM9ylnoK8tFK7PolXQadv6Q==", + "license": "MIT", + "dependencies": { + "@tanstack/query-core": "5.100.10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + }, + "peerDependencies": { + "react": "^18 || ^19" + } + }, + "node_modules/@tybys/wasm-util": { + "version": "0.10.2", + "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.2.tgz", + "integrity": "sha512-RoBvJ2X0wuKlWFIjrwffGw1IqZHKQqzIchKaadZZfnNpsAYp2mM0h36JtPCjNDAHGgYez/15uMBpfGwchhiMgg==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@types/d3": { + "version": "7.4.3", + "resolved": "https://registry.npmjs.org/@types/d3/-/d3-7.4.3.tgz", + "integrity": "sha512-lZXZ9ckh5R8uiFVt8ogUNf+pIrK4EsWrx2Np75WvF/eTpJ0FMHNhjXk8CKEx/+gpHbNQyJWehbFaTvqmHWB3ww==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-array": "*", + "@types/d3-axis": "*", + "@types/d3-brush": "*", + "@types/d3-chord": "*", + "@types/d3-color": "*", + "@types/d3-contour": "*", + "@types/d3-delaunay": "*", + "@types/d3-dispatch": "*", + "@types/d3-drag": "*", + "@types/d3-dsv": "*", + "@types/d3-ease": "*", + "@types/d3-fetch": "*", + "@types/d3-force": "*", + "@types/d3-format": "*", + "@types/d3-geo": "*", + "@types/d3-hierarchy": "*", + "@types/d3-interpolate": "*", + "@types/d3-path": "*", + "@types/d3-polygon": "*", + "@types/d3-quadtree": "*", + "@types/d3-random": "*", + "@types/d3-scale": "*", + "@types/d3-scale-chromatic": "*", + "@types/d3-selection": "*", + "@types/d3-shape": "*", + "@types/d3-time": "*", + "@types/d3-time-format": "*", + "@types/d3-timer": "*", + "@types/d3-transition": "*", + "@types/d3-zoom": "*" + } + }, + "node_modules/@types/d3-array": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/@types/d3-array/-/d3-array-3.2.2.tgz", + "integrity": "sha512-hOLWVbm7uRza0BYXpIIW5pxfrKe0W+D5lrFiAEYR+pb6w3N2SwSMaJbXdUfSEv+dT4MfHBLtn5js0LAWaO6otw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-axis": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/@types/d3-axis/-/d3-axis-3.0.6.tgz", + "integrity": "sha512-pYeijfZuBd87T0hGn0FO1vQ/cgLk6E1ALJjfkC0oJ8cbwkZl3TpgS8bVBLZN+2jjGgg38epgxb2zmoGtSfvgMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-selection": "*" + } + }, + "node_modules/@types/d3-brush": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/@types/d3-brush/-/d3-brush-3.0.6.tgz", + "integrity": "sha512-nH60IZNNxEcrh6L1ZSMNA28rj27ut/2ZmI3r96Zd+1jrZD++zD3LsMIjWlvg4AYrHn/Pqz4CF3veCxGjtbqt7A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-selection": "*" + } + }, + "node_modules/@types/d3-chord": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/@types/d3-chord/-/d3-chord-3.0.6.tgz", + "integrity": "sha512-LFYWWd8nwfwEmTZG9PfQxd17HbNPksHBiJHaKuY1XeqscXacsS2tyoo6OdRsjf+NQYeB6XrNL3a25E3gH69lcg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-color": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/@types/d3-color/-/d3-color-3.1.3.tgz", + "integrity": "sha512-iO90scth9WAbmgv7ogoq57O9YpKmFBbmoEoCHDB2xMBY0+/KVrqAaCDyCE16dUspeOvIxFFRI+0sEtqDqy2b4A==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-contour": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/@types/d3-contour/-/d3-contour-3.0.6.tgz", + "integrity": "sha512-BjzLgXGnCWjUSYGfH1cpdo41/hgdWETu4YxpezoztawmqsvCeep+8QGfiY6YbDvfgHz/DkjeIkkZVJavB4a3rg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-array": "*", + "@types/geojson": "*" + } + }, + "node_modules/@types/d3-delaunay": { + "version": "6.0.4", + "resolved": "https://registry.npmjs.org/@types/d3-delaunay/-/d3-delaunay-6.0.4.tgz", + "integrity": "sha512-ZMaSKu4THYCU6sV64Lhg6qjf1orxBthaC161plr5KuPHo3CNm8DTHiLw/5Eq2b6TsNP0W0iJrUOFscY6Q450Hw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-dispatch": { + "version": "3.0.7", + "resolved": "https://registry.npmjs.org/@types/d3-dispatch/-/d3-dispatch-3.0.7.tgz", + "integrity": "sha512-5o9OIAdKkhN1QItV2oqaE5KMIiXAvDWBDPrD85e58Qlz1c1kI/J0NcqbEG88CoTwJrYe7ntUCVfeUl2UJKbWgA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-drag": { + "version": "3.0.7", + "resolved": "https://registry.npmjs.org/@types/d3-drag/-/d3-drag-3.0.7.tgz", + "integrity": "sha512-HE3jVKlzU9AaMazNufooRJ5ZpWmLIoc90A37WU2JMmeq28w1FQqCZswHZ3xR+SuxYftzHq6WU6KJHvqxKzTxxQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-selection": "*" + } + }, + "node_modules/@types/d3-dsv": { + "version": "3.0.7", + "resolved": "https://registry.npmjs.org/@types/d3-dsv/-/d3-dsv-3.0.7.tgz", + "integrity": "sha512-n6QBF9/+XASqcKK6waudgL0pf/S5XHPPI8APyMLLUHd8NqouBGLsU8MgtO7NINGtPBtk9Kko/W4ea0oAspwh9g==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-ease": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@types/d3-ease/-/d3-ease-3.0.2.tgz", + "integrity": "sha512-NcV1JjO5oDzoK26oMzbILE6HW7uVXOHLQvHshBUW4UMdZGfiY6v5BeQwh9a9tCzv+CeefZQHJt5SRgK154RtiA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-fetch": { + "version": "3.0.7", + "resolved": "https://registry.npmjs.org/@types/d3-fetch/-/d3-fetch-3.0.7.tgz", + "integrity": "sha512-fTAfNmxSb9SOWNB9IoG5c8Hg6R+AzUHDRlsXsDZsNp6sxAEOP0tkP3gKkNSO/qmHPoBFTxNrjDprVHDQDvo5aA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-dsv": "*" + } + }, + "node_modules/@types/d3-force": { + "version": "3.0.10", + "resolved": "https://registry.npmjs.org/@types/d3-force/-/d3-force-3.0.10.tgz", + "integrity": "sha512-ZYeSaCF3p73RdOKcjj+swRlZfnYpK1EbaDiYICEEp5Q6sUiqFaFQ9qgoshp5CzIyyb/yD09kD9o2zEltCexlgw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-format": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/d3-format/-/d3-format-3.0.4.tgz", + "integrity": "sha512-fALi2aI6shfg7vM5KiR1wNJnZ7r6UuggVqtDA+xiEdPZQwy/trcQaHnwShLuLdta2rTymCNpxYTiMZX/e09F4g==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-geo": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@types/d3-geo/-/d3-geo-3.1.0.tgz", + "integrity": "sha512-856sckF0oP/diXtS4jNsiQw/UuK5fQG8l/a9VVLeSouf1/PPbBE1i1W852zVwKwYCBkFJJB7nCFTbk6UMEXBOQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/geojson": "*" + } + }, + "node_modules/@types/d3-hierarchy": { + "version": "3.1.7", + "resolved": "https://registry.npmjs.org/@types/d3-hierarchy/-/d3-hierarchy-3.1.7.tgz", + "integrity": "sha512-tJFtNoYBtRtkNysX1Xq4sxtjK8YgoWUNpIiUee0/jHGRwqvzYxkq0hGVbbOGSz+JgFxxRu4K8nb3YpG3CMARtg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-interpolate": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/d3-interpolate/-/d3-interpolate-3.0.4.tgz", + "integrity": "sha512-mgLPETlrpVV1YRJIglr4Ez47g7Yxjl1lj7YKsiMCb27VJH9W8NVM6Bb9d8kkpG/uAQS5AmbA48q2IAolKKo1MA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-color": "*" + } + }, + "node_modules/@types/d3-path": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/@types/d3-path/-/d3-path-3.1.1.tgz", + "integrity": "sha512-VMZBYyQvbGmWyWVea0EHs/BwLgxc+MKi1zLDCONksozI4YJMcTt8ZEuIR4Sb1MMTE8MMW49v0IwI5+b7RmfWlg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-polygon": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@types/d3-polygon/-/d3-polygon-3.0.2.tgz", + "integrity": "sha512-ZuWOtMaHCkN9xoeEMr1ubW2nGWsp4nIql+OPQRstu4ypeZ+zk3YKqQT0CXVe/PYqrKpZAi+J9mTs05TKwjXSRA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-quadtree": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/@types/d3-quadtree/-/d3-quadtree-3.0.6.tgz", + "integrity": "sha512-oUzyO1/Zm6rsxKRHA1vH0NEDG58HrT5icx/azi9MF1TWdtttWl0UIUsjEQBBh+SIkrpd21ZjEv7ptxWys1ncsg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-random": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@types/d3-random/-/d3-random-3.0.3.tgz", + "integrity": "sha512-Imagg1vJ3y76Y2ea0871wpabqp613+8/r0mCLEBfdtqC7xMSfj9idOnmBYyMoULfHePJyxMAw3nWhJxzc+LFwQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-scale": { + "version": "4.0.9", + "resolved": "https://registry.npmjs.org/@types/d3-scale/-/d3-scale-4.0.9.tgz", + "integrity": "sha512-dLmtwB8zkAeO/juAMfnV+sItKjlsw2lKdZVVy6LRr0cBmegxSABiLEpGVmSJJ8O08i4+sGR6qQtb6WtuwJdvVw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-time": "*" + } + }, + "node_modules/@types/d3-scale-chromatic": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@types/d3-scale-chromatic/-/d3-scale-chromatic-3.1.0.tgz", + "integrity": "sha512-iWMJgwkK7yTRmWqRB5plb1kadXyQ5Sj8V/zYlFGMUBbIPKQScw+Dku9cAAMgJG+z5GYDoMjWGLVOvjghDEFnKQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-selection": { + "version": "3.0.11", + "resolved": "https://registry.npmjs.org/@types/d3-selection/-/d3-selection-3.0.11.tgz", + "integrity": "sha512-bhAXu23DJWsrI45xafYpkQ4NtcKMwWnAC/vKrd2l+nxMFuvOT3XMYTIj2opv8vq8AO5Yh7Qac/nSeP/3zjTK0w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-shape": { + "version": "3.1.8", + "resolved": "https://registry.npmjs.org/@types/d3-shape/-/d3-shape-3.1.8.tgz", + "integrity": "sha512-lae0iWfcDeR7qt7rA88BNiqdvPS5pFVPpo5OfjElwNaT2yyekbM0C9vK+yqBqEmHr6lDkRnYNoTBYlAgJa7a4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-path": "*" + } + }, + "node_modules/@types/d3-time": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/d3-time/-/d3-time-3.0.4.tgz", + "integrity": "sha512-yuzZug1nkAAaBlBBikKZTgzCeA+k1uy4ZFwWANOfKw5z5LRhV0gNA7gNkKm7HoK+HRN0wX3EkxGk0fpbWhmB7g==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-time-format": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/@types/d3-time-format/-/d3-time-format-4.0.3.tgz", + "integrity": "sha512-5xg9rC+wWL8kdDj153qZcsJ0FWiFt0J5RB6LYUNZjwSnesfblqrI/bJ1wBdJ8OQfncgbJG5+2F+qfqnqyzYxyg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-timer": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@types/d3-timer/-/d3-timer-3.0.2.tgz", + "integrity": "sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/d3-transition": { + "version": "3.0.9", + "resolved": "https://registry.npmjs.org/@types/d3-transition/-/d3-transition-3.0.9.tgz", + "integrity": "sha512-uZS5shfxzO3rGlu0cC3bjmMFKsXv+SmZZcgp0KD22ts4uGXp5EVYGzu/0YdwZeKmddhcAccYtREJKkPfXkZuCg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-selection": "*" + } + }, + "node_modules/@types/d3-zoom": { + "version": "3.0.8", + "resolved": "https://registry.npmjs.org/@types/d3-zoom/-/d3-zoom-3.0.8.tgz", + "integrity": "sha512-iqMC4/YlFCSlO8+2Ii1GGGliCAY4XdeG748w5vQUbevlbDu0zSjH/+jojorQVBK/se0j6DUFNPBGSqD3YWYnDw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/d3-interpolate": "*", + "@types/d3-selection": "*" + } + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/geojson": { + "version": "7946.0.16", + "resolved": "https://registry.npmjs.org/@types/geojson/-/geojson-7946.0.16.tgz", + "integrity": "sha512-6C8nqWur3j98U6+lXDfTUWIfgvZU+EumvpHKcYjujKH7woYyLj2sUmff0tRhrqM7BohUw7Pz3ZB1jj2gW9Fvmg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/json5": { + "version": "0.0.29", + "resolved": "https://registry.npmjs.org/@types/json5/-/json5-0.0.29.tgz", + "integrity": "sha512-dRLjCWHYg4oaA77cxO64oO+7JwCwnIzkZPdrrC71jQmQtlhM556pwKo5bUzqvZndkVbeFLIIi+9TC40JNF5hNQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/jsonwebtoken": { + "version": "9.0.10", + "resolved": "https://registry.npmjs.org/@types/jsonwebtoken/-/jsonwebtoken-9.0.10.tgz", + "integrity": "sha512-asx5hIG9Qmf/1oStypjanR7iKTv0gXQ1Ov/jfrX6kS/EO0OFni8orbmGCn0672NHR3kXHwpAwR+B368ZGN/2rA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/ms": "*", + "@types/node": "*" + } + }, + "node_modules/@types/ms": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz", + "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/node": { + "version": "20.19.41", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.41.tgz", + "integrity": "sha512-ECymXOukMnOoVkC2bb1Vc/w/836DXncOg5m8Xj1RH7xSHZJWNYY6Zh7EH477vcnD5egKNNfy2RpNOmuChhFPgQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "undici-types": "~6.21.0" + } + }, + "node_modules/@types/react": { + "version": "19.2.14", + "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.14.tgz", + "integrity": "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w==", + "license": "MIT", + "dependencies": { + "csstype": "^3.2.2" + } + }, + "node_modules/@types/react-dom": { + "version": "19.2.3", + "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-19.2.3.tgz", + "integrity": "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==", + "devOptional": true, + "license": "MIT", + "peerDependencies": { + "@types/react": "^19.2.0" + } + }, + "node_modules/@typescript-eslint/eslint-plugin": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.59.3.tgz", + "integrity": "sha512-PwFvSKsXGShKGW6n5bZOhGHEcCZXM8HofLK9fNsEwZXzFRjoY+XT1Vsf1zgyXdwTr0ZYz1/2tkZ0DBTT9jZjhw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/regexpp": "^4.12.2", + "@typescript-eslint/scope-manager": "8.59.3", + "@typescript-eslint/type-utils": "8.59.3", + "@typescript-eslint/utils": "8.59.3", + "@typescript-eslint/visitor-keys": "8.59.3", + "ignore": "^7.0.5", + "natural-compare": "^1.4.0", + "ts-api-utils": "^2.5.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "@typescript-eslint/parser": "^8.59.3", + "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0", + "typescript": ">=4.8.4 <6.1.0" + } + }, + "node_modules/@typescript-eslint/eslint-plugin/node_modules/ignore": { + "version": "7.0.5", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz", + "integrity": "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/@typescript-eslint/parser": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.59.3.tgz", + "integrity": "sha512-HPwA+hVkfcriajbNvTmZv4VRauibay+cWArYUYq7u7W7PmGShMxbPxLvrwDme55a6d5alG3nrYfhyJ/G28XlLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/scope-manager": "8.59.3", + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/typescript-estree": "8.59.3", + "@typescript-eslint/visitor-keys": "8.59.3", + "debug": "^4.4.3" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0", + "typescript": ">=4.8.4 <6.1.0" + } + }, + "node_modules/@typescript-eslint/project-service": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.59.3.tgz", + "integrity": "sha512-ECiUWa/KYRGDFUqTNehaRgzDshnJfkTABJxVemHk4ko22gcr0ukloKjWvyQ64g8YCV/UI47kN1dbmjf/GaQYng==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/tsconfig-utils": "^8.59.3", + "@typescript-eslint/types": "^8.59.3", + "debug": "^4.4.3" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <6.1.0" + } + }, + "node_modules/@typescript-eslint/scope-manager": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.59.3.tgz", + "integrity": "sha512-t2LvZnoEfzKtnPjgeEu41xw5gxq9mQVfYy4OoZ4Vlt0sk3JwxmhCca/AR7DwOiHrjWgjAj6as4AhRLKSDfvZIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/visitor-keys": "8.59.3" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/tsconfig-utils": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.59.3.tgz", + "integrity": "sha512-PcIJHjmaREXLgIAIzLnSY9VucEzz8FKXsRgFa1DmdGCK/5tJpW03TKJF01Q6VZd1lLdz2sIKPWaDUZN9dp//dw==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <6.1.0" + } + }, + "node_modules/@typescript-eslint/type-utils": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.59.3.tgz", + "integrity": "sha512-g71d8QD8UaiHGvrJwyIS1hCX5r63w6Jll+4VEYhEAHXTDIqX1JgxhTAbEHtKntL9kuc4jRo7/GWw5xfCepSccQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/typescript-estree": "8.59.3", + "@typescript-eslint/utils": "8.59.3", + "debug": "^4.4.3", + "ts-api-utils": "^2.5.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0", + "typescript": ">=4.8.4 <6.1.0" + } + }, + "node_modules/@typescript-eslint/types": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.59.3.tgz", + "integrity": "sha512-ePFoH0g4ludssdRFqqDxQePCxU4WQyRa9+XVwjm7yLn0FKhMeoetC+qBEEI1Eyb1pGSDveTIT09Bvw2WhlGayg==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/typescript-estree": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.59.3.tgz", + "integrity": "sha512-CbRjVRAf7Lr9Kr8RopKcbY45p2VfmmHrm0ygOCYFi7oU8q19m0Fs/6iHS7kNOmwpp+ob07ZVcAqlxUod9lYdmg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/project-service": "8.59.3", + "@typescript-eslint/tsconfig-utils": "8.59.3", + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/visitor-keys": "8.59.3", + "debug": "^4.4.3", + "minimatch": "^10.2.2", + "semver": "^7.7.3", + "tinyglobby": "^0.2.15", + "ts-api-utils": "^2.5.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <6.1.0" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": { + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz", + "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": { + "version": "10.2.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", + "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.5" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/semver": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.0.tgz", + "integrity": "sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/@typescript-eslint/utils": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.59.3.tgz", + "integrity": "sha512-JAvT14goBzRzzzZyqq3P9BLArIxTtQURUtFgQ/V7FO+eU+Gg6ES+5ymOPP1wRxXcxAYeivCk4uS3jCKWI1K8Zg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.9.1", + "@typescript-eslint/scope-manager": "8.59.3", + "@typescript-eslint/types": "8.59.3", + "@typescript-eslint/typescript-estree": "8.59.3" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0", + "typescript": ">=4.8.4 <6.1.0" + } + }, + "node_modules/@typescript-eslint/visitor-keys": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.59.3.tgz", + "integrity": "sha512-f1UQF7ggd42YiwI5wGrRaPsa+P0CINBlrkLPmGfpq/u/I/oVtecoEIfFR9ag/oa1sLOsRNZ6xehf6qMZhQGBDg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.59.3", + "eslint-visitor-keys": "^5.0.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/visitor-keys/node_modules/eslint-visitor-keys": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-5.0.1.tgz", + "integrity": "sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@unrs/resolver-binding-android-arm-eabi": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-android-arm-eabi/-/resolver-binding-android-arm-eabi-1.11.1.tgz", + "integrity": "sha512-ppLRUgHVaGRWUx0R0Ut06Mjo9gBaBkg3v/8AxusGLhsIotbBLuRk51rAzqLC8gq6NyyAojEXglNjzf6R948DNw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@unrs/resolver-binding-android-arm64": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-android-arm64/-/resolver-binding-android-arm64-1.11.1.tgz", + "integrity": "sha512-lCxkVtb4wp1v+EoN+HjIG9cIIzPkX5OtM03pQYkG+U5O/wL53LC4QbIeazgiKqluGeVEeBlZahHalCaBvU1a2g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@unrs/resolver-binding-darwin-arm64": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-darwin-arm64/-/resolver-binding-darwin-arm64-1.11.1.tgz", + "integrity": "sha512-gPVA1UjRu1Y/IsB/dQEsp2V1pm44Of6+LWvbLc9SDk1c2KhhDRDBUkQCYVWe6f26uJb3fOK8saWMgtX8IrMk3g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@unrs/resolver-binding-darwin-x64": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-darwin-x64/-/resolver-binding-darwin-x64-1.11.1.tgz", + "integrity": "sha512-cFzP7rWKd3lZaCsDze07QX1SC24lO8mPty9vdP+YVa3MGdVgPmFc59317b2ioXtgCMKGiCLxJ4HQs62oz6GfRQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@unrs/resolver-binding-freebsd-x64": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-freebsd-x64/-/resolver-binding-freebsd-x64-1.11.1.tgz", + "integrity": "sha512-fqtGgak3zX4DCB6PFpsH5+Kmt/8CIi4Bry4rb1ho6Av2QHTREM+47y282Uqiu3ZRF5IQioJQ5qWRV6jduA+iGw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@unrs/resolver-binding-linux-arm-gnueabihf": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm-gnueabihf/-/resolver-binding-linux-arm-gnueabihf-1.11.1.tgz", + "integrity": "sha512-u92mvlcYtp9MRKmP+ZvMmtPN34+/3lMHlyMj7wXJDeXxuM0Vgzz0+PPJNsro1m3IZPYChIkn944wW8TYgGKFHw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-arm-musleabihf": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm-musleabihf/-/resolver-binding-linux-arm-musleabihf-1.11.1.tgz", + "integrity": "sha512-cINaoY2z7LVCrfHkIcmvj7osTOtm6VVT16b5oQdS4beibX2SYBwgYLmqhBjA1t51CarSaBuX5YNsWLjsqfW5Cw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-arm64-gnu": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm64-gnu/-/resolver-binding-linux-arm64-gnu-1.11.1.tgz", + "integrity": "sha512-34gw7PjDGB9JgePJEmhEqBhWvCiiWCuXsL9hYphDF7crW7UgI05gyBAi6MF58uGcMOiOqSJ2ybEeCvHcq0BCmQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-arm64-musl": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-arm64-musl/-/resolver-binding-linux-arm64-musl-1.11.1.tgz", + "integrity": "sha512-RyMIx6Uf53hhOtJDIamSbTskA99sPHS96wxVE/bJtePJJtpdKGXO1wY90oRdXuYOGOTuqjT8ACccMc4K6QmT3w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-ppc64-gnu": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-ppc64-gnu/-/resolver-binding-linux-ppc64-gnu-1.11.1.tgz", + "integrity": "sha512-D8Vae74A4/a+mZH0FbOkFJL9DSK2R6TFPC9M+jCWYia/q2einCubX10pecpDiTmkJVUH+y8K3BZClycD8nCShA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-riscv64-gnu": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-riscv64-gnu/-/resolver-binding-linux-riscv64-gnu-1.11.1.tgz", + "integrity": "sha512-frxL4OrzOWVVsOc96+V3aqTIQl1O2TjgExV4EKgRY09AJ9leZpEg8Ak9phadbuX0BA4k8U5qtvMSQQGGmaJqcQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-riscv64-musl": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-riscv64-musl/-/resolver-binding-linux-riscv64-musl-1.11.1.tgz", + "integrity": "sha512-mJ5vuDaIZ+l/acv01sHoXfpnyrNKOk/3aDoEdLO/Xtn9HuZlDD6jKxHlkN8ZhWyLJsRBxfv9GYM2utQ1SChKew==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-s390x-gnu": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-s390x-gnu/-/resolver-binding-linux-s390x-gnu-1.11.1.tgz", + "integrity": "sha512-kELo8ebBVtb9sA7rMe1Cph4QHreByhaZ2QEADd9NzIQsYNQpt9UkM9iqr2lhGr5afh885d/cB5QeTXSbZHTYPg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-x64-gnu": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-x64-gnu/-/resolver-binding-linux-x64-gnu-1.11.1.tgz", + "integrity": "sha512-C3ZAHugKgovV5YvAMsxhq0gtXuwESUKc5MhEtjBpLoHPLYM+iuwSj3lflFwK3DPm68660rZ7G8BMcwSro7hD5w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-linux-x64-musl": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-linux-x64-musl/-/resolver-binding-linux-x64-musl-1.11.1.tgz", + "integrity": "sha512-rV0YSoyhK2nZ4vEswT/QwqzqQXw5I6CjoaYMOX0TqBlWhojUf8P94mvI7nuJTeaCkkds3QE4+zS8Ko+GdXuZtA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@unrs/resolver-binding-wasm32-wasi": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-wasm32-wasi/-/resolver-binding-wasm32-wasi-1.11.1.tgz", + "integrity": "sha512-5u4RkfxJm+Ng7IWgkzi3qrFOvLvQYnPBmjmZQ8+szTK/b31fQCnleNl1GgEt7nIsZRIf5PLhPwT0WM+q45x/UQ==", + "cpu": [ + "wasm32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@napi-rs/wasm-runtime": "^0.2.11" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@unrs/resolver-binding-win32-arm64-msvc": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-arm64-msvc/-/resolver-binding-win32-arm64-msvc-1.11.1.tgz", + "integrity": "sha512-nRcz5Il4ln0kMhfL8S3hLkxI85BXs3o8EYoattsJNdsX4YUU89iOkVn7g0VHSRxFuVMdM4Q1jEpIId1Ihim/Uw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@unrs/resolver-binding-win32-ia32-msvc": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-ia32-msvc/-/resolver-binding-win32-ia32-msvc-1.11.1.tgz", + "integrity": "sha512-DCEI6t5i1NmAZp6pFonpD5m7i6aFrpofcp4LA2i8IIq60Jyo28hamKBxNrZcyOwVOZkgsRp9O2sXWBWP8MnvIQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@unrs/resolver-binding-win32-x64-msvc": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-win32-x64-msvc/-/resolver-binding-win32-x64-msvc-1.11.1.tgz", + "integrity": "sha512-lrW200hZdbfRtztbygyaq/6jP6AKE8qQN2KvPcJ+x7wiD038YtnYtZ82IMNJ69GJibV7bwL3y9FgK+5w/pYt6g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/acorn": { + "version": "8.16.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz", + "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==", + "dev": true, + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/agent-base": { + "version": "7.1.4", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz", + "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==", + "license": "MIT", + "engines": { + "node": ">= 14" + } + }, + "node_modules/ajv": { + "version": "6.15.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz", + "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/aria-query": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.2.tgz", + "integrity": "sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/array-buffer-byte-length": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/array-buffer-byte-length/-/array-buffer-byte-length-1.0.2.tgz", + "integrity": "sha512-LHE+8BuR7RYGDKvnrmcuSq3tDcKv9OFEXQt/HpbZhY7V6h0zlUXutnAD82GiFx9rdieCMjkvtcsPqBwgUl1Iiw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "is-array-buffer": "^3.0.5" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array-includes": { + "version": "3.1.9", + "resolved": "https://registry.npmjs.org/array-includes/-/array-includes-3.1.9.tgz", + "integrity": "sha512-FmeCCAenzH0KH381SPT5FZmiA/TmpndpcaShhfgEN9eCVjnFBqq3l1xrI42y8+PPLI6hypzou4GXw00WHmPBLQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.4", + "define-properties": "^1.2.1", + "es-abstract": "^1.24.0", + "es-object-atoms": "^1.1.1", + "get-intrinsic": "^1.3.0", + "is-string": "^1.1.1", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array.prototype.findlast": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/array.prototype.findlast/-/array.prototype.findlast-1.2.5.tgz", + "integrity": "sha512-CVvd6FHg1Z3POpBLxO6E6zr+rSKEQ9L6rZHAaY7lLfhKsWYUBBOuMs0e9o24oopj6H+geRCX0YJ+TJLBK2eHyQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.2", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.0.0", + "es-shim-unscopables": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array.prototype.findlastindex": { + "version": "1.2.6", + "resolved": "https://registry.npmjs.org/array.prototype.findlastindex/-/array.prototype.findlastindex-1.2.6.tgz", + "integrity": "sha512-F/TKATkzseUExPlfvmwQKGITM3DGTK+vkAsCZoDc5daVygbJBnjEUCbgkAvVFsgfXfX4YIqZ/27G3k3tdXrTxQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.4", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.9", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "es-shim-unscopables": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array.prototype.flat": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/array.prototype.flat/-/array.prototype.flat-1.3.3.tgz", + "integrity": "sha512-rwG/ja1neyLqCuGZ5YYrznA62D4mZXg0i1cIskIUKSiqF3Cje9/wXAls9B9s1Wa2fomMsIv8czB8jZcPmxCXFg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.5", + "es-shim-unscopables": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array.prototype.flatmap": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/array.prototype.flatmap/-/array.prototype.flatmap-1.3.3.tgz", + "integrity": "sha512-Y7Wt51eKJSyi80hFrJCePGGNo5ktJCslFuboqJsbf57CCPcm5zztluPlc4/aD8sWsKvlwatezpV4U1efk8kpjg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.5", + "es-shim-unscopables": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array.prototype.tosorted": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/array.prototype.tosorted/-/array.prototype.tosorted-1.1.4.tgz", + "integrity": "sha512-p6Fx8B7b7ZhL/gmUsAy0D15WhvDccw3mnGNbZpi3pmeJdxtWsj2jEaI4Y6oo3XiHfzuSgPwKc04MYt6KgvC/wA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.3", + "es-errors": "^1.3.0", + "es-shim-unscopables": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/arraybuffer.prototype.slice": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.4.tgz", + "integrity": "sha512-BNoCY6SXXPQ7gF2opIP4GBE+Xw7U+pHMYKuzjgCN3GwiaIR09UUeKfheyIry77QtrCBlC0KK0q5/TER/tYh3PQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-buffer-byte-length": "^1.0.1", + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.5", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6", + "is-array-buffer": "^3.0.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/ast-types-flow": { + "version": "0.0.8", + "resolved": "https://registry.npmjs.org/ast-types-flow/-/ast-types-flow-0.0.8.tgz", + "integrity": "sha512-OH/2E5Fg20h2aPrbe+QL8JZQFko0YZaF+j4mnQ7BGhfavO7OpSLa8a0y9sBwomHdSbkhTS8TQNayBfnW5DwbvQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/async-function": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz", + "integrity": "sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/available-typed-arrays": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz", + "integrity": "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "possible-typed-array-names": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/aws-ssl-profiles": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/aws-ssl-profiles/-/aws-ssl-profiles-1.1.2.tgz", + "integrity": "sha512-NZKeq9AfyQvEeNlN0zSYAaWrmBffJh3IELMZfRpJVWgrpEbtEpnjvzqBPf+mxoI287JohRDoa+/nsfqqiZmF6g==", + "license": "MIT", + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/axe-core": { + "version": "4.11.4", + "resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.11.4.tgz", + "integrity": "sha512-KunSNx+TVpkAw/6ULfhnx+HWRecjqZGTOyquAoWHYLRSdK1tB5Ihce1ZW+UY3fj33bYAFWPu7W/GRSmmrCGuxA==", + "dev": true, + "license": "MPL-2.0", + "engines": { + "node": ">=4" + } + }, + "node_modules/axobject-query": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz", + "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/baseline-browser-mapping": { + "version": "2.10.29", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.29.tgz", + "integrity": "sha512-Asa2krT+XTPZINCS+2QcyS8WTkObE77RwkydwF7h6DmnKqbvlalz93m/dnphUyCa6SWSP51VgtEUf2FN+gelFQ==", + "license": "Apache-2.0", + "bin": { + "baseline-browser-mapping": "dist/cli.cjs" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/better-result": { + "version": "2.9.2", + "resolved": "https://registry.npmjs.org/better-result/-/better-result-2.9.2.tgz", + "integrity": "sha512-WIFoBPCdnTOdk9inkE1ZRvCZ4P0CpSkAiLlchC65N7n9DcjZ3NhqkBOlafzpOVnO8ixyi37kicmSJ3ENhPZl7Q==", + "license": "MIT" + }, + "node_modules/bignumber.js": { + "version": "9.3.1", + "resolved": "https://registry.npmjs.org/bignumber.js/-/bignumber.js-9.3.1.tgz", + "integrity": "sha512-Ko0uX15oIUS7wJ3Rb30Fs6SkVbLmPBAKdlm7q9+ak9bbIeFf0MwuBsQV6z7+X768/cHsfg+WlysDWJcmthjsjQ==", + "license": "MIT", + "engines": { + "node": "*" + } + }, + "node_modules/brace-expansion": { + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/browserslist": { + "version": "4.28.2", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.2.tgz", + "integrity": "sha512-48xSriZYYg+8qXna9kwqjIVzuQxi+KYWp2+5nCYnYKPTr0LvD89Jqk2Or5ogxz0NUMfIjhh2lIUX/LyX9B4oIg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "baseline-browser-mapping": "^2.10.12", + "caniuse-lite": "^1.0.30001782", + "electron-to-chromium": "^1.5.328", + "node-releases": "^2.0.36", + "update-browserslist-db": "^1.2.3" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "node_modules/buffer-equal-constant-time": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz", + "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==", + "license": "BSD-3-Clause" + }, + "node_modules/c12": { + "version": "3.3.4", + "resolved": "https://registry.npmjs.org/c12/-/c12-3.3.4.tgz", + "integrity": "sha512-cM0ApFQSBXuourJejzwv/AuPRvAxordTyParRVcHjjtXirtkzM0uK2L9TTn9s0cXZbG7E55jCivRQzoxYmRAlA==", + "license": "MIT", + "dependencies": { + "chokidar": "^5.0.0", + "confbox": "^0.2.4", + "defu": "^6.1.6", + "dotenv": "^17.3.1", + "exsolve": "^1.0.8", + "giget": "^3.2.0", + "jiti": "^2.6.1", + "ohash": "^2.0.11", + "pathe": "^2.0.3", + "perfect-debounce": "^2.1.0", + "pkg-types": "^2.3.0", + "rc9": "^3.0.1" + }, + "peerDependencies": { + "magicast": "*" + }, + "peerDependenciesMeta": { + "magicast": { + "optional": true + } + } + }, + "node_modules/call-bind": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.9.tgz", + "integrity": "sha512-a/hy+pNsFUTR+Iz8TCJvXudKVLAnz/DyeSUo10I5yvFDQJBFU2s9uqQpoSrJlroHUKoKqzg+epxyP9lqFdzfBQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "get-intrinsic": "^1.3.0", + "set-function-length": "^1.2.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/call-bound": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz", + "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001792", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001792.tgz", + "integrity": "sha512-hVLMUZFgR4JJ6ACt1uEESvQN1/dBVqPAKY0hgrV70eN3391K6juAfTjKZLKvOMsx8PxA7gsY1/tLMMTcfFLLpw==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0" + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/chart.js": { + "version": "4.5.1", + "resolved": "https://registry.npmjs.org/chart.js/-/chart.js-4.5.1.tgz", + "integrity": "sha512-GIjfiT9dbmHRiYi6Nl2yFCq7kkwdkp1W/lp2J99rX0yo9tgJGn3lKQATztIjb5tVtevcBtIdICNWqlq5+E8/Pw==", + "license": "MIT", + "dependencies": { + "@kurkle/color": "^0.3.0" + }, + "engines": { + "pnpm": ">=8" + } + }, + "node_modules/chokidar": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz", + "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==", + "license": "MIT", + "dependencies": { + "readdirp": "^5.0.0" + }, + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/client-only": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/client-only/-/client-only-0.0.1.tgz", + "integrity": "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA==", + "license": "MIT" + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/commander": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-7.2.0.tgz", + "integrity": "sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==", + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, + "node_modules/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "dev": true, + "license": "MIT" + }, + "node_modules/confbox": { + "version": "0.2.4", + "resolved": "https://registry.npmjs.org/confbox/-/confbox-0.2.4.tgz", + "integrity": "sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ==", + "license": "MIT" + }, + "node_modules/convert-source-map": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", + "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", + "dev": true, + "license": "MIT" + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "license": "MIT" + }, + "node_modules/d3": { + "version": "7.9.0", + "resolved": "https://registry.npmjs.org/d3/-/d3-7.9.0.tgz", + "integrity": "sha512-e1U46jVP+w7Iut8Jt8ri1YsPOvFpg46k+K8TpCb0P+zjCkjkPnV7WzfDJzMHy1LnA+wj5pLT1wjO901gLXeEhA==", + "license": "ISC", + "dependencies": { + "d3-array": "3", + "d3-axis": "3", + "d3-brush": "3", + "d3-chord": "3", + "d3-color": "3", + "d3-contour": "4", + "d3-delaunay": "6", + "d3-dispatch": "3", + "d3-drag": "3", + "d3-dsv": "3", + "d3-ease": "3", + "d3-fetch": "3", + "d3-force": "3", + "d3-format": "3", + "d3-geo": "3", + "d3-hierarchy": "3", + "d3-interpolate": "3", + "d3-path": "3", + "d3-polygon": "3", + "d3-quadtree": "3", + "d3-random": "3", + "d3-scale": "4", + "d3-scale-chromatic": "3", + "d3-selection": "3", + "d3-shape": "3", + "d3-time": "3", + "d3-time-format": "4", + "d3-timer": "3", + "d3-transition": "3", + "d3-zoom": "3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-array": { + "version": "3.2.4", + "resolved": "https://registry.npmjs.org/d3-array/-/d3-array-3.2.4.tgz", + "integrity": "sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==", + "license": "ISC", + "dependencies": { + "internmap": "1 - 2" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-axis": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/d3-axis/-/d3-axis-3.0.0.tgz", + "integrity": "sha512-IH5tgjV4jE/GhHkRV0HiVYPDtvfjHQlQfJHs0usq7M30XcSBvOotpmH1IgkcXsO/5gEQZD43B//fc7SRT5S+xw==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-brush": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/d3-brush/-/d3-brush-3.0.0.tgz", + "integrity": "sha512-ALnjWlVYkXsVIGlOsuWH1+3udkYFI48Ljihfnh8FZPF2QS9o+PzGLBslO0PjzVoHLZ2KCVgAM8NVkXPJB2aNnQ==", + "license": "ISC", + "dependencies": { + "d3-dispatch": "1 - 3", + "d3-drag": "2 - 3", + "d3-interpolate": "1 - 3", + "d3-selection": "3", + "d3-transition": "3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-chord": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-chord/-/d3-chord-3.0.1.tgz", + "integrity": "sha512-VE5S6TNa+j8msksl7HwjxMHDM2yNK3XCkusIlpX5kwauBfXuyLAtNg9jCp/iHH61tgI4sb6R/EIMWCqEIdjT/g==", + "license": "ISC", + "dependencies": { + "d3-path": "1 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-color": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-color/-/d3-color-3.1.0.tgz", + "integrity": "sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-contour": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/d3-contour/-/d3-contour-4.0.2.tgz", + "integrity": "sha512-4EzFTRIikzs47RGmdxbeUvLWtGedDUNkTcmzoeyg4sP/dvCexO47AaQL7VKy/gul85TOxw+IBgA8US2xwbToNA==", + "license": "ISC", + "dependencies": { + "d3-array": "^3.2.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-delaunay": { + "version": "6.0.4", + "resolved": "https://registry.npmjs.org/d3-delaunay/-/d3-delaunay-6.0.4.tgz", + "integrity": "sha512-mdjtIZ1XLAM8bm/hx3WwjfHt6Sggek7qH043O8KEjDXN40xi3vx/6pYSVTwLjEgiXQTbvaouWKynLBiUZ6SK6A==", + "license": "ISC", + "dependencies": { + "delaunator": "5" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-dispatch": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-dispatch/-/d3-dispatch-3.0.1.tgz", + "integrity": "sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-drag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/d3-drag/-/d3-drag-3.0.0.tgz", + "integrity": "sha512-pWbUJLdETVA8lQNJecMxoXfH6x+mO2UQo8rSmZ+QqxcbyA3hfeprFgIT//HW2nlHChWeIIMwS2Fq+gEARkhTkg==", + "license": "ISC", + "dependencies": { + "d3-dispatch": "1 - 3", + "d3-selection": "3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-dsv": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-dsv/-/d3-dsv-3.0.1.tgz", + "integrity": "sha512-UG6OvdI5afDIFP9w4G0mNq50dSOsXHJaRE8arAS5o9ApWnIElp8GZw1Dun8vP8OyHOZ/QJUKUJwxiiCCnUwm+Q==", + "license": "ISC", + "dependencies": { + "commander": "7", + "iconv-lite": "0.6", + "rw": "1" + }, + "bin": { + "csv2json": "bin/dsv2json.js", + "csv2tsv": "bin/dsv2dsv.js", + "dsv2dsv": "bin/dsv2dsv.js", + "dsv2json": "bin/dsv2json.js", + "json2csv": "bin/json2dsv.js", + "json2dsv": "bin/json2dsv.js", + "json2tsv": "bin/json2dsv.js", + "tsv2csv": "bin/dsv2dsv.js", + "tsv2json": "bin/dsv2json.js" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-ease": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-ease/-/d3-ease-3.0.1.tgz", + "integrity": "sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-fetch": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-fetch/-/d3-fetch-3.0.1.tgz", + "integrity": "sha512-kpkQIM20n3oLVBKGg6oHrUchHM3xODkTzjMoj7aWQFq5QEM+R6E4WkzT5+tojDY7yjez8KgCBRoj4aEr99Fdqw==", + "license": "ISC", + "dependencies": { + "d3-dsv": "1 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-force": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/d3-force/-/d3-force-3.0.0.tgz", + "integrity": "sha512-zxV/SsA+U4yte8051P4ECydjD/S+qeYtnaIyAs9tgHCqfguma/aAQDjo85A9Z6EKhBirHRJHXIgJUlffT4wdLg==", + "license": "ISC", + "dependencies": { + "d3-dispatch": "1 - 3", + "d3-quadtree": "1 - 3", + "d3-timer": "1 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-format": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/d3-format/-/d3-format-3.1.2.tgz", + "integrity": "sha512-AJDdYOdnyRDV5b6ArilzCPPwc1ejkHcoyFarqlPqT7zRYjhavcT3uSrqcMvsgh2CgoPbK3RCwyHaVyxYcP2Arg==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-geo": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/d3-geo/-/d3-geo-3.1.1.tgz", + "integrity": "sha512-637ln3gXKXOwhalDzinUgY83KzNWZRKbYubaG+fGVuc/dxO64RRljtCTnf5ecMyE1RIdtqpkVcq0IbtU2S8j2Q==", + "license": "ISC", + "dependencies": { + "d3-array": "2.5.0 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-hierarchy": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/d3-hierarchy/-/d3-hierarchy-3.1.2.tgz", + "integrity": "sha512-FX/9frcub54beBdugHjDCdikxThEqjnR93Qt7PvQTOHxyiNCAlvMrHhclk3cD5VeAaq9fxmfRp+CnWw9rEMBuA==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-interpolate": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-interpolate/-/d3-interpolate-3.0.1.tgz", + "integrity": "sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==", + "license": "ISC", + "dependencies": { + "d3-color": "1 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-path": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-path/-/d3-path-3.1.0.tgz", + "integrity": "sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-polygon": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-polygon/-/d3-polygon-3.0.1.tgz", + "integrity": "sha512-3vbA7vXYwfe1SYhED++fPUQlWSYTTGmFmQiany/gdbiWgU/iEyQzyymwL9SkJjFFuCS4902BSzewVGsHHmHtXg==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-quadtree": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-quadtree/-/d3-quadtree-3.0.1.tgz", + "integrity": "sha512-04xDrxQTDTCFwP5H6hRhsRcb9xxv2RzkcsygFzmkSIOJy3PeRJP7sNk3VRIbKXcog561P9oU0/rVH6vDROAgUw==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-random": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-random/-/d3-random-3.0.1.tgz", + "integrity": "sha512-FXMe9GfxTxqd5D6jFsQ+DJ8BJS4E/fT5mqqdjovykEB2oFbTMDVdg1MGFxfQW+FBOGoB++k8swBrgwSHT1cUXQ==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-scale": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/d3-scale/-/d3-scale-4.0.2.tgz", + "integrity": "sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ==", + "license": "ISC", + "dependencies": { + "d3-array": "2.10.0 - 3", + "d3-format": "1 - 3", + "d3-interpolate": "1.2.0 - 3", + "d3-time": "2.1.1 - 3", + "d3-time-format": "2 - 4" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-scale-chromatic": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-scale-chromatic/-/d3-scale-chromatic-3.1.0.tgz", + "integrity": "sha512-A3s5PWiZ9YCXFye1o246KoscMWqf8BsD9eRiJ3He7C9OBaxKhAd5TFCdEx/7VbKtxxTsu//1mMJFrEt572cEyQ==", + "license": "ISC", + "dependencies": { + "d3-color": "1 - 3", + "d3-interpolate": "1 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-selection": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/d3-selection/-/d3-selection-3.0.0.tgz", + "integrity": "sha512-fmTRWbNMmsmWq6xJV8D19U/gw/bwrHfNXxrIN+HfZgnzqTHp9jOmKMhsTUjXOJnZOdZY9Q28y4yebKzqDKlxlQ==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-shape": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/d3-shape/-/d3-shape-3.2.0.tgz", + "integrity": "sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==", + "license": "ISC", + "dependencies": { + "d3-path": "^3.1.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-time": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-time/-/d3-time-3.1.0.tgz", + "integrity": "sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q==", + "license": "ISC", + "dependencies": { + "d3-array": "2 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-time-format": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/d3-time-format/-/d3-time-format-4.1.0.tgz", + "integrity": "sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg==", + "license": "ISC", + "dependencies": { + "d3-time": "1 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-timer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-timer/-/d3-timer-3.0.1.tgz", + "integrity": "sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-transition": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-transition/-/d3-transition-3.0.1.tgz", + "integrity": "sha512-ApKvfjsSR6tg06xrL434C0WydLr7JewBB3V+/39RMHsaXTOG0zmt/OAXeng5M5LBm0ojmxJrpomQVZ1aPvBL4w==", + "license": "ISC", + "dependencies": { + "d3-color": "1 - 3", + "d3-dispatch": "1 - 3", + "d3-ease": "1 - 3", + "d3-interpolate": "1 - 3", + "d3-timer": "1 - 3" + }, + "engines": { + "node": ">=12" + }, + "peerDependencies": { + "d3-selection": "2 - 3" + } + }, + "node_modules/d3-zoom": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/d3-zoom/-/d3-zoom-3.0.0.tgz", + "integrity": "sha512-b8AmV3kfQaqWAuacbPuNbL6vahnOJflOhexLzMMNLga62+/nh0JzvJ0aO/5a5MVgUFGS7Hu1P9P03o3fJkDCyw==", + "license": "ISC", + "dependencies": { + "d3-dispatch": "1 - 3", + "d3-drag": "2 - 3", + "d3-interpolate": "1 - 3", + "d3-selection": "2 - 3", + "d3-transition": "2 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/damerau-levenshtein": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/damerau-levenshtein/-/damerau-levenshtein-1.0.8.tgz", + "integrity": "sha512-sdQSFB7+llfUcQHUQO3+B8ERRj0Oa4w9POWMI/puGtuf7gFywGmkaLCElnudfTiKZV+NvHqL0ifzdrI8Ro7ESA==", + "dev": true, + "license": "BSD-2-Clause" + }, + "node_modules/data-uri-to-buffer": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/data-uri-to-buffer/-/data-uri-to-buffer-4.0.1.tgz", + "integrity": "sha512-0R9ikRb668HB7QDxT1vkpuUBtqc53YyAwMwGeUFKRojY/NWKvdZ+9UYtRfGmhqNbRkTSVpMbmyhXipFFv2cb/A==", + "license": "MIT", + "engines": { + "node": ">= 12" + } + }, + "node_modules/data-view-buffer": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/data-view-buffer/-/data-view-buffer-1.0.2.tgz", + "integrity": "sha512-EmKO5V3OLXh1rtK2wgXRansaK1/mtVdTUEiEI0W8RkvgT05kfxaH29PliLnpLP73yYO6142Q72QNa8Wx/A5CqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/data-view-byte-length": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/data-view-byte-length/-/data-view-byte-length-1.0.2.tgz", + "integrity": "sha512-tuhGbE6CfTM9+5ANGf+oQb72Ky/0+s3xKUpHvShfiz2RxMFgFPjsXuRLBVMtvMs15awe45SRb83D6wH4ew6wlQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/inspect-js" + } + }, + "node_modules/data-view-byte-offset": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/data-view-byte-offset/-/data-view-byte-offset-1.0.1.tgz", + "integrity": "sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/deepmerge-ts": { + "version": "7.1.5", + "resolved": "https://registry.npmjs.org/deepmerge-ts/-/deepmerge-ts-7.1.5.tgz", + "integrity": "sha512-HOJkrhaYsweh+W+e74Yn7YStZOilkoPb6fycpwNLKzSPtruFs48nYis0zy5yJz1+ktUhHxoRDJ27RQAWLIJVJw==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/define-data-property": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", + "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0", + "es-errors": "^1.3.0", + "gopd": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/define-properties": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz", + "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-data-property": "^1.0.1", + "has-property-descriptors": "^1.0.0", + "object-keys": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/defu": { + "version": "6.1.7", + "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.7.tgz", + "integrity": "sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==", + "license": "MIT" + }, + "node_modules/delaunator": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/delaunator/-/delaunator-5.1.0.tgz", + "integrity": "sha512-AGrQ4QSgssa1NGmWmLPqN5NY2KajF5MqxetNEO+o0n3ZwZZeTmt7bBnvzHWrmkZFxGgr4HdyFgelzgi06otLuQ==", + "license": "ISC", + "dependencies": { + "robust-predicates": "^3.0.2" + } + }, + "node_modules/denque": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/denque/-/denque-2.1.0.tgz", + "integrity": "sha512-HVQE3AAb/pxF8fQAoiqpvg9i3evqug3hoiwakOyZAwJm+6vZehbkYXZ0l4JxS+I3QxM97v5aaRNhj8v5oBhekw==", + "license": "Apache-2.0", + "engines": { + "node": ">=0.10" + } + }, + "node_modules/destr": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz", + "integrity": "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==", + "license": "MIT" + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "devOptional": true, + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, + "node_modules/doctrine": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-2.1.0.tgz", + "integrity": "sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "esutils": "^2.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/dotenv": { + "version": "17.4.2", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz", + "integrity": "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/ecdsa-sig-formatter": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz", + "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==", + "license": "Apache-2.0", + "dependencies": { + "safe-buffer": "^5.0.1" + } + }, + "node_modules/effect": { + "version": "3.20.0", + "resolved": "https://registry.npmjs.org/effect/-/effect-3.20.0.tgz", + "integrity": "sha512-qMLfDJscrNG8p/aw+IkT9W7fgj50Z4wG5bLBy0Txsxz8iUHjDIkOgO3SV0WZfnQbNG2VJYb0b+rDLMrhM4+Krw==", + "license": "MIT", + "dependencies": { + "@standard-schema/spec": "^1.0.0", + "fast-check": "^3.23.1" + } + }, + "node_modules/electron-to-chromium": { + "version": "1.5.354", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.354.tgz", + "integrity": "sha512-JaBHwWcfIdmSAfWM5l3uwjGd431j8YEMikZ+K/2nXVuBqJKyZ0f+2h4n4JY5AyNiZmnY9qQr2RU3v9DxDmHMNg==", + "dev": true, + "license": "ISC" + }, + "node_modules/emoji-regex": { + "version": "9.2.2", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", + "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", + "dev": true, + "license": "MIT" + }, + "node_modules/empathic": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/empathic/-/empathic-2.0.0.tgz", + "integrity": "sha512-i6UzDscO/XfAcNYD75CfICkmfLedpyPDdozrLMmQc5ORaQcdMoc21OnlEylMIqI7U8eniKrPMxxtj8k0vhmJhA==", + "license": "MIT", + "engines": { + "node": ">=14" + } + }, + "node_modules/enhanced-resolve": { + "version": "5.21.3", + "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.21.3.tgz", + "integrity": "sha512-QyL119InA+XXEkNLNTPCXPugSvOfhwv0JOlGNzvxs0hZaiHLNvXSpudUWsOlsXGWJh8G6ckCScEkVHfX3kw/2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.4", + "tapable": "^2.3.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/env-paths": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-3.0.0.tgz", + "integrity": "sha512-dtJUTepzMW3Lm/NPxRf3wP4642UWhjL2sQxc+ym2YMj1m/H2zDNQOlezafzkHwn6sMstjHTwG6iQQsctDW/b1A==", + "license": "MIT", + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/es-abstract": { + "version": "1.24.2", + "resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.24.2.tgz", + "integrity": "sha512-2FpH9Q5i2RRwyEP1AylXe6nYLR5OhaJTZwmlcP0dL/+JCbgg7yyEo/sEK6HeGZRf3dFpWwThaRHVApXSkW3xeg==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-buffer-byte-length": "^1.0.2", + "arraybuffer.prototype.slice": "^1.0.4", + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.8", + "call-bound": "^1.0.4", + "data-view-buffer": "^1.0.2", + "data-view-byte-length": "^1.0.2", + "data-view-byte-offset": "^1.0.1", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "es-set-tostringtag": "^2.1.0", + "es-to-primitive": "^1.3.0", + "function.prototype.name": "^1.1.8", + "get-intrinsic": "^1.3.0", + "get-proto": "^1.0.1", + "get-symbol-description": "^1.1.0", + "globalthis": "^1.0.4", + "gopd": "^1.2.0", + "has-property-descriptors": "^1.0.2", + "has-proto": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "internal-slot": "^1.1.0", + "is-array-buffer": "^3.0.5", + "is-callable": "^1.2.7", + "is-data-view": "^1.0.2", + "is-negative-zero": "^2.0.3", + "is-regex": "^1.2.1", + "is-set": "^2.0.3", + "is-shared-array-buffer": "^1.0.4", + "is-string": "^1.1.1", + "is-typed-array": "^1.1.15", + "is-weakref": "^1.1.1", + "math-intrinsics": "^1.1.0", + "object-inspect": "^1.13.4", + "object-keys": "^1.1.1", + "object.assign": "^4.1.7", + "own-keys": "^1.0.1", + "regexp.prototype.flags": "^1.5.4", + "safe-array-concat": "^1.1.3", + "safe-push-apply": "^1.0.0", + "safe-regex-test": "^1.1.0", + "set-proto": "^1.0.0", + "stop-iteration-iterator": "^1.1.0", + "string.prototype.trim": "^1.2.10", + "string.prototype.trimend": "^1.0.9", + "string.prototype.trimstart": "^1.0.8", + "typed-array-buffer": "^1.0.3", + "typed-array-byte-length": "^1.0.3", + "typed-array-byte-offset": "^1.0.4", + "typed-array-length": "^1.0.7", + "unbox-primitive": "^1.1.0", + "which-typed-array": "^1.1.19" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-iterator-helpers": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/es-iterator-helpers/-/es-iterator-helpers-1.3.2.tgz", + "integrity": "sha512-HVLACW1TppGYjJ8H6/jqH/pqOtKRw6wMlrB23xfExmFWxFquAIWCmwoLsOyN96K4a5KbmOf5At9ZUO3GZbetAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.9", + "call-bound": "^1.0.4", + "define-properties": "^1.2.1", + "es-abstract": "^1.24.2", + "es-errors": "^1.3.0", + "es-set-tostringtag": "^2.1.0", + "function-bind": "^1.1.2", + "get-intrinsic": "^1.3.0", + "globalthis": "^1.0.4", + "gopd": "^1.2.0", + "has-property-descriptors": "^1.0.2", + "has-proto": "^1.2.0", + "has-symbols": "^1.1.0", + "internal-slot": "^1.1.0", + "iterator.prototype": "^1.1.5", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", + "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-set-tostringtag": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", + "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-shim-unscopables": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/es-shim-unscopables/-/es-shim-unscopables-1.1.0.tgz", + "integrity": "sha512-d9T8ucsEhh8Bi1woXCf+TIKDIROLG5WCkxg8geBCbvk22kzwC5G2OnXVMO6FUsvQlgUUXQ2itephWDLqDzbeCw==", + "dev": true, + "license": "MIT", + "dependencies": { + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-to-primitive": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-to-primitive/-/es-to-primitive-1.3.0.tgz", + "integrity": "sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-callable": "^1.2.7", + "is-date-object": "^1.0.5", + "is-symbol": "^1.0.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint": { + "version": "9.39.4", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.4.tgz", + "integrity": "sha512-XoMjdBOwe/esVgEvLmNsD3IRHkm7fbKIUGvrleloJXUZgDHig2IPWNniv+GwjyJXzuNqVjlr5+4yVUZjycJwfQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.8.0", + "@eslint-community/regexpp": "^4.12.1", + "@eslint/config-array": "^0.21.2", + "@eslint/config-helpers": "^0.4.2", + "@eslint/core": "^0.17.0", + "@eslint/eslintrc": "^3.3.5", + "@eslint/js": "9.39.4", + "@eslint/plugin-kit": "^0.4.1", + "@humanfs/node": "^0.16.6", + "@humanwhocodes/module-importer": "^1.0.1", + "@humanwhocodes/retry": "^0.4.2", + "@types/estree": "^1.0.6", + "ajv": "^6.14.0", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.6", + "debug": "^4.3.2", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^8.4.0", + "eslint-visitor-keys": "^4.2.1", + "espree": "^10.4.0", + "esquery": "^1.5.0", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^8.0.0", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.5", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + }, + "peerDependencies": { + "jiti": "*" + }, + "peerDependenciesMeta": { + "jiti": { + "optional": true + } + } + }, + "node_modules/eslint-config-next": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/eslint-config-next/-/eslint-config-next-16.2.6.tgz", + "integrity": "sha512-z2ELYSkyrrJ6cuunTU8vhsT/RpouPkjaSah06nVW6Rg2Hpg0Vs8s497/e5s8G8qtdp4ccsiovz5P1rv+5VSW2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@next/eslint-plugin-next": "16.2.6", + "eslint-import-resolver-node": "^0.3.6", + "eslint-import-resolver-typescript": "^3.5.2", + "eslint-plugin-import": "^2.32.0", + "eslint-plugin-jsx-a11y": "^6.10.0", + "eslint-plugin-react": "^7.37.0", + "eslint-plugin-react-hooks": "^7.0.0", + "globals": "16.4.0", + "typescript-eslint": "^8.46.0" + }, + "peerDependencies": { + "eslint": ">=9.0.0", + "typescript": ">=3.3.1" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/eslint-config-next/node_modules/globals": { + "version": "16.4.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-16.4.0.tgz", + "integrity": "sha512-ob/2LcVVaVGCYN+r14cnwnoDPUufjiYgSqRhiFD0Q1iI4Odora5RE8Iv1D24hAz5oMophRGkGz+yuvQmmUMnMw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint-import-resolver-node": { + "version": "0.3.10", + "resolved": "https://registry.npmjs.org/eslint-import-resolver-node/-/eslint-import-resolver-node-0.3.10.tgz", + "integrity": "sha512-tRrKqFyCaKict5hOd244sL6EQFNycnMQnBe+j8uqGNXYzsImGbGUU4ibtoaBmv5FLwJwcFJNeg1GeVjQfbMrDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^3.2.7", + "is-core-module": "^2.16.1", + "resolve": "^2.0.0-next.6" + } + }, + "node_modules/eslint-import-resolver-node/node_modules/debug": { + "version": "3.2.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", + "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/eslint-import-resolver-typescript": { + "version": "3.10.1", + "resolved": "https://registry.npmjs.org/eslint-import-resolver-typescript/-/eslint-import-resolver-typescript-3.10.1.tgz", + "integrity": "sha512-A1rHYb06zjMGAxdLSkN2fXPBwuSaQ0iO5M/hdyS0Ajj1VBaRp0sPD3dn1FhME3c/JluGFbwSxyCfqdSbtQLAHQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "@nolyfill/is-core-module": "1.0.39", + "debug": "^4.4.0", + "get-tsconfig": "^4.10.0", + "is-bun-module": "^2.0.0", + "stable-hash": "^0.0.5", + "tinyglobby": "^0.2.13", + "unrs-resolver": "^1.6.2" + }, + "engines": { + "node": "^14.18.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint-import-resolver-typescript" + }, + "peerDependencies": { + "eslint": "*", + "eslint-plugin-import": "*", + "eslint-plugin-import-x": "*" + }, + "peerDependenciesMeta": { + "eslint-plugin-import": { + "optional": true + }, + "eslint-plugin-import-x": { + "optional": true + } + } + }, + "node_modules/eslint-module-utils": { + "version": "2.12.1", + "resolved": "https://registry.npmjs.org/eslint-module-utils/-/eslint-module-utils-2.12.1.tgz", + "integrity": "sha512-L8jSWTze7K2mTg0vos/RuLRS5soomksDPoJLXIslC7c8Wmut3bx7CPpJijDcBZtxQ5lrbUdM+s0OlNbz0DCDNw==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^3.2.7" + }, + "engines": { + "node": ">=4" + }, + "peerDependenciesMeta": { + "eslint": { + "optional": true + } + } + }, + "node_modules/eslint-module-utils/node_modules/debug": { + "version": "3.2.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", + "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/eslint-plugin-import": { + "version": "2.32.0", + "resolved": "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.32.0.tgz", + "integrity": "sha512-whOE1HFo/qJDyX4SnXzP4N6zOWn79WhnCUY/iDR0mPfQZO8wcYE4JClzI2oZrhBnnMUCBCHZhO6VQyoBU95mZA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@rtsao/scc": "^1.1.0", + "array-includes": "^3.1.9", + "array.prototype.findlastindex": "^1.2.6", + "array.prototype.flat": "^1.3.3", + "array.prototype.flatmap": "^1.3.3", + "debug": "^3.2.7", + "doctrine": "^2.1.0", + "eslint-import-resolver-node": "^0.3.9", + "eslint-module-utils": "^2.12.1", + "hasown": "^2.0.2", + "is-core-module": "^2.16.1", + "is-glob": "^4.0.3", + "minimatch": "^3.1.2", + "object.fromentries": "^2.0.8", + "object.groupby": "^1.0.3", + "object.values": "^1.2.1", + "semver": "^6.3.1", + "string.prototype.trimend": "^1.0.9", + "tsconfig-paths": "^3.15.0" + }, + "engines": { + "node": ">=4" + }, + "peerDependencies": { + "eslint": "^2 || ^3 || ^4 || ^5 || ^6 || ^7.2.0 || ^8 || ^9" + } + }, + "node_modules/eslint-plugin-import/node_modules/debug": { + "version": "3.2.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", + "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/eslint-plugin-jsx-a11y": { + "version": "6.10.2", + "resolved": "https://registry.npmjs.org/eslint-plugin-jsx-a11y/-/eslint-plugin-jsx-a11y-6.10.2.tgz", + "integrity": "sha512-scB3nz4WmG75pV8+3eRUQOHZlNSUhFNq37xnpgRkCCELU3XMvXAxLk1eqWWyE22Ki4Q01Fnsw9BA3cJHDPgn2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "aria-query": "^5.3.2", + "array-includes": "^3.1.8", + "array.prototype.flatmap": "^1.3.2", + "ast-types-flow": "^0.0.8", + "axe-core": "^4.10.0", + "axobject-query": "^4.1.0", + "damerau-levenshtein": "^1.0.8", + "emoji-regex": "^9.2.2", + "hasown": "^2.0.2", + "jsx-ast-utils": "^3.3.5", + "language-tags": "^1.0.9", + "minimatch": "^3.1.2", + "object.fromentries": "^2.0.8", + "safe-regex-test": "^1.0.3", + "string.prototype.includes": "^2.0.1" + }, + "engines": { + "node": ">=4.0" + }, + "peerDependencies": { + "eslint": "^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9" + } + }, + "node_modules/eslint-plugin-react": { + "version": "7.37.5", + "resolved": "https://registry.npmjs.org/eslint-plugin-react/-/eslint-plugin-react-7.37.5.tgz", + "integrity": "sha512-Qteup0SqU15kdocexFNAJMvCJEfa2xUKNV4CC1xsVMrIIqEy3SQ/rqyxCWNzfrd3/ldy6HMlD2e0JDVpDg2qIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-includes": "^3.1.8", + "array.prototype.findlast": "^1.2.5", + "array.prototype.flatmap": "^1.3.3", + "array.prototype.tosorted": "^1.1.4", + "doctrine": "^2.1.0", + "es-iterator-helpers": "^1.2.1", + "estraverse": "^5.3.0", + "hasown": "^2.0.2", + "jsx-ast-utils": "^2.4.1 || ^3.0.0", + "minimatch": "^3.1.2", + "object.entries": "^1.1.9", + "object.fromentries": "^2.0.8", + "object.values": "^1.2.1", + "prop-types": "^15.8.1", + "resolve": "^2.0.0-next.5", + "semver": "^6.3.1", + "string.prototype.matchall": "^4.0.12", + "string.prototype.repeat": "^1.0.0" + }, + "engines": { + "node": ">=4" + }, + "peerDependencies": { + "eslint": "^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9.7" + } + }, + "node_modules/eslint-plugin-react-hooks": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/eslint-plugin-react-hooks/-/eslint-plugin-react-hooks-7.1.1.tgz", + "integrity": "sha512-f2I7Gw6JbvCexzIInuSbZpfdQ44D7iqdWX01FKLvrPgqxoE7oMj8clOfto8U6vYiz4yd5oKu39rRSVOe1zRu0g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.24.4", + "@babel/parser": "^7.24.4", + "hermes-parser": "^0.25.1", + "zod": "^3.25.0 || ^4.0.0", + "zod-validation-error": "^3.5.0 || ^4.0.0" + }, + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "eslint": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0 || ^9.0.0 || ^10.0.0" + } + }, + "node_modules/eslint-scope": { + "version": "8.4.0", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz", + "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", + "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/espree": { + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz", + "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.15.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^4.2.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/esquery": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", + "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/exsolve": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/exsolve/-/exsolve-1.0.8.tgz", + "integrity": "sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==", + "license": "MIT" + }, + "node_modules/extend": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", + "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==", + "license": "MIT" + }, + "node_modules/fast-check": { + "version": "3.23.2", + "resolved": "https://registry.npmjs.org/fast-check/-/fast-check-3.23.2.tgz", + "integrity": "sha512-h5+1OzzfCC3Ef7VbtKdcv7zsstUQwUDlYpUTvjeUsJAssPgLn7QzbboPtL5ro04Mq0rPOsMzl7q5hIbRs2wD1A==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/dubzzz" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fast-check" + } + ], + "license": "MIT", + "dependencies": { + "pure-rand": "^6.1.0" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "license": "MIT" + }, + "node_modules/fast-glob": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.1.tgz", + "integrity": "sha512-kNFPyjhh5cKjrUltxs+wFx+ZkbRaxxmZ+X0ZU31SOsxCEtP9VPgtq2teZw1DebupL5GmDaNQ6yKMMVcM41iqDg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.4" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fast-glob/node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.2.tgz", + "integrity": "sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/fastq": { + "version": "1.20.1", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz", + "integrity": "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==", + "dev": true, + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, + "node_modules/fetch-blob": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/fetch-blob/-/fetch-blob-3.2.0.tgz", + "integrity": "sha512-7yAQpD2UMJzLi1Dqv7qFYnPbaPx7ZfFK6PiIxQ4PfkGPyNyl2Ugx+a/umUonmKqjhM4DnfbMvdX6otXq83soQQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/jimmywarting" + }, + { + "type": "paypal", + "url": "https://paypal.me/jimmywarting" + } + ], + "license": "MIT", + "dependencies": { + "node-domexception": "^1.0.0", + "web-streams-polyfill": "^3.0.3" + }, + "engines": { + "node": "^12.20 || >= 14.13" + } + }, + "node_modules/file-entry-cache": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", + "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^4.0.0" + }, + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/flat-cache": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", + "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.4" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/flatted": { + "version": "3.4.2", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.2.tgz", + "integrity": "sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==", + "dev": true, + "license": "ISC" + }, + "node_modules/for-each": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/for-each/-/for-each-0.3.5.tgz", + "integrity": "sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-callable": "^1.2.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/foreground-child": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz", + "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==", + "license": "ISC", + "dependencies": { + "cross-spawn": "^7.0.6", + "signal-exit": "^4.0.1" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/formdata-polyfill": { + "version": "4.0.10", + "resolved": "https://registry.npmjs.org/formdata-polyfill/-/formdata-polyfill-4.0.10.tgz", + "integrity": "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g==", + "license": "MIT", + "dependencies": { + "fetch-blob": "^3.1.2" + }, + "engines": { + "node": ">=12.20.0" + } + }, + "node_modules/framer-motion": { + "version": "12.38.0", + "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.38.0.tgz", + "integrity": "sha512-rFYkY/pigbcswl1XQSb7q424kSTQ8q6eAC+YUsSKooHQYuLdzdHjrt6uxUC+PRAO++q5IS7+TamgIw1AphxR+g==", + "license": "MIT", + "dependencies": { + "motion-dom": "^12.38.0", + "motion-utils": "^12.36.0", + "tslib": "^2.4.0" + }, + "peerDependencies": { + "@emotion/is-prop-valid": "*", + "react": "^18.0.0 || ^19.0.0", + "react-dom": "^18.0.0 || ^19.0.0" + }, + "peerDependenciesMeta": { + "@emotion/is-prop-valid": { + "optional": true + }, + "react": { + "optional": true + }, + "react-dom": { + "optional": true + } + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/function.prototype.name": { + "version": "1.1.8", + "resolved": "https://registry.npmjs.org/function.prototype.name/-/function.prototype.name-1.1.8.tgz", + "integrity": "sha512-e5iwyodOHhbMr/yNrc7fDYG4qlbIvI5gajyzPnb5TCwyhjApznQh1BMFou9b30SevY43gCJKXycoCBjMbsuW0Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "define-properties": "^1.2.1", + "functions-have-names": "^1.2.3", + "hasown": "^2.0.2", + "is-callable": "^1.2.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/functions-have-names": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/functions-have-names/-/functions-have-names-1.2.3.tgz", + "integrity": "sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/gaxios": { + "version": "7.1.4", + "resolved": "https://registry.npmjs.org/gaxios/-/gaxios-7.1.4.tgz", + "integrity": "sha512-bTIgTsM2bWn3XklZISBTQX7ZSddGW+IO3bMdGaemHZ3tbqExMENHLx6kKZ/KlejgrMtj8q7wBItt51yegqalrA==", + "license": "Apache-2.0", + "dependencies": { + "extend": "^3.0.2", + "https-proxy-agent": "^7.0.1", + "node-fetch": "^3.3.2" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/gcp-metadata": { + "version": "8.1.2", + "resolved": "https://registry.npmjs.org/gcp-metadata/-/gcp-metadata-8.1.2.tgz", + "integrity": "sha512-zV/5HKTfCeKWnxG0Dmrw51hEWFGfcF2xiXqcA3+J90WDuP0SvoiSO5ORvcBsifmx/FoIjgQN3oNOGaQ5PhLFkg==", + "license": "Apache-2.0", + "dependencies": { + "gaxios": "^7.0.0", + "google-logging-utils": "^1.0.0", + "json-bigint": "^1.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/generate-function": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/generate-function/-/generate-function-2.3.1.tgz", + "integrity": "sha512-eeB5GfMNeevm/GRYq20ShmsaGcmI81kIX2K9XQx5miC8KdHaC6Jm0qQ8ZNeGOi7wYB8OsdxKs+Y2oVuTFuVwKQ==", + "license": "MIT", + "dependencies": { + "is-property": "^1.0.2" + } + }, + "node_modules/generator-function": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/generator-function/-/generator-function-2.0.1.tgz", + "integrity": "sha512-SFdFmIJi+ybC0vjlHN0ZGVGHc3lgE0DxPAT0djjVg+kjOnSqclqmj0KQ7ykTOLP6YxoqOvuAODGdcHJn+43q3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/gensync": { + "version": "1.0.0-beta.2", + "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", + "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-port-please": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/get-port-please/-/get-port-please-3.2.0.tgz", + "integrity": "sha512-I9QVvBw5U/hw3RmWpYKRumUeaDgxTPd401x364rLmWBJcOQ753eov1eTgzDqRG9bqFIfDc7gfzcQEWrUri3o1A==", + "license": "MIT" + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "dev": true, + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/get-symbol-description": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/get-symbol-description/-/get-symbol-description-1.1.0.tgz", + "integrity": "sha512-w9UMqWwJxHNOvoNzSJ2oPF5wvYcvP7jUvYzhp67yEhTi17ZDBBC1z9pTdGuzjD+EFIqLSYRweZjqfiPzQ06Ebg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-tsconfig": { + "version": "4.14.0", + "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.14.0.tgz", + "integrity": "sha512-yTb+8DXzDREzgvYmh6s9vHsSVCHeC0G3PI5bEXNBHtmshPnO+S5O7qgLEOn0I5QvMy6kpZN8K1NKGyilLb93wA==", + "dev": true, + "license": "MIT", + "dependencies": { + "resolve-pkg-maps": "^1.0.0" + }, + "funding": { + "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1" + } + }, + "node_modules/giget": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/giget/-/giget-3.2.0.tgz", + "integrity": "sha512-GvHTWcykIR/fP8cj8dMpuMMkvaeJfPvYnhq0oW+chSeIr+ldX21ifU2Ms6KBoyKZQZmVaUAAhQ2EZ68KJF8a7A==", + "license": "MIT", + "bin": { + "giget": "dist/cli.mjs" + } + }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/globals": { + "version": "14.0.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", + "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/globalthis": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz", + "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-properties": "^1.2.1", + "gopd": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/google-auth-library": { + "version": "10.6.2", + "resolved": "https://registry.npmjs.org/google-auth-library/-/google-auth-library-10.6.2.tgz", + "integrity": "sha512-e27Z6EThmVNNvtYASwQxose/G57rkRuaRbQyxM2bvYLLX/GqWZ5chWq2EBoUchJbCc57eC9ArzO5wMsEmWftCw==", + "license": "Apache-2.0", + "dependencies": { + "base64-js": "^1.3.0", + "ecdsa-sig-formatter": "^1.0.11", + "gaxios": "^7.1.4", + "gcp-metadata": "8.1.2", + "google-logging-utils": "1.1.3", + "jws": "^4.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/google-logging-utils": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/google-logging-utils/-/google-logging-utils-1.1.3.tgz", + "integrity": "sha512-eAmLkjDjAFCVXg7A1unxHsLf961m6y17QFqXqAXGj/gVkKFrEICfStRfwUlGNfeCEjNRa32JEWOUTlYXPyyKvA==", + "license": "Apache-2.0", + "engines": { + "node": ">=14" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "license": "ISC" + }, + "node_modules/grammex": { + "version": "3.1.12", + "resolved": "https://registry.npmjs.org/grammex/-/grammex-3.1.12.tgz", + "integrity": "sha512-6ufJOsSA7LcQehIJNCO7HIBykfM7DXQual0Ny780/DEcJIpBlHRvcqEBWGPYd7hrXL2GJ3oJI1MIhaXjWmLQOQ==", + "license": "MIT" + }, + "node_modules/graphmatch": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/graphmatch/-/graphmatch-1.1.1.tgz", + "integrity": "sha512-5ykVn/EXM1hF0XCaWh05VbYvEiOL2lY1kBxZtaYsyvjp7cmWOU1XsAdfQBwClraEofXDT197lFbXOEVMHpvQOg==", + "license": "MIT" + }, + "node_modules/has-bigints": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-bigints/-/has-bigints-1.1.0.tgz", + "integrity": "sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/has-property-descriptors": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz", + "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-proto": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.2.0.tgz", + "integrity": "sha512-KIL7eQPfHQRC8+XluaIw7BHUwwqL19bQn4hzNgdr+1wXoU0KKj6rufu47lhY7KbJR2C6T6+PfyN0Ea7wkSS+qQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-tostringtag": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz", + "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.3.tgz", + "integrity": "sha512-ej4AhfhfL2Q2zpMmLo7U1Uv9+PyhIZpgQLGT1F9miIGmiCJIoCgSmczFdrc97mWT4kVY72KA+WnnhJ5pghSvSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/hermes-estree": { + "version": "0.25.1", + "resolved": "https://registry.npmjs.org/hermes-estree/-/hermes-estree-0.25.1.tgz", + "integrity": "sha512-0wUoCcLp+5Ev5pDW2OriHC2MJCbwLwuRx+gAqMTOkGKJJiBCLjtrvy4PWUGn6MIVefecRpzoOZ/UV6iGdOr+Cw==", + "dev": true, + "license": "MIT" + }, + "node_modules/hermes-parser": { + "version": "0.25.1", + "resolved": "https://registry.npmjs.org/hermes-parser/-/hermes-parser-0.25.1.tgz", + "integrity": "sha512-6pEjquH3rqaI6cYAXYPcz9MS4rY6R4ngRgrgfDshRptUZIc3lw0MCIJIGDj9++mfySOuPTHB4nrSW99BCvOPIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "hermes-estree": "0.25.1" + } + }, + "node_modules/hono": { + "version": "4.12.18", + "resolved": "https://registry.npmjs.org/hono/-/hono-4.12.18.tgz", + "integrity": "sha512-RWzP96k/yv0PQfyXnWjs6zot20TqfpfsNXhOnev8d1InAxubW93L11/oNUc3tQqn2G0bSdAOBpX+2uDFHV7kdQ==", + "license": "MIT", + "engines": { + "node": ">=16.9.0" + } + }, + "node_modules/http-status-codes": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/http-status-codes/-/http-status-codes-2.3.0.tgz", + "integrity": "sha512-RJ8XvFvpPM/Dmc5SV+dC4y5PCeOhT3x1Hq0NU3rjGeg5a/CqlhZ7uudknPwZFz4aeAXDcbAyaeP7GAo9lvngtA==", + "license": "MIT" + }, + "node_modules/https-proxy-agent": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", + "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.2", + "debug": "4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/iconv-lite": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", + "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/internal-slot": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz", + "integrity": "sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "hasown": "^2.0.2", + "side-channel": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/internmap": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/internmap/-/internmap-2.0.3.tgz", + "integrity": "sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/is-array-buffer": { + "version": "3.0.5", + "resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.5.tgz", + "integrity": "sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "get-intrinsic": "^1.2.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-async-function": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-async-function/-/is-async-function-2.1.1.tgz", + "integrity": "sha512-9dgM/cZBnNvjzaMYHVoxxfPj2QXt22Ev7SuuPrs+xav0ukGB0S6d4ydZdEiM48kLx5kDV+QBPrpVnFyefL8kkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "async-function": "^1.0.0", + "call-bound": "^1.0.3", + "get-proto": "^1.0.1", + "has-tostringtag": "^1.0.2", + "safe-regex-test": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-bigint": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/is-bigint/-/is-bigint-1.1.0.tgz", + "integrity": "sha512-n4ZT37wG78iz03xPRKJrHTdZbe3IicyucEtdRsV5yglwc3GyUfbAfpSeD0FJ41NbUNSt5wbhqfp1fS+BgnvDFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-bigints": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-boolean-object": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/is-boolean-object/-/is-boolean-object-1.2.2.tgz", + "integrity": "sha512-wa56o2/ElJMYqjCjGkXri7it5FbebW5usLw/nPmCMs5DeZ7eziSYZhSmPRn0txqeW4LnAmQQU7FgqLpsEFKM4A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-bun-module": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-bun-module/-/is-bun-module-2.0.0.tgz", + "integrity": "sha512-gNCGbnnnnFAUGKeZ9PdbyeGYJqewpmc2aKHUEMO5nQPWU9lOmv7jcmQIv+qHD8fXW6W7qfuCwX4rY9LNRjXrkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "semver": "^7.7.1" + } + }, + "node_modules/is-bun-module/node_modules/semver": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.0.tgz", + "integrity": "sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/is-callable": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.7.tgz", + "integrity": "sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-core-module": { + "version": "2.16.2", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.2.tgz", + "integrity": "sha512-evOr8xfXKxE6qSR0hSXL2r3sd7ALj8+7jQEUvPYcm5sgZFdJ+AYzT6yNmJenvIYQBgIGwfwz08sL8zoL7yq2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "hasown": "^2.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-data-view": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-data-view/-/is-data-view-1.0.2.tgz", + "integrity": "sha512-RKtWF8pGmS87i2D6gqQu/l7EYRlVdfzemCJN/P3UOs//x1QE7mfhvzHIApBTRf7axvT6DMGwSwBXYCT0nfB9xw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "get-intrinsic": "^1.2.6", + "is-typed-array": "^1.1.13" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-date-object": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/is-date-object/-/is-date-object-1.1.0.tgz", + "integrity": "sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-finalizationregistry": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-finalizationregistry/-/is-finalizationregistry-1.1.1.tgz", + "integrity": "sha512-1pC6N8qWJbWoPtEjgcL2xyhQOP491EQjeUo3qTKcmV8YSDDJrOepfG8pcC7h/QgnQHYSv0mJ3Z/ZWxmatVrysg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-generator-function": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/is-generator-function/-/is-generator-function-1.1.2.tgz", + "integrity": "sha512-upqt1SkGkODW9tsGNG5mtXTXtECizwtS2kA161M+gJPc1xdb/Ax629af6YrTwcOeQHbewrPNlE5Dx7kzvXTizA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.4", + "generator-function": "^2.0.0", + "get-proto": "^1.0.1", + "has-tostringtag": "^1.0.2", + "safe-regex-test": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-map": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz", + "integrity": "sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-negative-zero": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-negative-zero/-/is-negative-zero-2.0.3.tgz", + "integrity": "sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-number-object": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-number-object/-/is-number-object-1.1.1.tgz", + "integrity": "sha512-lZhclumE1G6VYD8VHe35wFaIif+CTy5SJIi5+3y4psDgWu4wPDoBhF8NxUOinEc7pHgiTsT6MaBb92rKhhD+Xw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-property": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-property/-/is-property-1.0.2.tgz", + "integrity": "sha512-Ks/IoX00TtClbGQr4TWXemAnktAQvYB7HzcCxDGqEZU6oCmb2INHuOoKxbtR+HFkmYWBKv/dOZtGRiAjDhj92g==", + "license": "MIT" + }, + "node_modules/is-regex": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.2.1.tgz", + "integrity": "sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "gopd": "^1.2.0", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-set": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-set/-/is-set-2.0.3.tgz", + "integrity": "sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-shared-array-buffer": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/is-shared-array-buffer/-/is-shared-array-buffer-1.0.4.tgz", + "integrity": "sha512-ISWac8drv4ZGfwKl5slpHG9OwPNty4jOWPRIhBpxOoD+hqITiwuipOQ2bNthAzwA3B4fIjO4Nln74N0S9byq8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-string": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-string/-/is-string-1.1.1.tgz", + "integrity": "sha512-BtEeSsoaQjlSPBemMQIrY1MY0uM6vnS1g5fmufYOtnxLGUZM2178PKbhsk7Ffv58IX+ZtcvoGwccYsh0PglkAA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-symbol": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-symbol/-/is-symbol-1.1.1.tgz", + "integrity": "sha512-9gGx6GTtCQM73BgmHQXfDmLtfjjTUDSyoxTCbp5WtoixAhfgsDirWIcVQ/IHpvI5Vgd5i/J5F7B9cN/WlVbC/w==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "has-symbols": "^1.1.0", + "safe-regex-test": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-typed-array": { + "version": "1.1.15", + "resolved": "https://registry.npmjs.org/is-typed-array/-/is-typed-array-1.1.15.tgz", + "integrity": "sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "which-typed-array": "^1.1.16" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-weakmap": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/is-weakmap/-/is-weakmap-2.0.2.tgz", + "integrity": "sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-weakref": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-weakref/-/is-weakref-1.1.1.tgz", + "integrity": "sha512-6i9mGWSlqzNMEqpCp93KwRS1uUOodk2OJ6b+sq7ZPDSy2WuI5NFIxp/254TytR8ftefexkWn5xNiHUNpPOfSew==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-weakset": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/is-weakset/-/is-weakset-2.0.4.tgz", + "integrity": "sha512-mfcwb6IzQyOKTs84CQMrOwW4gQcaTOAWJ0zzJCl2WSPDrWk/OzDaImWFH3djXhb24g4eudZfLRozAvPGw4d9hQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "get-intrinsic": "^1.2.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/isarray": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz", + "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==", + "dev": true, + "license": "MIT" + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "license": "ISC" + }, + "node_modules/iterator.prototype": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/iterator.prototype/-/iterator.prototype-1.1.5.tgz", + "integrity": "sha512-H0dkQoCa3b2VEeKQBOxFph+JAbcrQdE7KC0UkqwpLmv2EC4P41QXP+rqo9wYodACiG5/WM5s9oDApTU8utwj9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-object-atoms": "^1.0.0", + "get-intrinsic": "^1.2.6", + "get-proto": "^1.0.0", + "has-symbols": "^1.1.0", + "set-function-name": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/jiti": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.7.0.tgz", + "integrity": "sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==", + "license": "MIT", + "bin": { + "jiti": "lib/jiti-cli.mjs" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/jsesc": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz", + "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==", + "dev": true, + "license": "MIT", + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/json-bigint": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-bigint/-/json-bigint-1.0.0.tgz", + "integrity": "sha512-SiPv/8VpZuWbvLSMtTDU8hEfrZWg/mH/nV/b4o0CYbSxu1UIQPLdwKOCIyLQX+VIPO5vrLX3i8qtqFyhdPSUSQ==", + "license": "MIT", + "dependencies": { + "bignumber.js": "^9.0.0" + } + }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/json5": { + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz", + "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==", + "dev": true, + "license": "MIT", + "bin": { + "json5": "lib/cli.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/jsonwebtoken": { + "version": "9.0.3", + "resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.3.tgz", + "integrity": "sha512-MT/xP0CrubFRNLNKvxJ2BYfy53Zkm++5bX9dtuPbqAeQpTVe0MQTFhao8+Cp//EmJp244xt6Drw/GVEGCUj40g==", + "license": "MIT", + "dependencies": { + "jws": "^4.0.1", + "lodash.includes": "^4.3.0", + "lodash.isboolean": "^3.0.3", + "lodash.isinteger": "^4.0.4", + "lodash.isnumber": "^3.0.3", + "lodash.isplainobject": "^4.0.6", + "lodash.isstring": "^4.0.1", + "lodash.once": "^4.0.0", + "ms": "^2.1.1", + "semver": "^7.5.4" + }, + "engines": { + "node": ">=12", + "npm": ">=6" + } + }, + "node_modules/jsonwebtoken/node_modules/semver": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.0.tgz", + "integrity": "sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/jsx-ast-utils": { + "version": "3.3.5", + "resolved": "https://registry.npmjs.org/jsx-ast-utils/-/jsx-ast-utils-3.3.5.tgz", + "integrity": "sha512-ZZow9HBI5O6EPgSJLUb8n2NKgmVWTwCvHGwFuJlMjvLFqlGG6pjirPhtdsseaLZjSibD8eegzmYpUZwoIlj2cQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-includes": "^3.1.6", + "array.prototype.flat": "^1.3.1", + "object.assign": "^4.1.4", + "object.values": "^1.1.6" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/jwa": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz", + "integrity": "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg==", + "license": "MIT", + "dependencies": { + "buffer-equal-constant-time": "^1.0.1", + "ecdsa-sig-formatter": "1.0.11", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/jws": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/jws/-/jws-4.0.1.tgz", + "integrity": "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA==", + "license": "MIT", + "dependencies": { + "jwa": "^2.0.1", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, + "node_modules/language-subtag-registry": { + "version": "0.3.23", + "resolved": "https://registry.npmjs.org/language-subtag-registry/-/language-subtag-registry-0.3.23.tgz", + "integrity": "sha512-0K65Lea881pHotoGEa5gDlMxt3pctLi2RplBb7Ezh4rRdLEOtgi7n4EwK9lamnUCkKBqaeKRVebTq6BAxSkpXQ==", + "dev": true, + "license": "CC0-1.0" + }, + "node_modules/language-tags": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/language-tags/-/language-tags-1.0.9.tgz", + "integrity": "sha512-MbjN408fEndfiQXbFQ1vnd+1NoLDsnQW41410oQBXiyXDMYH5z505juWa4KUE1LqxRC7DgOgZDbKLxHIwm27hA==", + "dev": true, + "license": "MIT", + "dependencies": { + "language-subtag-registry": "^0.3.20" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/lightningcss": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.32.0.tgz", + "integrity": "sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==", + "dev": true, + "license": "MPL-2.0", + "dependencies": { + "detect-libc": "^2.0.3" + }, + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + }, + "optionalDependencies": { + "lightningcss-android-arm64": "1.32.0", + "lightningcss-darwin-arm64": "1.32.0", + "lightningcss-darwin-x64": "1.32.0", + "lightningcss-freebsd-x64": "1.32.0", + "lightningcss-linux-arm-gnueabihf": "1.32.0", + "lightningcss-linux-arm64-gnu": "1.32.0", + "lightningcss-linux-arm64-musl": "1.32.0", + "lightningcss-linux-x64-gnu": "1.32.0", + "lightningcss-linux-x64-musl": "1.32.0", + "lightningcss-win32-arm64-msvc": "1.32.0", + "lightningcss-win32-x64-msvc": "1.32.0" + } + }, + "node_modules/lightningcss-android-arm64": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.32.0.tgz", + "integrity": "sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-arm64": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.32.0.tgz", + "integrity": "sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-x64": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.32.0.tgz", + "integrity": "sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-freebsd-x64": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.32.0.tgz", + "integrity": "sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm-gnueabihf": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.32.0.tgz", + "integrity": "sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-gnu": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.32.0.tgz", + "integrity": "sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-musl": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.32.0.tgz", + "integrity": "sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-gnu": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.32.0.tgz", + "integrity": "sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-musl": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.32.0.tgz", + "integrity": "sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-arm64-msvc": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.32.0.tgz", + "integrity": "sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-x64-msvc": { + "version": "1.32.0", + "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.32.0.tgz", + "integrity": "sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/lodash.includes": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz", + "integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==", + "license": "MIT" + }, + "node_modules/lodash.isboolean": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz", + "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==", + "license": "MIT" + }, + "node_modules/lodash.isinteger": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz", + "integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==", + "license": "MIT" + }, + "node_modules/lodash.isnumber": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz", + "integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==", + "license": "MIT" + }, + "node_modules/lodash.isplainobject": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", + "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", + "license": "MIT" + }, + "node_modules/lodash.isstring": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz", + "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==", + "license": "MIT" + }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.once": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz", + "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==", + "license": "MIT" + }, + "node_modules/long": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz", + "integrity": "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA==", + "license": "Apache-2.0" + }, + "node_modules/loose-envify": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz", + "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "js-tokens": "^3.0.0 || ^4.0.0" + }, + "bin": { + "loose-envify": "cli.js" + } + }, + "node_modules/lru-cache": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz", + "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", + "dev": true, + "license": "ISC", + "dependencies": { + "yallist": "^3.0.2" + } + }, + "node_modules/lru.min": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/lru.min/-/lru.min-1.1.4.tgz", + "integrity": "sha512-DqC6n3QQ77zdFpCMASA1a3Jlb64Hv2N2DciFGkO/4L9+q/IpIAuRlKOvCXabtRW6cQf8usbmM6BE/TOPysCdIA==", + "license": "MIT", + "engines": { + "bun": ">=1.0.0", + "deno": ">=1.30.0", + "node": ">=8.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wellwelwel" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/minimatch": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/motion-dom": { + "version": "12.38.0", + "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.38.0.tgz", + "integrity": "sha512-pdkHLD8QYRp8VfiNLb8xIBJis1byQ9gPT3Jnh2jqfFtAsWUA3dEepDlsWe/xMpO8McV+VdpKVcp+E+TGJEtOoA==", + "license": "MIT", + "dependencies": { + "motion-utils": "^12.36.0" + } + }, + "node_modules/motion-utils": { + "version": "12.36.0", + "resolved": "https://registry.npmjs.org/motion-utils/-/motion-utils-12.36.0.tgz", + "integrity": "sha512-eHWisygbiwVvf6PZ1vhaHCLamvkSbPIeAYxWUuL3a2PD/TROgE7FvfHWTIH4vMl798QLfMw15nRqIaRDXTlYRg==", + "license": "MIT" + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/mysql2": { + "version": "3.15.3", + "resolved": "https://registry.npmjs.org/mysql2/-/mysql2-3.15.3.tgz", + "integrity": "sha512-FBrGau0IXmuqg4haEZRBfHNWB5mUARw6hNwPDXXGg0XzVJ50mr/9hb267lvpVMnhZ1FON3qNd4Xfcez1rbFwSg==", + "license": "MIT", + "dependencies": { + "aws-ssl-profiles": "^1.1.1", + "denque": "^2.1.0", + "generate-function": "^2.3.1", + "iconv-lite": "^0.7.0", + "long": "^5.2.1", + "lru.min": "^1.0.0", + "named-placeholders": "^1.1.3", + "seq-queue": "^0.0.5", + "sqlstring": "^2.3.2" + }, + "engines": { + "node": ">= 8.0" + } + }, + "node_modules/mysql2/node_modules/iconv-lite": { + "version": "0.7.2", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.2.tgz", + "integrity": "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/named-placeholders": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/named-placeholders/-/named-placeholders-1.1.6.tgz", + "integrity": "sha512-Tz09sEL2EEuv5fFowm419c1+a/jSMiBjI9gHxVLrVdbUkkNUUfjsVYs9pVZu5oCon/kmRh9TfLEObFtkVxmY0w==", + "license": "MIT", + "dependencies": { + "lru.min": "^1.1.0" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/nanoid": { + "version": "3.3.12", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.12.tgz", + "integrity": "sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/napi-postinstall": { + "version": "0.3.4", + "resolved": "https://registry.npmjs.org/napi-postinstall/-/napi-postinstall-0.3.4.tgz", + "integrity": "sha512-PHI5f1O0EP5xJ9gQmFGMS6IZcrVvTjpXjz7Na41gTE7eE2hK11lg04CECCYEEjdc17EV4DO+fkGEtt7TpTaTiQ==", + "dev": true, + "license": "MIT", + "bin": { + "napi-postinstall": "lib/cli.js" + }, + "engines": { + "node": "^12.20.0 || ^14.18.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/napi-postinstall" + } + }, + "node_modules/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" + }, + "node_modules/next": { + "version": "16.2.6", + "resolved": "https://registry.npmjs.org/next/-/next-16.2.6.tgz", + "integrity": "sha512-qOVgKJg1+At15NpeUP+eJgCHvTCgXsogweq87Ri/Ix7PkqQHg4sdaXmSFqKlgaIXE4kW0g25LE68W87UANlHtw==", + "license": "MIT", + "dependencies": { + "@next/env": "16.2.6", + "@swc/helpers": "0.5.15", + "baseline-browser-mapping": "^2.9.19", + "caniuse-lite": "^1.0.30001579", + "postcss": "8.4.31", + "styled-jsx": "5.1.6" + }, + "bin": { + "next": "dist/bin/next" + }, + "engines": { + "node": ">=20.9.0" + }, + "optionalDependencies": { + "@next/swc-darwin-arm64": "16.2.6", + "@next/swc-darwin-x64": "16.2.6", + "@next/swc-linux-arm64-gnu": "16.2.6", + "@next/swc-linux-arm64-musl": "16.2.6", + "@next/swc-linux-x64-gnu": "16.2.6", + "@next/swc-linux-x64-musl": "16.2.6", + "@next/swc-win32-arm64-msvc": "16.2.6", + "@next/swc-win32-x64-msvc": "16.2.6", + "sharp": "^0.34.5" + }, + "peerDependencies": { + "@opentelemetry/api": "^1.1.0", + "@playwright/test": "^1.51.1", + "babel-plugin-react-compiler": "*", + "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", + "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", + "sass": "^1.3.0" + }, + "peerDependenciesMeta": { + "@opentelemetry/api": { + "optional": true + }, + "@playwright/test": { + "optional": true + }, + "babel-plugin-react-compiler": { + "optional": true + }, + "sass": { + "optional": true + } + } + }, + "node_modules/next/node_modules/postcss": { + "version": "8.4.31", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.31.tgz", + "integrity": "sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.6", + "picocolors": "^1.0.0", + "source-map-js": "^1.0.2" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/node-domexception": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/node-domexception/-/node-domexception-1.0.0.tgz", + "integrity": "sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ==", + "deprecated": "Use your platform's native DOMException instead", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/jimmywarting" + }, + { + "type": "github", + "url": "https://paypal.me/jimmywarting" + } + ], + "license": "MIT", + "engines": { + "node": ">=10.5.0" + } + }, + "node_modules/node-exports-info": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/node-exports-info/-/node-exports-info-1.6.0.tgz", + "integrity": "sha512-pyFS63ptit/P5WqUkt+UUfe+4oevH+bFeIiPPdfb0pFeYEu/1ELnJu5l+5EcTKYL5M7zaAa7S8ddywgXypqKCw==", + "dev": true, + "license": "MIT", + "dependencies": { + "array.prototype.flatmap": "^1.3.3", + "es-errors": "^1.3.0", + "object.entries": "^1.1.9", + "semver": "^6.3.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/node-fetch": { + "version": "3.3.2", + "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-3.3.2.tgz", + "integrity": "sha512-dRB78srN/l6gqWulah9SrxeYnxeddIG30+GOqK/9OlLVyLg3HPnr6SqOWTWOXKRwC2eGYCkZ59NNuSgvSrpgOA==", + "license": "MIT", + "dependencies": { + "data-uri-to-buffer": "^4.0.0", + "fetch-blob": "^3.1.4", + "formdata-polyfill": "^4.0.10" + }, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/node-fetch" + } + }, + "node_modules/node-releases": { + "version": "2.0.44", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.44.tgz", + "integrity": "sha512-5WUyunoPMsvvEhS8AxHtRzP+oA8UCkJ7YRxatWKjngndhDGLiqEVAQKWjFAiAiuL8zMRGzGSJxFnLetoa43qGQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-inspect": { + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object-keys": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz", + "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/object.assign": { + "version": "4.1.7", + "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.7.tgz", + "integrity": "sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0", + "has-symbols": "^1.1.0", + "object-keys": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object.entries": { + "version": "1.1.9", + "resolved": "https://registry.npmjs.org/object.entries/-/object.entries-1.1.9.tgz", + "integrity": "sha512-8u/hfXFRBD1O0hPUjioLhoWFHRmt6tKA4/vZPyckBr18l1KE9uHrFaFaUi8MDRTpi4uak2goyPTSNJLXX2k2Hw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.4", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/object.fromentries": { + "version": "2.0.8", + "resolved": "https://registry.npmjs.org/object.fromentries/-/object.fromentries-2.0.8.tgz", + "integrity": "sha512-k6E21FzySsSK5a21KRADBd/NGneRegFO5pLHfdQLpRDETUNJueLXs3WCzyQ3tFRDYgbq3KHGXfTbi2bs8WQ6rQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.2", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object.groupby": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/object.groupby/-/object.groupby-1.0.3.tgz", + "integrity": "sha512-+Lhy3TQTuzXI5hevh8sBGqbmurHbbIjAi0Z4S63nthVLmLxfbj4T54a4CfZrXIrt9iP4mVAPYMo/v99taj3wjQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/object.values": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/object.values/-/object.values-1.2.1.tgz", + "integrity": "sha512-gXah6aZrcUxjWg2zR2MwouP2eHlCBzdV4pygudehaKXSGW4v2AsRQUK+lwwXhii6KFZcunEnmSUoYp5CXibxtA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/ohash": { + "version": "2.0.11", + "resolved": "https://registry.npmjs.org/ohash/-/ohash-2.0.11.tgz", + "integrity": "sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==", + "license": "MIT" + }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/own-keys": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/own-keys/-/own-keys-1.0.1.tgz", + "integrity": "sha512-qFOyK5PjiWZd+QQIh+1jhdb9LpxTF0qs7Pm8o5QHYZ0M3vKqSqzsZaEB6oWlxZ+q2sJBMI/Ktgd2N5ZwQoRHfg==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-intrinsic": "^1.2.6", + "object-keys": "^1.1.1", + "safe-push-apply": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-parse": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", + "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", + "dev": true, + "license": "MIT" + }, + "node_modules/pathe": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz", + "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==", + "license": "MIT" + }, + "node_modules/perfect-debounce": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/perfect-debounce/-/perfect-debounce-2.1.0.tgz", + "integrity": "sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==", + "license": "MIT" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pkg-types": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-2.3.1.tgz", + "integrity": "sha512-y+ichcgc2LrADuhLNAx8DFjVfgz91pRxfZdI3UDhxHvcVEZsenLO+7XaU5vOp0u/7V/wZ+plyuQxtrDlZJ+yeg==", + "license": "MIT", + "dependencies": { + "confbox": "^0.2.4", + "exsolve": "^1.0.8", + "pathe": "^2.0.3" + } + }, + "node_modules/possible-typed-array-names": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.1.0.tgz", + "integrity": "sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/postcss": { + "version": "8.5.14", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.14.tgz", + "integrity": "sha512-SoSL4+OSEtR99LHFZQiJLkT59C5B1amGO1NzTwj7TT1qCUgUO6hxOvzkOYxD+vMrXBM3XJIKzokoERdqQq/Zmg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.11", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/postgres": { + "version": "3.4.7", + "resolved": "https://registry.npmjs.org/postgres/-/postgres-3.4.7.tgz", + "integrity": "sha512-Jtc2612XINuBjIl/QTWsV5UvE8UHuNblcO3vVADSrKsrc6RqGX6lOW1cEo3CM2v0XG4Nat8nI+YM7/f26VxXLw==", + "license": "Unlicense", + "engines": { + "node": ">=12" + }, + "funding": { + "type": "individual", + "url": "https://github.com/sponsors/porsager" + } + }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/prisma": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/prisma/-/prisma-7.8.0.tgz", + "integrity": "sha512-yfN4yrw7HV9kEJhoy1+jgah0jafEIQsf7uWouSsM8MvJtlubsk+kM7AIBWZ8+GJl74Yj3c+nbYqBkMOxtsZ3Lw==", + "hasInstallScript": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/config": "7.8.0", + "@prisma/dev": "0.24.3", + "@prisma/engines": "7.8.0", + "@prisma/studio-core": "0.27.3", + "mysql2": "3.15.3", + "postgres": "3.4.7" + }, + "bin": { + "prisma": "build/index.js" + }, + "engines": { + "node": "^20.19 || ^22.12 || >=24.0" + }, + "peerDependencies": { + "better-sqlite3": ">=9.0.0", + "typescript": ">=5.4.0" + }, + "peerDependenciesMeta": { + "better-sqlite3": { + "optional": true + }, + "typescript": { + "optional": true + } + } + }, + "node_modules/prop-types": { + "version": "15.8.1", + "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz", + "integrity": "sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==", + "dev": true, + "license": "MIT", + "dependencies": { + "loose-envify": "^1.4.0", + "object-assign": "^4.1.1", + "react-is": "^16.13.1" + } + }, + "node_modules/proper-lockfile": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/proper-lockfile/-/proper-lockfile-4.1.2.tgz", + "integrity": "sha512-TjNPblN4BwAWMXU8s9AEz4JmQxnD1NNL7bNOY/AKUzyamc379FWASUhc/K1pL2noVb+XmZKLL68cjzLsiOAMaA==", + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.4", + "retry": "^0.12.0", + "signal-exit": "^3.0.2" + } + }, + "node_modules/proper-lockfile/node_modules/signal-exit": { + "version": "3.0.7", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", + "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", + "license": "ISC" + }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/pure-rand": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/pure-rand/-/pure-rand-6.1.0.tgz", + "integrity": "sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/dubzzz" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fast-check" + } + ], + "license": "MIT" + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/rc9": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/rc9/-/rc9-3.0.1.tgz", + "integrity": "sha512-gMDyleLWVE+i6Sgtc0QbbY6pEKqYs97NGi6isHQPqYlLemPoO8dxQ3uGi0f4NiP98c+jMW6cG1Kx9dDwfvqARQ==", + "license": "MIT", + "dependencies": { + "defu": "^6.1.6", + "destr": "^2.0.5" + } + }, + "node_modules/react": { + "version": "19.2.4", + "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", + "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-dom": { + "version": "19.2.4", + "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.4.tgz", + "integrity": "sha512-AXJdLo8kgMbimY95O2aKQqsz2iWi9jMgKJhRBAxECE4IFxfcazB2LmzloIoibJI3C12IlY20+KFaLv+71bUJeQ==", + "license": "MIT", + "dependencies": { + "scheduler": "^0.27.0" + }, + "peerDependencies": { + "react": "^19.2.4" + } + }, + "node_modules/react-is": { + "version": "16.13.1", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", + "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/readdirp": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.0.0.tgz", + "integrity": "sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==", + "license": "MIT", + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "type": "individual", + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/reflect.getprototypeof": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/reflect.getprototypeof/-/reflect.getprototypeof-1.0.10.tgz", + "integrity": "sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.9", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.0.0", + "get-intrinsic": "^1.2.7", + "get-proto": "^1.0.1", + "which-builtin-type": "^1.2.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/regexp.prototype.flags": { + "version": "1.5.4", + "resolved": "https://registry.npmjs.org/regexp.prototype.flags/-/regexp.prototype.flags-1.5.4.tgz", + "integrity": "sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "es-errors": "^1.3.0", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "set-function-name": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/remeda": { + "version": "2.33.4", + "resolved": "https://registry.npmjs.org/remeda/-/remeda-2.33.4.tgz", + "integrity": "sha512-ygHswjlc/opg2VrtiYvUOPLjxjtdKvjGz1/plDhkG66hjNjFr1xmfrs2ClNFo/E6TyUFiwYNh53bKV26oBoMGQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/remeda" + } + }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/resolve": { + "version": "2.0.0-next.6", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-2.0.0-next.6.tgz", + "integrity": "sha512-3JmVl5hMGtJ3kMmB3zi3DL25KfkCEyy3Tw7Gmw7z5w8M9WlwoPFnIvwChzu1+cF3iaK3sp18hhPz8ANeimdJfA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "is-core-module": "^2.16.1", + "node-exports-info": "^1.6.0", + "object-keys": "^1.1.1", + "path-parse": "^1.0.7", + "supports-preserve-symlinks-flag": "^1.0.0" + }, + "bin": { + "resolve": "bin/resolve" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/resolve-pkg-maps": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz", + "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1" + } + }, + "node_modules/retry": { + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/retry/-/retry-0.12.0.tgz", + "integrity": "sha512-9LkiTwjUh6rT555DtE9rTX+BKByPfrMzEAtnlEtdEwr3Nkffwiihqe2bWADg+OQRjt9gl6ICdmB/ZFDCGAtSow==", + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/robust-predicates": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/robust-predicates/-/robust-predicates-3.0.3.tgz", + "integrity": "sha512-NS3levdsRIUOmiJ8FZWCP7LG3QpJyrs/TE0Zpf1yvZu8cAJJ6QMW92H1c7kWpdIHo8RvmLxN/o2JXTKHp74lUA==", + "license": "Unlicense" + }, + "node_modules/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, + "node_modules/rw": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/rw/-/rw-1.3.3.tgz", + "integrity": "sha512-PdhdWy89SiZogBLaw42zdeqtRJ//zFd2PgQavcICDUgJT5oW10QCRKbJ6bg4r0/UY2M6BWd5tkxuGFRvCkgfHQ==", + "license": "BSD-3-Clause" + }, + "node_modules/safe-array-concat": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/safe-array-concat/-/safe-array-concat-1.1.4.tgz", + "integrity": "sha512-wtZlHyOje6OZTGqAoaDKxFkgRtkF9CnHAVnCHKfuj200wAgL+bSJhdsCD2l0Qx/2ekEXjPWcyKkfGb5CPboslg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.9", + "call-bound": "^1.0.4", + "get-intrinsic": "^1.3.0", + "has-symbols": "^1.1.0", + "isarray": "^2.0.5" + }, + "engines": { + "node": ">=0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/safe-push-apply": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/safe-push-apply/-/safe-push-apply-1.0.0.tgz", + "integrity": "sha512-iKE9w/Z7xCzUMIZqdBsp6pEQvwuEebH4vdpjcDWnyzaI6yl6O9FHvVpmGelvEHNsoY6wGblkxR6Zty/h00WiSA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "isarray": "^2.0.5" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/safe-regex-test": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/safe-regex-test/-/safe-regex-test-1.1.0.tgz", + "integrity": "sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "is-regex": "^1.2.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "license": "MIT" + }, + "node_modules/scheduler": { + "version": "0.27.0", + "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz", + "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==", + "license": "MIT" + }, + "node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/seq-queue": { + "version": "0.0.5", + "resolved": "https://registry.npmjs.org/seq-queue/-/seq-queue-0.0.5.tgz", + "integrity": "sha512-hr3Wtp/GZIc/6DAGPDcV4/9WoZhjrkXsi5B/07QgX8tsdc6ilr7BFM6PM6rbdAX1kFSDYeZGLipIZZKyQP0O5Q==" + }, + "node_modules/set-function-length": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", + "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-errors": "^1.3.0", + "function-bind": "^1.1.2", + "get-intrinsic": "^1.2.4", + "gopd": "^1.0.1", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/set-function-name": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/set-function-name/-/set-function-name-2.0.2.tgz", + "integrity": "sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-errors": "^1.3.0", + "functions-have-names": "^1.2.3", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/set-proto": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/set-proto/-/set-proto-1.0.0.tgz", + "integrity": "sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/sharp": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.5.tgz", + "integrity": "sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg==", + "hasInstallScript": true, + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@img/colour": "^1.0.0", + "detect-libc": "^2.1.2", + "semver": "^7.7.3" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-darwin-arm64": "0.34.5", + "@img/sharp-darwin-x64": "0.34.5", + "@img/sharp-libvips-darwin-arm64": "1.2.4", + "@img/sharp-libvips-darwin-x64": "1.2.4", + "@img/sharp-libvips-linux-arm": "1.2.4", + "@img/sharp-libvips-linux-arm64": "1.2.4", + "@img/sharp-libvips-linux-ppc64": "1.2.4", + "@img/sharp-libvips-linux-riscv64": "1.2.4", + "@img/sharp-libvips-linux-s390x": "1.2.4", + "@img/sharp-libvips-linux-x64": "1.2.4", + "@img/sharp-libvips-linuxmusl-arm64": "1.2.4", + "@img/sharp-libvips-linuxmusl-x64": "1.2.4", + "@img/sharp-linux-arm": "0.34.5", + "@img/sharp-linux-arm64": "0.34.5", + "@img/sharp-linux-ppc64": "0.34.5", + "@img/sharp-linux-riscv64": "0.34.5", + "@img/sharp-linux-s390x": "0.34.5", + "@img/sharp-linux-x64": "0.34.5", + "@img/sharp-linuxmusl-arm64": "0.34.5", + "@img/sharp-linuxmusl-x64": "0.34.5", + "@img/sharp-wasm32": "0.34.5", + "@img/sharp-win32-arm64": "0.34.5", + "@img/sharp-win32-ia32": "0.34.5", + "@img/sharp-win32-x64": "0.34.5" + } + }, + "node_modules/sharp/node_modules/semver": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.0.tgz", + "integrity": "sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==", + "license": "ISC", + "optional": true, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/side-channel": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz", + "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3", + "side-channel-list": "^1.0.0", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz", + "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/signal-exit": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", + "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", + "license": "ISC", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/sqlstring": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/sqlstring/-/sqlstring-2.3.3.tgz", + "integrity": "sha512-qC9iz2FlN7DQl3+wjwn3802RTyjCx7sDvfQEXchwa6CWOx07/WVfh91gBmQ9fahw8snwGEWU3xGzOt4tFyHLxg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/stable-hash": { + "version": "0.0.5", + "resolved": "https://registry.npmjs.org/stable-hash/-/stable-hash-0.0.5.tgz", + "integrity": "sha512-+L3ccpzibovGXFK+Ap/f8LOS0ahMrHTf3xu7mMLSpEGU0EO9ucaysSylKo9eRDFNhWve/y275iPmIZ4z39a9iA==", + "dev": true, + "license": "MIT" + }, + "node_modules/std-env": { + "version": "3.10.0", + "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz", + "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==", + "license": "MIT" + }, + "node_modules/stop-iteration-iterator": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/stop-iteration-iterator/-/stop-iteration-iterator-1.1.0.tgz", + "integrity": "sha512-eLoXW/DHyl62zxY4SCaIgnRhuMr6ri4juEYARS8E6sCEqzKpOiE521Ucofdx+KnDZl5xmvGYaaKCk5FEOxJCoQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "internal-slot": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/string.prototype.includes": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/string.prototype.includes/-/string.prototype.includes-2.0.1.tgz", + "integrity": "sha512-o7+c9bW6zpAdJHTtujeePODAhkuicdAryFsfVKwA+wGw89wJ4GTY484WTucM9hLtDEOpOvI+aHnzqnC5lHp4Rg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.3" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/string.prototype.matchall": { + "version": "4.0.12", + "resolved": "https://registry.npmjs.org/string.prototype.matchall/-/string.prototype.matchall-4.0.12.tgz", + "integrity": "sha512-6CC9uyBL+/48dYizRf7H7VAYCMCNTBeM78x/VTUe9bFEaxBepPJDa1Ow99LqI/1yF7kuy7Q3cQsYMrcjGUcskA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.3", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.6", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.0.0", + "get-intrinsic": "^1.2.6", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "internal-slot": "^1.1.0", + "regexp.prototype.flags": "^1.5.3", + "set-function-name": "^2.0.2", + "side-channel": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.repeat": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/string.prototype.repeat/-/string.prototype.repeat-1.0.0.tgz", + "integrity": "sha512-0u/TldDbKD8bFCQ/4f5+mNRrXwZ8hg2w7ZR8wa16e8z9XpePWl3eGEcUD0OXpEH/VJH/2G3gjUtR3ZOiBe2S/w==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-properties": "^1.1.3", + "es-abstract": "^1.17.5" + } + }, + "node_modules/string.prototype.trim": { + "version": "1.2.10", + "resolved": "https://registry.npmjs.org/string.prototype.trim/-/string.prototype.trim-1.2.10.tgz", + "integrity": "sha512-Rs66F0P/1kedk5lyYyH9uBzuiI/kNRmwJAR9quK6VOtIpZ2G+hMZd+HQbbv25MgCA6gEffoMZYxlTod4WcdrKA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.2", + "define-data-property": "^1.1.4", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.5", + "es-object-atoms": "^1.0.0", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.trimend": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/string.prototype.trimend/-/string.prototype.trimend-1.0.9.tgz", + "integrity": "sha512-G7Ok5C6E/j4SGfyLCloXTrngQIQU3PWtXGst3yM7Bea9FRURf1S42ZHlZZtsNque2FN2PoUhfZXYLNWwEr4dLQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "call-bound": "^1.0.2", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.trimstart": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/string.prototype.trimstart/-/string.prototype.trimstart-1.0.8.tgz", + "integrity": "sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/strip-bom": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", + "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/styled-jsx": { + "version": "5.1.6", + "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.1.6.tgz", + "integrity": "sha512-qSVyDTeMotdvQYoHWLNGwRFJHC+i+ZvdBRYosOFgC+Wg1vx4frN2/RG/NA7SYqqvKNLf39P2LSRA2pu6n0XYZA==", + "license": "MIT", + "dependencies": { + "client-only": "0.0.1" + }, + "engines": { + "node": ">= 12.0.0" + }, + "peerDependencies": { + "react": ">= 16.8.0 || 17.x.x || ^18.0.0-0 || ^19.0.0-0" + }, + "peerDependenciesMeta": { + "@babel/core": { + "optional": true + }, + "babel-plugin-macros": { + "optional": true + } + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/supports-preserve-symlinks-flag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", + "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/tailwindcss": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.3.0.tgz", + "integrity": "sha512-y6nxMGB1nMW9R6k96e5gdIFzcfL/gTJRNaqGes1YvkLnPVXzWgbqFF2yLC0T8G774n24cx3Pe8XrKoniCOAH+Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/tapable": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.3.tgz", + "integrity": "sha512-uxc/zpqFg6x7C8vOE7lh6Lbda8eEL9zmVm/PLeTPBRhh1xCgdWaQ+J1CUieGpIfm2HdtsUpRv+HshiasBMcc6A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.16", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.16.tgz", + "integrity": "sha512-pn99VhoACYR8nFHhxqix+uvsbXineAasWm5ojXoN8xEwK5Kd3/TrhNn1wByuD52UxWRLy8pu+kRMniEi6Eq9Zg==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tinyglobby/node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/tinyglobby/node_modules/picomatch": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz", + "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/ts-api-utils": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz", + "integrity": "sha512-OJ/ibxhPlqrMM0UiNHJ/0CKQkoKF243/AEmplt3qpRgkW8VG7IfOS41h7V8TjITqdByHzrjcS/2si+y4lIh8NA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18.12" + }, + "peerDependencies": { + "typescript": ">=4.8.4" + } + }, + "node_modules/tsconfig-paths": { + "version": "3.15.0", + "resolved": "https://registry.npmjs.org/tsconfig-paths/-/tsconfig-paths-3.15.0.tgz", + "integrity": "sha512-2Ac2RgzDe/cn48GvOe3M+o82pEFewD3UPbyoUHHdKasHwJKjds4fLXWf/Ux5kATBKN20oaFGu+jbElp1pos0mg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/json5": "^0.0.29", + "json5": "^1.0.2", + "minimist": "^1.2.6", + "strip-bom": "^3.0.0" + } + }, + "node_modules/tsconfig-paths/node_modules/json5": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz", + "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==", + "dev": true, + "license": "MIT", + "dependencies": { + "minimist": "^1.2.0" + }, + "bin": { + "json5": "lib/cli.js" + } + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/typed-array-buffer": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz", + "integrity": "sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "es-errors": "^1.3.0", + "is-typed-array": "^1.1.14" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/typed-array-byte-length": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/typed-array-byte-length/-/typed-array-byte-length-1.0.3.tgz", + "integrity": "sha512-BaXgOuIxz8n8pIq3e7Atg/7s+DpiYrxn4vdot3w9KbnBhcRQq6o3xemQdIfynqSeXeDrF32x+WvfzmOjPiY9lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "for-each": "^0.3.3", + "gopd": "^1.2.0", + "has-proto": "^1.2.0", + "is-typed-array": "^1.1.14" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typed-array-byte-offset": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/typed-array-byte-offset/-/typed-array-byte-offset-1.0.4.tgz", + "integrity": "sha512-bTlAFB/FBYMcuX81gbL4OcpH5PmlFHqlCCpAl8AlEzMz5k53oNDvN8p1PNOWLEmI2x4orp3raOFB51tv9X+MFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.8", + "for-each": "^0.3.3", + "gopd": "^1.2.0", + "has-proto": "^1.2.0", + "is-typed-array": "^1.1.15", + "reflect.getprototypeof": "^1.0.9" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typed-array-length": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/typed-array-length/-/typed-array-length-1.0.7.tgz", + "integrity": "sha512-3KS2b+kL7fsuk/eJZ7EQdnEmQoaho/r6KUef7hxvltNA5DR8NAUM+8wJMbJyZ4G9/7i3v5zPBIMN5aybAh2/Jg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "for-each": "^0.3.3", + "gopd": "^1.0.1", + "is-typed-array": "^1.1.13", + "possible-typed-array-names": "^1.0.0", + "reflect.getprototypeof": "^1.0.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "devOptional": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/typescript-eslint": { + "version": "8.59.3", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.59.3.tgz", + "integrity": "sha512-KgusgyDgG4LI8Ih/sWaCtZ06tckLAS5CvT5A4D1Q7bYVoAAyzwiZvE4BmwDHkhRVkvhRBepKeASoFzQetha7Fg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/eslint-plugin": "8.59.3", + "@typescript-eslint/parser": "8.59.3", + "@typescript-eslint/typescript-estree": "8.59.3", + "@typescript-eslint/utils": "8.59.3" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0", + "typescript": ">=4.8.4 <6.1.0" + } + }, + "node_modules/unbox-primitive": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.1.0.tgz", + "integrity": "sha512-nWJ91DjeOkej/TA8pXQ3myruKpKEYgqvpw9lz4OPHj/NWFNluYrjbz9j01CJ8yKQd2g4jFoOkINCTW2I5LEEyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.3", + "has-bigints": "^1.0.2", + "has-symbols": "^1.1.0", + "which-boxed-primitive": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/undici-types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/unrs-resolver": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/unrs-resolver/-/unrs-resolver-1.11.1.tgz", + "integrity": "sha512-bSjt9pjaEBnNiGgc9rUiHGKv5l4/TGzDmYw3RhnkJGtLhbnnA/5qJj7x3dNDCRx/PJxu774LlH8lCOlB4hEfKg==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "dependencies": { + "napi-postinstall": "^0.3.0" + }, + "funding": { + "url": "https://opencollective.com/unrs-resolver" + }, + "optionalDependencies": { + "@unrs/resolver-binding-android-arm-eabi": "1.11.1", + "@unrs/resolver-binding-android-arm64": "1.11.1", + "@unrs/resolver-binding-darwin-arm64": "1.11.1", + "@unrs/resolver-binding-darwin-x64": "1.11.1", + "@unrs/resolver-binding-freebsd-x64": "1.11.1", + "@unrs/resolver-binding-linux-arm-gnueabihf": "1.11.1", + "@unrs/resolver-binding-linux-arm-musleabihf": "1.11.1", + "@unrs/resolver-binding-linux-arm64-gnu": "1.11.1", + "@unrs/resolver-binding-linux-arm64-musl": "1.11.1", + "@unrs/resolver-binding-linux-ppc64-gnu": "1.11.1", + "@unrs/resolver-binding-linux-riscv64-gnu": "1.11.1", + "@unrs/resolver-binding-linux-riscv64-musl": "1.11.1", + "@unrs/resolver-binding-linux-s390x-gnu": "1.11.1", + "@unrs/resolver-binding-linux-x64-gnu": "1.11.1", + "@unrs/resolver-binding-linux-x64-musl": "1.11.1", + "@unrs/resolver-binding-wasm32-wasi": "1.11.1", + "@unrs/resolver-binding-win32-arm64-msvc": "1.11.1", + "@unrs/resolver-binding-win32-ia32-msvc": "1.11.1", + "@unrs/resolver-binding-win32-x64-msvc": "1.11.1" + } + }, + "node_modules/update-browserslist-db": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz", + "integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.1" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/valibot": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/valibot/-/valibot-1.2.0.tgz", + "integrity": "sha512-mm1rxUsmOxzrwnX5arGS+U4T25RdvpPjPN4yR0u9pUBov9+zGVtO84tif1eY4r6zWxVxu3KzIyknJy3rxfRZZg==", + "license": "MIT", + "peerDependencies": { + "typescript": ">=5" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/web-streams-polyfill": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/web-streams-polyfill/-/web-streams-polyfill-3.3.3.tgz", + "integrity": "sha512-d2JWLCivmZYTSIoge9MsgFCZrt571BikcWGYkjC1khllbTeDlGqZ2D8vD8E/lJa8WGWbb7Plm8/XJYV7IJHZZw==", + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/which-boxed-primitive": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/which-boxed-primitive/-/which-boxed-primitive-1.1.1.tgz", + "integrity": "sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-bigint": "^1.1.0", + "is-boolean-object": "^1.2.1", + "is-number-object": "^1.1.1", + "is-string": "^1.1.1", + "is-symbol": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-builtin-type": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/which-builtin-type/-/which-builtin-type-1.2.1.tgz", + "integrity": "sha512-6iBczoX+kDQ7a3+YJBnh3T+KZRxM/iYNPXicqk66/Qfm1b93iu+yOImkg0zHbj5LNOcNv1TEADiZ0xa34B4q6Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "function.prototype.name": "^1.1.6", + "has-tostringtag": "^1.0.2", + "is-async-function": "^2.0.0", + "is-date-object": "^1.1.0", + "is-finalizationregistry": "^1.1.0", + "is-generator-function": "^1.0.10", + "is-regex": "^1.2.1", + "is-weakref": "^1.0.2", + "isarray": "^2.0.5", + "which-boxed-primitive": "^1.1.0", + "which-collection": "^1.0.2", + "which-typed-array": "^1.1.16" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-collection": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/which-collection/-/which-collection-1.0.2.tgz", + "integrity": "sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-map": "^2.0.3", + "is-set": "^2.0.3", + "is-weakmap": "^2.0.2", + "is-weakset": "^2.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-typed-array": { + "version": "1.1.20", + "resolved": "https://registry.npmjs.org/which-typed-array/-/which-typed-array-1.1.20.tgz", + "integrity": "sha512-LYfpUkmqwl0h9A2HL09Mms427Q1RZWuOHsukfVcKRq9q95iQxdw0ix1JQrqbcDR9PH1QDwf5Qo8OZb5lksZ8Xg==", + "dev": true, + "license": "MIT", + "dependencies": { + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.8", + "call-bound": "^1.0.4", + "for-each": "^0.3.5", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/yallist": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", + "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", + "dev": true, + "license": "ISC" + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/zeptomatch": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/zeptomatch/-/zeptomatch-2.1.0.tgz", + "integrity": "sha512-KiGErG2J0G82LSpniV0CtIzjlJ10E04j02VOudJsPyPwNZgGnRKQy7I1R7GMyg/QswnE4l7ohSGrQbQbjXPPDA==", + "license": "MIT", + "dependencies": { + "grammex": "^3.1.11", + "graphmatch": "^1.1.0" + } + }, + "node_modules/zod": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/zod/-/zod-4.4.3.tgz", + "integrity": "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/colinhacks" + } + }, + "node_modules/zod-validation-error": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/zod-validation-error/-/zod-validation-error-4.0.2.tgz", + "integrity": "sha512-Q6/nZLe6jxuU80qb/4uJ4t5v2VEZ44lzQjPDhYJNztRQ4wyWc6VF3D3Kb/fAuPetZQnhS3hnajCf9CsWesghLQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18.0.0" + }, + "peerDependencies": { + "zod": "^3.25.0 || ^4.0.0" + } + } + } +} diff --git a/dashboard/package.json b/dashboard/package.json new file mode 100644 index 0000000..0b87f23 --- /dev/null +++ b/dashboard/package.json @@ -0,0 +1,36 @@ +{ + "name": "dashboard", + "version": "0.1.0", + "private": true, + "scripts": { + "dev": "next dev", + "build": "next build", + "start": "next start", + "lint": "eslint" + }, + "dependencies": { + "@prisma/client": "^7.8.0", + "@tanstack/react-query": "^5.100.10", + "d3": "^7.9.0", + "framer-motion": "^12.38.0", + "google-auth-library": "^10.6.2", + "jsonwebtoken": "^9.0.3", + "next": "16.2.6", + "prisma": "^7.8.0", + "react": "19.2.4", + "react-dom": "19.2.4", + "zod": "^4.4.3" + }, + "devDependencies": { + "@tailwindcss/postcss": "^4", + "@types/d3": "^7.4.3", + "@types/jsonwebtoken": "^9.0.10", + "@types/node": "^20", + "@types/react": "^19", + "@types/react-dom": "^19", + "eslint": "^9", + "eslint-config-next": "16.2.6", + "tailwindcss": "^4", + "typescript": "^5" + } +} diff --git a/dashboard/postcss.config.mjs b/dashboard/postcss.config.mjs new file mode 100644 index 0000000..61e3684 --- /dev/null +++ b/dashboard/postcss.config.mjs @@ -0,0 +1,7 @@ +const config = { + plugins: { + "@tailwindcss/postcss": {}, + }, +}; + +export default config; diff --git a/dashboard/prisma.config.ts b/dashboard/prisma.config.ts new file mode 100644 index 0000000..831a20f --- /dev/null +++ b/dashboard/prisma.config.ts @@ -0,0 +1,14 @@ +// This file was generated by Prisma, and assumes you have installed the following: +// npm install --save-dev prisma dotenv +import "dotenv/config"; +import { defineConfig } from "prisma/config"; + +export default defineConfig({ + schema: "prisma/schema.prisma", + migrations: { + path: "prisma/migrations", + }, + datasource: { + url: process.env["DATABASE_URL"], + }, +}); diff --git a/dashboard/prisma/schema.prisma b/dashboard/prisma/schema.prisma new file mode 100644 index 0000000..5264d35 --- /dev/null +++ b/dashboard/prisma/schema.prisma @@ -0,0 +1,14 @@ +// This is your Prisma schema file, +// learn more about it in the docs: https://pris.ly/d/prisma-schema + +// Get a free hosted Postgres database in seconds: `npx create-db` + +generator client { + provider = "prisma-client" + output = "../app/generated/prisma" +} + +datasource db { + provider = "postgresql" + url = env("DATABASE_URL") +} diff --git a/dashboard/public/file.svg b/dashboard/public/file.svg new file mode 100644 index 0000000..004145c --- /dev/null +++ b/dashboard/public/file.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/dashboard/public/globe.svg b/dashboard/public/globe.svg new file mode 100644 index 0000000..567f17b --- /dev/null +++ b/dashboard/public/globe.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/dashboard/public/next.svg b/dashboard/public/next.svg new file mode 100644 index 0000000..5174b28 --- /dev/null +++ b/dashboard/public/next.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/dashboard/public/vercel.svg b/dashboard/public/vercel.svg new file mode 100644 index 0000000..7705396 --- /dev/null +++ b/dashboard/public/vercel.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/dashboard/public/window.svg b/dashboard/public/window.svg new file mode 100644 index 0000000..b2b2a44 --- /dev/null +++ b/dashboard/public/window.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/dashboard/tsconfig.json b/dashboard/tsconfig.json new file mode 100644 index 0000000..3a13f90 --- /dev/null +++ b/dashboard/tsconfig.json @@ -0,0 +1,34 @@ +{ + "compilerOptions": { + "target": "ES2017", + "lib": ["dom", "dom.iterable", "esnext"], + "allowJs": true, + "skipLibCheck": true, + "strict": true, + "noEmit": true, + "esModuleInterop": true, + "module": "esnext", + "moduleResolution": "bundler", + "resolveJsonModule": true, + "isolatedModules": true, + "jsx": "react-jsx", + "incremental": true, + "plugins": [ + { + "name": "next" + } + ], + "paths": { + "@/*": ["./*"] + } + }, + "include": [ + "next-env.d.ts", + "**/*.ts", + "**/*.tsx", + ".next/types/**/*.ts", + ".next/dev/types/**/*.ts", + "**/*.mts" + ], + "exclude": ["node_modules"] +} From acb8c5c595dc60086d118c3a056a71958768abb0 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Wed, 13 May 2026 23:52:07 +0300 Subject: [PATCH 02/24] feat(db): add postgres docker setup and prisma models (#2) Add docker-compose.yml with Postgres 16 on port 5433 (avoids conflict with host-installed Postgres on 5432). Add User, Session, Event, Track models with cascade deletes and FK indexes. Run first migration (init), applied locally and to Neon. Also fix .env.example exclusion in dashboard/.gitignore that silently dropped the file from the AC 1 PR. Closes Week 1 AC 2. --- dashboard/.env.example | 10 +++ dashboard/.gitignore | 1 + dashboard/prisma.config.ts | 6 +- .../20260513203222_init/migration.sql | 74 +++++++++++++++++++ .../prisma/migrations/migration_lock.toml | 3 + dashboard/prisma/schema.prisma | 55 ++++++++++++-- docker-compose.yml | 21 ++++++ 7 files changed, 160 insertions(+), 10 deletions(-) create mode 100644 dashboard/.env.example create mode 100644 dashboard/prisma/migrations/20260513203222_init/migration.sql create mode 100644 dashboard/prisma/migrations/migration_lock.toml create mode 100644 docker-compose.yml diff --git a/dashboard/.env.example b/dashboard/.env.example new file mode 100644 index 0000000..4fd5c05 --- /dev/null +++ b/dashboard/.env.example @@ -0,0 +1,10 @@ +# Postgres connection string (direct, no pooler). +# Local dev: docker-compose.yml provides the matching credentials. +# Production (Neon): direct connection string (no "-pooler" in hostname). +# Connection pooling in prod is handled via @prisma/adapter-neon, not a separate URL. +DATABASE_URL="postgresql://postgres:postgres@localhost:5433/worktrace" + +GOOGLE_CLIENT_ID="" +GOOGLE_CLIENT_SECRET="" +JWT_SECRET="" +NEXT_PUBLIC_APP_URL="http://localhost:3000" \ No newline at end of file diff --git a/dashboard/.gitignore b/dashboard/.gitignore index 45254b6..bf8d094 100644 --- a/dashboard/.gitignore +++ b/dashboard/.gitignore @@ -32,6 +32,7 @@ yarn-error.log* # env files (can opt-in for committing if needed) .env* +!.env.example # vercel .vercel diff --git a/dashboard/prisma.config.ts b/dashboard/prisma.config.ts index 831a20f..d73df7b 100644 --- a/dashboard/prisma.config.ts +++ b/dashboard/prisma.config.ts @@ -1,7 +1,5 @@ -// This file was generated by Prisma, and assumes you have installed the following: -// npm install --save-dev prisma dotenv import "dotenv/config"; -import { defineConfig } from "prisma/config"; +import { defineConfig, env } from "prisma/config"; export default defineConfig({ schema: "prisma/schema.prisma", @@ -9,6 +7,6 @@ export default defineConfig({ path: "prisma/migrations", }, datasource: { - url: process.env["DATABASE_URL"], + url: env("DATABASE_URL"), }, }); diff --git a/dashboard/prisma/migrations/20260513203222_init/migration.sql b/dashboard/prisma/migrations/20260513203222_init/migration.sql new file mode 100644 index 0000000..5527d0b --- /dev/null +++ b/dashboard/prisma/migrations/20260513203222_init/migration.sql @@ -0,0 +1,74 @@ +-- CreateTable +CREATE TABLE "User" ( + "id" TEXT NOT NULL, + "email" TEXT NOT NULL, + "googleId" TEXT NOT NULL, + "name" TEXT, + "picture" TEXT, + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + + CONSTRAINT "User_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "Session" ( + "id" TEXT NOT NULL, + "userId" TEXT NOT NULL, + "startedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "endedAt" TIMESTAMP(3), + + CONSTRAINT "Session_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "Event" ( + "id" TEXT NOT NULL, + "sessionId" TEXT NOT NULL, + "url" TEXT NOT NULL, + "title" TEXT NOT NULL, + "content" TEXT, + "tags" TEXT[], + "timestamp" TIMESTAMP(3) NOT NULL, + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT "Event_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "Track" ( + "id" TEXT NOT NULL, + "sessionId" TEXT NOT NULL, + "artist" TEXT NOT NULL, + "title" TEXT NOT NULL, + "capturedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT "Track_pkey" PRIMARY KEY ("id") +); + +-- CreateIndex +CREATE UNIQUE INDEX "User_email_key" ON "User"("email"); + +-- CreateIndex +CREATE UNIQUE INDEX "User_googleId_key" ON "User"("googleId"); + +-- CreateIndex +CREATE INDEX "Session_userId_idx" ON "Session"("userId"); + +-- CreateIndex +CREATE INDEX "Event_sessionId_idx" ON "Event"("sessionId"); + +-- CreateIndex +CREATE INDEX "Event_timestamp_idx" ON "Event"("timestamp"); + +-- CreateIndex +CREATE INDEX "Track_sessionId_idx" ON "Track"("sessionId"); + +-- AddForeignKey +ALTER TABLE "Session" ADD CONSTRAINT "Session_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "Event" ADD CONSTRAINT "Event_sessionId_fkey" FOREIGN KEY ("sessionId") REFERENCES "Session"("id") ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "Track" ADD CONSTRAINT "Track_sessionId_fkey" FOREIGN KEY ("sessionId") REFERENCES "Session"("id") ON DELETE CASCADE ON UPDATE CASCADE; diff --git a/dashboard/prisma/migrations/migration_lock.toml b/dashboard/prisma/migrations/migration_lock.toml new file mode 100644 index 0000000..044d57c --- /dev/null +++ b/dashboard/prisma/migrations/migration_lock.toml @@ -0,0 +1,3 @@ +# Please do not edit this file manually +# It should be added in your version-control system (e.g., Git) +provider = "postgresql" diff --git a/dashboard/prisma/schema.prisma b/dashboard/prisma/schema.prisma index 5264d35..67a61b1 100644 --- a/dashboard/prisma/schema.prisma +++ b/dashboard/prisma/schema.prisma @@ -1,8 +1,3 @@ -// This is your Prisma schema file, -// learn more about it in the docs: https://pris.ly/d/prisma-schema - -// Get a free hosted Postgres database in seconds: `npx create-db` - generator client { provider = "prisma-client" output = "../app/generated/prisma" @@ -10,5 +5,53 @@ generator client { datasource db { provider = "postgresql" - url = env("DATABASE_URL") +} + +model User { + id String @id @default(cuid()) + email String @unique + googleId String @unique + name String? + picture String? + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + sessions Session[] +} + +model Session { + id String @id @default(cuid()) + userId String + startedAt DateTime @default(now()) + endedAt DateTime? + user User @relation(fields: [userId], references: [id], onDelete: Cascade) + events Event[] + tracks Track[] + + @@index([userId]) +} + +model Event { + id String @id @default(cuid()) + sessionId String + url String + title String + content String? + tags String[] + timestamp DateTime + createdAt DateTime @default(now()) + session Session @relation(fields: [sessionId], references: [id], onDelete: Cascade) + + @@index([sessionId]) + @@index([timestamp]) +} + +model Track { + id String @id @default(cuid()) + sessionId String + artist String + title String + capturedAt DateTime @default(now()) + session Session @relation(fields: [sessionId], references: [id], onDelete: Cascade) + + @@index([sessionId]) } diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..53772fd --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,21 @@ +services: + postgres: + image: postgres:16-alpine + container_name: worktrace-postgres + restart: unless-stopped + environment: + POSTGRES_USER: postgres + POSTGRES_PASSWORD: postgres + POSTGRES_DB: worktrace + ports: + - "5433:5432" + volumes: + - worktrace-pgdata:/var/lib/postgresql/data + healthcheck: + test: ["CMD-SHELL", "pg_isready -U postgres -d worktrace"] + interval: 5s + timeout: 5s + retries: 5 + +volumes: + worktrace-pgdata: From ecf542563015755ed374ea8b6bf262220e36e125 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Thu, 14 May 2026 00:13:45 +0300 Subject: [PATCH 03/24] chore(ai): add CLAUDE.md ruleset and skill recipes (#3) Set up the AI rulebook before introducing AI-generated code in AC 7: - CLAUDE.md with type-safety, validation, dashboard structure, auth, extension isolation, and Prisma rules - .claude/skills/{api-route,prisma-model,extension-message}.md with task-specific recipes and code examples - dashboard/server/ folder placeholder for upcoming business logic Closes Week 1 AC 6. --- .claude/skills/api-route.md | 74 +++++++++++++++++++++++++ .claude/skills/extension-message.md | 85 +++++++++++++++++++++++++++++ .claude/skills/prisma-model.md | 68 +++++++++++++++++++++++ CLAUDE.md | 54 ++++++++++++++++++ dashboard/server/.gitkeep | 0 5 files changed, 281 insertions(+) create mode 100644 .claude/skills/api-route.md create mode 100644 .claude/skills/extension-message.md create mode 100644 .claude/skills/prisma-model.md create mode 100644 CLAUDE.md create mode 100644 dashboard/server/.gitkeep diff --git a/.claude/skills/api-route.md b/.claude/skills/api-route.md new file mode 100644 index 0000000..7c9c9e7 --- /dev/null +++ b/.claude/skills/api-route.md @@ -0,0 +1,74 @@ +# Skill: add a Next.js Route Handler + +Use when adding or modifying a `dashboard/app/api/**/route.ts` endpoint. + +## Location + +- App Router: `dashboard/app/api//route.ts` +- For versioned APIs: `dashboard/app/api/v1//route.ts` +- Subresource: `dashboard/app/api/v1//[id]/route.ts` + +## Structure (every handler) + +1. Parse the request — `await req.json()`, query params via `req.nextUrl.searchParams`, route params via the second arg. +2. Validate with a Zod schema. Define inline unless reused; if reused, move to `dashboard/server/schemas/`. +3. Delegate to a `dashboard/server/.ts` module — never inline business logic. +4. Return typed JSON via `NextResponse.json(...)`. + +## Example: POST /api/v1/events + +```ts +import { NextRequest, NextResponse } from "next/server"; +import { z } from "zod"; +import { createEvent } from "@/server/events"; + +const CreateEventInput = z.object({ + sessionId: z.string().cuid(), + url: z.string().url(), + title: z.string().min(1), + content: z.string().optional(), + tags: z.array(z.string()).default([]), + timestamp: z.coerce.date(), +}); + +export async function POST(req: NextRequest) { + const body = await req.json(); + const parsed = CreateEventInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: parsed.error.format() }, { status: 400 }); + } + + const event = await createEvent(parsed.data); + return NextResponse.json(event, { status: 201 }); +} +``` + +## HTTP semantics + +- `200` OK — successful GET / PATCH / DELETE-with-body +- `201` Created — successful POST that created a resource +- `204` No Content — DELETE / accepted POST with no response body +- `400` Bad Request — Zod validation error +- `401` Unauthorized — missing/invalid JWT +- `403` Forbidden — authenticated but not allowed +- `404` Not Found — resource missing + +## CORS for the Chrome Extension + +Endpoints called from `chrome-extension://*` need CORS headers. Use the shared helper (added in AC 3): + +```ts +import { withCors } from "@/server/cors"; + +export const POST = withCors(async (req) => { /* ... */ }); +export const OPTIONS = withCors(async () => new NextResponse(null, { status: 204 })); +``` + +Always pair non-GET handlers with an `OPTIONS` handler for the CORS preflight. + +## Anti-patterns + +- ❌ Doing DB queries directly in the handler — delegate to `server/`. +- ❌ Swallowing errors with `try/catch` that returns `200` — let real errors bubble or map them to typed responses. +- ❌ `req.json()` without `safeParse` — always validate. +- ❌ Adding business logic to the handler to "make it easier" — refactor the server module instead. diff --git a/.claude/skills/extension-message.md b/.claude/skills/extension-message.md new file mode 100644 index 0000000..059d166 --- /dev/null +++ b/.claude/skills/extension-message.md @@ -0,0 +1,85 @@ +# Skill: messaging inside the Chrome Extension + +The extension has 3 isolated execution contexts that communicate via Chrome message APIs. + +## Topology + +``` ++----------+ +-------------------+ +-----------+ +| popup | <--> | background (SW) | <--> | content | ++----------+ +-------------------+ +-----------+ + | + v + +---------------+ + | dashboard API | + +---------------+ +``` + +## Rules + +- **All `fetch` calls to the dashboard API live in `background.ts`.** + Never `fetch` from `content.ts` or `popup.ts` — they don't hold the JWT and CORS blocks them anyway. +- **JWT is stored in `chrome.storage.local`, read only by the service worker.** + Content scripts and popup never touch the token directly. +- **content.ts** parses the current page (DOM, metadata, tracks) and sends events to background. +- **popup.ts** controls UI; it queries background for state and triggers actions. + +## Typed message envelope + +Define a single discriminated union and a matching Zod schema in `extension/shared/messages.ts`: + +```ts +import { z } from "zod"; + +export const ExtensionMessage = z.discriminatedUnion("type", [ + z.object({ type: z.literal("PAGE_PARSED"), data: ParsedPage }), + z.object({ type: z.literal("TRACK_CAPTURED"), data: TrackInfo }), + z.object({ type: z.literal("GET_SESSION_STATE") }), + z.object({ type: z.literal("START_SESSION") }), + z.object({ type: z.literal("STOP_SESSION") }), + z.object({ type: z.literal("SYNC_NOW") }), +]); +export type ExtensionMessage = z.infer; +``` + +Always validate incoming messages — content scripts from other extensions can post to your listener: + +```ts +chrome.runtime.onMessage.addListener((msg, _sender, sendResponse) => { + const parsed = ExtensionMessage.safeParse(msg); + if (!parsed.success) return; + handleMessage(parsed.data).then(sendResponse); + return true; // keep channel open for async response +}); +``` + +## Send direction + +- popup → background: `chrome.runtime.sendMessage(msg)` +- background → content (specific tab): `chrome.tabs.sendMessage(tabId, msg)` +- content → background: `chrome.runtime.sendMessage(msg)` +- background → popup: response to the popup's `sendMessage` promise + +## Service worker lifecycle + +Chrome may unload a Manifest V3 service worker at any time when idle. + +- Persist all state in `chrome.storage.local` — never in module-level variables. +- For periodic work (sync polling, session timer), use `chrome.alarms`, not `setInterval` (it dies on unload). +- On every event the worker handles, re-read state from storage; don't trust cached in-memory state. + +## Network failures + +Events from content scripts must not be lost when the network drops: + +1. Try to send the event/batch via `fetch`. +2. On failure, queue it in `chrome.storage.local` under a `pendingEvents` key. +3. Re-try on `online` event with exponential backoff (1s, 2s, 4s, …, cap at 60s). +4. After N failed attempts, surface a sync-error indicator to the popup. + +## Anti-patterns + +- ❌ `fetch` directly from `content.ts` — JWT not available; CORS blocks the request anyway. +- ❌ Storing JWT in any tab's `localStorage` — per-origin and gets cleared. +- ❌ `setInterval` in service worker — unreliable in MV3. +- ❌ Importing TypeScript types from `dashboard/` — breaks isolation, complicates bundling. diff --git a/.claude/skills/prisma-model.md b/.claude/skills/prisma-model.md new file mode 100644 index 0000000..abea339 --- /dev/null +++ b/.claude/skills/prisma-model.md @@ -0,0 +1,68 @@ +# Skill: add or change a Prisma model + +Use when editing `dashboard/prisma/schema.prisma`. + +## Steps + +1. Edit `dashboard/prisma/schema.prisma` — add/modify model, field, or relation. +2. Add `@@index([fk_field])` on every foreign-key column. + Postgres does NOT auto-index FKs (unlike MySQL); without this, joins do full table scans. +3. Add `@unique` (single column) or `@@unique([a, b])` (compound) for natural keys. +4. For owned children (e.g., `Session` owned by `User`), set `onDelete: Cascade`: + ```prisma + user User @relation(fields: [userId], references: [id], onDelete: Cascade) + ``` +5. Ensure local Postgres is running: `docker compose up -d` (from repo root). +6. Generate the migration AND apply it locally: + ``` + cd dashboard + npx prisma migrate dev --name + ``` +7. Inspect `dashboard/prisma/migrations/_/migration.sql` — make sure the SQL matches what you expected. +8. Commit BOTH the schema change AND the migration files. + +## Conventions + +- IDs: `String @id @default(cuid())` +- Server-set timestamps: `createdAt DateTime @default(now())`, `updatedAt DateTime @updatedAt` +- Client-set timestamps (e.g., when an event happened in the browser): explicit, no default +- Optional fields: `?` suffix — `content String?` +- Arrays of primitives: `tags String[]` (Postgres native array) + +## Imports + +Generated client lives at `dashboard/app/generated/prisma` (gitignored, regenerated on `prisma generate`). + +```ts +import { PrismaClient } from "@/generated/prisma"; +``` + +NOT `@prisma/client` — that path is for Prisma 6 and older. Prisma 7 outputs to a custom folder defined by `generator client { output = "..." }` in `schema.prisma`. + +## Singleton in dev + +Next.js dev hot-reload would create a new `PrismaClient` on every reload, exhausting connections. Use a singleton in `dashboard/server/db.ts`: + +```ts +import { PrismaClient } from "@/generated/prisma"; + +const globalForPrisma = globalThis as unknown as { prisma?: PrismaClient }; + +export const prisma = + globalForPrisma.prisma ?? new PrismaClient({ log: ["warn", "error"] }); + +if (process.env.NODE_ENV !== "production") { + globalForPrisma.prisma = prisma; +} +``` + +## Production migrations + +On Vercel deploy, run `npx prisma migrate deploy` (not `migrate dev`) — it applies pending migrations without prompting and never alters the schema. + +## Anti-patterns + +- ❌ Editing schema without running `migrate dev` — DB drifts from code. +- ❌ Editing existing migration SQL files — generate a new migration instead. +- ❌ Using `db push` in production — it skips migration history. +- ❌ Importing `@prisma/client` — wrong path for Prisma 7. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..6e5a2f0 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,54 @@ +# WorkTrace — Claude Code rules + +Chrome extension + Next.js dashboard for capturing dev session context +and generating AI session reports. + +## Repo layout +- `/dashboard` — Next.js 16 (App Router) web app +- `/extension` — Chrome Extension (Manifest V3) — coming in AC 4 +- `/docs` — task spec +- Database: PostgreSQL via Prisma 7 + +## Type safety +- TypeScript strict. **`any` is forbidden** — use `unknown` + type guards, or define proper types. + +## Validation +- Zod for all external input (Route Handlers, extension messages, env vars). +- Validate at the boundary, not deep inside business logic. + +## Dashboard structure +- **Business logic lives in `dashboard/server/`** (server-only modules). +- Route Handlers in `dashboard/app/api/**/route.ts` are thin: parse → validate (Zod) → call `server/` → respond. +- React components NEVER contain business logic or direct DB access. +- Server Components MAY call `server/` modules directly (no fetch round-trip). + +## Auth +Auth logic lives ONLY in: +- `dashboard/app/api/auth/**/route.ts` — Google token verification, JWT issuance +- `dashboard/middleware.ts` — route guarding for `/dashboard/*` + +Do NOT duplicate auth checks in components, server modules, or other Route Handlers. + +## Extension ↔ Dashboard isolation +- NEVER import from `dashboard/` inside `extension/` (or vice versa). +- All extension API calls go through `background.ts` (service worker) — never directly from `content.ts` or `popup.ts`. +- JWT lives in `chrome.storage.local`, read/written only by service worker. + +## Database (Prisma 7) +- Schema: `dashboard/prisma/schema.prisma`. +- Generated client output: `dashboard/app/generated/prisma` (gitignored). +- Imports: `import { PrismaClient } from "@/generated/prisma"` — **not** `@prisma/client`. +- Singleton `PrismaClient` per process — see `dashboard/server/db.ts` (added when first needed). +- Migrations are committed to git. + +## Skills +Task-specific recipes live in `.claude/skills/`: +- `api-route.md` — adding a Next.js Route Handler +- `prisma-model.md` — adding/changing a Prisma model +- `extension-message.md` — messaging between extension contexts + +## Workflow +Use `Plan → Review → Implement` for non-trivial work: +1. Write a plan markdown to `/plans/.md` describing scope and decisions +2. User reviews and approves +3. Implement following the approved plan diff --git a/dashboard/server/.gitkeep b/dashboard/server/.gitkeep new file mode 100644 index 0000000..e69de29 From 00ef78779c51b1b4428a126e9c140f5dab992b4f Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Thu, 14 May 2026 21:42:10 +0300 Subject: [PATCH 04/24] feat(api): events endpoint with zod and cors (AC 3, AC 7) (#4) * feat(api): add POST /api/v1/events with prisma-zod schemas Adds the first Route Handler: parse -> Zod -> server -> Prisma. Schemas in server/schemas/ derived from prisma-zod-generator output. PrismaClient singleton uses @prisma/adapter-pg (required by Prisma 7). Closes Week 1 AC 7. * feat(api): add CORS for chrome-extension origin server/cors.ts: withCors() wrapper + corsPreflight() helper. Echoes request Origin back if it matches the chrome-extension ID pattern, sends "null" otherwise. POST /api/v1/events wrapped + OPTIONS handler exported. Switch Zod error response to z.treeifyError (z.format deprecated). Closes Week 1 AC 3. --- .claude/skills/api-route.md | 44 +- .claude/skills/prisma-model.md | 42 +- .gitignore | 4 +- CLAUDE.md | 20 +- dashboard/.gitignore | 2 +- dashboard/app/api/v1/events/route.ts | 20 + dashboard/package-lock.json | 1277 +++++++++++++++++++++++++- dashboard/package.json | 4 + dashboard/prisma/schema.prisma | 7 +- dashboard/server/.gitkeep | 0 dashboard/server/cors.ts | 31 + dashboard/server/db.ts | 22 + dashboard/server/events.ts | 6 + dashboard/server/schemas/events.ts | 12 + plans/AC3-cors.md | 169 ++++ plans/AC7-events-api-route.md | 201 ++++ 16 files changed, 1809 insertions(+), 52 deletions(-) create mode 100644 dashboard/app/api/v1/events/route.ts delete mode 100644 dashboard/server/.gitkeep create mode 100644 dashboard/server/cors.ts create mode 100644 dashboard/server/db.ts create mode 100644 dashboard/server/events.ts create mode 100644 dashboard/server/schemas/events.ts create mode 100644 plans/AC3-cors.md create mode 100644 plans/AC7-events-api-route.md diff --git a/.claude/skills/api-route.md b/.claude/skills/api-route.md index 7c9c9e7..d082944 100644 --- a/.claude/skills/api-route.md +++ b/.claude/skills/api-route.md @@ -11,25 +11,39 @@ Use when adding or modifying a `dashboard/app/api/**/route.ts` endpoint. ## Structure (every handler) 1. Parse the request — `await req.json()`, query params via `req.nextUrl.searchParams`, route params via the second arg. -2. Validate with a Zod schema. Define inline unless reused; if reused, move to `dashboard/server/schemas/`. +2. Validate with a Zod schema. Schemas live in `dashboard/server/schemas/.ts` — never inline in the route handler. **Derive from the generated schemas at `@/generated/zod/schemas/objects/UncheckedCreateInput.schema`** (or similar) using `.omit()` / `.extend()` / `.pick()`. The `Unchecked*` variants expose foreign keys as scalars (e.g., `sessionId: string`), matching what API clients send. 3. Delegate to a `dashboard/server/.ts` module — never inline business logic. 4. Return typed JSON via `NextResponse.json(...)`. ## Example: POST /api/v1/events +`dashboard/server/schemas/events.ts`: ```ts -import { NextRequest, NextResponse } from "next/server"; import { z } from "zod"; -import { createEvent } from "@/server/events"; +import { EventUncheckedCreateInputObjectZodSchema } from "@/generated/zod/schemas/objects/EventUncheckedCreateInput.schema"; + +export const CreateEventInput = EventUncheckedCreateInputObjectZodSchema + .omit({ id: true, createdAt: true }) + .extend({ + sessionId: z.string().regex(/^c[a-z0-9]{24}$/, "must be a CUID"), + url: z.url(), + title: z.string().min(1), + }); + +export type CreateEventInput = z.infer; +``` -const CreateEventInput = z.object({ - sessionId: z.string().cuid(), - url: z.string().url(), - title: z.string().min(1), - content: z.string().optional(), - tags: z.array(z.string()).default([]), - timestamp: z.coerce.date(), -}); +Notes on the derived pattern: +- **Base from generated:** all fields and types come from Prisma — no manual duplication. +- **`.omit()` server-managed fields:** clients don't set `id` or `createdAt`. +- **`.extend()` for stricter validation:** the generated schema just says `z.string()` for FKs and URLs; we tighten with a CUID regex, `z.url()`, and `z.string().min(1)`. +- **CUID regex** not `z.cuid()`: Zod 4 deprecated `z.cuid()`. Our Prisma uses cuid v1 (`@default(cuid())`), validated by `/^c[a-z0-9]{24}$/`. + +`dashboard/app/api/v1/events/route.ts`: +```ts +import { NextRequest, NextResponse } from "next/server"; +import { createEvent } from "@/server/events"; +import { CreateEventInput } from "@/server/schemas/events"; export async function POST(req: NextRequest) { const body = await req.json(); @@ -55,15 +69,17 @@ export async function POST(req: NextRequest) { ## CORS for the Chrome Extension -Endpoints called from `chrome-extension://*` need CORS headers. Use the shared helper (added in AC 3): +Endpoints called from `chrome-extension://*` need CORS headers. Use the shared helpers in `@/server/cors`: ```ts -import { withCors } from "@/server/cors"; +import { withCors, corsPreflight } from "@/server/cors"; export const POST = withCors(async (req) => { /* ... */ }); -export const OPTIONS = withCors(async () => new NextResponse(null, { status: 204 })); +export function OPTIONS(req: NextRequest) { return corsPreflight(req); } ``` +`withCors` echoes the request's `Origin` back in `Access-Control-Allow-Origin` if it matches the Chrome extension format (`^chrome-extension://[a-p]{32}$`); otherwise it sends `null` (browsers block reading the response; Postman/curl ignore CORS and still see the body). + Always pair non-GET handlers with an `OPTIONS` handler for the CORS preflight. ## Anti-patterns diff --git a/.claude/skills/prisma-model.md b/.claude/skills/prisma-model.md index abea339..ad1c2e5 100644 --- a/.claude/skills/prisma-model.md +++ b/.claude/skills/prisma-model.md @@ -29,27 +29,53 @@ Use when editing `dashboard/prisma/schema.prisma`. - Optional fields: `?` suffix — `content String?` - Arrays of primitives: `tags String[]` (Postgres native array) -## Imports +## Generated artifacts + +Two generators run on every `prisma generate`: + +- `dashboard/generated/prisma/` — Prisma client (entry: `client.ts`) +- `dashboard/generated/zod/` — Zod schemas via `prisma-zod-generator` (one schema file per Prisma input/output type, under `schemas/objects/`) -Generated client lives at `dashboard/app/generated/prisma` (gitignored, regenerated on `prisma generate`). +Both folders are gitignored. + +## Imports ```ts -import { PrismaClient } from "@/generated/prisma"; +// Prisma client (DB access) +import { PrismaClient } from "@/generated/prisma/client"; + +// Zod base schemas (for derived API schemas in server/schemas/) +import { EventUncheckedCreateInputObjectZodSchema } from "@/generated/zod/schemas/objects/EventUncheckedCreateInput.schema"; ``` -NOT `@prisma/client` — that path is for Prisma 6 and older. Prisma 7 outputs to a custom folder defined by `generator client { output = "..." }` in `schema.prisma`. +NOT `@prisma/client` — that path is for Prisma 6 and older. Prisma 7 outputs to the custom folder defined by `generator client { output = "..." }` in `schema.prisma`. + +## When schema changes + +Running `npx prisma migrate dev --name ` regenerates BOTH the Prisma client and the Zod schemas. Any `server/schemas/.ts` derived schemas will automatically pick up the new fields via `.omit()` / `.extend()` chains — no manual updates needed unless field semantics changed. ## Singleton in dev -Next.js dev hot-reload would create a new `PrismaClient` on every reload, exhausting connections. Use a singleton in `dashboard/server/db.ts`: +Next.js dev hot-reload would create a new `PrismaClient` on every reload, exhausting connections. Use a singleton in `dashboard/server/db.ts`. + +Prisma 7's new `prisma-client` generator requires a driver adapter at runtime (no built-in engine). Use `@prisma/adapter-pg` for local Postgres / Neon direct connection. For Neon production with pooled connection, swap to `@prisma/adapter-neon` (in a future deploy PR). ```ts -import { PrismaClient } from "@/generated/prisma"; +import { PrismaPg } from "@prisma/adapter-pg"; +import { PrismaClient } from "@/generated/prisma/client"; const globalForPrisma = globalThis as unknown as { prisma?: PrismaClient }; -export const prisma = - globalForPrisma.prisma ?? new PrismaClient({ log: ["warn", "error"] }); +function createPrismaClient() { + const connectionString = process.env.DATABASE_URL; + if (!connectionString) { + throw new Error("DATABASE_URL is not set"); + } + const adapter = new PrismaPg({ connectionString }); + return new PrismaClient({ adapter, log: ["warn", "error"] }); +} + +export const prisma = globalForPrisma.prisma ?? createPrismaClient(); if (process.env.NODE_ENV !== "production") { globalForPrisma.prisma = prisma; diff --git a/.gitignore b/.gitignore index 045e03a..12c7b35 100644 --- a/.gitignore +++ b/.gitignore @@ -19,9 +19,9 @@ extension/dist/ extension/build/ *.zip -# Prisma generated client +# Prisma generated artifacts (client + zod schemas) **/app/generated/ -**/generated/prisma/ +**/generated/ # Environment .env diff --git a/CLAUDE.md b/CLAUDE.md index 6e5a2f0..152a045 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,10 +12,6 @@ and generating AI session reports. ## Type safety - TypeScript strict. **`any` is forbidden** — use `unknown` + type guards, or define proper types. -## Validation -- Zod for all external input (Route Handlers, extension messages, env vars). -- Validate at the boundary, not deep inside business logic. - ## Dashboard structure - **Business logic lives in `dashboard/server/`** (server-only modules). - Route Handlers in `dashboard/app/api/**/route.ts` are thin: parse → validate (Zod) → call `server/` → respond. @@ -36,11 +32,21 @@ Do NOT duplicate auth checks in components, server modules, or other Route Handl ## Database (Prisma 7) - Schema: `dashboard/prisma/schema.prisma`. -- Generated client output: `dashboard/app/generated/prisma` (gitignored). -- Imports: `import { PrismaClient } from "@/generated/prisma"` — **not** `@prisma/client`. -- Singleton `PrismaClient` per process — see `dashboard/server/db.ts` (added when first needed). +- Two generators run on `prisma generate`: + - `dashboard/generated/prisma/` — Prisma client (entry: `client.ts`) + - `dashboard/generated/zod/` — Zod schemas (`prisma-zod-generator`) +- Both folders gitignored. +- Imports: + - `import { PrismaClient } from "@/generated/prisma/client"` — **not** `@prisma/client` (Prisma 7 uses `client.ts` entry). + - Base Zod schemas: `import { EventUncheckedCreateInputObjectZodSchema } from "@/generated/zod/schemas/objects/EventUncheckedCreateInput.schema"`. +- Singleton `PrismaClient` per process — see `dashboard/server/db.ts`. Uses `@prisma/adapter-pg` (Prisma 7 requires a driver adapter at runtime). - Migrations are committed to git. +## Validation +- Zod for all external input (Route Handlers, extension messages, env vars). +- API-facing schemas live in `dashboard/server/schemas/.ts` — derived from the generated `@/generated/zod` base schemas via `.omit()` / `.extend()` / `.pick()`. **Never hand-write a schema that duplicates Prisma model fields.** +- Validate at the boundary, not deep inside business logic. + ## Skills Task-specific recipes live in `.claude/skills/`: - `api-route.md` — adding a Next.js Route Handler diff --git a/dashboard/.gitignore b/dashboard/.gitignore index bf8d094..2a0c7e3 100644 --- a/dashboard/.gitignore +++ b/dashboard/.gitignore @@ -41,4 +41,4 @@ yarn-error.log* *.tsbuildinfo next-env.d.ts -/app/generated/prisma +/generated diff --git a/dashboard/app/api/v1/events/route.ts b/dashboard/app/api/v1/events/route.ts new file mode 100644 index 0000000..cd3cde8 --- /dev/null +++ b/dashboard/app/api/v1/events/route.ts @@ -0,0 +1,20 @@ +import { NextRequest, NextResponse } from "next/server"; +import { z } from "zod"; +import { createEvent } from "@/server/events"; +import { CreateEventInput } from "@/server/schemas/events"; +import { withCors, corsPreflight } from "@/server/cors"; + +export const POST = withCors(async (req) => { + const body = await req.json(); + const parsed = CreateEventInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + } + + const event = await createEvent(parsed.data); + return NextResponse.json(event, { status: 201 }); +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/package-lock.json b/dashboard/package-lock.json index cef1d24..642f17f 100644 --- a/dashboard/package-lock.json +++ b/dashboard/package-lock.json @@ -8,6 +8,7 @@ "name": "dashboard", "version": "0.1.0", "dependencies": { + "@prisma/adapter-pg": "^7.8.0", "@prisma/client": "^7.8.0", "@tanstack/react-query": "^5.100.10", "d3": "^7.9.0", @@ -15,6 +16,7 @@ "google-auth-library": "^10.6.2", "jsonwebtoken": "^9.0.3", "next": "16.2.6", + "pg": "^8.20.0", "prisma": "^7.8.0", "react": "19.2.4", "react-dom": "19.2.4", @@ -25,10 +27,12 @@ "@types/d3": "^7.4.3", "@types/jsonwebtoken": "^9.0.10", "@types/node": "^20", + "@types/pg": "^8.20.0", "@types/react": "^19", "@types/react-dom": "^19", "eslint": "^9", "eslint-config-next": "16.2.6", + "prisma-zod-generator": "^2.1.4", "tailwindcss": "^4", "typescript": "^5" } @@ -1295,6 +1299,18 @@ "node": ">=12.4.0" } }, + "node_modules/@prisma/adapter-pg": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/adapter-pg/-/adapter-pg-7.8.0.tgz", + "integrity": "sha512-ygb3UkerK3v8MDpXVgCISdRNDozpxh6+JVJgiIGbSr5KBgz10LLf5ejUskPGoXlsIjxsOu6nuy1JVQr2EKGSlg==", + "license": "Apache-2.0", + "dependencies": { + "@prisma/driver-adapter-utils": "7.8.0", + "@types/pg": "^8.16.0", + "pg": "^8.16.3", + "postgres-array": "3.0.4" + } + }, "node_modules/@prisma/client": { "version": "7.8.0", "resolved": "https://registry.npmjs.org/@prisma/client/-/client-7.8.0.tgz", @@ -1368,6 +1384,22 @@ "zeptomatch": "2.1.0" } }, + "node_modules/@prisma/dmmf": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/dmmf/-/dmmf-7.8.0.tgz", + "integrity": "sha512-7xzcSFWO6J+dFUgIX7jL7QqUhEDfaa8GSZGsjjHyZct1Su+6KrvMl3S2+fnRkuKUIoTPg3Mj02oZuUdaNSfsaw==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/@prisma/driver-adapter-utils": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/driver-adapter-utils/-/driver-adapter-utils-7.8.0.tgz", + "integrity": "sha512-/Q13o0ZT0rjc1Xk0Q9KhZYwuq2EW/vSbWUBKfgEKkaCuB/Sg6bqnjmTZqC5cD4d6y1vfFAEwBRzfzoSMIVJ55A==", + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.8.0" + } + }, "node_modules/@prisma/engines": { "version": "7.8.0", "resolved": "https://registry.npmjs.org/@prisma/engines/-/engines-7.8.0.tgz", @@ -1416,6 +1448,39 @@ "@prisma/debug": "7.8.0" } }, + "node_modules/@prisma/generator": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/generator/-/generator-7.8.0.tgz", + "integrity": "sha512-KHGB0b8/9pNWyiK9EPJNE2/v1bMtqJgJldqjNNVvoE4uOhNSSWTmhHhPVfRsiuOVybzHCdCUQ/gdidCbpYAD5w==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/@prisma/generator-helper": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/generator-helper/-/generator-helper-7.8.0.tgz", + "integrity": "sha512-i+2Gad6D/0dS0YHKFdYX3M8KYN1gwNkET813WXKfW2HeWmgipmSJsNSzOA44kTM+Rx6Dev3yBQwx5sZXXdtgtQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.8.0", + "@prisma/dmmf": "7.8.0", + "@prisma/generator": "7.8.0" + } + }, + "node_modules/@prisma/get-dmmf": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/get-dmmf/-/get-dmmf-7.8.0.tgz", + "integrity": "sha512-lWPV4cu0JCGuIKR45cLKpzMei4TY4uPAa9UxWVes37so5M8XJfdEm0MHLTHmVPZNKPxqAAI/Z845R6Mzgcv1DQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.8.0", + "@prisma/dmmf": "7.8.0", + "@prisma/prisma-schema-wasm": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "@streamparser/json": "0.0.22", + "pluralize": "8.0.0" + } + }, "node_modules/@prisma/get-platform": { "version": "7.2.0", "resolved": "https://registry.npmjs.org/@prisma/get-platform/-/get-platform-7.2.0.tgz", @@ -1431,12 +1496,80 @@ "integrity": "sha512-YSGTiSlBAVJPzX4ONZmMotL+ozJwQjRmZweQNIq/ER0tQJKJynNkRB3kyvt37eOfsbMCXk3gnLF6J9OJ4QWftw==", "license": "Apache-2.0" }, + "node_modules/@prisma/internals": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/internals/-/internals-7.8.0.tgz", + "integrity": "sha512-0rjawF2eB7DSq47HKqYuKF+cAV80pB6pnxJzKSN4rzk4R0ET5Lytjf4c8wPJJ7HwPMTQWPwPe3vlKfp9UB8s9A==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/config": "7.8.0", + "@prisma/debug": "7.8.0", + "@prisma/dmmf": "7.8.0", + "@prisma/driver-adapter-utils": "7.8.0", + "@prisma/engines": "7.8.0", + "@prisma/fetch-engine": "7.8.0", + "@prisma/generator": "7.8.0", + "@prisma/generator-helper": "7.8.0", + "@prisma/get-dmmf": "7.8.0", + "@prisma/get-platform": "7.8.0", + "@prisma/prisma-schema-wasm": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "@prisma/schema-engine-wasm": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "@prisma/schema-files-loader": "7.8.0", + "@streamparser/json": "0.0.22", + "arg": "5.0.2", + "prompts": "2.4.2" + }, + "peerDependencies": { + "typescript": ">=5.4.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@prisma/internals/node_modules/@prisma/get-platform": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/get-platform/-/get-platform-7.8.0.tgz", + "integrity": "sha512-WlxgRGnolL8VH2EmkH1R/DkKNr/mVdS3G2h42IZFFZ3eUrH9OT6t73kIOSlkkrv50wG123Iq8d96ufv5LlZktw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/debug": "7.8.0" + } + }, + "node_modules/@prisma/prisma-schema-wasm": { + "version": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "resolved": "https://registry.npmjs.org/@prisma/prisma-schema-wasm/-/prisma-schema-wasm-7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a.tgz", + "integrity": "sha512-yyKNwOSaxExepEI+pWwESbDNRSIhzE53PXD6YaEvY7cNl39qOIMjWJCIXMDwZQpt5ixDkL/sesWYg3XxCmBkZQ==", + "dev": true, + "license": "Apache-2.0" + }, "node_modules/@prisma/query-plan-executor": { "version": "7.2.0", "resolved": "https://registry.npmjs.org/@prisma/query-plan-executor/-/query-plan-executor-7.2.0.tgz", "integrity": "sha512-EOZmNzcV8uJ0mae3DhTsiHgoNCuu1J9mULQpGCh62zN3PxPTd+qI9tJvk5jOst8WHKQNwJWR3b39t0XvfBB0WQ==", "license": "Apache-2.0" }, + "node_modules/@prisma/schema-engine-wasm": { + "version": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "resolved": "https://registry.npmjs.org/@prisma/schema-engine-wasm/-/schema-engine-wasm-7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a.tgz", + "integrity": "sha512-1qyiBr10vgh02ccZyBNMDZGUT6xdl856pKQQNGpcveKb85zFEO8wy+q7kkVrr9t5h88bkahKd/QLXG/9M0YSJg==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/@prisma/schema-files-loader": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/@prisma/schema-files-loader/-/schema-files-loader-7.8.0.tgz", + "integrity": "sha512-WxCCsgreVggULyP5ElOOHYXjNK9qN+2U15uGRIyRWb87VZWsDZLlYOdC3zR2XKKmkzEq1ncJ5fFWcFyxnNCq7A==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@prisma/prisma-schema-wasm": "7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a", + "fs-extra": "11.3.0" + } + }, "node_modules/@prisma/streams-local": { "version": "0.1.2", "resolved": "https://registry.npmjs.org/@prisma/streams-local/-/streams-local-0.1.2.tgz", @@ -1646,6 +1779,13 @@ "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==", "license": "MIT" }, + "node_modules/@streamparser/json": { + "version": "0.0.22", + "resolved": "https://registry.npmjs.org/@streamparser/json/-/json-0.0.22.tgz", + "integrity": "sha512-b6gTSBjJ8G8SuO3Gbbj+zXbVx8NSs1EbpbMKpzGLWMdkR+98McH9bEjSz3+0mPJf68c5nxa3CrJHp5EQNXM6zQ==", + "dev": true, + "license": "MIT" + }, "node_modules/@swc/helpers": { "version": "0.5.15", "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.15.tgz", @@ -1963,6 +2103,37 @@ "tslib": "^2.4.0" } }, + "node_modules/@types/body-parser": { + "version": "1.19.6", + "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz", + "integrity": "sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/connect": "*", + "@types/node": "*" + } + }, + "node_modules/@types/connect": { + "version": "3.4.38", + "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz", + "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/cors": { + "version": "2.8.19", + "resolved": "https://registry.npmjs.org/@types/cors/-/cors-2.8.19.tgz", + "integrity": "sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, "node_modules/@types/d3": { "version": "7.4.3", "resolved": "https://registry.npmjs.org/@types/d3/-/d3-7.4.3.tgz", @@ -2254,6 +2425,31 @@ "dev": true, "license": "MIT" }, + "node_modules/@types/express": { + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/@types/express/-/express-5.0.6.tgz", + "integrity": "sha512-sKYVuV7Sv9fbPIt/442koC7+IIwK5olP1KWeD88e/idgoJqDm3JV/YUiPwkoKK92ylff2MGxSz1CSjsXelx0YA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/body-parser": "*", + "@types/express-serve-static-core": "^5.0.0", + "@types/serve-static": "^2" + } + }, + "node_modules/@types/express-serve-static-core": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-5.1.1.tgz", + "integrity": "sha512-v4zIMr/cX7/d2BpAEX3KNKL/JrT1s43s96lLvvdTmza1oEvDudCqK9aF/djc/SWgy8Yh0h30TZx5VpzqFCxk5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*", + "@types/qs": "*", + "@types/range-parser": "*", + "@types/send": "*" + } + }, "node_modules/@types/geojson": { "version": "7946.0.16", "resolved": "https://registry.npmjs.org/@types/geojson/-/geojson-7946.0.16.tgz", @@ -2261,6 +2457,13 @@ "dev": true, "license": "MIT" }, + "node_modules/@types/http-errors": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz", + "integrity": "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==", + "dev": true, + "license": "MIT" + }, "node_modules/@types/json-schema": { "version": "7.0.15", "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", @@ -2297,12 +2500,36 @@ "version": "20.19.41", "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.41.tgz", "integrity": "sha512-ECymXOukMnOoVkC2bb1Vc/w/836DXncOg5m8Xj1RH7xSHZJWNYY6Zh7EH477vcnD5egKNNfy2RpNOmuChhFPgQ==", - "dev": true, "license": "MIT", "dependencies": { "undici-types": "~6.21.0" } }, + "node_modules/@types/pg": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/@types/pg/-/pg-8.20.0.tgz", + "integrity": "sha512-bEPFOaMAHTEP1EzpvHTbmwR8UsFyHSKsRisLIHVMXnpNefSbGA1bD6CVy+qKjGSqmZqNqBDV2azOBo8TgkcVow==", + "license": "MIT", + "dependencies": { + "@types/node": "*", + "pg-protocol": "*", + "pg-types": "^2.2.0" + } + }, + "node_modules/@types/qs": { + "version": "6.15.1", + "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.15.1.tgz", + "integrity": "sha512-GZHUBZR9hckSUhrxmp1nG6NwdpM9fCunJwyThLW1X3AyHgd9IlHb6VANpQQqDr2o/qQp6McZ3y/IA2rVzKzSbw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/range-parser": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz", + "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==", + "dev": true, + "license": "MIT" + }, "node_modules/@types/react": { "version": "19.2.14", "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.14.tgz", @@ -2322,6 +2549,27 @@ "@types/react": "^19.2.0" } }, + "node_modules/@types/send": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.1.tgz", + "integrity": "sha512-arsCikDvlU99zl1g69TcAB3mzZPpxgw0UQnaHeC1Nwb015xp8bknZv5rIfri9xTOcMuaVgvabfIRA7PSZVuZIQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/serve-static": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-2.2.0.tgz", + "integrity": "sha512-8mam4H1NHLtu7nmtalF7eyBH14QyOASmcxHhSfEoRyr0nP/YdoesEtU+uSRvMe96TW/HPTtkoKqQLl53N7UXMQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/http-errors": "*", + "@types/node": "*" + } + }, "node_modules/@typescript-eslint/eslint-plugin": { "version": "8.59.3", "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.59.3.tgz", @@ -2886,6 +3134,20 @@ "win32" ] }, + "node_modules/accepts": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz", + "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==", + "dev": true, + "license": "MIT", + "dependencies": { + "mime-types": "^3.0.0", + "negotiator": "^1.0.0" + }, + "engines": { + "node": ">= 0.6" + } + }, "node_modules/acorn": { "version": "8.16.0", "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz", @@ -2935,6 +3197,48 @@ "url": "https://github.com/sponsors/epoberezkin" } }, + "node_modules/ajv-formats": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz", + "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^8.0.0" + }, + "peerDependencies": { + "ajv": "^8.0.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, + "node_modules/ajv-formats/node_modules/ajv": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz", + "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ajv-formats/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "dev": true, + "license": "MIT" + }, "node_modules/ansi-styles": { "version": "4.3.0", "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", @@ -2951,6 +3255,13 @@ "url": "https://github.com/chalk/ansi-styles?sponsor=1" } }, + "node_modules/arg": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz", + "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==", + "dev": true, + "license": "MIT" + }, "node_modules/argparse": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", @@ -3244,6 +3555,48 @@ "node": "*" } }, + "node_modules/body-parser": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.2.tgz", + "integrity": "sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA==", + "dev": true, + "license": "MIT", + "dependencies": { + "bytes": "^3.1.2", + "content-type": "^1.0.5", + "debug": "^4.4.3", + "http-errors": "^2.0.0", + "iconv-lite": "^0.7.0", + "on-finished": "^2.4.1", + "qs": "^6.14.1", + "raw-body": "^3.0.1", + "type-is": "^2.0.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/body-parser/node_modules/iconv-lite": { + "version": "0.7.2", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.2.tgz", + "integrity": "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/brace-expansion": { "version": "1.1.14", "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", @@ -3308,6 +3661,16 @@ "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==", "license": "BSD-3-Clause" }, + "node_modules/bytes": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", + "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/c12": { "version": "3.3.4", "resolved": "https://registry.npmjs.org/c12/-/c12-3.3.4.tgz", @@ -3508,6 +3871,30 @@ "integrity": "sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ==", "license": "MIT" }, + "node_modules/content-disposition": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz", + "integrity": "sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/content-type": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", + "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, "node_modules/convert-source-map": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", @@ -3515,27 +3902,65 @@ "dev": true, "license": "MIT" }, - "node_modules/cross-spawn": { - "version": "7.0.6", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", - "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "node_modules/cookie": { + "version": "0.7.2", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz", + "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==", + "dev": true, "license": "MIT", - "dependencies": { - "path-key": "^3.1.0", - "shebang-command": "^2.0.0", - "which": "^2.0.1" - }, "engines": { - "node": ">= 8" + "node": ">= 0.6" } }, - "node_modules/csstype": { - "version": "3.2.3", - "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", - "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", - "license": "MIT" - }, - "node_modules/d3": { + "node_modules/cookie-signature": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz", + "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.6.0" + } + }, + "node_modules/cors": { + "version": "2.8.6", + "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz", + "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==", + "dev": true, + "license": "MIT", + "dependencies": { + "object-assign": "^4", + "vary": "^1" + }, + "engines": { + "node": ">= 0.10" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "license": "MIT" + }, + "node_modules/d3": { "version": "7.9.0", "resolved": "https://registry.npmjs.org/d3/-/d3-7.9.0.tgz", "integrity": "sha512-e1U46jVP+w7Iut8Jt8ri1YsPOvFpg46k+K8TpCb0P+zjCkjkPnV7WzfDJzMHy1LnA+wj5pLT1wjO901gLXeEhA==", @@ -4099,6 +4524,16 @@ "node": ">=0.10" } }, + "node_modules/depd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", + "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/destr": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz", @@ -4164,6 +4599,13 @@ "safe-buffer": "^5.0.1" } }, + "node_modules/ee-first": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", + "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", + "dev": true, + "license": "MIT" + }, "node_modules/effect": { "version": "3.20.0", "resolved": "https://registry.npmjs.org/effect/-/effect-3.20.0.tgz", @@ -4197,6 +4639,16 @@ "node": ">=14" } }, + "node_modules/encodeurl": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz", + "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/enhanced-resolve": { "version": "5.21.3", "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.21.3.tgz", @@ -4410,6 +4862,13 @@ "node": ">=6" } }, + "node_modules/escape-html": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", + "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", + "dev": true, + "license": "MIT" + }, "node_modules/escape-string-regexp": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", @@ -4829,6 +5288,60 @@ "node": ">=0.10.0" } }, + "node_modules/etag": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", + "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/express": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz", + "integrity": "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==", + "dev": true, + "license": "MIT", + "dependencies": { + "accepts": "^2.0.0", + "body-parser": "^2.2.1", + "content-disposition": "^1.0.0", + "content-type": "^1.0.5", + "cookie": "^0.7.1", + "cookie-signature": "^1.2.1", + "debug": "^4.4.0", + "depd": "^2.0.0", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "etag": "^1.8.1", + "finalhandler": "^2.1.0", + "fresh": "^2.0.0", + "http-errors": "^2.0.0", + "merge-descriptors": "^2.0.0", + "mime-types": "^3.0.0", + "on-finished": "^2.4.1", + "once": "^1.4.0", + "parseurl": "^1.3.3", + "proxy-addr": "^2.0.7", + "qs": "^6.14.0", + "range-parser": "^1.2.1", + "router": "^2.2.0", + "send": "^1.1.0", + "serve-static": "^2.2.0", + "statuses": "^2.0.1", + "type-is": "^2.0.1", + "vary": "^1.1.2" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/exsolve": { "version": "1.0.8", "resolved": "https://registry.npmjs.org/exsolve/-/exsolve-1.0.8.tgz", @@ -4988,6 +5501,28 @@ "node": ">=8" } }, + "node_modules/finalhandler": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz", + "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^4.4.0", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "on-finished": "^2.4.1", + "parseurl": "^1.3.3", + "statuses": "^2.0.1" + }, + "engines": { + "node": ">= 18.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/find-up": { "version": "5.0.0", "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", @@ -5070,6 +5605,16 @@ "node": ">=12.20.0" } }, + "node_modules/forwarded": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", + "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, "node_modules/framer-motion": { "version": "12.38.0", "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.38.0.tgz", @@ -5097,6 +5642,31 @@ } } }, + "node_modules/fresh": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz", + "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/fs-extra": { + "version": "11.3.0", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.0.tgz", + "integrity": "sha512-Z4XaCL6dUDHfP/jT25jJKMmtxvuwbkrD1vNSMFlo9lNLY2c5FHYSQgHPRZUjAB26TpDEoW9HCOgplrdbaPV/ew==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.0", + "jsonfile": "^6.0.1", + "universalify": "^2.0.0" + }, + "engines": { + "node": ">=14.14" + } + }, "node_modules/function-bind": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", @@ -5500,6 +6070,27 @@ "node": ">=16.9.0" } }, + "node_modules/http-errors": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz", + "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "depd": "~2.0.0", + "inherits": "~2.0.4", + "setprototypeof": "~1.2.0", + "statuses": "~2.0.2", + "toidentifier": "~1.0.1" + }, + "engines": { + "node": ">= 0.8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/http-status-codes": { "version": "2.3.0", "resolved": "https://registry.npmjs.org/http-status-codes/-/http-status-codes-2.3.0.tgz", @@ -5568,6 +6159,13 @@ "node": ">=0.8.19" } }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "dev": true, + "license": "ISC" + }, "node_modules/internal-slot": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz", @@ -5592,6 +6190,16 @@ "node": ">=12" } }, + "node_modules/ipaddr.js": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", + "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.10" + } + }, "node_modules/is-array-buffer": { "version": "3.0.5", "resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.5.tgz", @@ -5862,6 +6470,13 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/is-promise": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz", + "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==", + "dev": true, + "license": "MIT" + }, "node_modules/is-property": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/is-property/-/is-property-1.0.2.tgz", @@ -6129,6 +6744,19 @@ "node": ">=6" } }, + "node_modules/jsonfile": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz", + "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "universalify": "^2.0.0" + }, + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, "node_modules/jsonwebtoken": { "version": "9.0.3", "resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.3.tgz", @@ -6210,6 +6838,16 @@ "json-buffer": "3.0.1" } }, + "node_modules/kleur": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", + "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, "node_modules/language-subtag-registry": { "version": "0.3.23", "resolved": "https://registry.npmjs.org/language-subtag-registry/-/language-subtag-registry-0.3.23.tgz", @@ -6634,6 +7272,29 @@ "node": ">= 0.4" } }, + "node_modules/media-typer": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz", + "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/merge-descriptors": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz", + "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/merge2": { "version": "1.4.1", "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", @@ -6658,6 +7319,33 @@ "node": ">=8.6" } }, + "node_modules/mime-db": { + "version": "1.54.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz", + "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz", + "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "mime-db": "^1.54.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/minimatch": { "version": "3.1.5", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", @@ -6791,6 +7479,16 @@ "dev": true, "license": "MIT" }, + "node_modules/negotiator": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz", + "integrity": "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, "node_modules/next": { "version": "16.2.6", "resolved": "https://registry.npmjs.org/next/-/next-16.2.6.tgz", @@ -7065,6 +7763,29 @@ "integrity": "sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==", "license": "MIT" }, + "node_modules/on-finished": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", + "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", + "dev": true, + "license": "MIT", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/once": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", + "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", + "dev": true, + "license": "ISC", + "dependencies": { + "wrappy": "1" + } + }, "node_modules/optionator": { "version": "0.9.4", "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", @@ -7146,6 +7867,16 @@ "node": ">=6" } }, + "node_modules/parseurl": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", + "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/path-exists": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", @@ -7172,6 +7903,17 @@ "dev": true, "license": "MIT" }, + "node_modules/path-to-regexp": { + "version": "8.4.2", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz", + "integrity": "sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==", + "dev": true, + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/pathe": { "version": "2.0.3", "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz", @@ -7184,6 +7926,104 @@ "integrity": "sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==", "license": "MIT" }, + "node_modules/pg": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/pg/-/pg-8.20.0.tgz", + "integrity": "sha512-ldhMxz2r8fl/6QkXnBD3CR9/xg694oT6DZQ2s6c/RI28OjtSOpxnPrUCGOBJ46RCUxcWdx3p6kw/xnDHjKvaRA==", + "license": "MIT", + "dependencies": { + "pg-connection-string": "^2.12.0", + "pg-pool": "^3.13.0", + "pg-protocol": "^1.13.0", + "pg-types": "2.2.0", + "pgpass": "1.0.5" + }, + "engines": { + "node": ">= 16.0.0" + }, + "optionalDependencies": { + "pg-cloudflare": "^1.3.0" + }, + "peerDependencies": { + "pg-native": ">=3.0.1" + }, + "peerDependenciesMeta": { + "pg-native": { + "optional": true + } + } + }, + "node_modules/pg-cloudflare": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.3.0.tgz", + "integrity": "sha512-6lswVVSztmHiRtD6I8hw4qP/nDm1EJbKMRhf3HCYaqud7frGysPv7FYJ5noZQdhQtN2xJnimfMtvQq21pdbzyQ==", + "license": "MIT", + "optional": true + }, + "node_modules/pg-connection-string": { + "version": "2.12.0", + "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.12.0.tgz", + "integrity": "sha512-U7qg+bpswf3Cs5xLzRqbXbQl85ng0mfSV/J0nnA31MCLgvEaAo7CIhmeyrmJpOr7o+zm0rXK+hNnT5l9RHkCkQ==", + "license": "MIT" + }, + "node_modules/pg-int8": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/pg-int8/-/pg-int8-1.0.1.tgz", + "integrity": "sha512-WCtabS6t3c8SkpDBUlb1kjOs7l66xsGdKpIPZsg4wR+B3+u9UAum2odSsF9tnvxg80h4ZxLWMy4pRjOsFIqQpw==", + "license": "ISC", + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/pg-pool": { + "version": "3.13.0", + "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.13.0.tgz", + "integrity": "sha512-gB+R+Xud1gLFuRD/QgOIgGOBE2KCQPaPwkzBBGC9oG69pHTkhQeIuejVIk3/cnDyX39av2AxomQiyPT13WKHQA==", + "license": "MIT", + "peerDependencies": { + "pg": ">=8.0" + } + }, + "node_modules/pg-protocol": { + "version": "1.13.0", + "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.13.0.tgz", + "integrity": "sha512-zzdvXfS6v89r6v7OcFCHfHlyG/wvry1ALxZo4LqgUoy7W9xhBDMaqOuMiF3qEV45VqsN6rdlcehHrfDtlCPc8w==", + "license": "MIT" + }, + "node_modules/pg-types": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/pg-types/-/pg-types-2.2.0.tgz", + "integrity": "sha512-qTAAlrEsl8s4OiEQY69wDvcMIdQN6wdz5ojQiOy6YRMuynxenON0O5oCpJI6lshc6scgAY8qvJ2On/p+CXY0GA==", + "license": "MIT", + "dependencies": { + "pg-int8": "1.0.1", + "postgres-array": "~2.0.0", + "postgres-bytea": "~1.0.0", + "postgres-date": "~1.0.4", + "postgres-interval": "^1.1.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/pg-types/node_modules/postgres-array": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-2.0.0.tgz", + "integrity": "sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/pgpass": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/pgpass/-/pgpass-1.0.5.tgz", + "integrity": "sha512-FdW9r/jQZhSeohs1Z3sI1yxFQNFvMcnmfuj4WBMUTxOrAyLMaTcE1aAMBiTlbMNaXvBCQuVi0R7hd8udDSP7ug==", + "license": "MIT", + "dependencies": { + "split2": "^4.1.0" + } + }, "node_modules/picocolors": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", @@ -7214,6 +8054,16 @@ "pathe": "^2.0.3" } }, + "node_modules/pluralize": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/pluralize/-/pluralize-8.0.0.tgz", + "integrity": "sha512-Nc3IT5yHzflTfbjgqWcCPpo7DaKy4FnpB0l/zCAW0Tc7jxAiuqSxHasntB3D7887LSrA93kDJ9IXovxJYxyLCA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, "node_modules/possible-typed-array-names": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.1.0.tgz", @@ -7266,6 +8116,45 @@ "url": "https://github.com/sponsors/porsager" } }, + "node_modules/postgres-array": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-3.0.4.tgz", + "integrity": "sha512-nAUSGfSDGOaOAEGwqsRY27GPOea7CNipJPOA7lPbdEpx5Kg3qzdP0AaWC5MlhTWV9s4hFX39nomVZ+C4tnGOJQ==", + "license": "MIT", + "engines": { + "node": ">=12" + } + }, + "node_modules/postgres-bytea": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.1.tgz", + "integrity": "sha512-5+5HqXnsZPE65IJZSMkZtURARZelel2oXUEO8rH83VS/hxH5vv1uHquPg5wZs8yMAfdv971IU+kcPUczi7NVBQ==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/postgres-date": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/postgres-date/-/postgres-date-1.0.7.tgz", + "integrity": "sha512-suDmjLVQg78nMK2UZ454hAG+OAW+HQPZ6n++TNDUX+L0+uUlLywnoxJKDou51Zm+zTCjrCl0Nq6J9C5hP9vK/Q==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/postgres-interval": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/postgres-interval/-/postgres-interval-1.2.0.tgz", + "integrity": "sha512-9ZhXKM/rw350N1ovuWHbGxnGh/SNJ4cnxHiM0rxE4VN41wsg8P8zWn9hv/buK00RP4WvlOyr/RBDiptyxVbkZQ==", + "license": "MIT", + "dependencies": { + "xtend": "^4.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/prelude-ls": { "version": "1.2.1", "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", @@ -7276,6 +8165,22 @@ "node": ">= 0.8.0" } }, + "node_modules/prettier": { + "version": "3.8.3", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.3.tgz", + "integrity": "sha512-7igPTM53cGHMW8xWuVTydi2KO233VFiTNyF5hLJqpilHfmn8C8gPf+PS7dUT64YcXFbiMGZxS9pCSxL/Dxm/Jw==", + "dev": true, + "license": "MIT", + "bin": { + "prettier": "bin/prettier.cjs" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, "node_modules/prisma": { "version": "7.8.0", "resolved": "https://registry.npmjs.org/prisma/-/prisma-7.8.0.tgz", @@ -7309,6 +8214,82 @@ } } }, + "node_modules/prisma-zod-generator": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/prisma-zod-generator/-/prisma-zod-generator-2.1.4.tgz", + "integrity": "sha512-fiNUD4unEXZqfnE23IM3beCR6+hNXi8wZglF1yJG079LqTqdZXFntvqM+Mk/k/Yc7bc0aPeZLYwie3qDRotAHQ==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "dependencies": { + "@prisma/client": "^7.0.0", + "@prisma/generator-helper": "^7.0.0", + "@prisma/internals": "^7.0.0", + "@types/cors": "^2.8.19", + "@types/express": "^5.0.5", + "ajv": "^8.17.1", + "ajv-formats": "^3.0.1", + "cors": "^2.8.5", + "dotenv": "^17.2.3", + "express": "^5.1.0", + "js-yaml": "^4.1.1", + "node-fetch": "^3.3.2", + "prettier": "^3.6.2", + "tslib": "^2.8.1" + }, + "bin": { + "prisma-zod-generator": "lib/generator.js", + "pzg-pro": "lib/cli/pzg-pro.js" + }, + "engines": { + "node": ">=20.19.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/omar-dulaimi" + }, + "peerDependencies": { + "zod": ">=3.25.0 <5" + } + }, + "node_modules/prisma-zod-generator/node_modules/ajv": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz", + "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/prisma-zod-generator/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "dev": true, + "license": "MIT" + }, + "node_modules/prompts": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", + "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "kleur": "^3.0.3", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 6" + } + }, "node_modules/prop-types": { "version": "15.8.1", "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz", @@ -7338,6 +8319,20 @@ "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", "license": "ISC" }, + "node_modules/proxy-addr": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", + "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", + "dev": true, + "license": "MIT", + "dependencies": { + "forwarded": "0.2.0", + "ipaddr.js": "1.9.1" + }, + "engines": { + "node": ">= 0.10" + } + }, "node_modules/punycode": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", @@ -7364,6 +8359,22 @@ ], "license": "MIT" }, + "node_modules/qs": { + "version": "6.15.1", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.1.tgz", + "integrity": "sha512-6YHEFRL9mfgcAvql/XhwTvf5jKcOiiupt2FiJxHkiX1z4j7WL8J/jRHYLluORvc1XxB5rV20KoeK00gVJamspg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "side-channel": "^1.1.0" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, "node_modules/queue-microtask": { "version": "1.2.3", "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", @@ -7385,6 +8396,49 @@ ], "license": "MIT" }, + "node_modules/range-parser": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", + "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/raw-body": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.2.tgz", + "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "bytes": "~3.1.2", + "http-errors": "~2.0.1", + "iconv-lite": "~0.7.0", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/raw-body/node_modules/iconv-lite": { + "version": "0.7.2", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.2.tgz", + "integrity": "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/rc9": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/rc9/-/rc9-3.0.1.tgz", @@ -7568,6 +8622,23 @@ "integrity": "sha512-NS3levdsRIUOmiJ8FZWCP7LG3QpJyrs/TE0Zpf1yvZu8cAJJ6QMW92H1c7kWpdIHo8RvmLxN/o2JXTKHp74lUA==", "license": "Unlicense" }, + "node_modules/router": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz", + "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^4.4.0", + "depd": "^2.0.0", + "is-promise": "^4.0.0", + "parseurl": "^1.3.3", + "path-to-regexp": "^8.0.0" + }, + "engines": { + "node": ">= 18" + } + }, "node_modules/run-parallel": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", @@ -7695,11 +8766,58 @@ "semver": "bin/semver.js" } }, + "node_modules/send": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz", + "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^4.4.3", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "etag": "^1.8.1", + "fresh": "^2.0.0", + "http-errors": "^2.0.1", + "mime-types": "^3.0.2", + "ms": "^2.1.3", + "on-finished": "^2.4.1", + "range-parser": "^1.2.1", + "statuses": "^2.0.2" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/seq-queue": { "version": "0.0.5", "resolved": "https://registry.npmjs.org/seq-queue/-/seq-queue-0.0.5.tgz", "integrity": "sha512-hr3Wtp/GZIc/6DAGPDcV4/9WoZhjrkXsi5B/07QgX8tsdc6ilr7BFM6PM6rbdAX1kFSDYeZGLipIZZKyQP0O5Q==" }, + "node_modules/serve-static": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.1.tgz", + "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==", + "dev": true, + "license": "MIT", + "dependencies": { + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "parseurl": "^1.3.3", + "send": "^1.2.0" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/set-function-length": { "version": "1.2.2", "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", @@ -7749,6 +8867,13 @@ "node": ">= 0.4" } }, + "node_modules/setprototypeof": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", + "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", + "dev": true, + "license": "ISC" + }, "node_modules/sharp": { "version": "0.34.5", "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.5.tgz", @@ -7916,6 +9041,13 @@ "url": "https://github.com/sponsors/isaacs" } }, + "node_modules/sisteransi": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", + "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", + "dev": true, + "license": "MIT" + }, "node_modules/source-map-js": { "version": "1.2.1", "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", @@ -7925,6 +9057,15 @@ "node": ">=0.10.0" } }, + "node_modules/split2": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz", + "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==", + "license": "ISC", + "engines": { + "node": ">= 10.x" + } + }, "node_modules/sqlstring": { "version": "2.3.3", "resolved": "https://registry.npmjs.org/sqlstring/-/sqlstring-2.3.3.tgz", @@ -7941,6 +9082,16 @@ "dev": true, "license": "MIT" }, + "node_modules/statuses": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz", + "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/std-env": { "version": "3.10.0", "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz", @@ -8228,6 +9379,16 @@ "node": ">=8.0" } }, + "node_modules/toidentifier": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", + "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.6" + } + }, "node_modules/ts-api-utils": { "version": "2.5.0", "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz", @@ -8286,6 +9447,39 @@ "node": ">= 0.8.0" } }, + "node_modules/type-is": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.1.0.tgz", + "integrity": "sha512-faYHw0anBbc/kWF3zFTEnxSFOAGUX9GFbOBthvDdLsIlEoWOFOtS0zgCiQYwIskL9iGXZL3kAXD8OoZ4GmMATA==", + "dev": true, + "license": "MIT", + "dependencies": { + "content-type": "^2.0.0", + "media-typer": "^1.1.0", + "mime-types": "^3.0.0" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/type-is/node_modules/content-type": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.0.0.tgz", + "integrity": "sha512-j/O/d7GcZCyNl7/hwZAb606rzqkyvaDctLmckbxLzHvFBzTJHuGEdodATcP3yIRoDrLHkIATJuvzbFlp/ki2cQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/typed-array-buffer": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz", @@ -8425,9 +9619,28 @@ "version": "6.21.0", "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", - "dev": true, "license": "MIT" }, + "node_modules/universalify": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", + "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 10.0.0" + } + }, + "node_modules/unpipe": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", + "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/unrs-resolver": { "version": "1.11.1", "resolved": "https://registry.npmjs.org/unrs-resolver/-/unrs-resolver-1.11.1.tgz", @@ -8518,6 +9731,16 @@ } } }, + "node_modules/vary": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", + "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/web-streams-polyfill": { "version": "3.3.3", "resolved": "https://registry.npmjs.org/web-streams-polyfill/-/web-streams-polyfill-3.3.3.tgz", @@ -8641,6 +9864,22 @@ "node": ">=0.10.0" } }, + "node_modules/wrappy": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", + "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/xtend": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz", + "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==", + "license": "MIT", + "engines": { + "node": ">=0.4" + } + }, "node_modules/yallist": { "version": "3.1.1", "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", diff --git a/dashboard/package.json b/dashboard/package.json index 0b87f23..23c9ce5 100644 --- a/dashboard/package.json +++ b/dashboard/package.json @@ -9,6 +9,7 @@ "lint": "eslint" }, "dependencies": { + "@prisma/adapter-pg": "^7.8.0", "@prisma/client": "^7.8.0", "@tanstack/react-query": "^5.100.10", "d3": "^7.9.0", @@ -16,6 +17,7 @@ "google-auth-library": "^10.6.2", "jsonwebtoken": "^9.0.3", "next": "16.2.6", + "pg": "^8.20.0", "prisma": "^7.8.0", "react": "19.2.4", "react-dom": "19.2.4", @@ -26,10 +28,12 @@ "@types/d3": "^7.4.3", "@types/jsonwebtoken": "^9.0.10", "@types/node": "^20", + "@types/pg": "^8.20.0", "@types/react": "^19", "@types/react-dom": "^19", "eslint": "^9", "eslint-config-next": "16.2.6", + "prisma-zod-generator": "^2.1.4", "tailwindcss": "^4", "typescript": "^5" } diff --git a/dashboard/prisma/schema.prisma b/dashboard/prisma/schema.prisma index 67a61b1..3f2dd19 100644 --- a/dashboard/prisma/schema.prisma +++ b/dashboard/prisma/schema.prisma @@ -1,6 +1,11 @@ generator client { provider = "prisma-client" - output = "../app/generated/prisma" + output = "../generated/prisma" +} + +generator zod { + provider = "prisma-zod-generator" + output = "../generated/zod" } datasource db { diff --git a/dashboard/server/.gitkeep b/dashboard/server/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/dashboard/server/cors.ts b/dashboard/server/cors.ts new file mode 100644 index 0000000..f6f52e6 --- /dev/null +++ b/dashboard/server/cors.ts @@ -0,0 +1,31 @@ +import { NextRequest, NextResponse } from "next/server"; + +const ALLOWED_ORIGIN_PATTERN = /^chrome-extension:\/\/[a-p]{32}$/; + +function corsHeaders(origin: string | null): Record { + const allow = origin && ALLOWED_ORIGIN_PATTERN.test(origin) ? origin : "null"; + return { + "Access-Control-Allow-Origin": allow, + "Access-Control-Allow-Methods": "GET, POST, OPTIONS", + "Access-Control-Allow-Headers": "Authorization, Content-Type", + Vary: "Origin", + }; +} + +export function withCors( + handler: (req: NextRequest) => Promise | NextResponse, +): (req: NextRequest) => Promise { + return async (req) => { + const res = await handler(req); + const headers = corsHeaders(req.headers.get("origin")); + for (const [k, v] of Object.entries(headers)) res.headers.set(k, v); + return res; + }; +} + +export function corsPreflight(req: NextRequest): NextResponse { + return new NextResponse(null, { + status: 204, + headers: corsHeaders(req.headers.get("origin")), + }); +} diff --git a/dashboard/server/db.ts b/dashboard/server/db.ts new file mode 100644 index 0000000..c8c4511 --- /dev/null +++ b/dashboard/server/db.ts @@ -0,0 +1,22 @@ +import { PrismaPg } from "@prisma/adapter-pg"; +import { PrismaClient } from "@/generated/prisma/client"; + +declare global { + // eslint-disable-next-line no-var + var prismaGlobal: PrismaClient | undefined; +} + +function createPrismaClient() { + const connectionString = process.env.DATABASE_URL; + if (!connectionString) { + throw new Error("DATABASE_URL is not set"); + } + const adapter = new PrismaPg({ connectionString }); + return new PrismaClient({ adapter, log: ["warn", "error"] }); +} + +export const prisma = globalThis.prismaGlobal ?? createPrismaClient(); + +if (process.env.NODE_ENV !== "production") { + globalThis.prismaGlobal = prisma; +} diff --git a/dashboard/server/events.ts b/dashboard/server/events.ts new file mode 100644 index 0000000..e0084f8 --- /dev/null +++ b/dashboard/server/events.ts @@ -0,0 +1,6 @@ +import type { CreateEventInput } from "./schemas/events"; +import { prisma } from "./db"; + +export function createEvent(input: CreateEventInput) { + return prisma.event.create({ data: input }); +} diff --git a/dashboard/server/schemas/events.ts b/dashboard/server/schemas/events.ts new file mode 100644 index 0000000..ee7ac33 --- /dev/null +++ b/dashboard/server/schemas/events.ts @@ -0,0 +1,12 @@ +import { z } from "zod"; +import { EventUncheckedCreateInputObjectZodSchema } from "@/generated/zod/schemas/objects/EventUncheckedCreateInput.schema"; + +export const CreateEventInput = EventUncheckedCreateInputObjectZodSchema + .omit({ id: true, createdAt: true }) + .extend({ + sessionId: z.string().regex(/^c[a-z0-9]{24}$/, "must be a CUID"), + url: z.url(), + title: z.string().min(1), + }); + +export type CreateEventInput = z.infer; diff --git a/plans/AC3-cors.md b/plans/AC3-cors.md new file mode 100644 index 0000000..9c9e82b --- /dev/null +++ b/plans/AC3-cors.md @@ -0,0 +1,169 @@ +# Plan: AC 3 — CORS for Chrome Extension + +**Branch:** `feature/api-events-and-cors` (second commit, same branch as AC 7) +**Closes:** Week 1 AC 3 ([docs/Task.md L55](../docs/Task.md#L55)) +**Status:** plan, awaiting approval + +## Scope + +Make `dashboard/app/api/v1/events/route.ts` (added in AC 7) callable from the Chrome Extension. Add the CORS infrastructure so future Route Handlers can reuse it. + +Per AC 3 in TZ: +> У Route Handlers налаштовано `Access-Control-Allow-Origin` для `chrome-extension://*`. Перевірено через Postman — запит проходить без помилок. + +## Files + +| Path | Action | Notes | +|---|---|---| +| `dashboard/server/cors.ts` | new | `withCors()` wrapper + `corsPreflight()` helper | +| `dashboard/app/api/v1/events/route.ts` | modify | wrap `POST` with `withCors`, add `OPTIONS` handler | +| `.claude/skills/api-route.md` | modify | tighten CORS section with real import path and code snippet | +| `plans/AC3-cors.md` | add (this file) | | + +## Design decisions + +### 1. Pattern: higher-order wrapper, not header-on-each-response + +Two common patterns: + +- **Per-handler headers:** every handler manually calls `res.headers.set("Access-Control-Allow-Origin", ...)` before return. Repetitive; easy to forget. +- **Higher-order wrapper:** `withCors(handler)` returns a handler that adds CORS headers to whatever the wrapped handler returns. + +**Decision:** wrapper. Adding CORS to a new endpoint is then a one-liner: +```ts +export const POST = withCors(async (req) => { /* ... */ }); +``` + +### 2. Origin matching: regex, not wildcard, not `*` + +The TZ says `chrome-extension://*`. CORS spec doesn't support wildcards in the origin value — `Access-Control-Allow-Origin` must be either an exact origin or `*`. + +Options: +- **`*`** — allow any origin. Simplest but exposes the API to any website. Also incompatible with `Access-Control-Allow-Credentials: true` (which we'll need in Week 2 for JWT in Authorization header). +- **Echo origin if it matches a regex** — accept the request, then write back the actual origin in the header. Browsers verify the echoed value matches their own origin. + +**Decision:** echo + regex. Chrome extension IDs are 32-char lowercase a-p strings (`a-p` because Chrome encodes a 128-bit ID in base16 over `a-p`). Regex: `/^chrome-extension:\/\/[a-p]{32}$/`. + +For non-matching origins (or absent `Origin` header), the helper writes `Access-Control-Allow-Origin: null` — browsers block reading the response, but Postman / curl / server-to-server requests still work fine (they don't enforce CORS). + +### 3. `OPTIONS` preflight handler + +Browsers send `OPTIONS` preflight before any cross-origin POST with `Content-Type: application/json` (it's a "non-simple" request). Without an `OPTIONS` handler that returns 204 with CORS headers, the actual POST never gets sent by the browser. + +**Decision:** export an `OPTIONS` function from the route file that returns 204 with the same CORS headers. The helper `corsPreflight(req)` builds the response. + +### 4. Headers we expose + +- `Access-Control-Allow-Origin: ` +- `Access-Control-Allow-Methods: GET, POST, OPTIONS` +- `Access-Control-Allow-Headers: Authorization, Content-Type` — `Authorization` for the upcoming JWT in Week 2, `Content-Type` because our payload is `application/json` +- `Vary: Origin` — tells caches that the response varies by `Origin` header (important for CDN behavior) + +**Not yet included** (out of scope for AC 3): +- `Access-Control-Allow-Credentials: true` — only needed if we use cookies. We use a `Bearer` token in `Authorization` header (Week 2), not cookies. Don't enable until needed. +- `Access-Control-Max-Age` — caches the preflight result. Optimization, not correctness. Skip. + +### 5. Where the helper lives + +`dashboard/server/cors.ts` — single file, per the api-route skill recipe which already references `@/server/cors`. + +Not a subfolder; the surface is small (one wrapper, one preflight builder, one regex). + +## Final code + +`dashboard/server/cors.ts`: +```ts +import { NextRequest, NextResponse } from "next/server"; + +const ALLOWED_ORIGIN_PATTERN = /^chrome-extension:\/\/[a-p]{32}$/; + +function corsHeaders(origin: string | null): Record { + const allow = origin && ALLOWED_ORIGIN_PATTERN.test(origin) ? origin : "null"; + return { + "Access-Control-Allow-Origin": allow, + "Access-Control-Allow-Methods": "GET, POST, OPTIONS", + "Access-Control-Allow-Headers": "Authorization, Content-Type", + "Vary": "Origin", + }; +} + +export function withCors( + handler: (req: NextRequest) => Promise | NextResponse, +): (req: NextRequest) => Promise { + return async (req) => { + const res = await handler(req); + const headers = corsHeaders(req.headers.get("origin")); + for (const [k, v] of Object.entries(headers)) res.headers.set(k, v); + return res; + }; +} + +export function corsPreflight(req: NextRequest): NextResponse { + return new NextResponse(null, { + status: 204, + headers: corsHeaders(req.headers.get("origin")), + }); +} +``` + +`dashboard/app/api/v1/events/route.ts` (only delta — wrap POST + add OPTIONS): +```ts +import { NextRequest, NextResponse } from "next/server"; +import { createEvent } from "@/server/events"; +import { CreateEventInput } from "@/server/schemas/events"; +import { withCors, corsPreflight } from "@/server/cors"; + +export const POST = withCors(async (req) => { + const body = await req.json(); + const parsed = CreateEventInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: parsed.error.format() }, { status: 400 }); + } + const event = await createEvent(parsed.data); + return NextResponse.json(event, { status: 201 }); +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} +``` + +## Verification + +- [ ] `npx tsc --noEmit` — clean +- [ ] OPTIONS preflight (curl with `-X OPTIONS` and `Origin: chrome-extension://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa`) → 204 + correct CORS headers +- [ ] POST with matching origin → 201 + `Access-Control-Allow-Origin: chrome-extension://...` echoed back +- [ ] POST with bad origin (`https://evil.com`) → still 201 (server doesn't reject), but `Access-Control-Allow-Origin: null` so browser would block the response read +- [ ] POST without Origin header (Postman / curl) → still 201, header is `null` but client doesn't care + +## Test commands + +```powershell +# 1. OPTIONS preflight +$h = @{ "Origin" = "chrome-extension://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" } +$r = Invoke-WebRequest -Uri "http://localhost:3000/api/v1/events" -Method Options -Headers $h +Write-Host "Status: $($r.StatusCode)" +$r.Headers | Format-List + +# 2. POST with matching extension origin +$body = '{"sessionId":"ctestsess0000000000000001","url":"https://example.com","title":"With CORS","tags":["cors"],"timestamp":"2026-05-14T13:00:00Z"}' +$r = Invoke-WebRequest -Uri "http://localhost:3000/api/v1/events" -Method Post -Body $body -ContentType "application/json" -Headers $h +$r.Headers["Access-Control-Allow-Origin"] +``` + +## Out of scope + +- **Origin allowlist for the production extension ID** — once the extension is packaged in Week 4 and gets a real Chrome ID, we'd tighten the regex (or env-driven list). For now any extension-shaped origin is accepted. +- **CSRF** — same-origin policy + CORS is enough; we don't use cookies. +- **Rate limiting / abuse** — Week 2/3. +- **CORS for the dashboard's own pages** — same-origin, no CORS needed. + +## Lesson for the skill + +`api-route.md` already mentions CORS but with placeholder code. Update with the real import paths once `server/cors.ts` exists: +```ts +import { withCors, corsPreflight } from "@/server/cors"; + +export const POST = withCors(async (req) => { /* ... */ }); +export function OPTIONS(req) { return corsPreflight(req); } +``` diff --git a/plans/AC7-events-api-route.md b/plans/AC7-events-api-route.md new file mode 100644 index 0000000..987935d --- /dev/null +++ b/plans/AC7-events-api-route.md @@ -0,0 +1,201 @@ +# Plan: AC 7 — POST /api/v1/events Route Handler + +**Branch:** `feature/api-events-and-cors` (combined PR with AC 3) +**Closes:** Week 1 AC 7 ([docs/Task.md L63](../docs/Task.md#L63)) +**Status:** implemented, awaiting smoke test + +This plan is written post-hoc after several mid-stream corrections from the user. It documents the final decisions and the changes that landed, including all the adjustments made during implementation. + +## Scope + +First Route Handler in the project, exercising the rules from CLAUDE.md (AC 6). Accepts an event payload from the (future) extension and writes to Postgres via Prisma. + +Per CLAUDE.md: +- Thin handler: parse → validate → delegate → respond +- Business logic in `dashboard/server/` +- Zod for validation at the boundary +- Schemas in `dashboard/server/schemas/` + +## Files + +| Path | Action | Notes | +|---|---|---| +| `dashboard/server/db.ts` | new | PrismaClient singleton + `@prisma/adapter-pg` | +| `dashboard/server/schemas/events.ts` | new | `CreateEventInput` Zod schema derived from generated | +| `dashboard/server/events.ts` | new | `createEvent()` business function | +| `dashboard/app/api/v1/events/route.ts` | new | POST handler | +| `dashboard/prisma/schema.prisma` | modify | output path + zod generator block | +| `dashboard/package.json` | modify | `+@prisma/adapter-pg`, `+pg`, `+@types/pg`, `+prisma-zod-generator` | +| `.gitignore` (root) | modify | broader `**/generated/` pattern | +| `dashboard/.gitignore` | modify | `/generated` (was `/app/generated/prisma`) | +| `dashboard/server/.gitkeep` | delete | server has real files now | +| `CLAUDE.md` | modify | dedup Validation section, document derived-schema pattern, adapter requirement | +| `.claude/skills/api-route.md` | modify | example uses derived-from-generated pattern | +| `.claude/skills/prisma-model.md` | modify | document zod generator + adapter singleton | + +## Design decisions + +### 1. Use `@prisma/adapter-pg` (Prisma 7 mandate) + +**Initial assumption:** `new PrismaClient({ log: ["warn", "error"] })` would just work, like Prisma 6. + +**Reality:** Prisma 7's new `prisma-client` generator drops the built-in engine. `PrismaClient` constructor requires either `accelerateUrl` (Prisma Accelerate) or an `adapter` (driver-based). Without one, TypeScript rejects the call. + +**Decision:** install `@prisma/adapter-pg` + `pg` + `@types/pg`. Wrap the `DATABASE_URL` in `new PrismaPg({ connectionString })`. For Neon production we'll later swap to `@prisma/adapter-neon` (Week 4 deploy). + +### 2. Singleton — `declare global` instead of `as unknown as` (user correction) + +**Initial code:** +```ts +const globalForPrisma = globalThis as unknown as { prisma?: PrismaClient }; +``` + +User flagged: double-cast is ugly. + +**Final code:** +```ts +declare global { + // eslint-disable-next-line no-var + var prismaGlobal: PrismaClient | undefined; +} + +export const prisma = globalThis.prismaGlobal ?? createPrismaClient(); +``` + +`declare global` augments the global type properly, no cast needed. + +### 3. Move Prisma output out of `app/` directory + +**Initial path:** `dashboard/app/generated/prisma` (from AC 2 PR). + +**Problem found during AC 7:** the default tsconfig alias `"@/*": ["./*"]` resolves `@/generated/prisma` to `dashboard/generated/prisma` (not `dashboard/app/generated/prisma`). CLAUDE.md (AC 6) had documented `@/generated/prisma/client` as the import path — which would have been broken. + +**Decision:** change the schema's `output` from `"../app/generated/prisma"` → `"../generated/prisma"`. Prisma generator now produces client at `dashboard/generated/prisma/`. The default `@/*` alias resolves correctly without custom tsconfig paths. Also matches Next.js best practice (non-route code stays outside `app/`). + +### 4. Import path: `@/generated/prisma/client` (not `@/generated/prisma`) + +**Reason:** Prisma 7's new generator emits `client.ts` as the entry point — there is no `index.ts`. So the package directory itself can't be imported; you must point at `client`. + +**CLAUDE.md and `prisma-model.md` skill updated** to reflect this. Previously they said `from "@/generated/prisma"` which would have failed at TypeScript resolution. + +### 5. Zod schemas in `server/schemas/`, not inline (user direction) + +**Initial code:** Zod schema was inline in `route.ts`. + +User flagged: schemas should live in a dedicated folder. + +**Decision:** all API Zod schemas live in `dashboard/server/schemas/.ts`. Route handlers import from there. + +`api-route.md` skill rule was tightened from "inline unless reused" to "always in `server/schemas/`". + +### 6. Generate Zod schemas from Prisma (user direction) + +**User request:** use `zod-prisma-types` everywhere possible to avoid duplicating Prisma field types in hand-written Zod schemas. + +**Discovery (via WebSearch):** `zod-prisma-types` is in maintenance mode and does NOT support Prisma 7 (only 4.x-6.x). Its own author recommends migrating to `prisma-zod-generator` by Omar Dulaimi, which requires Prisma 7+ in its latest versions. + +**Decision:** install `prisma-zod-generator`. Add to `schema.prisma`: +```prisma +generator zod { + provider = "prisma-zod-generator" + output = "../generated/zod" +} +``` + +This generates `dashboard/generated/zod/schemas/objects/*.schema.ts` — one Zod schema per Prisma input/output type. + +### 7. Derive from `EventUncheckedCreateInput`, not `EventCreateInput` + +Two Zod schemas are generated for create: +- `EventCreateInputObjectSchema` — has nested `session: SessionCreateNestedOneWithoutEventsInputSchema` (Prisma's relation-create syntax) +- `EventUncheckedCreateInputObjectSchema` — has scalar `sessionId: string` + +**API clients send a flat `{ sessionId, url, title, ... }` payload** — they don't know about Prisma's nested-create dialect. So we derive from the `Unchecked` variant. + +**Final `server/schemas/events.ts`:** +```ts +export const CreateEventInput = EventUncheckedCreateInputObjectZodSchema + .omit({ id: true, createdAt: true }) + .extend({ + sessionId: z.string().regex(/^c[a-z0-9]{24}$/, "must be a CUID"), + url: z.url(), + title: z.string().min(1), + }); +``` + +- `.omit({ id, createdAt })` — server sets these, never accepts from client. +- `.extend(...)` — tighten validation. Generated schema types these as plain `z.string()`; we add CUID format, URL format, non-empty constraint. + +Prisma's `event.create()` accepts both `EventCreateInput` and `EventUncheckedCreateInput` shapes, so passing the flat object works. + +### 8. Zod 4 deprecations — use top-level helpers + custom regex + +**Hit at runtime:** +- `z.string().cuid()` deprecated → tried `z.cuid()` → also deprecated (Zod 4 deprecates cuid1 validation entirely in favor of cuid2) +- `z.string().url()` deprecated → replaced with `z.url()` (top-level) + +**Decision:** +- URL: `z.url()` (top-level) +- CUID: custom regex `/^c[a-z0-9]{24}$/`. We can't use `z.cuid2()` because Prisma's `@default(cuid())` generates cuid v1 (24-char strings starting with `c`), not v2. + +Documented in `api-route.md` skill so future schemas use the same pattern. + +### 9. Broader `.gitignore` pattern for generated files + +**Before:** root `.gitignore` had `**/generated/prisma/` (specific path). + +**Problem:** new `dashboard/generated/zod/` folder wouldn't be covered — 73+ files would be committed. + +**Decision:** simplify root `.gitignore` to `**/generated/` — covers any subfolder under any `generated/` directory. Also updated `dashboard/.gitignore` to `/generated` (relative to dashboard root) for clarity, replacing the obsolete `/app/generated/prisma` line from AC 2. + +### 10. No auth, no batching, no rate-limit in this AC + +Out of scope: +- **Auth:** Week 2 AC 1 will add JWT verification. AC 7's handler accepts unauthenticated requests for now. +- **Batching:** Week 2 AC 5 (extension sends events in batches with retry). AC 7's handler accepts one event per request. +- **Idempotency keys:** future enhancement. +- **Rate limiting:** future enhancement. + +## Final file: `dashboard/app/api/v1/events/route.ts` + +```ts +import { NextRequest, NextResponse } from "next/server"; +import { createEvent } from "@/server/events"; +import { CreateEventInput } from "@/server/schemas/events"; + +export async function POST(req: NextRequest) { + const body = await req.json(); + const parsed = CreateEventInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: parsed.error.format() }, { status: 400 }); + } + + const event = await createEvent(parsed.data); + return NextResponse.json(event, { status: 201 }); +} +``` + +5 imports out, 12 lines of logic. Matches `api-route.md` skill exactly. + +## Verification + +- [x] `npx tsc --noEmit` — clean, no errors, no deprecations +- [x] `npx prisma generate` — both prisma client and zod schemas regenerate +- [x] `docker compose up -d` — Postgres healthy on port 5433 +- [ ] **Smoke test:** POST a valid event → 201 with event JSON; POST a bad body → 400 with Zod errors (TODO before commit) + +## Out of scope for this AC (handled in AC 3 of same PR) + +- CORS headers (`Access-Control-Allow-Origin: chrome-extension://*`) +- `OPTIONS` preflight handler +- `dashboard/server/cors.ts` helper + +CORS is the next commit on the same branch. + +## Lessons captured for the skills + +The drift between "initial plan" and "what landed" was driven by issues that future AI sessions would hit too. The skills now document the actual patterns: + +- `api-route.md` — derived-from-generated example, CUID regex, server-managed fields via `.omit()` +- `prisma-model.md` — adapter-based singleton, both generators on schema change +- `CLAUDE.md` — consolidated Validation section pointing at `server/schemas/` and the derived-schema rule From 067887e513dc0eaf5e3dbc54a866c8d7bfce4143 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Thu, 14 May 2026 23:00:11 +0300 Subject: [PATCH 05/24] feat(extension): init manifest v3 with vite + crxjs (AC 4) (#5) MV3 + TypeScript scaffold under extension/. Background SW, content script (), empty popup, placeholder icons. Loads in Chrome via Load unpacked. See plans/AC4-extension-init.md. --- .gitignore | 1 - dashboard/.gitignore | 3 +- dashboard/package.json | 2 +- extension/.env.example | 1 + extension/.gitignore | 12 + extension/package-lock.json | 1819 +++++++++++++++++++++++++++++ extension/package.json | 18 + extension/src/background/index.ts | 5 + extension/src/content/index.ts | 1 + extension/src/icons/icon-128.png | Bin 0 -> 936 bytes extension/src/icons/icon-16.png | Bin 0 -> 145 bytes extension/src/icons/icon-32.png | Bin 0 -> 172 bytes extension/src/icons/icon-48.png | Bin 0 -> 232 bytes extension/src/manifest.ts | 35 + extension/src/popup/index.html | 16 + extension/src/popup/popup.css | 39 + extension/src/popup/popup.ts | 1 + extension/tsconfig.json | 20 + extension/vite.config.ts | 11 + plans/AC4-extension-init.md | 272 +++++ 20 files changed, 2253 insertions(+), 3 deletions(-) create mode 100644 extension/.env.example create mode 100644 extension/.gitignore create mode 100644 extension/package-lock.json create mode 100644 extension/package.json create mode 100644 extension/src/background/index.ts create mode 100644 extension/src/content/index.ts create mode 100644 extension/src/icons/icon-128.png create mode 100644 extension/src/icons/icon-16.png create mode 100644 extension/src/icons/icon-32.png create mode 100644 extension/src/icons/icon-48.png create mode 100644 extension/src/manifest.ts create mode 100644 extension/src/popup/index.html create mode 100644 extension/src/popup/popup.css create mode 100644 extension/src/popup/popup.ts create mode 100644 extension/tsconfig.json create mode 100644 extension/vite.config.ts create mode 100644 plans/AC4-extension-init.md diff --git a/.gitignore b/.gitignore index 12c7b35..a1ac299 100644 --- a/.gitignore +++ b/.gitignore @@ -20,7 +20,6 @@ extension/build/ *.zip # Prisma generated artifacts (client + zod schemas) -**/app/generated/ **/generated/ # Environment diff --git a/dashboard/.gitignore b/dashboard/.gitignore index 2a0c7e3..9178f0a 100644 --- a/dashboard/.gitignore +++ b/dashboard/.gitignore @@ -41,4 +41,5 @@ yarn-error.log* *.tsbuildinfo next-env.d.ts -/generated +# prisma generated artifacts (client + zod schemas) +/generated/ diff --git a/dashboard/package.json b/dashboard/package.json index 23c9ce5..d5dc9f5 100644 --- a/dashboard/package.json +++ b/dashboard/package.json @@ -4,7 +4,7 @@ "private": true, "scripts": { "dev": "next dev", - "build": "next build", + "build": "prisma generate && next build", "start": "next start", "lint": "eslint" }, diff --git a/extension/.env.example b/extension/.env.example new file mode 100644 index 0000000..99cbcd5 --- /dev/null +++ b/extension/.env.example @@ -0,0 +1 @@ +VITE_API_BASE_URL=http://localhost:3000 diff --git a/extension/.gitignore b/extension/.gitignore new file mode 100644 index 0000000..c373d11 --- /dev/null +++ b/extension/.gitignore @@ -0,0 +1,12 @@ +node_modules/ +dist/ +.env +.env.* +!.env.example + +# logs +*.log +npm-debug.log* + +# typescript +*.tsbuildinfo diff --git a/extension/package-lock.json b/extension/package-lock.json new file mode 100644 index 0000000..3951578 --- /dev/null +++ b/extension/package-lock.json @@ -0,0 +1,1819 @@ +{ + "name": "worktrace-extension", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "worktrace-extension", + "version": "0.1.0", + "devDependencies": { + "@crxjs/vite-plugin": "^2.0.0-beta.36", + "@types/chrome": "^0.0.290", + "typescript": "^5.6.0", + "vite": "^7.0.0" + } + }, + "node_modules/@crxjs/vite-plugin": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/@crxjs/vite-plugin/-/vite-plugin-2.4.0.tgz", + "integrity": "sha512-bDLdq0W2V1SkMQDJjrcYyjK9/uKtdl4joT7GRImcootCjZdKRiRYt+cv9z8tJoU/tK3o1lX48LTqN7JMsk5AQg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@rollup/pluginutils": "^4.1.2", + "@webcomponents/custom-elements": "^1.5.0", + "acorn-walk": "^8.2.0", + "convert-source-map": "^1.7.0", + "debug": "^4.3.3", + "es-module-lexer": "^0.10.0", + "fast-glob": "^3.2.11", + "fs-extra": "^10.0.1", + "jsesc": "^3.0.2", + "magic-string": "^0.30.12", + "node-html-parser": "^7.0.2", + "pathe": "^2.0.1", + "picocolors": "^1.1.1", + "react-refresh": "^0.13.0", + "rollup": "2.79.2", + "rxjs": "7.5.7" + }, + "peerDependencies": { + "vite": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.7.tgz", + "integrity": "sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.7.tgz", + "integrity": "sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.7.tgz", + "integrity": "sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.7.tgz", + "integrity": "sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.7.tgz", + "integrity": "sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.7.tgz", + "integrity": "sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.7.tgz", + "integrity": "sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.7.tgz", + "integrity": "sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.7.tgz", + "integrity": "sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.7.tgz", + "integrity": "sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.7.tgz", + "integrity": "sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.7.tgz", + "integrity": "sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.7.tgz", + "integrity": "sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.7.tgz", + "integrity": "sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.7.tgz", + "integrity": "sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.7.tgz", + "integrity": "sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.7.tgz", + "integrity": "sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.7.tgz", + "integrity": "sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.7.tgz", + "integrity": "sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.7.tgz", + "integrity": "sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.7.tgz", + "integrity": "sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.7.tgz", + "integrity": "sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.7.tgz", + "integrity": "sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.7.tgz", + "integrity": "sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.7.tgz", + "integrity": "sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.7.tgz", + "integrity": "sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "dev": true, + "license": "MIT" + }, + "node_modules/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@rollup/pluginutils": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-4.2.1.tgz", + "integrity": "sha512-iKnFXr7NkdZAIHiIWE+BX5ULi/ucVFYWD6TbAV+rZctiRTY2PL6tsIKhoIOaoskiWAkgu+VsbXgUVDNLHf+InQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "estree-walker": "^2.0.1", + "picomatch": "^2.2.2" + }, + "engines": { + "node": ">= 8.0.0" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.60.4.tgz", + "integrity": "sha512-F5QXMSiFebS9hKZj02XhWLLnRpJ3B3AROP0tWbFBSj+6kCbg5m9j5JoHKd4mmSVy5mS/IMQloYgYxCuJC0fxEQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.60.4.tgz", + "integrity": "sha512-GxxTKApUpzRhof7poWvCJHRF51C67u1R7D6DiluBE8wKU1u5GWE8t+v81JvJYtbawoBFX1hLv5Ei4eVjkWokaw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.60.4.tgz", + "integrity": "sha512-tua0TaJxMOB1R0V0RS1jFZ/RpURFDJIOR2A6jWwQeawuFyS4gBW+rntLRaQd0EQ4bd6Vp44Z2rXW+YYDBsj6IA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.60.4.tgz", + "integrity": "sha512-CSKq7MsP+5PFIcydhAiR1K0UhEI1A2jWXVKHPCBZ151yOutENwvnPocgVHkivu2kviURtCEB6zUQw0vs8RrhMg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.60.4.tgz", + "integrity": "sha512-+O8OkVdyvXMtJEciu2wS/pzm1IxntEEQx3z5TAVy4l32G0etZn+RsA48ARRrFm6Ri8fvqPQfgrvNxSjKAbnd3g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.60.4.tgz", + "integrity": "sha512-Iw3oMskH3AfNuhU0MSN7vNbdi4me/NiYo2azqPz/Le16zHSa+3RRmliCMWWQmh4lcndccU40xcJuTYJZxNo/lw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.60.4.tgz", + "integrity": "sha512-EIPRXTVQpHyF8WOo219AD2yEltPehLTcTMz2fn6JsatLYSzQf00hj3rulF+yauOlF9/FtM2WpkT/hJh/KJFGhA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.60.4.tgz", + "integrity": "sha512-J3Yh9PzzF1Ovah2At+lHiGQdsYgArxBbXv/zHfSyaiFQEqvNv7DcW98pCrmdjCZBrqBiKrKKe2V+aaSGWuBe/w==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.60.4.tgz", + "integrity": "sha512-BFDEZMYfUvLn37ONE1yMBojPxnMlTFsdyNoqncT0qFq1mAfllL+ATMMJd8TeuVMiX84s1KbcxcZbXInmcO2mRg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.60.4.tgz", + "integrity": "sha512-pc9EYOSlOgdQ2uPl1o9PF6/kLSgaUosia7gOuS8mB69IxJvlclko1MECXysjs5ryez1/5zjYqx3+xYU0TU6R1A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.60.4.tgz", + "integrity": "sha512-NxnomyxYerDh5n4iLrNa+sH+Z+U4BMEE46V2PgQ/hoB909i8gV1M5wPojWg9fk1jWpO3IQnOs20K4wyZuFLEFQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.60.4.tgz", + "integrity": "sha512-nbJnQ8a3z1mtmrwImCYhc6BGpThAyYVRQxw9uKSKG4wR6aAYno9sVjJ0zaZcW9BPJX1GbrDPf+SvdWjgTuDmnw==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.60.4.tgz", + "integrity": "sha512-2EU6acNrQLd8tYvo/LXW535wupT3m6fo7HKo6lr7ktQoItxTyOL1ZCR/GfGCuXl2vR+zmfI6eRXkSemafv+iVg==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.60.4.tgz", + "integrity": "sha512-WeBtoMuaMxiiIrO2IYP3xs6GMWkJP2C0EoT8beTLkUPmzV1i/UcOSVw1d5r9KBODtHKilG5yFxsGRnBbK3wJ4A==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.60.4.tgz", + "integrity": "sha512-FJHFfqpKUI3A10WrWKiFbBZ7yVbGT4q4B5o1qKFFojqpaYoh9LrQgqWCmmcxQzVSXYtyB5bzkXrYzlHTs21MYA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.60.4.tgz", + "integrity": "sha512-mcEl6CUT5IAUmQf1m9FYSmVqCJlpQ8r8eyftFUHG8i9OhY7BkBXSUdnLH5DOf0wCOjcP9v/QO93zpmF1SptCCw==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.60.4.tgz", + "integrity": "sha512-ynt3JxVd2w2buzoKDWIyiV1pJW93xlQic1THVLXilz429oijRpSHivZAgp65KBu+cMcgf1eVVjdnTLvPxgCuoQ==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.60.4.tgz", + "integrity": "sha512-Boiz5+MsaROEWDf+GGEwF8VMHGhlUoQMtIPjOgA5fv4osupqTVnJteQNKJwUcnUog2G55jYXH7KZFFiJe0TEzQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.60.4.tgz", + "integrity": "sha512-+qfSY27qIrFfI/Hom04KYFw3GKZSGU4lXus51wsb5EuySfFlWRwjkKWoE9emgRw/ukoT4Udsj4W/+xxG8VbPKg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.60.4.tgz", + "integrity": "sha512-VpTfOPHgVXEBeeR8hZ2O0F3aSso+JDWqTWmTmzcQKted54IAdUVbxE+j/MVxUsKa8L20HJhv3vUezVPoquqWjA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.60.4.tgz", + "integrity": "sha512-IPOsh5aRYuLv/nkU51X10Bf75Bsf6+gZdx1X+QP5QM6lIJFHHqbHLG0uJn/hWthzo13UAc2umiUorqZy3axoZg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.60.4.tgz", + "integrity": "sha512-4QzE9E81OohJ/HKzHhsqU+zcYYojVOXlFMs1DdyMT6qXl/niOH7AVElmmEdUNHHS/oRkc++d5k6Vy85zFs0DEw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.60.4.tgz", + "integrity": "sha512-zTPgT1YuHHcd+Tmx7h8aml0FWFVelV5N54oHow9SLj+GfoDy/huQ+UV396N/C7KpMDMiPspRktzM1/0r1usYEA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.60.4.tgz", + "integrity": "sha512-DRS4G7mi9lJxqEDezIkKCaUIKCrLUUDCUaCsTPCi/rtqaC6D/jjwslMQyiDU50Ka0JKpeXeRBFBAXwArY52vBw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.60.4.tgz", + "integrity": "sha512-QVTUovf40zgTqlFVrKA1uXMVvU2QWEFWfAH8Wdc48IxLvrJMQVMBRjuQyUpzZCDkakImib9eVazbWlC6ksWtJw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/chrome": { + "version": "0.0.290", + "resolved": "https://registry.npmjs.org/@types/chrome/-/chrome-0.0.290.tgz", + "integrity": "sha512-N92vsAdlwoWameDQ8D4K0EZXXvxsJ1+gJg+4TWjUUsZ6gpontVmwl1XVtysA3mso45Fcn5UPiX/yqiT8GcBV3A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/filesystem": "*", + "@types/har-format": "*" + } + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/filesystem": { + "version": "0.0.36", + "resolved": "https://registry.npmjs.org/@types/filesystem/-/filesystem-0.0.36.tgz", + "integrity": "sha512-vPDXOZuannb9FZdxgHnqSwAG/jvdGM8Wq+6N4D/d80z+D4HWH+bItqsZaVRQykAn6WEVeEkLm2oQigyHtgb0RA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/filewriter": "*" + } + }, + "node_modules/@types/filewriter": { + "version": "0.0.33", + "resolved": "https://registry.npmjs.org/@types/filewriter/-/filewriter-0.0.33.tgz", + "integrity": "sha512-xFU8ZXTw4gd358lb2jw25nxY9QAgqn2+bKKjKOYfNCzN4DKCFetK7sPtrlpg66Ywe3vWY9FNxprZawAh9wfJ3g==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/har-format": { + "version": "1.2.16", + "resolved": "https://registry.npmjs.org/@types/har-format/-/har-format-1.2.16.tgz", + "integrity": "sha512-fluxdy7ryD3MV6h8pTfTYpy/xQzCFC7m89nOH9y94cNqJ1mDIDPut7MnRHI3F6qRmh/cT2fUjG1MLdCNb4hE9A==", + "dev": true, + "license": "MIT" + }, + "node_modules/@webcomponents/custom-elements": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/@webcomponents/custom-elements/-/custom-elements-1.6.0.tgz", + "integrity": "sha512-CqTpxOlUCPWRNUPZDxT5v2NnHXA4oox612iUGnmTUGQFhZ1Gkj8kirtl/2wcF6MqX7+PqqicZzOCBKKfIn0dww==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/acorn": { + "version": "8.16.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz", + "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==", + "dev": true, + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-walk": { + "version": "8.3.5", + "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.5.tgz", + "integrity": "sha512-HEHNfbars9v4pgpW6SO1KSPkfoS0xVOM/9UzkJltjlsHZmJasxg8aXkuZa7SMf8vKGIBhpUsPluQSqhJFCqebw==", + "dev": true, + "license": "MIT", + "dependencies": { + "acorn": "^8.11.0" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/boolbase": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz", + "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==", + "dev": true, + "license": "ISC" + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/convert-source-map": { + "version": "1.9.0", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-1.9.0.tgz", + "integrity": "sha512-ASFBup0Mz1uyiIjANan1jzLQami9z1PoYSZCiiYW2FczPbenXc45FZdBZLzOT+r6+iciuEModtmCti+hjaAk0A==", + "dev": true, + "license": "MIT" + }, + "node_modules/css-select": { + "version": "5.2.2", + "resolved": "https://registry.npmjs.org/css-select/-/css-select-5.2.2.tgz", + "integrity": "sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0", + "css-what": "^6.1.0", + "domhandler": "^5.0.2", + "domutils": "^3.0.1", + "nth-check": "^2.0.1" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/css-what": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.2.2.tgz", + "integrity": "sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">= 6" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/dom-serializer": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-2.0.0.tgz", + "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==", + "dev": true, + "license": "MIT", + "dependencies": { + "domelementtype": "^2.3.0", + "domhandler": "^5.0.2", + "entities": "^4.2.0" + }, + "funding": { + "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1" + } + }, + "node_modules/domelementtype": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz", + "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fb55" + } + ], + "license": "BSD-2-Clause" + }, + "node_modules/domhandler": { + "version": "5.0.3", + "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-5.0.3.tgz", + "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "domelementtype": "^2.3.0" + }, + "engines": { + "node": ">= 4" + }, + "funding": { + "url": "https://github.com/fb55/domhandler?sponsor=1" + } + }, + "node_modules/domutils": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz", + "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "dom-serializer": "^2.0.0", + "domelementtype": "^2.3.0", + "domhandler": "^5.0.3" + }, + "funding": { + "url": "https://github.com/fb55/domutils?sponsor=1" + } + }, + "node_modules/entities": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz", + "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/es-module-lexer": { + "version": "0.10.5", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-0.10.5.tgz", + "integrity": "sha512-+7IwY/kiGAacQfY+YBhKMvEmyAJnw5grTUgjG85Pe7vcUI/6b7pZjZG8nQ7+48YhzEAEqrEgD2dCz/JIK+AYvw==", + "dev": true, + "license": "MIT" + }, + "node_modules/esbuild": { + "version": "0.27.7", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.7.tgz", + "integrity": "sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.27.7", + "@esbuild/android-arm": "0.27.7", + "@esbuild/android-arm64": "0.27.7", + "@esbuild/android-x64": "0.27.7", + "@esbuild/darwin-arm64": "0.27.7", + "@esbuild/darwin-x64": "0.27.7", + "@esbuild/freebsd-arm64": "0.27.7", + "@esbuild/freebsd-x64": "0.27.7", + "@esbuild/linux-arm": "0.27.7", + "@esbuild/linux-arm64": "0.27.7", + "@esbuild/linux-ia32": "0.27.7", + "@esbuild/linux-loong64": "0.27.7", + "@esbuild/linux-mips64el": "0.27.7", + "@esbuild/linux-ppc64": "0.27.7", + "@esbuild/linux-riscv64": "0.27.7", + "@esbuild/linux-s390x": "0.27.7", + "@esbuild/linux-x64": "0.27.7", + "@esbuild/netbsd-arm64": "0.27.7", + "@esbuild/netbsd-x64": "0.27.7", + "@esbuild/openbsd-arm64": "0.27.7", + "@esbuild/openbsd-x64": "0.27.7", + "@esbuild/openharmony-arm64": "0.27.7", + "@esbuild/sunos-x64": "0.27.7", + "@esbuild/win32-arm64": "0.27.7", + "@esbuild/win32-ia32": "0.27.7", + "@esbuild/win32-x64": "0.27.7" + } + }, + "node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-glob": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", + "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.8" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fastq": { + "version": "1.20.1", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz", + "integrity": "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==", + "dev": true, + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/fs-extra": { + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz", + "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.0", + "jsonfile": "^6.0.1", + "universalify": "^2.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/he": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz", + "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==", + "dev": true, + "license": "MIT", + "bin": { + "he": "bin/he" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/jsesc": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz", + "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==", + "dev": true, + "license": "MIT", + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/jsonfile": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz", + "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "universalify": "^2.0.0" + }, + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.12", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.12.tgz", + "integrity": "sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/node-html-parser": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/node-html-parser/-/node-html-parser-7.1.0.tgz", + "integrity": "sha512-iJo8b2uYGT40Y8BTyy5ufL6IVbN8rbm/1QK2xffXU/1a/v3AAa0d1YAoqBNYqaS4R/HajkWIpIfdE6KcyFh1AQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "css-select": "^5.1.0", + "he": "1.2.0" + } + }, + "node_modules/nth-check": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz", + "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0" + }, + "funding": { + "url": "https://github.com/fb55/nth-check?sponsor=1" + } + }, + "node_modules/pathe": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz", + "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==", + "dev": true, + "license": "MIT" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/postcss": { + "version": "8.5.14", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.14.tgz", + "integrity": "sha512-SoSL4+OSEtR99LHFZQiJLkT59C5B1amGO1NzTwj7TT1qCUgUO6hxOvzkOYxD+vMrXBM3XJIKzokoERdqQq/Zmg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.11", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/react-refresh": { + "version": "0.13.0", + "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.13.0.tgz", + "integrity": "sha512-XP8A9BT0CpRBD+NYLLeIhld/RqG9+gktUjW1FkE+Vm7OCinbG1SshcK5tb9ls4kzvjZr9mOQc7HYgBngEyPAXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/rollup": { + "version": "2.79.2", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-2.79.2.tgz", + "integrity": "sha512-fS6iqSPZDs3dr/y7Od6y5nha8dW1YnbgtsyotCVvoFGKbERG++CVRFv1meyGDE1SNItQA8BrnCw7ScdAhRJ3XQ==", + "dev": true, + "license": "MIT", + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=10.0.0" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + } + }, + "node_modules/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, + "node_modules/rxjs": { + "version": "7.5.7", + "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.5.7.tgz", + "integrity": "sha512-z9MzKh/UcOqB3i20H6rtrlaE/CgjLOvheWK/9ILrbhROGTweAi1BaFsTT9FbwZi5Trr1qNRs+MXkhmR06awzQA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.1.0" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.16", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.16.tgz", + "integrity": "sha512-pn99VhoACYR8nFHhxqix+uvsbXineAasWm5ojXoN8xEwK5Kd3/TrhNn1wByuD52UxWRLy8pu+kRMniEi6Eq9Zg==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tinyglobby/node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/tinyglobby/node_modules/picomatch": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz", + "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "dev": true, + "license": "0BSD" + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/universalify": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", + "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 10.0.0" + } + }, + "node_modules/vite": { + "version": "7.3.3", + "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.3.tgz", + "integrity": "sha512-/4XH147Ui7OGTjg3HbdWe5arnZQSbfuRzdr9Ec7TQi5I7R+ir0Rlc9GIvD4v0XZurELqA035KVXJXpR61xhiTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.27.0", + "fdir": "^6.5.0", + "picomatch": "^4.0.3", + "postcss": "^8.5.6", + "rollup": "^4.43.0", + "tinyglobby": "^0.2.15" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "lightningcss": "^1.21.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vite/node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/vite/node_modules/picomatch": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz", + "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/vite/node_modules/rollup": { + "version": "4.60.4", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.4.tgz", + "integrity": "sha512-WHeFSbZYsPu3+bLoNRUuAO+wavNlocOPf3wSHTP7hcFKVnJeWsYlCDbr3mTS14FCizf9ccIxXA8sGL8zKeQN3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.8" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.60.4", + "@rollup/rollup-android-arm64": "4.60.4", + "@rollup/rollup-darwin-arm64": "4.60.4", + "@rollup/rollup-darwin-x64": "4.60.4", + "@rollup/rollup-freebsd-arm64": "4.60.4", + "@rollup/rollup-freebsd-x64": "4.60.4", + "@rollup/rollup-linux-arm-gnueabihf": "4.60.4", + "@rollup/rollup-linux-arm-musleabihf": "4.60.4", + "@rollup/rollup-linux-arm64-gnu": "4.60.4", + "@rollup/rollup-linux-arm64-musl": "4.60.4", + "@rollup/rollup-linux-loong64-gnu": "4.60.4", + "@rollup/rollup-linux-loong64-musl": "4.60.4", + "@rollup/rollup-linux-ppc64-gnu": "4.60.4", + "@rollup/rollup-linux-ppc64-musl": "4.60.4", + "@rollup/rollup-linux-riscv64-gnu": "4.60.4", + "@rollup/rollup-linux-riscv64-musl": "4.60.4", + "@rollup/rollup-linux-s390x-gnu": "4.60.4", + "@rollup/rollup-linux-x64-gnu": "4.60.4", + "@rollup/rollup-linux-x64-musl": "4.60.4", + "@rollup/rollup-openbsd-x64": "4.60.4", + "@rollup/rollup-openharmony-arm64": "4.60.4", + "@rollup/rollup-win32-arm64-msvc": "4.60.4", + "@rollup/rollup-win32-ia32-msvc": "4.60.4", + "@rollup/rollup-win32-x64-gnu": "4.60.4", + "@rollup/rollup-win32-x64-msvc": "4.60.4", + "fsevents": "~2.3.2" + } + } + } +} diff --git a/extension/package.json b/extension/package.json new file mode 100644 index 0000000..4d2ecfc --- /dev/null +++ b/extension/package.json @@ -0,0 +1,18 @@ +{ + "name": "worktrace-extension", + "version": "0.1.0", + "private": true, + "type": "module", + "description": "WorkTrace Chrome extension — captures dev session context.", + "scripts": { + "dev": "vite", + "build": "vite build", + "typecheck": "tsc --noEmit" + }, + "devDependencies": { + "@crxjs/vite-plugin": "^2.0.0-beta.36", + "@types/chrome": "^0.0.290", + "typescript": "^5.6.0", + "vite": "^7.0.0" + } +} diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts new file mode 100644 index 0000000..3c1839f --- /dev/null +++ b/extension/src/background/index.ts @@ -0,0 +1,5 @@ +console.log("[worktrace] service worker booted"); + +chrome.runtime.onInstalled.addListener((details) => { + console.log("[worktrace] installed", details.reason); +}); diff --git a/extension/src/content/index.ts b/extension/src/content/index.ts new file mode 100644 index 0000000..208a5dd --- /dev/null +++ b/extension/src/content/index.ts @@ -0,0 +1 @@ +console.log("[worktrace] content script loaded", location.href); diff --git a/extension/src/icons/icon-128.png b/extension/src/icons/icon-128.png new file mode 100644 index 0000000000000000000000000000000000000000..06012ed545b51b58f6d789b315ffd08803a56029 GIT binary patch literal 936 zcmeAS@N?(olHy`uVBq!ia0vp^4Is?H1|$#LC7uRSjKx9jP7LeL$-D$|SkfJR9T^xl z_H+M9WCij$3p^r=85sBugD~Uq{1qt-49vEkE{-7;ac?gv`nfWSFb96~I&>(|;~$sZ zwxmhR6kiH&e{`bn)$!-oU)z?yWjIbdWLwwpe*XRXh07NCHqGiX!lvI6;>1s;*b3=DjSL74G){)!Z!prfaYV@QPi+jELS3<4q!j^(D0A51#IxlczU zjVJN2wtnuZ)FY>X>i)4`xi;PJzaEeY1P%Wgw=**^RPaa`GG6?;WSRY?8~Gq{Pgg&e IbxsLQ0B4jjX8-^I literal 0 HcmV?d00001 diff --git a/extension/src/icons/icon-48.png b/extension/src/icons/icon-48.png new file mode 100644 index 0000000000000000000000000000000000000000..38e678de4398d94616ed1e5a2f965dd95d555b2d GIT binary patch literal 232 zcmeAS@N?(olHy`uVBq!ia0vp^1|ZDA1|-9oezpTC#^NA%Cx&(BWL^R}Ea{HEjtmSN z`?>!lvI6;>1s;*b3=DjSL74G){)!Z!V6CT%V@QVc+w+Qi4Gs*"], + js: ["src/content/index.ts"], + run_at: "document_idle", + }, + ], + permissions: ["storage", "activeTab", "tabs"], + host_permissions: [ + "http://localhost:3000/*", + "https://worktrace-ecru.vercel.app/*", + ], +}); diff --git a/extension/src/popup/index.html b/extension/src/popup/index.html new file mode 100644 index 0000000..caaa154 --- /dev/null +++ b/extension/src/popup/index.html @@ -0,0 +1,16 @@ + + + + + + WorkTrace + + + +
+

WorkTrace

+

Coming soon.

+
+ + + diff --git a/extension/src/popup/popup.css b/extension/src/popup/popup.css new file mode 100644 index 0000000..cc10e08 --- /dev/null +++ b/extension/src/popup/popup.css @@ -0,0 +1,39 @@ +:root { + color-scheme: light dark; + font-family: + system-ui, + -apple-system, + "Segoe UI", + Roboto, + sans-serif; +} + +html, +body { + margin: 0; + padding: 0; +} + +body { + width: 320px; + min-height: 200px; + background: #0f172a; + color: #e2e8f0; +} + +main { + padding: 20px 24px; +} + +h1 { + margin: 0 0 8px; + font-size: 18px; + font-weight: 600; + letter-spacing: -0.01em; +} + +p { + margin: 0; + font-size: 13px; + color: #94a3b8; +} diff --git a/extension/src/popup/popup.ts b/extension/src/popup/popup.ts new file mode 100644 index 0000000..701c59c --- /dev/null +++ b/extension/src/popup/popup.ts @@ -0,0 +1 @@ +console.log("[worktrace] popup loaded"); diff --git a/extension/tsconfig.json b/extension/tsconfig.json new file mode 100644 index 0000000..2cb6cdc --- /dev/null +++ b/extension/tsconfig.json @@ -0,0 +1,20 @@ +{ + "compilerOptions": { + "target": "ES2022", + "module": "ESNext", + "moduleResolution": "bundler", + "lib": ["ES2022", "DOM", "DOM.Iterable"], + "types": ["chrome", "vite/client"], + "strict": true, + "noUncheckedIndexedAccess": true, + "noUnusedLocals": true, + "noUnusedParameters": true, + "isolatedModules": true, + "esModuleInterop": true, + "skipLibCheck": true, + "noEmit": true, + "resolveJsonModule": true, + "allowImportingTsExtensions": true + }, + "include": ["src/**/*", "vite.config.ts"] +} diff --git a/extension/vite.config.ts b/extension/vite.config.ts new file mode 100644 index 0000000..7ca1bee --- /dev/null +++ b/extension/vite.config.ts @@ -0,0 +1,11 @@ +import { defineConfig } from "vite"; +import { crx } from "@crxjs/vite-plugin"; +import manifest from "./src/manifest"; + +export default defineConfig({ + plugins: [crx({ manifest })], + build: { + target: "es2022", + sourcemap: true, + }, +}); diff --git a/plans/AC4-extension-init.md b/plans/AC4-extension-init.md new file mode 100644 index 0000000..b81c57c --- /dev/null +++ b/plans/AC4-extension-init.md @@ -0,0 +1,272 @@ +# Plan: AC 4 — Chrome Extension initialization + +**Branch:** `feature/extension-init` +**Closes:** Week 1 AC 4 ([docs/Task.md L58](../docs/Task.md#L58)) +**Status:** plan, awaiting approval + +## Scope + +Bootstrap an empty-but-loadable Chrome Extension at `extension/` with: + +- Manifest V3 +- Background service worker (TypeScript, empty handler with a `console.log` heartbeat) +- Content script (TypeScript, empty stub injected on ``) +- Empty popup (HTML + CSS + minimal TS) +- Vite + `@crxjs/vite-plugin` build pipeline producing a `dist/` that loads via `chrome://extensions` → Load unpacked without errors + +Per AC 4 in TZ: +> Створено Chrome Extension з Manifest V3. Є фоновий service worker, базовий content script та порожній HTML popup. Розширення завантажується у Chrome без помилок. + +Out of scope (later ACs of Week 2): +- Auth flow / Google OAuth (AC 1) +- Real content parsing logic (AC 2) +- Session manager / timer (AC 3) +- Popup UI (AC 4 of Week 2) +- Batch sync to `/api/v1/events` (AC 5) + +## Files + +| Path | Action | Notes | +|---|---|---| +| `extension/package.json` | new | name `worktrace-extension`, scripts `dev` / `build` / `typecheck` | +| `extension/tsconfig.json` | new | strict mode, `target: ES2022`, types `chrome` + `vite/client` | +| `extension/vite.config.ts` | new | imports `@crxjs/vite-plugin` with `manifest` from `./src/manifest.ts` | +| `extension/src/manifest.ts` | new | typed `defineManifest({...})` — MV3, permissions, content scripts, action | +| `extension/src/background/index.ts` | new | service worker — `chrome.runtime.onInstalled` log | +| `extension/src/content/index.ts` | new | content script stub — `console.debug("[worktrace] content loaded", location.href)` | +| `extension/src/popup/index.html` | new | empty popup shell, references `popup.ts` and `popup.css` | +| `extension/src/popup/popup.ts` | new | empty TS module (just a `console.debug`) | +| `extension/src/popup/popup.css` | new | minimal layout (320×200, padding) | +| `extension/src/icons/icon-16.png` | new | placeholder icon (16/32/48/128) | +| `extension/src/icons/icon-32.png` | new | | +| `extension/src/icons/icon-48.png` | new | | +| `extension/src/icons/icon-128.png` | new | | +| `extension/.env.example` | new | `VITE_API_BASE_URL=http://localhost:3000` | +| `extension/.env` | new (gitignored) | local override; same default for now | +| `extension/.gitignore` | new | `node_modules`, `dist`, `.env` | +| `extension/README.md` | new | dev/build instructions, "Load unpacked → select `extension/dist`" | +| `dashboard/package.json` | modify | `build` script: `"prisma generate && next build"` — Vercel build needs Prisma client generated (see "Build script piggyback" below) | +| `plans/AC4-extension-init.md` | add (this file) | | + +Root `README.md` (the one closing AC 5 next sprint) is **not** touched here — that's AC 5's scope. + +## Design decisions + +### 1. Bundler: Vite + `@crxjs/vite-plugin` + +Considered: + +- **Plain `tsc` + manual copy** of `manifest.json` / HTML / icons to `dist/`. Smallest dep tree but no HMR, asset pipeline by hand, manifest is plain JSON (no type safety). +- **`tsup` (esbuild wrapper).** Fast, simple, but same asset-copy problem; popup HTML still hand-managed. +- **webpack + `webpack-extension-reloader`.** Mature but heavy config; the project already standardizes on Vite-style tooling via Next.js, so adding webpack is gratuitous. +- **Vite + `@crxjs/vite-plugin`.** Industry default for MV3 + TS in 2025/26. Manifest authored as a typed TS module (`defineManifest({...})`), HMR for popup, automatic rebuild + copy of content/background scripts and icons, source-map support. + +**Decision:** Vite + `@crxjs/vite-plugin`. The asset pipeline alone (HTML, icons, manifest) saves enough boilerplate to justify the dep, and HMR will pay for itself starting Week 2 popup work. + +Versions to pin (latest stable as of 2026-05): `vite@^7`, `@crxjs/vite-plugin@^2`, `@types/chrome@latest`, `typescript@^5`. + +### 2. Directory layout: `src/` + `dist/` + +``` +extension/ +├─ src/ +│ ├─ manifest.ts ← defineManifest(...) +│ ├─ background/index.ts +│ ├─ content/index.ts +│ ├─ popup/ +│ │ ├─ index.html +│ │ ├─ popup.ts +│ │ └─ popup.css +│ └─ icons/icon-{16,32,48,128}.png +├─ dist/ ← gitignored, output of `npm run build` +├─ .env.example +├─ package.json +├─ tsconfig.json +└─ vite.config.ts +``` + +`@crxjs/vite-plugin` reads `manifest.ts`, treats every script/HTML it references as a Vite entry point, and writes the final `manifest.json` into `dist/`. No copy step. + +### 3. Permissions — declared upfront for the whole project + +Per the question we resolved: declare everything the future ACs will need now, so we don't have to re-prompt the user to reload the extension on each AC. + +```ts +permissions: ["storage", "activeTab", "tabs"], +host_permissions: [ + "http://localhost:3000/*", + "https://worktrace-ecru.vercel.app/*", +], +``` + +Rationale per permission: + +- **`storage`** — `chrome.storage.local` for JWT (Week 2 AC 1) and session state (Week 2 AC 3). +- **`activeTab`** — gives the extension temporary access to the currently focused tab when the user clicks the action icon, without the broad `` host grant. Used by the popup to read tab info on demand. +- **`tabs`** — needed to read `tab.url` / `tab.title` from the background worker for events that fire outside a user click (e.g. tab change while a session is active). `activeTab` alone won't suffice because it's gated on user gesture. +- **`host_permissions`** for the API: required for `fetch()` from the background worker to the dashboard. `localhost:3000` for dev; `worktrace-ecru.vercel.app` is the production domain assigned by Vercel (the `-ecru` suffix because `worktrace.vercel.app` was taken). Preview deploys (`worktrace-git-*.vercel.app`, `worktrace--*.vercel.app`) are intentionally **not** included — extension talks only to production. If we ever need to point the local extension at a preview, override `VITE_API_BASE_URL` in `.env` for that build. + +**Not added** (would expand the warning shown at install time): + +- `""` as a host permission — content scripts are declared with `matches: [""]` in the `content_scripts` block, which is a separate grant from `host_permissions`. We don't need full host access for `fetch` from anywhere. +- `"scripting"` — only needed if we inject scripts dynamically via `chrome.scripting.executeScript`. We use static `content_scripts` registration. Add later only if dynamic injection becomes necessary. +- `"alarms"` — for Week 2 batched sync if we choose `chrome.alarms` over `setTimeout`. Decide then. + +### 4. API base URL via Vite env + +Per the question we resolved: `VITE_API_BASE_URL` from `.env` is inlined at build time. + +- `extension/.env.example` documents the var. +- `extension/.env` (gitignored) holds the local value (`http://localhost:3000`). +- Production build will set the var via shell or `.env.production` later (Week 4). +- Access in TS: `import.meta.env.VITE_API_BASE_URL` (typed via `vite/client` reference in `tsconfig.json`). + +Not used in AC 4 itself (no fetch yet) but the wiring lets Week 2 AC 1 reach for it without scaffolding. + +### 5. Manifest — single source of truth as TS + +```ts +// extension/src/manifest.ts +import { defineManifest } from "@crxjs/vite-plugin"; +import pkg from "../package.json" with { type: "json" }; + +export default defineManifest({ + manifest_version: 3, + name: "WorkTrace", + version: pkg.version, + description: "Capture dev session context for AI-generated reports.", + icons: { + "16": "src/icons/icon-16.png", + "32": "src/icons/icon-32.png", + "48": "src/icons/icon-48.png", + "128": "src/icons/icon-128.png", + }, + action: { + default_popup: "src/popup/index.html", + default_title: "WorkTrace", + }, + background: { + service_worker: "src/background/index.ts", + type: "module", + }, + content_scripts: [ + { + matches: [""], + js: ["src/content/index.ts"], + run_at: "document_idle", + }, + ], + permissions: ["storage", "activeTab", "tabs"], + host_permissions: [ + "http://localhost:3000/*", + "https://worktrace-ecru.vercel.app/*", + ], +}); +``` + +`type: "module"` on background is what unlocks ES module imports inside the service worker (MV3 requirement when bundling with Vite). + +### 6. Empty stubs — what counts as "porozhniy" + +The TZ asks for an empty popup and basic content script. To keep "loads without errors" honest, each stub will: + +- **background:** register `chrome.runtime.onInstalled` with a `console.log("[worktrace] installed")`. Nothing else. +- **content:** one `console.debug("[worktrace] content script loaded", location.href)`. No DOM access, no message listeners. +- **popup:** an `

WorkTrace

` and a paragraph "Coming soon." Loads `popup.css` and `popup.ts`. `popup.ts` does nothing but log. + +This is enough to verify each entry point bundles and is wired in the manifest, without preempting Week 2 logic. + +### 7. Icons + +Placeholder PNGs at the four required sizes. I'll generate a single solid-colour square (project accent) at each size — manifest validation requires the files to exist at the declared paths or Chrome refuses to load. Real icon design is out of scope here. + +### 8. Build script piggyback (`dashboard/package.json`) + +While setting up the Vercel project for the production domain, the first deploy revealed that `dashboard/package.json` build script was just `next build`, but the codebase imports from `@/generated/prisma/client` and `@/generated/zod/...` — both gitignored per CLAUDE.md. Vercel had no generated client → `Module not found` at build time. + +**Fix:** `"build": "prisma generate && next build"`. Currently overridden in Vercel UI (Build Command override toggle); committing the package.json change here makes the Vercel override redundant (can be turned off after merge, but no harm in leaving it). + +Why bundle this here instead of a separate fix PR: the override was needed precisely because we wanted the production URL for `host_permissions` in this AC. The two changes are coupled in motivation. + +Alternative considered: `"postinstall": "prisma generate"`. Rejected because it runs on every `npm install` (including tooling installs that don't need a client) and is less explicit about when generation happens. + +### 9. Isolation rule from CLAUDE.md + +`extension/` does not import from `dashboard/` and vice versa. Verified by: +- Separate `package.json`, `tsconfig.json`, `node_modules` per app. +- No path aliases reaching across. + +The two stay communicable only via HTTP (the events API). + +## `package.json` shape + +```json +{ + "name": "worktrace-extension", + "version": "0.1.0", + "private": true, + "type": "module", + "scripts": { + "dev": "vite", + "build": "vite build", + "typecheck": "tsc --noEmit" + }, + "devDependencies": { + "@crxjs/vite-plugin": "^2.0.0", + "@types/chrome": "^0.0.270", + "typescript": "^5.6.0", + "vite": "^7.0.0" + } +} +``` + +Versions will be re-checked at `npm install` time and pinned to whatever resolves; the caret ranges above are the floor. + +## `tsconfig.json` shape + +```json +{ + "compilerOptions": { + "target": "ES2022", + "module": "ESNext", + "moduleResolution": "bundler", + "lib": ["ES2022", "DOM", "DOM.Iterable"], + "types": ["chrome", "vite/client"], + "strict": true, + "noUncheckedIndexedAccess": true, + "noUnusedLocals": true, + "noUnusedParameters": true, + "isolatedModules": true, + "esModuleInterop": true, + "skipLibCheck": true, + "noEmit": true, + "resolveJsonModule": true + }, + "include": ["src/**/*", "vite.config.ts"] +} +``` + +`any` is forbidden per CLAUDE.md — strict mode + `noUncheckedIndexedAccess` enforce it at compile time. + +## Verification + +- [ ] `cd extension && npm install` — clean install +- [ ] `npm run typecheck` — zero errors +- [ ] `npm run build` — produces `extension/dist/manifest.json`, `dist/src/background/index.js`, `dist/src/content/index.js`, `dist/src/popup/index.html`, all four icons +- [ ] Chrome `chrome://extensions` → Developer mode → Load unpacked → select `extension/dist` → loads with no errors / warnings in the extension card +- [ ] Click extension icon → popup opens, shows "WorkTrace / Coming soon." +- [ ] Open any HTTPS page → DevTools console shows `[worktrace] content script loaded ...` +- [ ] `chrome://extensions` → service worker "Inspect" → console shows `[worktrace] installed` after first load +- [ ] `npm run dev` — Vite dev server runs, HMR-rebuilds the popup on edit (sanity-check the toolchain) + +## Out of scope + +- **Real icon art** — placeholder solid-colour PNGs. +- **Custom production domain** — if a non-`vercel.app` domain is added later (e.g. `worktrace.app`), update `host_permissions` then. +- **Linting** — the project hasn't standardized an extension-side ESLint config; can be added when the dashboard's flat config is generalized. +- **CI** — extension build will be added to GitHub Actions in Week 4 AC 1. +- **Packaging `.zip`** — Week 4 AC 2. + +## Lesson for the skill + +After implementation, update `.claude/skills/extension-message.md` to reference the actual `src/background/index.ts` / `src/content/index.ts` paths and the typed `import.meta.env.VITE_API_BASE_URL` access pattern. From d01cf27a2b33bb74219cd259ef0056a0ad0f19d3 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Fri, 15 May 2026 21:14:18 +0300 Subject: [PATCH 06/24] chore(repo): finalize week 1 - readme, governance, ci, lint, husky (AC 5) (#6) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(readme): add full root readme (AC 5) * chore(repo): add license, contributing guide, and PR template * ci: add lint and typecheck workflow GitHub Actions workflow that runs on every pull request and push to development/main. Two jobs: - dashboard: prisma generate (required before tsc — generated client is gitignored), npm run lint, tsc --noEmit - extension: tsc --noEmit * chore(lint): tighten typescript rules Stricter eslint rules in dashboard to enforce CLAUDE.md type-safety guarantees at PR time: - @typescript-eslint/no-explicit-any: error - @typescript-eslint/ban-ts-comment: error - @typescript-eslint/consistent-type-assertions: forbid object-literal casts ({ foo } as T) - no-restricted-syntax: forbid casting to unknown (incl. as unknown as T) Also ignore generated/** (output of prisma generate — autogenerated) and remove the now-redundant eslint-disable-next-line in server/db.ts. * chore(tooling): add husky pre-commit, gitattributes, nvmrc Pre-commit hook runs eslint --fix on staged dashboard files via lint-staged. Catches issues locally before CI; typecheck stays in CI because it needs the whole project and is too slow per-commit. - husky + lint-staged installed in a new root package.json (the repo is a monorepo without a workspace tool) - lint-staged.config.mjs uses npm --prefix dashboard to run eslint from the dashboard cwd so the flat config resolves naturally - .gitattributes normalizes line endings to LF — stops the "LF will be replaced by CRLF" warnings on every commit - .nvmrc pins Node 20 for nvm use / IDE auto-switch * fix(ci): provide dummy DATABASE_URL for prisma generate prisma.config.ts uses prisma/config's strict env() helper, which throws PrismaConfigEnvError if DATABASE_URL is missing at load time. The CI runner has no .env file (gitignored), so prisma generate failed before reading the schema. prisma generate does not connect to the database — it only reads the schema and writes the generated client + zod schemas. A dummy URL satisfies the config loader without touching any real database. Set DATABASE_URL only on the prisma generate step, not on the whole job, so an accidental query elsewhere still fails loudly. --- .gitattributes | 14 + .github/PULL_REQUEST_TEMPLATE.md | 44 ++ .github/workflows/ci.yml | 46 ++ .husky/pre-commit | 1 + .nvmrc | 1 + CONTRIBUTING.md | 94 +++ LICENSE | 21 + README.md | 116 +++- dashboard/eslint.config.mjs | 24 + dashboard/server/db.ts | 1 - lint-staged.config.mjs | 14 + package-lock.json | 786 ++++++++++++++++++++++ package.json | 13 + plans/{ => week1}/AC3-cors.md | 2 +- plans/{ => week1}/AC4-extension-init.md | 2 +- plans/week1/AC5-root-readme.md | 167 +++++ plans/{ => week1}/AC7-events-api-route.md | 2 +- plans/week1/repo-governance-and-ci.md | 235 +++++++ plans/week1/repo-hygiene-husky.md | 154 +++++ 19 files changed, 1730 insertions(+), 7 deletions(-) create mode 100644 .gitattributes create mode 100644 .github/PULL_REQUEST_TEMPLATE.md create mode 100644 .github/workflows/ci.yml create mode 100644 .husky/pre-commit create mode 100644 .nvmrc create mode 100644 CONTRIBUTING.md create mode 100644 LICENSE create mode 100644 lint-staged.config.mjs create mode 100644 package-lock.json create mode 100644 package.json rename plans/{ => week1}/AC3-cors.md (99%) rename plans/{ => week1}/AC4-extension-init.md (99%) create mode 100644 plans/week1/AC5-root-readme.md rename plans/{ => week1}/AC7-events-api-route.md (99%) create mode 100644 plans/week1/repo-governance-and-ci.md create mode 100644 plans/week1/repo-hygiene-husky.md diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..e8f7a24 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,14 @@ +# Normalize line endings — LF in repo, LF in working tree on all platforms. +* text=auto eol=lf + +# Binary file types — never touch line endings. +*.png binary +*.jpg binary +*.jpeg binary +*.gif binary +*.ico binary +*.webp binary +*.zip binary +*.pdf binary +*.woff binary +*.woff2 binary diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..05368cf --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,44 @@ +## What + + + +## Changes + +### Code + + +- + +### Tooling / config + + +- + +### Docs / plan + + +- `plans/weekN/.md` — design rationale +- + +## Design decisions + + +- + +## Verification + + +- [ ] `npx tsc --noEmit` (dashboard) — clean +- [ ] `npm run lint` (dashboard) — clean +- [ ] `npm run typecheck` (extension) — clean +- [ ] Manual test: + +## Out of scope (future PRs) + + +- + +## Closes + + +- diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..351dfb9 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,46 @@ +name: CI + +on: + pull_request: + branches: [development, main] + push: + branches: [development, main] + +jobs: + dashboard: + runs-on: ubuntu-latest + defaults: + run: + working-directory: dashboard + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: '20' + cache: 'npm' + cache-dependency-path: dashboard/package-lock.json + - run: npm ci + - run: npx prisma generate + env: + # prisma.config.ts uses prisma/config's strict env() helper, which + # throws if DATABASE_URL is unset. `prisma generate` does not connect + # to the database — it only reads the schema and writes the client — + # so a dummy URL satisfies the config loader. + DATABASE_URL: "postgresql://prisma:prisma@localhost:5432/prisma" + - run: npm run lint + - run: npx tsc --noEmit + + extension: + runs-on: ubuntu-latest + defaults: + run: + working-directory: extension + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: '20' + cache: 'npm' + cache-dependency-path: extension/package-lock.json + - run: npm ci + - run: npm run typecheck diff --git a/.husky/pre-commit b/.husky/pre-commit new file mode 100644 index 0000000..2312dc5 --- /dev/null +++ b/.husky/pre-commit @@ -0,0 +1 @@ +npx lint-staged diff --git a/.nvmrc b/.nvmrc new file mode 100644 index 0000000..209e3ef --- /dev/null +++ b/.nvmrc @@ -0,0 +1 @@ +20 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..7fd89bd --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,94 @@ +# Contributing + +Short reference for working in this repo. Full context, weekly roadmap, and acceptance criteria live in [docs/Task.md](docs/Task.md). + +## Workflow: Plan → Review → Implement + +Never start a non-trivial change by writing code. The loop is: + +1. **Plan** — write a markdown file at `plans/weekN/.md` describing scope, files touched, design decisions, and a verification checklist. The plan goes on the feature branch as its first commit (or alongside the implementation commit when small). +2. **Review** — the user reads the plan and approves (or asks for adjustments) before any code is written. +3. **Implement** — only after approval. The implementation should follow the plan; if reality diverges, update the plan in the same PR. + +See [docs/Task.md § "Головне правило воркфлоу"](docs/Task.md#L180) for the rationale. + +## Branches + +Two protected branches: + +- `main` — production. Direct pushes blocked. Only merges from `development` after final review. +- `development` — integration branch. Direct pushes blocked. All feature work merges here via PR. + +Each task gets its own branch off `development`: + +``` +feature/ new functionality +fix/ bug fix +chore/ deps, config, repo meta — no logic changes +refactor/ behavior-preserving refactor +docs/ docs-only changes +``` + +PR → `development`. When a week (or milestone) is done: `development` → PR → `main`. + +See [docs/Task.md § "Git воркфлоу"](docs/Task.md#L104) for full naming conventions and examples. + +## Commit messages + +[Conventional Commits](https://www.conventionalcommits.org/). Format: + +``` +(): +``` + +Types: `feat`, `fix`, `chore`, `refactor`, `style`, `test`, `docs`. + +- Description in English, lowercase, no trailing period. +- First line ≤ 72 characters. +- Body (after a blank line) only if extra context is needed. + +Examples: + +``` +feat(extension): add content script for page metadata parsing +fix(popup): reset timer on service worker restart +docs(readme): add full root readme (AC 5) +chore(deps): update prisma to 7.9 +``` + +Full guidance: [docs/Task.md § "Commit messages"](docs/Task.md#L144). + +## Branch protection (one-time GitHub UI setup — repo owner) + +Settings → Branches → add rule for each of `main` and `development`: + +- [x] Require a pull request before merging +- [x] Require status checks to pass before merging + - Required checks (once CI lands): `CI / dashboard`, `CI / extension` +- [x] Do not allow bypassing the above settings + +This step is GitHub UI only — it isn't expressible in a commit. Enable after the CI workflow has run at least once on `development` so the status check names become selectable. + +## Where things live + +Architectural invariants enforced in [CLAUDE.md](CLAUDE.md). Quick map: + +| Concern | Location | +|---|---| +| Business logic (dashboard) | `dashboard/server/` — never inside React components or Route Handlers | +| Route Handlers | `dashboard/app/api/**/route.ts` — thin: parse → validate (Zod) → call `server/` → respond | +| Auth (Google token, JWT) | `dashboard/app/api/auth/**/route.ts` + `dashboard/middleware.ts` — nowhere else | +| Zod schemas for API input | `dashboard/server/schemas/.ts` — derived from `@/generated/zod/...`, never hand-written from scratch | +| Prisma schema + migrations | `dashboard/prisma/` | +| Extension service worker | `extension/src/background/` — only place that talks to the API or `chrome.storage.local` | +| Extension content/popup | `extension/src/content/`, `extension/src/popup/` — message the background, never `fetch` directly | +| Task recipes (for the AI) | `.claude/skills/` | +| Plans (per-AC) | `plans/weekN/` | + +## Type safety + +TypeScript strict. `any` is forbidden — use `unknown` + type guards, or define proper types. Enforced by `tsc --noEmit` in CI. + +## `extension/` ↔ `dashboard/` isolation + +Never import from `dashboard/` inside `extension/` or vice versa. They communicate only via HTTP (the API routes). Separate `package.json`, `tsconfig.json`, and `node_modules` per app. diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..ebfcc52 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 BODMAT + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md index 6fea290..e0bd5ec 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,116 @@ # WorkTrace -Browser extension + web dashboard that captures developer -session context and generates AI-powered reports. +Browser extension + web dashboard that captures developer session context and generates AI-powered session reports. -See [docs/Task.md](docs/Task.md) for full scope and acceptance criteria. +## What it is + +A Chrome extension (Manifest V3) silently records the pages a developer opens during a coding session — URLs, titles, page metadata, tags, optionally the music they listen to — and ships them to a Next.js dashboard. The dashboard renders a per-session timeline and asks an LLM to summarize each session into a structured Markdown report. + +See [docs/Task.md](docs/Task.md) for the full specification, acceptance criteria, and four-week roadmap. + +## Repo layout + +``` +worktrace/ +├─ dashboard/ Next.js 16 web app (App Router) + API routes + Prisma +├─ extension/ Chrome Manifest V3 extension (Vite + @crxjs/vite-plugin) +├─ docs/ Project specification (Task.md) +├─ plans/ Per-AC implementation plans (Plan → Review → Implement) +├─ .claude/skills/ Task recipes for the AI assistant +├─ CLAUDE.md AI agent rules (architecture invariants) +└─ docker-compose.yml Local PostgreSQL for development +``` + +The two apps are isolated — `extension/` never imports from `dashboard/` and vice versa. They communicate over HTTP only. + +## Tech stack + +- **Dashboard** — Next.js 16 (App Router, Server Components), React 19, Tailwind CSS v4, TanStack Query v5, Framer Motion, D3.js +- **Backend** — Next.js Route Handlers, Prisma 7 (with `@prisma/adapter-pg`), Zod, `google-auth-library`, `jsonwebtoken` +- **Extension** — Manifest V3, Vite 7 + `@crxjs/vite-plugin`, TypeScript (strict) +- **Database** — PostgreSQL 16 (Docker for local, Neon for production) +- **AI** — LLM provider TBD (Week 3): OpenAI / Groq / Gemini / OpenRouter +- **Deploy** — Vercel (dashboard), `.zip` for local extension install + +Versions in `dashboard/package.json` and `extension/package.json` are authoritative. + +## Prerequisites + +- **Node.js** 20 or newer +- **Docker Desktop** (or Docker Engine + Compose plugin) +- **Chrome** 120+ (for loading the unpacked extension) + +## Setup + +### 1. Clone and configure env + +```bash +git clone https://github.com/BODMAT/worktrace.git +cd worktrace +cp dashboard/.env.example dashboard/.env +cp extension/.env.example extension/.env +``` + +The dashboard `.env` contains `DATABASE_URL` (already pointing at the docker-compose Postgres) plus `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `JWT_SECRET`. The Google/JWT values are **not required for Week 1** — leave them blank until the auth flow lands in Week 2. + +### 2. Start PostgreSQL + +```bash +docker-compose up -d +``` + +This boots a `worktrace-postgres` container on host port **5433** (mapped to container 5432, so it won't collide with a local Postgres on 5432). The `DATABASE_URL` in `dashboard/.env.example` already uses this port. + +### 3. Run the dashboard + +```bash +cd dashboard +npm install +npx prisma migrate dev +npm run dev +``` + +The dashboard is now at `http://localhost:3000`. The `npm run dev` step also implicitly runs `prisma generate` on first build, materializing the Prisma client and Zod schemas into `dashboard/generated/` (both gitignored). + +### 4. Build and load the extension + +```bash +cd extension +npm install +npm run build +``` + +Then in Chrome: + +1. Open `chrome://extensions` +2. Toggle **Developer mode** (top right) +3. Click **Load unpacked** +4. Select `extension/dist/` + +The extension card should appear with no errors. For HMR-rebuild during active development use `npm run dev` instead of `npm run build`. + +## Verifying it works + +1. **Dashboard** — `http://localhost:3000` loads (Next.js placeholder page is fine for Week 1). +2. **Extension** — the card on `chrome://extensions` shows no errors; clicking the toolbar icon opens an empty popup; the service worker logs `[worktrace] installed` (visible via the extension's **Inspect** link). +3. **API** — a POST to the events endpoint round-trips through Postgres: + + ```bash + curl -X POST http://localhost:3000/api/v1/events \ + -H "Content-Type: application/json" \ + -d '{"sessionId":"ctestsess0000000000000001","url":"https://example.com","title":"Hello","tags":["test"],"timestamp":"2026-05-15T12:00:00Z"}' + ``` + + A 201 response with the created event means the dashboard, Prisma, and Postgres are wired up correctly. (The `sessionId` must reference an existing `Session` row — create one via `npx prisma studio` or seed it manually.) + +## Project docs + +- [docs/Task.md](docs/Task.md) — full acceptance criteria, weekly roadmap, git workflow +- [CLAUDE.md](CLAUDE.md) — AI agent rules: architecture invariants, type-safety constraints, import boundaries +- [.claude/skills/](.claude/skills/) — task recipes (`api-route.md`, `prisma-model.md`, `extension-message.md`) +- [plans/](plans/) — per-AC implementation plans authored before each commit (the Plan → Review → Implement loop) + +## Deploy + +- **Dashboard** — Vercel with **Root Directory: `dashboard`**. The build command `prisma generate && next build` (declared in `dashboard/package.json`) regenerates the Prisma client at build time since `dashboard/generated/` is gitignored. Production database is Neon. +- **Extension** — distributed as a `.zip` of `extension/dist/` for local install. Chrome Web Store packaging is scheduled for Week 4 AC 2. diff --git a/dashboard/eslint.config.mjs b/dashboard/eslint.config.mjs index 05e726d..e355fe6 100644 --- a/dashboard/eslint.config.mjs +++ b/dashboard/eslint.config.mjs @@ -12,7 +12,31 @@ const eslintConfig = defineConfig([ "out/**", "build/**", "next-env.d.ts", + // Generated by `prisma generate` — both `prisma-client` and `prisma-zod-generator`. + "generated/**", ]), + { + rules: { + // CLAUDE.md: `any` is forbidden. Use `unknown` + type guards or a proper type. + "@typescript-eslint/no-explicit-any": "error", + // Block `@ts-ignore`, `@ts-nocheck`, `@ts-expect-error` (the latter without a description). + "@typescript-eslint/ban-ts-comment": "error", + // Forbid `{ foo: bar } as SomeType` — a common source of silent bugs. Allow `value as SomeType`. + "@typescript-eslint/consistent-type-assertions": [ + "error", + { assertionStyle: "as", objectLiteralTypeAssertions: "never" }, + ], + // Forbid casting to `unknown` (incl. the `as unknown as T` escape hatch). + "no-restricted-syntax": [ + "error", + { + selector: "TSAsExpression[typeAnnotation.type='TSUnknownKeyword']", + message: + "Casting to `unknown` (including `as unknown as T`) is forbidden. Use a proper type guard or define a real type.", + }, + ], + }, + }, ]); export default eslintConfig; diff --git a/dashboard/server/db.ts b/dashboard/server/db.ts index c8c4511..1144249 100644 --- a/dashboard/server/db.ts +++ b/dashboard/server/db.ts @@ -2,7 +2,6 @@ import { PrismaPg } from "@prisma/adapter-pg"; import { PrismaClient } from "@/generated/prisma/client"; declare global { - // eslint-disable-next-line no-var var prismaGlobal: PrismaClient | undefined; } diff --git a/lint-staged.config.mjs b/lint-staged.config.mjs new file mode 100644 index 0000000..184ead9 --- /dev/null +++ b/lint-staged.config.mjs @@ -0,0 +1,14 @@ +import path from "node:path"; + +const dashboardLint = (files) => { + const dashboardDir = path.resolve("dashboard"); + const relative = files + .map((f) => path.relative(dashboardDir, f).replace(/\\/g, "/")) + .map((f) => `"${f}"`) + .join(" "); + return `npm --prefix dashboard run lint -- --fix ${relative}`; +}; + +export default { + "dashboard/**/*.{ts,tsx,mjs,cjs,js,jsx}": dashboardLint, +}; diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..dbc47b9 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,786 @@ +{ + "name": "worktrace", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "worktrace", + "version": "0.1.0", + "devDependencies": { + "husky": "^9", + "lint-staged": "^15" + } + }, + "node_modules/ansi-escapes": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.3.0.tgz", + "integrity": "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==", + "dev": true, + "license": "MIT", + "dependencies": { + "environment": "^1.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ansi-regex": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/chalk": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz", + "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/cli-cursor": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-5.0.0.tgz", + "integrity": "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==", + "dev": true, + "license": "MIT", + "dependencies": { + "restore-cursor": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cli-truncate": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/cli-truncate/-/cli-truncate-4.0.0.tgz", + "integrity": "sha512-nPdaFdQ0h/GEigbPClz11D0v/ZJEwxmeVZGeMo3Z5StPtUTkA9o1lD6QwoirYiSDzbcwn2XcjwmCp68W1IS4TA==", + "dev": true, + "license": "MIT", + "dependencies": { + "slice-ansi": "^5.0.0", + "string-width": "^7.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/colorette": { + "version": "2.0.20", + "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz", + "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==", + "dev": true, + "license": "MIT" + }, + "node_modules/commander": { + "version": "13.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-13.1.0.tgz", + "integrity": "sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/emoji-regex": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz", + "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==", + "dev": true, + "license": "MIT" + }, + "node_modules/environment": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz", + "integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eventemitter3": { + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", + "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==", + "dev": true, + "license": "MIT" + }, + "node_modules/execa": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-8.0.1.tgz", + "integrity": "sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cross-spawn": "^7.0.3", + "get-stream": "^8.0.1", + "human-signals": "^5.0.0", + "is-stream": "^3.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^5.1.0", + "onetime": "^6.0.0", + "signal-exit": "^4.1.0", + "strip-final-newline": "^3.0.0" + }, + "engines": { + "node": ">=16.17" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.6.0.tgz", + "integrity": "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/get-stream": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-8.0.1.tgz", + "integrity": "sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/human-signals": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-5.0.0.tgz", + "integrity": "sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=16.17.0" + } + }, + "node_modules/husky": { + "version": "9.1.7", + "resolved": "https://registry.npmjs.org/husky/-/husky-9.1.7.tgz", + "integrity": "sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==", + "dev": true, + "license": "MIT", + "bin": { + "husky": "bin.js" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/typicode" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-4.0.0.tgz", + "integrity": "sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-stream": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz", + "integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" + }, + "node_modules/lilconfig": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz", + "integrity": "sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/antonk52" + } + }, + "node_modules/lint-staged": { + "version": "15.5.2", + "resolved": "https://registry.npmjs.org/lint-staged/-/lint-staged-15.5.2.tgz", + "integrity": "sha512-YUSOLq9VeRNAo/CTaVmhGDKG+LBtA8KF1X4K5+ykMSwWST1vDxJRB2kv2COgLb1fvpCo+A/y9A0G0znNVmdx4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^5.4.1", + "commander": "^13.1.0", + "debug": "^4.4.0", + "execa": "^8.0.1", + "lilconfig": "^3.1.3", + "listr2": "^8.2.5", + "micromatch": "^4.0.8", + "pidtree": "^0.6.0", + "string-argv": "^0.3.2", + "yaml": "^2.7.0" + }, + "bin": { + "lint-staged": "bin/lint-staged.js" + }, + "engines": { + "node": ">=18.12.0" + }, + "funding": { + "url": "https://opencollective.com/lint-staged" + } + }, + "node_modules/listr2": { + "version": "8.3.3", + "resolved": "https://registry.npmjs.org/listr2/-/listr2-8.3.3.tgz", + "integrity": "sha512-LWzX2KsqcB1wqQ4AHgYb4RsDXauQiqhjLk+6hjbaeHG4zpjjVAB6wC/gz6X0l+Du1cN3pUB5ZlrvTbhGSNnUQQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "cli-truncate": "^4.0.0", + "colorette": "^2.0.20", + "eventemitter3": "^5.0.1", + "log-update": "^6.1.0", + "rfdc": "^1.4.1", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=18.0.0" + } + }, + "node_modules/log-update": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/log-update/-/log-update-6.1.0.tgz", + "integrity": "sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-escapes": "^7.0.0", + "cli-cursor": "^5.0.0", + "slice-ansi": "^7.1.0", + "strip-ansi": "^7.1.0", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/is-fullwidth-code-point": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-5.1.0.tgz", + "integrity": "sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-east-asian-width": "^1.3.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/slice-ansi": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-7.1.2.tgz", + "integrity": "sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "is-fullwidth-code-point": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/slice-ansi?sponsor=1" + } + }, + "node_modules/merge-stream": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz", + "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==", + "dev": true, + "license": "MIT" + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/mimic-fn": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-4.0.0.tgz", + "integrity": "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/mimic-function": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/mimic-function/-/mimic-function-5.0.1.tgz", + "integrity": "sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/npm-run-path": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-5.3.0.tgz", + "integrity": "sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^4.0.0" + }, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/npm-run-path/node_modules/path-key": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz", + "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/onetime": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-6.0.0.tgz", + "integrity": "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "mimic-fn": "^4.0.0" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/picomatch": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pidtree": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/pidtree/-/pidtree-0.6.0.tgz", + "integrity": "sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g==", + "dev": true, + "license": "MIT", + "bin": { + "pidtree": "bin/pidtree.js" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/restore-cursor": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-5.1.0.tgz", + "integrity": "sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==", + "dev": true, + "license": "MIT", + "dependencies": { + "onetime": "^7.0.0", + "signal-exit": "^4.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/restore-cursor/node_modules/onetime": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-7.0.0.tgz", + "integrity": "sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "mimic-function": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/rfdc": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/rfdc/-/rfdc-1.4.1.tgz", + "integrity": "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==", + "dev": true, + "license": "MIT" + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/signal-exit": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", + "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/slice-ansi": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-5.0.0.tgz", + "integrity": "sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.0.0", + "is-fullwidth-code-point": "^4.0.0" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/slice-ansi?sponsor=1" + } + }, + "node_modules/string-argv": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/string-argv/-/string-argv-0.3.2.tgz", + "integrity": "sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.6.19" + } + }, + "node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/strip-final-newline": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-3.0.0.tgz", + "integrity": "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/wrap-ansi": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz", + "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "string-width": "^7.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/yaml": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz", + "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==", + "dev": true, + "license": "ISC", + "bin": { + "yaml": "bin.mjs" + }, + "engines": { + "node": ">= 14.6" + }, + "funding": { + "url": "https://github.com/sponsors/eemeli" + } + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..d702cef --- /dev/null +++ b/package.json @@ -0,0 +1,13 @@ +{ + "name": "worktrace", + "version": "0.1.0", + "private": true, + "description": "WorkTrace monorepo — Chrome extension + Next.js dashboard for AI-generated dev session reports.", + "scripts": { + "prepare": "husky" + }, + "devDependencies": { + "husky": "^9", + "lint-staged": "^15" + } +} diff --git a/plans/AC3-cors.md b/plans/week1/AC3-cors.md similarity index 99% rename from plans/AC3-cors.md rename to plans/week1/AC3-cors.md index 9c9e82b..70ec389 100644 --- a/plans/AC3-cors.md +++ b/plans/week1/AC3-cors.md @@ -1,7 +1,7 @@ # Plan: AC 3 — CORS for Chrome Extension **Branch:** `feature/api-events-and-cors` (second commit, same branch as AC 7) -**Closes:** Week 1 AC 3 ([docs/Task.md L55](../docs/Task.md#L55)) +**Closes:** Week 1 AC 3 ([docs/Task.md L55](../../docs/Task.md#L55)) **Status:** plan, awaiting approval ## Scope diff --git a/plans/AC4-extension-init.md b/plans/week1/AC4-extension-init.md similarity index 99% rename from plans/AC4-extension-init.md rename to plans/week1/AC4-extension-init.md index b81c57c..b9a78c1 100644 --- a/plans/AC4-extension-init.md +++ b/plans/week1/AC4-extension-init.md @@ -1,7 +1,7 @@ # Plan: AC 4 — Chrome Extension initialization **Branch:** `feature/extension-init` -**Closes:** Week 1 AC 4 ([docs/Task.md L58](../docs/Task.md#L58)) +**Closes:** Week 1 AC 4 ([docs/Task.md L58](../../docs/Task.md#L58)) **Status:** plan, awaiting approval ## Scope diff --git a/plans/week1/AC5-root-readme.md b/plans/week1/AC5-root-readme.md new file mode 100644 index 0000000..b3a3426 --- /dev/null +++ b/plans/week1/AC5-root-readme.md @@ -0,0 +1,167 @@ +# Plan: AC 5 — Root `README.md` + +**Branch:** `chore/repo-setup` (first commit; a second commit on the same branch will add GitHub branch-protection notes + minimal CI) +**Closes:** Week 1 AC 5 ([docs/Task.md L59](../../docs/Task.md#L59)) +**Status:** plan, awaiting approval + +## Scope + +Replace the current 7-line placeholder `README.md` with a complete, ready root README that lets a fresh contributor (or reviewer) go from `git clone` to a running dashboard + loadable extension in one read. + +Per AC 5 in TZ: +> Dashboard і Extension живуть в одному репо у папках `/dashboard` і `/extension`. У Vercel налаштовано `Root Directory: dashboard`. Є кореневий `README.md` з інструкцією `docker-compose up` і як запустити extension локально. + +The first two clauses are already true. Only the README is missing — that's the entire scope of this commit. + +## What's in / out + +User-confirmed scope (from review questions): + +**In** — language: English. Sections to include beyond the two TZ-mandated commands: +- Tech stack overview + link to full TZ +- Prisma migrate + `.env` setup steps + +**Out** — explicitly skipped: +- Workflow guide (Plan → Review → Implement, branch strategy, conventional commits) — already in `docs/Task.md`; linked, not duplicated +- Vercel deployment guide — only the **fact** of `Root Directory: dashboard` is mentioned (it's literally in AC 5's wording); no env-var setup walkthrough +- Screenshots / demo GIFs — no real UX yet; defer to Week 4 AC 3 (Loom demo) +- Sub-package READMEs (`dashboard/README.md`, `extension/README.md`) — single root file is enough at this stage + +## Files + +| Path | Action | Notes | +|---|---|---| +| `README.md` | rewrite | Replace 7-line placeholder with full README | +| `plans/AC5-root-readme.md` | add (this file) | | + +Nothing else touched. The second commit on this branch (GitHub branch-protection + minimal CI) will be planned separately. + +## Design decisions + +### 1. One file, not three + +User picked "тільки кореневий". A single root README: +- Avoids duplication between `dashboard/README.md` and `extension/README.md`. +- Keeps the contributor's mental cost low (one entry point). +- The AC 4 plan said it would add `extension/README.md`, but that file was never created — the relevant content (Vite build, load unpacked) goes into the root README instead. + +### 2. Audience: a reviewer who just cloned the repo + +Not a marketing readme. The reader is someone (TA, future-me, a hiring reviewer) who wants to: +- Understand what the project is in 30 seconds. +- Get it running locally in ~5 minutes. +- Know where to look for deeper context (TZ, CLAUDE.md, `/plans`). + +Optimize for "can I run this?" over "is this impressive?". Tone: terse, command-first, no marketing copy. + +### 3. Structure (proposed) + +``` +# WorkTrace + ← one-line tagline (browser extension + dashboard for AI-generated session reports) + +## What it is + ← 2-3 sentence summary. Link → docs/Task.md for full spec. + +## Repo layout + ← tree showing /dashboard, /extension, /docs, /plans, plus a one-line description each. + +## Tech stack + ← compact bulleted list grouped by area (dashboard / extension / db / ai). + Not a full version dump — package.json is the source of truth. + +## Prerequisites + ← Node 20+, Docker Desktop (or Docker Engine + Compose), Chrome 120+. + +## Setup + ### 1. Clone & env + ← `git clone`, `cp dashboard/.env.example dashboard/.env`, + `cp extension/.env.example extension/.env`, + note that GOOGLE_CLIENT_ID/SECRET/JWT_SECRET stay blank until Week 2. + ### 2. Start Postgres + ← `docker-compose up -d`. Note port 5433 (not 5432). + ### 3. Dashboard + ← `cd dashboard && npm install && npx prisma migrate dev && npm run dev` + → http://localhost:3000 + ### 4. Extension + ← `cd extension && npm install && npm run build` + → `chrome://extensions` → Developer mode → Load unpacked → select `extension/dist/` + ← optional: `npm run dev` for HMR-rebuild during development. + +## Verifying it works + ← three quick checks: + 1. dashboard loads at localhost:3000 (Next.js placeholder page is fine for Week 1) + 2. extension card appears in chrome://extensions with no errors + 3. POST to /api/v1/events via Postman/curl returns 201 (one-line example) + +## Project docs + ← bulleted links: + - docs/Task.md — full acceptance criteria & roadmap + - CLAUDE.md — AI agent rules (architecture invariants) + - .claude/skills/ — task recipes + - plans/ — per-AC implementation plans (Plan → Review → Implement workflow) + +## Deploy + ← two lines: + - Dashboard: Vercel with **Root Directory: `dashboard`** (Build Command default; Prisma client is generated by `npm run build`). + - Extension: `.zip` of `extension/dist/` for local install (Chrome Web Store packaging is Week 4 AC 2). +``` + +### 4. What goes in "Tech stack" + +Compact, grouped, no versions (versions live in `package.json`): + +- **Dashboard** — Next.js 16 (App Router), React 19, Tailwind v4, TanStack Query, Framer Motion, D3.js +- **Backend** — Next.js Route Handlers, Prisma 7 (with `@prisma/adapter-pg`), Zod, `google-auth-library`, `jsonwebtoken` +- **Extension** — Manifest V3, Vite + `@crxjs/vite-plugin`, TypeScript +- **Database** — PostgreSQL 16 (Docker local / Neon prod) +- **AI** — TBD (planned Week 3): OpenAI / Groq / Gemini + +Marking AI as TBD is honest — no key picked yet, no code touching the LLM exists. Don't promise what's not built. + +### 5. `.env` handling + +The two `.env.example` files already exist: +- `dashboard/.env.example` — DATABASE_URL (matches docker-compose), GOOGLE_CLIENT_ID/SECRET, JWT_SECRET, NEXT_PUBLIC_APP_URL +- `extension/.env.example` — VITE_API_BASE_URL + +README will: +- Tell the user to copy each `.env.example` → `.env`. +- Note that Google/JWT vars are **not required** for Week 1 (the API works without them; auth lands in Week 2). +- Not duplicate the variable list — the example files are authoritative. + +### 6. Postgres port + +`docker-compose.yml` maps host **5433** → container 5432 (avoids clashing with a local Postgres on 5432). README will state this explicitly because the next thing a contributor does after `docker-compose up` is connect to the DB, and the off-by-one port is the #1 trip wire. + +### 7. Style rules + +- Code blocks fenced with language hint (` ```bash ` / ` ```ts `) so GitHub highlights them. +- All commands assume the user is in the repo root unless the block starts with `cd`. +- Use relative links (`[docs/Task.md](docs/Task.md)`) so they work both on GitHub and in editors. +- No emojis (CLAUDE.md rule). +- Keep total length under ~150 lines — anything longer signals scope creep. + +## Verification + +- [ ] `README.md` renders cleanly on GitHub (preview before merge) +- [ ] All relative links resolve (no 404s) +- [ ] A fresh-clone walkthrough on a clean machine succeeds end to end: + - [ ] `docker-compose up -d` brings Postgres up + - [ ] `cd dashboard && npm i && npx prisma migrate dev` succeeds + - [ ] `npm run dev` → localhost:3000 loads + - [ ] `cd extension && npm i && npm run build` produces `dist/` + - [ ] Chrome loads `extension/dist/` unpacked without errors +- [ ] No mention of features that don't exist yet (AI report, auth flow, etc.) framed as if they work — those are explicitly labeled as upcoming weeks + +## Out of scope (for this commit) + +- GitHub branch-protection rules (`main` and `development`) — second commit on this branch. +- Minimal CI workflow (`.github/workflows/ci.yml` — lint + typecheck) — second commit on this branch. +- PR template, issue templates, CODEOWNERS — not asked for. +- Contributing guide — TZ doesn't request, and Plan→Review→Implement workflow is already in `docs/Task.md`. +- License file — TZ doesn't request. + +## Lesson for the skill + +No skill update needed — README authoring isn't a recurring task that warrants a recipe. The `init` skill (built-in) handles CLAUDE.md generation, which is the analogous task for AI guidance. diff --git a/plans/AC7-events-api-route.md b/plans/week1/AC7-events-api-route.md similarity index 99% rename from plans/AC7-events-api-route.md rename to plans/week1/AC7-events-api-route.md index 987935d..d16426d 100644 --- a/plans/AC7-events-api-route.md +++ b/plans/week1/AC7-events-api-route.md @@ -1,7 +1,7 @@ # Plan: AC 7 — POST /api/v1/events Route Handler **Branch:** `feature/api-events-and-cors` (combined PR with AC 3) -**Closes:** Week 1 AC 7 ([docs/Task.md L63](../docs/Task.md#L63)) +**Closes:** Week 1 AC 7 ([docs/Task.md L63](../../docs/Task.md#L63)) **Status:** implemented, awaiting smoke test This plan is written post-hoc after several mid-stream corrections from the user. It documents the final decisions and the changes that landed, including all the adjustments made during implementation. diff --git a/plans/week1/repo-governance-and-ci.md b/plans/week1/repo-governance-and-ci.md new file mode 100644 index 0000000..424c97d --- /dev/null +++ b/plans/week1/repo-governance-and-ci.md @@ -0,0 +1,235 @@ +# Plan: Repository governance + minimal CI + +**Branch:** `chore/repo-setup` (commits 2 and 3, continuing after `65d8aad` — root README) +**Closes:** +- No Week 1 AC directly (governance files aren't in TZ) +- Week 4 AC 1 partially ([docs/Task.md L97](../../docs/Task.md#L97)) — CI runs lint+typecheck on PRs to `development` and `main`, branch protection prevents merging with failing checks +**Status:** plan, awaiting approval + +## Scope + +Two commits, in order: + +### Commit 2 — `chore: add license, contributing guide, and PR template` + +GitHub community-health files + documented branch-protection rules. No code, only repo-meta. + +### Commit 3 — `ci: add lint and typecheck workflow` + +Minimal GitHub Actions workflow that runs ESLint on the dashboard and `tsc --noEmit` on both packages for every PR to `development` and `main`. This is the technical half of Week 4 AC 1; UI-side branch-protection (toggling "Require status checks") is a one-time GitHub Settings click that the repo owner does after the workflow lands and runs once successfully. + +## Files + +### Commit 2 + +| Path | Action | Notes | +|---|---|---| +| `LICENSE` | new | MIT, copyright 2026 BODMAT | +| `CONTRIBUTING.md` | new | Plan→Review→Implement, branch naming, commit conventions, branch protection summary | +| `.github/PULL_REQUEST_TEMPLATE.md` | new | Auto-populated PR body — closes AC link, plan link, changes summary, verification checklist | +| `plans/repo-governance-and-ci.md` | add (this file) | committed with commit 2 | + +### Commit 3 + +| Path | Action | Notes | +|---|---|---| +| `.github/workflows/ci.yml` | new | Two jobs: `dashboard` (lint + typecheck), `extension` (typecheck) | + +Nothing else touched. No changes to `dashboard/` or `extension/` source. + +## Design decisions + +### 1. LICENSE — MIT, single copyright holder + +User picked MIT in the previous question. Standard form, single copyright line: + +``` +Copyright (c) 2026 BODMAT +``` + +Use the canonical OSI MIT text verbatim (no project-specific clauses). Adding `` is optional — `BODMAT` matches the GitHub handle. + +### 2. CONTRIBUTING.md — reference, not full duplication + +The Plan→Review→Implement workflow, branch strategy, and commit conventions are already in [docs/Task.md](../../docs/Task.md) (§ "Git воркфлоу", "Commit messages", "Головне правило воркфлоу"). CONTRIBUTING.md will: + +- Summarize each in 3-5 lines (so a drive-by contributor doesn't need to read the full TZ). +- Link out to `docs/Task.md` for full context. +- Add one section that's **not** in `docs/Task.md`: branch-protection rules that need to be toggled in GitHub Settings UI by the owner (`main` and `development` — require PR, require status checks, do not allow bypass). +- Add a short "Where to put new files" map (server logic → `dashboard/server/`, extension messaging → `extension/src/background/`, etc.) — pulled from CLAUDE.md. + +Tone: imperative, terse. Audience: someone who just cloned the repo and wants to open their first PR. + +Section sketch: + +``` +# Contributing + +## Workflow: Plan → Review → Implement + ← 3 bullet description, link to docs/Task.md § "Головне правило воркфлоу" + +## Branches + ← naming (feature/, fix/, chore/), branched from development, + PR back to development. Link to docs/Task.md § "Git воркфлоу". + +## Commit messages + ← Conventional Commits, 1 example line, link to docs/Task.md. + +## Branch protection (repo owner — one-time GitHub UI setup) + ← bulleted list: Settings → Branches → for main and development: + [x] Require a pull request before merging + [x] Require status checks to pass before merging + [x] Do not allow bypassing the above settings + Status check to require: "CI / dashboard" and "CI / extension" (added in next commit). + +## Where things live + ← short map from CLAUDE.md (server/ for business logic, etc.) +``` + +### 3. Pull request template — reinforces Plan→Review→Implement + +GitHub renders `.github/PULL_REQUEST_TEMPLATE.md` as the default PR body. The template should make it impossible to open a PR without saying which plan and AC it closes — the loop's enforcement mechanism. + +Template: + +```markdown +## Closes +- AC: +- Plan: + +## Changes +- +- + +## Verification +- [ ] `npm run lint` (dashboard) — clean +- [ ] `npm run typecheck` (extension) — clean +- [ ] `npx tsc --noEmit` (dashboard) — clean +- [ ] Manual test: + +## Notes + +``` + +The verification commands match what CI runs, so a green CI box ≈ verification done. + +### 4. CI workflow shape + +`.github/workflows/ci.yml`: + +```yaml +name: CI + +on: + pull_request: + branches: [development, main] + push: + branches: [development, main] # also runs on direct pushes for status badges + +jobs: + dashboard: + runs-on: ubuntu-latest + defaults: + run: + working-directory: dashboard + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: '20' + cache: 'npm' + cache-dependency-path: dashboard/package-lock.json + - run: npm ci + - run: npx prisma generate + - run: npm run lint + - run: npx tsc --noEmit + + extension: + runs-on: ubuntu-latest + defaults: + run: + working-directory: extension + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: '20' + cache: 'npm' + cache-dependency-path: extension/package-lock.json + - run: npm ci + - run: npm run typecheck +``` + +Decisions inside this: + +#### 4a. Two jobs, not a matrix + +Matrix would be tempting (`strategy.matrix.package: [dashboard, extension]`) but the two packages have different scripts (`lint` exists in dashboard, not extension; `prisma generate` only matters in dashboard). Splitting into named jobs makes the GitHub status-check names readable (`CI / dashboard`, `CI / extension`) and lets us configure required checks per branch protection cleanly. + +#### 4b. `prisma generate` before typecheck + +The dashboard codebase imports from `@/generated/prisma/client` and `@/generated/zod/...`, both gitignored. Without `prisma generate`, `tsc` would error with "Cannot find module". The dashboard's `npm run build` already chains this (`"build": "prisma generate && next build"`), but `tsc --noEmit` alone doesn't — we run it explicitly. Extension doesn't have generated artifacts so no equivalent step needed. + +#### 4c. No ESLint in extension + +`extension/package.json` doesn't declare a lint script, and there's no ESLint config there. Out of scope for this commit (the AC 4 plan noted ESLint for extension is a future task). When extension lint is added later, append `- run: npm run lint` to the extension job. + +#### 4d. `actions/checkout@v4`, `actions/setup-node@v4`, Node 20 + +- `@v4` are current as of 2026-05. Pin majors; let Dependabot bump. +- Node 20 LTS matches the README prerequisite. Next.js 16 needs Node ≥ 18.18, so 20 is comfortable. +- No `cache: 'npm'` matrix wizardry — `cache-dependency-path` pins each job's cache to its own `package-lock.json` so they don't trash each other. + +#### 4e. Triggers — PR + push + +- `pull_request`: required for branch protection's "require status checks" to apply. +- `push` to `development`/`main`: gives the README a green-build badge and catches direct pushes (shouldn't happen once branch protection is on, but defensive). +- Not running on every push to feature branches — saves Actions minutes; the PR trigger covers it. + +#### 4f. No matrix on Node versions + +YAGNI. We support exactly Node 20 (per README). Add a 22/23 column when there's a reason. + +#### 4g. No caching of `~/.npm` manually + +`actions/setup-node@v4` with `cache: 'npm'` handles it. Don't reinvent. + +### 5. What CI does NOT do (yet) + +- **Build** (`next build`, `vite build`) — slower, and lint+typecheck already catch type/syntax errors. Add when we have build-time failures worth catching (e.g., when AC 4 Vercel deploys started failing). +- **Tests** — there are no tests yet; nothing to run. +- **Migrations check** (`prisma migrate diff` against committed schema) — useful, but Week 1 has exactly one migration. Add if drift becomes a problem. +- **Lint extension code** — see 4c. Future. +- **Auto-deploy to Vercel** — Vercel has its own GitHub integration; we don't need to duplicate it in Actions. (Week 4 AC 1 says "При мерджі в main — автодеплой на Vercel" — that's the Vercel integration, not a workflow step here.) + +### 6. Branch protection — documented, not automated + +GitHub branch protection is a UI setting, not a file in the repo (Rulesets API exists but is overkill for this). CONTRIBUTING.md will explicitly list the toggles to enable. The repo owner does this once after commit 3 lands and the workflow has run successfully on `development` (otherwise "Require status checks" can't find the check names to require). + +## Verification + +### Commit 2 + +- [ ] `LICENSE` exists, MIT text, copyright 2026 BODMAT +- [ ] `CONTRIBUTING.md` renders on GitHub, all internal links resolve +- [ ] `.github/PULL_REQUEST_TEMPLATE.md` exists — verify by opening a draft PR after push, body is pre-filled + +### Commit 3 + +- [ ] `.github/workflows/ci.yml` validates as YAML (`yamllint` or just GitHub Actions UI showing no parse errors) +- [ ] After push, **Actions** tab shows two jobs running: `dashboard` and `extension` +- [ ] Both jobs go green on the existing `chore/repo-setup` branch state +- [ ] If we deliberately break a file (add `const x: number = "string"` somewhere), CI fails on `dashboard` job — confirms typecheck is wired +- [ ] Branch-protection UI on GitHub now lists `dashboard` and `extension` as status checks the user can require + +## Out of scope (for this branch) + +- ESLint for extension code (no config exists; add when needed). +- Build step in CI (deferred until something breaks). +- Auto-merge / Dependabot / CodeQL / release workflows. +- CHANGELOG.md. +- Issue templates (skipped per earlier answer). + +## Lesson for the skill + +After commit 3, the `.claude/skills/` recipes already say "use Plan → Review → Implement"; they don't need an update for CI. If a future Route Handler skill adds a test command, mention it in the PR template's Verification section. diff --git a/plans/week1/repo-hygiene-husky.md b/plans/week1/repo-hygiene-husky.md new file mode 100644 index 0000000..4283d52 --- /dev/null +++ b/plans/week1/repo-hygiene-husky.md @@ -0,0 +1,154 @@ +# Plan: Repo hygiene + husky pre-commit + +**Branch:** `chore/repo-setup` (5th commit, continuing after `4e09c87` — lint tightening) +**Closes:** no AC directly — local DX improvements complementing the CI workflow. +**Status:** plan, awaiting approval + +## Scope + +Single commit `chore(repo): add husky pre-commit, gitattributes, nvmrc`. Three additions, all small, none of which conflict with future weekly work: + +- **Husky + lint-staged pre-commit hook** — runs ESLint with `--fix` on staged dashboard files. Catches errors locally before CI. Requires a root `package.json` (the repo has no workspace tool today). +- **`.gitattributes`** — normalize line endings to LF in git (stops the `LF will be replaced by CRLF` warnings on every commit, keeps the repo cross-platform sane). +- **`.nvmrc`** — pin Node 20 for `nvm use` / IDE auto-switch. + +## Files + +| Path | Action | Notes | +|---|---|---| +| `package.json` | new | root — `husky` + `lint-staged` as devDeps, `prepare` script | +| `package-lock.json` | new (auto) | generated by `npm install` | +| `.husky/pre-commit` | new | one-line shell: `npx lint-staged` | +| `lint-staged.config.mjs` | new | JS config — handles dashboard subdir paths cross-platform | +| `.gitattributes` | new | `* text=auto eol=lf` + binary markers | +| `.nvmrc` | new | one line: `20` | +| `plans/week1/repo-hygiene-husky.md` | add (this file) | | + +Root `.gitignore` already covers `node_modules/` — no change needed. + +## Design decisions + +### 1. Why a root `package.json` + +The repo is a monorepo without a workspace tool (`dashboard/` and `extension/` each have their own `package.json` and `node_modules`). Husky must install git hooks via a `prepare` script that runs at install time — that script needs to live in a `package.json` that the contributor will `npm install`. + +Three options considered: + +- **Root `package.json` just for husky/lint-staged.** Standard pattern. Contributor runs `npm install` at repo root once to install the hook. Mild cost: one more `node_modules/` directory (small — only husky + lint-staged + their deps). +- **Put husky inside `dashboard/`.** Awkward: `npm install` in dashboard would install hooks pointing to commands that assume cwd=repo-root. Also doesn't catch commits made when editing extension code if the contributor never installed dashboard deps. +- **No husky, rely on CI only.** What we have today. Loses the fast-feedback DX win. + +**Decision:** root `package.json`. Minimal — just husky + lint-staged. No build, no scripts beyond `prepare`. + +### 2. lint-staged config — JS, not JSON + +`lint-staged` config can live in `package.json` (JSON) or a separate `lint-staged.config.{mjs,js,cjs}` file (JS). For this monorepo we need JS because: + +- Staged files come in as absolute paths. +- ESLint resolves its flat config from `cwd`, not from the file's directory. +- So we need to run ESLint with `cwd=dashboard/`, passing dashboard-relative paths. +- That path arithmetic needs JS. + +Shape: + +```js +// lint-staged.config.mjs +import path from "node:path"; + +const dashboardLint = (files) => { + const dashboardDir = path.resolve("dashboard"); + const relative = files + .map((f) => path.relative(dashboardDir, f).replace(/\\/g, "/")) + .map((f) => `"${f}"`) + .join(" "); + // `npm --prefix` is cross-platform (no `cd && …` shell chains). + // `-- --fix ` forwards args to the dashboard `lint` script (which is `eslint`). + return `npm --prefix dashboard run lint -- --fix ${relative}`; +}; + +export default { + "dashboard/**/*.{ts,tsx,mjs,cjs,js,jsx}": dashboardLint, +}; +``` + +### 3. What runs in pre-commit + +- **`eslint --fix` on staged dashboard files** — auto-fixes formatting + flags real errors before commit. +- **NOT `tsc --noEmit`** — typecheck needs the whole project; running it per-commit adds ~5-10s for a small dashboard, more later. Stays in CI. +- **NOT extension lint** — extension has no ESLint config yet (noted in earlier plan). Add to lint-staged once it does. +- **NOT extension typecheck** — same reason as dashboard typecheck (speed). + +The pre-commit hook is a fast smoke test, not a full quality gate. The full gate is CI. + +### 4. `.gitattributes` content + +``` +# Treat as text and normalize line endings to LF. +* text=auto eol=lf + +# Binary — never modified. +*.png binary +*.jpg binary +*.jpeg binary +*.gif binary +*.ico binary +*.webp binary +*.zip binary +*.pdf binary +*.woff binary +*.woff2 binary +``` + +On Windows, git will still write CRLF to the working tree (controlled by `core.autocrlf`); `.gitattributes` only controls what's stored in the repo. Net effect: no more `LF will be replaced by CRLF` warnings on commit because git knows the file is text and the normalization is intentional. + +Existing files committed with CRLF in the repo won't be retroactively renormalized — git only converts on next touch. That's fine; no need to mass-rewrite history. + +### 5. `.nvmrc` content + +``` +20 +``` + +One line, no `v` prefix (`nvm` accepts both, but plain numbers are the convention). + +### 6. Installing without breaking existing flows + +After `npm install` at the new root `package.json`: +- A root `node_modules/` appears. +- `.husky/_/` directory gets created by husky's install script (handles the actual git hook wiring). +- `git commit` now invokes `.husky/pre-commit`. + +Existing flows (`cd dashboard && npm run dev`, `cd extension && npm run build`) are unaffected — they read their own `package.json` and `node_modules` as before. + +### 7. Skipping the hook when needed + +`git commit --no-verify` skips husky hooks. This should be rare (per CLAUDE.md, you investigate root causes rather than bypass); documenting it in CONTRIBUTING.md isn't necessary — most devs already know `--no-verify`. + +### 8. Versions to pin + +- `husky@^9` — latest major. v9 removed the `husky install` command; replaced by `husky` directly. Our `prepare` script reflects that. +- `lint-staged@^15` — latest stable, supports ESM config. + +Exact versions resolved at install time. + +## Verification + +- [ ] `npm install` at repo root succeeds; `node_modules/` and `package-lock.json` appear. +- [ ] `.husky/pre-commit` exists and is wired (husky uses `core.hooksPath`, so `ls .git/hooks/` should NOT show `pre-commit`). +- [ ] `cat .nvmrc` → `20`. +- [ ] Stage a deliberately-bad dashboard file (e.g. add `const x: any = 1` to a TS file) → `git commit` fails with the ESLint error. +- [ ] Stage a clean dashboard file → `git commit` succeeds, `eslint --fix` runs (no visible output if nothing to fix). +- [ ] Stage a file outside `dashboard/**` (e.g. a markdown file) → commit succeeds without running lint. +- [ ] After `.gitattributes` is in place, a subsequent commit of a TS file no longer prints `LF will be replaced by CRLF`. + +## Out of scope (for this branch) + +- Workspaces (`npm workspaces` / `pnpm`) — would unify `node_modules` but disrupts the current isolated layout. Defer until there's a real reason. +- Husky pre-push hook (run full typecheck) — heavier; add later if devs land bad commits often. +- ESLint config for `extension/` — already noted in the CI plan; separate task. +- Conventional-commits validation (`commitlint`) — useful but not asked for. +- `.editorconfig` — declined. + +## Lesson for the skill + +No skill file needs an update — pre-commit hooks aren't a recurring code-authoring task. If a contributor sees the hook fail and wants to bypass it, the rule "diagnose, don't bypass" is already in CLAUDE.md. From 3ca1aea284f438fd9ba52d1cee8c18fcc7e15333 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Fri, 22 May 2026 00:08:04 +0300 Subject: [PATCH 07/24] feat(extension): google oauth - jwt auth flow (Week 2 AC 1) (#7) * docs(plans): add week 2 AC 1 auth plan * feat(dashboard): add auth server module and /api/auth/extension route * feat(extension): implement google oauth flow, jwt storage and auth popup --- dashboard/.env.example | 34 ++++- dashboard/app/api/auth/extension/route.ts | 30 +++++ dashboard/server/auth.ts | 57 ++++++++ dashboard/server/schemas/auth.ts | 6 + extension/.env.example | 13 +- extension/src/background/index.ts | 154 +++++++++++++++++++++- extension/src/manifest.ts | 2 +- extension/src/popup/index.html | 6 +- extension/src/popup/popup.ts | 32 ++++- extension/src/types/auth.ts | 15 +++ plans/week2/AC1-auth.md | 107 +++++++++++++++ 11 files changed, 445 insertions(+), 11 deletions(-) create mode 100644 dashboard/app/api/auth/extension/route.ts create mode 100644 dashboard/server/auth.ts create mode 100644 dashboard/server/schemas/auth.ts create mode 100644 extension/src/types/auth.ts create mode 100644 plans/week2/AC1-auth.md diff --git a/dashboard/.env.example b/dashboard/.env.example index 4fd5c05..e9bf733 100644 --- a/dashboard/.env.example +++ b/dashboard/.env.example @@ -1,10 +1,34 @@ -# Postgres connection string (direct, no pooler). -# Local dev: docker-compose.yml provides the matching credentials. -# Production (Neon): direct connection string (no "-pooler" in hostname). -# Connection pooling in prod is handled via @prisma/adapter-neon, not a separate URL. +# ─── Database ────────────────────────────────────────────────────────────────── +# Local dev: credentials from docker-compose.yml (port 5433). +# Neon (prod): https://console.neon.tech → your project → Connection string +# Use the "Pooled connection" string for DATABASE_URL. DATABASE_URL="postgresql://postgres:postgres@localhost:5433/worktrace" +# ─── Google OAuth ────────────────────────────────────────────────────────────── +# https://console.cloud.google.com → APIs & Services → Credentials +# → "+ CREATE CREDENTIALS" → "OAuth 2.0 Client ID" +# +# For the Extension auth flow (Week 2): +# Application type: Chrome Extension +# Application ID: your unpacked extension ID from chrome://extensions +# → copy the generated Client ID here +# +# For the Web Dashboard OAuth (Week 3): +# Create a SEPARATE Client ID with Application type: Web application +# Authorized redirect URIs: http://localhost:3000/api/auth/callback/google GOOGLE_CLIENT_ID="" + +# Client secret — needed in Week 3 for the web dashboard authorization code flow. +# Same credentials page as GOOGLE_CLIENT_ID (Web application type). GOOGLE_CLIENT_SECRET="" + +# ─── JWT ─────────────────────────────────────────────────────────────────────── +# Random 256-bit secret used to sign/verify our own JWTs. +# Generate: openssl rand -base64 32 JWT_SECRET="" -NEXT_PUBLIC_APP_URL="http://localhost:3000" \ No newline at end of file + +# Token lifetime — any value accepted by the `ms` library (e.g. 7d, 24h, 3600). +JWT_EXPIRES_IN="7d" + +# ─── App ─────────────────────────────────────────────────────────────────────── +NEXT_PUBLIC_APP_URL="http://localhost:3000" diff --git a/dashboard/app/api/auth/extension/route.ts b/dashboard/app/api/auth/extension/route.ts new file mode 100644 index 0000000..8a5fc5d --- /dev/null +++ b/dashboard/app/api/auth/extension/route.ts @@ -0,0 +1,30 @@ +import { NextRequest, NextResponse } from "next/server"; +import { withCors, corsPreflight } from "@/server/cors"; +import { ExtensionAuthInput } from "@/server/schemas/auth"; +import { authenticateExtensionUser } from "@/server/auth"; + +export const POST = withCors(async (req: NextRequest) => { + let body: unknown; + try { + body = await req.json(); + } catch { + return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); + } + + const parsed = ExtensionAuthInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: parsed.error.format() }, { status: 400 }); + } + + try { + const token = await authenticateExtensionUser(parsed.data.googleToken); + return NextResponse.json({ token }, { status: 200 }); + } catch (err) { + const message = err instanceof Error ? err.message : "Authentication failed"; + return NextResponse.json({ error: message }, { status: 401 }); + } +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/server/auth.ts b/dashboard/server/auth.ts new file mode 100644 index 0000000..693e378 --- /dev/null +++ b/dashboard/server/auth.ts @@ -0,0 +1,57 @@ +import { OAuth2Client } from "google-auth-library"; +import jwt from "jsonwebtoken"; +import { prisma } from "@/server/db"; + +function requireEnv(name: string): string { + const v = process.env[name]; + if (!v) throw new Error(`Missing required env var: ${name}`); + return v; +} + +const googleClient = new OAuth2Client(); + +async function verifyGoogleToken(idToken: string) { + const ticket = await googleClient.verifyIdToken({ + idToken, + audience: requireEnv("GOOGLE_CLIENT_ID"), + }); + const payload = ticket.getPayload(); + if (!payload?.sub || !payload?.email) { + throw new Error("Invalid token payload: missing sub or email"); + } + return { + googleId: payload.sub, + email: payload.email, + name: payload.name ?? null, + picture: payload.picture ?? null, + }; +} + +async function upsertUser(data: { + googleId: string; + email: string; + name: string | null; + picture: string | null; +}) { + return prisma.user.upsert({ + where: { googleId: data.googleId }, + update: { email: data.email, name: data.name, picture: data.picture }, + create: { googleId: data.googleId, email: data.email, + name: data.name, picture: data.picture }, + }); +} + +function issueJWT(userId: string, email: string): string { + const expiresIn = (process.env.JWT_EXPIRES_IN ?? "7d") as jwt.SignOptions["expiresIn"]; + return jwt.sign( + { sub: userId, email }, + requireEnv("JWT_SECRET"), + { expiresIn }, + ); +} + +export async function authenticateExtensionUser(googleIdToken: string): Promise { + const googleUser = await verifyGoogleToken(googleIdToken); + const user = await upsertUser(googleUser); + return issueJWT(user.id, user.email); +} diff --git a/dashboard/server/schemas/auth.ts b/dashboard/server/schemas/auth.ts new file mode 100644 index 0000000..a62489e --- /dev/null +++ b/dashboard/server/schemas/auth.ts @@ -0,0 +1,6 @@ +import { z } from "zod"; + +export const ExtensionAuthInput = z.object({ + googleToken: z.string().min(1, "googleToken is required"), +}); +export type ExtensionAuthInput = z.infer; diff --git a/extension/.env.example b/extension/.env.example index 99cbcd5..867e941 100644 --- a/extension/.env.example +++ b/extension/.env.example @@ -1 +1,12 @@ -VITE_API_BASE_URL=http://localhost:3000 +# ─── Dashboard URL ───────────────────────────────────────────────────────────── +# Local dev: http://localhost:3000 +# Production: your Vercel deployment URL (e.g. https://worktrace-ecru.vercel.app) +VITE_DASHBOARD_URL="http://localhost:3000" + +# ─── Google OAuth ────────────────────────────────────────────────────────────── +# https://console.cloud.google.com → APIs & Services → Credentials +# → "+ CREATE CREDENTIALS" → "OAuth 2.0 Client ID" +# Application type: Chrome Extension +# Application ID: your unpacked extension ID from chrome://extensions +# → copy the generated Client ID here (same value as GOOGLE_CLIENT_ID in dashboard/.env) +VITE_GOOGLE_CLIENT_ID="" diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index 3c1839f..aef3cc0 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -1,5 +1,155 @@ -console.log("[worktrace] service worker booted"); +import type { AuthMessage, AuthResponse, StoredAuth } from "../types/auth"; + +const DASHBOARD_URL = import.meta.env.VITE_DASHBOARD_URL as string; +const GOOGLE_CLIENT_ID = import.meta.env.VITE_GOOGLE_CLIENT_ID as string; +const EXPIRY_BUFFER_MS = 60_000; + +// ─── Storage ─────────────────────────────────────────────────────────────────── + +async function getStoredAuth(): Promise { + const r = await chrome.storage.local.get(["jwt", "jwtExpiresAt"]); + if (!r["jwt"] || !r["jwtExpiresAt"]) return null; + return { jwt: r["jwt"] as string, jwtExpiresAt: r["jwtExpiresAt"] as number }; +} + +async function storeAuth(jwt: string, expiresAt: number): Promise { + await chrome.storage.local.set({ jwt, jwtExpiresAt: expiresAt }); +} + +async function clearAuth(): Promise { + await chrome.storage.local.remove(["jwt", "jwtExpiresAt"]); +} + +function isExpired(expiresAt: number): boolean { + return Date.now() >= expiresAt - EXPIRY_BUFFER_MS; +} + +// ─── Google OAuth ────────────────────────────────────────────────────────────── + +async function launchGoogleOAuth(): Promise { + const redirectUrl = chrome.identity.getRedirectURL("auth"); + const nonce = crypto.randomUUID(); + + const url = new URL("https://accounts.google.com/o/oauth2/v2/auth"); + url.searchParams.set("client_id", GOOGLE_CLIENT_ID); + url.searchParams.set("response_type", "id_token"); + url.searchParams.set("redirect_uri", redirectUrl); + url.searchParams.set("scope", "openid email profile"); + url.searchParams.set("nonce", nonce); + url.searchParams.set("prompt", "select_account"); + + const responseUrl = await chrome.identity.launchWebAuthFlow({ + url: url.toString(), + interactive: true, + }); + + if (!responseUrl) throw new Error("OAuth flow cancelled"); + + const fragment = new URL(responseUrl).hash.slice(1); + const idToken = new URLSearchParams(fragment).get("id_token"); + if (!idToken) throw new Error("No id_token in OAuth response"); + return idToken; +} + +// ─── JWT exchange ────────────────────────────────────────────────────────────── + +async function exchangeForJWT(googleIdToken: string): Promise { + const res = await fetch(`${DASHBOARD_URL}/api/auth/extension`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ googleToken: googleIdToken }), + }); + + if (!res.ok) { + const body = await res.json().catch(() => ({})) as Record; + throw new Error(`JWT exchange failed (${res.status}): ${JSON.stringify(body)}`); + } + + const { token } = await res.json() as { token: string }; + const payloadB64 = token.split(".")[1] ?? ""; + const { exp } = JSON.parse(atob(payloadB64)) as { exp: number }; + return { jwt: token, jwtExpiresAt: exp * 1000 }; +} + +// ─── Core ────────────────────────────────────────────────────────────────────── + +async function ensureAuthenticated(): Promise { + const stored = await getStoredAuth(); + if (stored && !isExpired(stored.jwtExpiresAt)) return stored.jwt; + + const googleIdToken = await launchGoogleOAuth(); + const auth = await exchangeForJWT(googleIdToken); + await storeAuth(auth.jwt, auth.jwtExpiresAt); + return auth.jwt; +} + +// Використовується в AC 5 для всіх API-запитів +export async function apiFetch( + path: string, + init: RequestInit = {}, +): Promise { + const token = await ensureAuthenticated(); + return fetch(`${DASHBOARD_URL}${path}`, { + ...init, + headers: { + "Content-Type": "application/json", + ...(init.headers as Record | undefined), + Authorization: `Bearer ${token}`, + }, + }); +} + +// ─── Message listener ────────────────────────────────────────────────────────── + +chrome.runtime.onMessage.addListener( + (message: AuthMessage, _sender, sendResponse: (r: AuthResponse) => void) => { + if (message.type === "AUTH_LOGIN") { + ensureAuthenticated() + .then((jwt) => sendResponse({ success: true, jwt })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "AUTH_LOGOUT") { + clearAuth() + .then(() => sendResponse({ success: true })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "AUTH_GET_STATUS") { + getStoredAuth() + .then((stored) => + sendResponse({ + success: true, + isAuthenticated: stored !== null && !isExpired(stored.jwtExpiresAt), + }), + ) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + return false; + }, +); + +// ─── Lifecycle ───────────────────────────────────────────────────────────────── chrome.runtime.onInstalled.addListener((details) => { - console.log("[worktrace] installed", details.reason); + console.log("[worktrace] service worker installed:", details.reason); }); diff --git a/extension/src/manifest.ts b/extension/src/manifest.ts index 27a41b7..6330a4e 100644 --- a/extension/src/manifest.ts +++ b/extension/src/manifest.ts @@ -27,7 +27,7 @@ export default defineManifest({ run_at: "document_idle", }, ], - permissions: ["storage", "activeTab", "tabs"], + permissions: ["storage", "activeTab", "tabs", "identity"], host_permissions: [ "http://localhost:3000/*", "https://worktrace-ecru.vercel.app/*", diff --git a/extension/src/popup/index.html b/extension/src/popup/index.html index caaa154..068fed1 100644 --- a/extension/src/popup/index.html +++ b/extension/src/popup/index.html @@ -9,7 +9,11 @@

WorkTrace

-

Coming soon.

+
+

Checking...

+ + +
diff --git a/extension/src/popup/popup.ts b/extension/src/popup/popup.ts index 701c59c..b5d394d 100644 --- a/extension/src/popup/popup.ts +++ b/extension/src/popup/popup.ts @@ -1 +1,31 @@ -console.log("[worktrace] popup loaded"); +import type { AuthMessage, AuthResponse } from "../types/auth"; + +function sendMessage(message: AuthMessage): Promise { + return new Promise((resolve) => { + chrome.runtime.sendMessage(message, resolve); + }); +} + +const statusEl = document.getElementById("auth-status") as HTMLParagraphElement; +const btnLogin = document.getElementById("btn-login") as HTMLButtonElement; +const btnLogout = document.getElementById("btn-logout") as HTMLButtonElement; + +// Check auth status when popup opens +sendMessage({ type: "AUTH_GET_STATUS" }).then((res) => { + if (res.success && "isAuthenticated" in res) { + statusEl.textContent = res.isAuthenticated ? "✅ Signed in" : "❌ Not signed in"; + } +}); + +btnLogin.addEventListener("click", async () => { + btnLogin.disabled = true; + statusEl.textContent = "Signing in..."; + const res = await sendMessage({ type: "AUTH_LOGIN" }); + statusEl.textContent = res.success ? "✅ Signed in" : `❌ ${!res.success ? res.error : ""}`; + btnLogin.disabled = false; +}); + +btnLogout.addEventListener("click", async () => { + await sendMessage({ type: "AUTH_LOGOUT" }); + statusEl.textContent = "❌ Not signed in"; +}); diff --git a/extension/src/types/auth.ts b/extension/src/types/auth.ts new file mode 100644 index 0000000..259bcf5 --- /dev/null +++ b/extension/src/types/auth.ts @@ -0,0 +1,15 @@ +export interface StoredAuth { + jwt: string; + jwtExpiresAt: number; // Unix ms +} + +export type AuthMessage = + | { type: "AUTH_LOGIN" } + | { type: "AUTH_LOGOUT" } + | { type: "AUTH_GET_STATUS" }; + +export type AuthResponse = + | { success: true; jwt: string } + | { success: true; isAuthenticated: boolean } + | { success: true } + | { success: false; error: string }; diff --git a/plans/week2/AC1-auth.md b/plans/week2/AC1-auth.md new file mode 100644 index 0000000..25c83c3 --- /dev/null +++ b/plans/week2/AC1-auth.md @@ -0,0 +1,107 @@ +# Plan: Week 2 AC 1 — Auth Extension → Dashboard + +**Branch:** `feature/extension-auth-google-oauth` +**Closes:** Week 2 AC 1 ([docs/Task.md L69](../../docs/Task.md#L69)) +**Status:** plan, awaiting review + +--- + +## Scope + +Full authentication flow між Chrome Extension і Next.js Dashboard: + +1. `chrome.identity.launchWebAuthFlow` → Google ID token +2. `POST /api/auth/extension` → dashboard верифікує token, повертає власний JWT +3. JWT зберігається в `chrome.storage.local` (service worker only) +4. Всі наступні API-запити йдуть через `apiFetch()` у service worker з `Authorization: Bearer ` + +--- + +## Commits (ordered) + +``` +chore: update .env.example files with auth vars ✅ done +feat(dashboard): add auth schema, server module and /api/auth/extension route +feat(extension): implement google oauth flow in service worker +feat(extension): add auth status and login/logout to popup +``` + +--- + +## Files + +| File | Action | Commit | +|---|---|---| +| `dashboard/.env.example` | updated | ✅ done | +| `extension/.env.example` | updated | ✅ done | +| `dashboard/server/schemas/auth.ts` | **new** | commit 2 | +| `dashboard/server/auth.ts` | **new** | commit 2 | +| `dashboard/app/api/auth/extension/route.ts` | **new** | commit 2 | +| `extension/src/types/auth.ts` | **new** | commit 3 | +| `extension/src/manifest.ts` | modify — add `"identity"` | commit 3 | +| `extension/src/background/index.ts` | **rewrite** | commit 3 | +| `extension/src/popup/index.html` | modify | commit 4 | +| `extension/src/popup/popup.ts` | modify | commit 4 | + +--- + +## Design decisions + +### 1. Google OAuth: `launchWebAuthFlow` з `response_type=id_token` + +`chrome.identity.getAuthToken` повертає access token — не верифікується через `google-auth-library.verifyIdToken()` без додаткового round-trip до Google. + +`launchWebAuthFlow` з OIDC params дає справжній JWT ID token, що верифікується локально через публічні ключі Google. Redirect URL: `chrome.identity.getRedirectURL("auth")` → `https://.chromiumapp.org/auth`. ID token повертається у hash fragment. + +``` +const url = new URL("https://accounts.google.com/o/oauth2/v2/auth"); +// response_type=id_token, scope=openid email profile, nonce=crypto.randomUUID() +``` + +### 2. JWT зберігається тільки в service worker + +Popup і content script ніколи не бачать JWT — тільки надсилають повідомлення типу `AUTH_LOGIN / AUTH_LOGOUT / AUTH_GET_STATUS` до background і отримують статус. + +### 3. Token expiry + auto-refresh в `ensureAuthenticated()` + +При кожному `apiFetch` перевіряємо `jwtExpiresAt - 60s < now()`. Якщо прострочений — повний OAuth flow. Без окремого background timer (service worker зупиняється між запитами в MV3). + +### 4. Dashboard: `server/auth.ts` — фасад з трьох кроків + +``` +verifyGoogleToken() → upsertUser() → issueJWT() +``` + +Публічний API — один метод `authenticateExtensionUser(googleIdToken): Promise`. Route handler тільки парсить, валідує і викликає його. + +### 5. `GOOGLE_CLIENT_SECRET` — не потрібен для AC 1 + +`OAuth2Client.verifyIdToken()` верифікує підпис через публічні JWK ключі Google. Secret знадобиться у Week 3 для authorization code flow в web dashboard. + +--- + +## Verification checklist + +### Dashboard +- [ ] `cd dashboard && npx tsc --noEmit` — без помилок +- [ ] `POST /api/auth/extension` без body → 400 +- [ ] `POST /api/auth/extension` з невалідним токеном → 401 +- [ ] `POST /api/auth/extension` з валідним Google ID token → 200 `{ token: "eyJ..." }` +- [ ] User з'явився/оновився в БД +- [ ] `OPTIONS /api/auth/extension` з extension origin → 204 + CORS headers + +### Extension +- [ ] `cd extension && npm run build` — без помилок +- [ ] Розширення завантажується в `chrome://extensions` без помилок +- [ ] Клік Login → Google OAuth popup → авторизація → статус змінюється +- [ ] `chrome.storage.local.get(["jwt"])` у DevTools service worker → JWT присутній +- [ ] Повторний клік Login (JWT свіжий) → не відкриває OAuth popup +- [ ] Клік Logout → JWT видалено зі storage + +--- + +## Out of scope + +- JWT верифікація у Route Handlers (окрім `/api/auth/extension`) — Week 3 middleware +- Refresh token / sliding session — `7d` JWT достатньо для MVP +- Error toast у popup — Week 3 бонус AC 5 From 0cfaf7cd49fb7eaf2682a6aff1ad2fcff0ddc975 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Fri, 22 May 2026 00:25:05 +0300 Subject: [PATCH 08/24] feat(extension): content script parser + session manager (Week 2 AC 2+3) (#8) * docs(plans): add week 2 AC 2+3 content script and session manager plan * feat(extension): add content script page metadata parser (AC 2) * feat(extension): add session manager with start/stop/timer and storage (AC 3) * docs(plans): update AC 2+3 plan with identified gaps for AC 4 and AC 5 --- extension/src/background/index.ts | 77 ++++++++- extension/src/background/session.ts | 47 ++++++ extension/src/content/index.ts | 34 +++- extension/src/types/content.ts | 8 + extension/src/types/session.ts | 14 ++ plans/week2/AC2-AC3-content-sessions.md | 197 ++++++++++++++++++++++++ 6 files changed, 375 insertions(+), 2 deletions(-) create mode 100644 extension/src/background/session.ts create mode 100644 extension/src/types/content.ts create mode 100644 extension/src/types/session.ts create mode 100644 plans/week2/AC2-AC3-content-sessions.md diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index aef3cc0..c627ae0 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -1,4 +1,12 @@ import type { AuthMessage, AuthResponse, StoredAuth } from "../types/auth"; +import type { ContentMessage } from "../types/content"; +import type { SessionMessage, SessionResponse } from "../types/session"; +import { + getSession, + startSession, + stopSession, + getElapsedMs, +} from "./session"; const DASHBOARD_URL = import.meta.env.VITE_DASHBOARD_URL as string; const GOOGLE_CLIENT_ID = import.meta.env.VITE_GOOGLE_CLIENT_ID as string; @@ -101,8 +109,10 @@ export async function apiFetch( // ─── Message listener ────────────────────────────────────────────────────────── +type IncomingMessage = AuthMessage | SessionMessage | ContentMessage; + chrome.runtime.onMessage.addListener( - (message: AuthMessage, _sender, sendResponse: (r: AuthResponse) => void) => { + (message: IncomingMessage, _sender, sendResponse: (r: AuthResponse | SessionResponse) => void) => { if (message.type === "AUTH_LOGIN") { ensureAuthenticated() .then((jwt) => sendResponse({ success: true, jwt })) @@ -144,6 +154,71 @@ chrome.runtime.onMessage.addListener( return true; } + // ─── Session messages ──────────────────────────────────────────────────── + + if (message.type === "SESSION_START") { + startSession() + .then((session) => sendResponse({ success: true, session })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "SESSION_STOP") { + stopSession() + .then((session) => sendResponse({ success: true, session })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "SESSION_GET_STATE") { + getSession() + .then((session) => { + if (session) { + // Attach live elapsed for the popup timer + const sessionWithElapsed = { + ...session, + elapsedMs: getElapsedMs(session), + }; + sendResponse({ success: true, session: sessionWithElapsed }); + } else { + sendResponse({ success: true, session: null }); + } + }) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + // ─── Content script messages ───────────────────────────────────────────── + + if (message.type === "PAGE_METADATA") { + // Store metadata only when a session is active (AC 5 will batch-send it) + getSession().then((session) => { + if (!session) return; + // Stored for AC 5 batch sync — no response needed + chrome.storage.local.get("pendingEvents").then((r) => { + const pending = (r["pendingEvents"] as unknown[]) ?? []; + pending.push({ ...message.payload, timestamp: new Date().toISOString() }); + chrome.storage.local.set({ pendingEvents: pending }); + }); + }); + return false; // no async response needed + } + return false; }, ); diff --git a/extension/src/background/session.ts b/extension/src/background/session.ts new file mode 100644 index 0000000..a9b6a27 --- /dev/null +++ b/extension/src/background/session.ts @@ -0,0 +1,47 @@ +import type { Session } from "../types/session"; + +const STORAGE_KEY = "activeSession"; + +// ─── Storage ─────────────────────────────────────────────────────────────────── + +export async function getSession(): Promise { + const r = await chrome.storage.local.get(STORAGE_KEY); + return (r[STORAGE_KEY] as Session) ?? null; +} + +async function saveSession(session: Session): Promise { + await chrome.storage.local.set({ [STORAGE_KEY]: session }); +} + +async function clearSession(): Promise { + await chrome.storage.local.remove(STORAGE_KEY); +} + +// ─── Timer ───────────────────────────────────────────────────────────────────── + +// Elapsed ms is derived from stored values — safe after SW restart +export function getElapsedMs(session: Session): number { + return session.totalActiveMs + (Date.now() - session.startedAt); +} + +// ─── Actions ────────────────────────────────────────────────────────────────── + +export async function startSession(): Promise { + const existing = await getSession(); + if (existing) return existing; // idempotent + + const session: Session = { + id: crypto.randomUUID(), + startedAt: Date.now(), + totalActiveMs: 0, + }; + await saveSession(session); + return session; +} + +export async function stopSession(): Promise { + const session = await getSession(); + if (!session) return null; + await clearSession(); + return session; +} diff --git a/extension/src/content/index.ts b/extension/src/content/index.ts index 208a5dd..99292e2 100644 --- a/extension/src/content/index.ts +++ b/extension/src/content/index.ts @@ -1 +1,33 @@ -console.log("[worktrace] content script loaded", location.href); +import type { ContentMessage, PageMetadata } from "../types/content"; + +function parseMetadata(): PageMetadata { + const headings = Array.from(document.querySelectorAll("h1, h2, h3")) + .map((el) => el.textContent?.trim() ?? "") + .filter((text) => text.length > 0); + + return { + url: window.location.href, + title: document.title, + metaDescription: + document.querySelector('meta[name="description"]') + ?.content ?? null, + headings, + }; +} + +function sendMetadata(): void { + const message: ContentMessage = { + type: "PAGE_METADATA", + payload: parseMetadata(), + }; + chrome.runtime.sendMessage(message).catch(() => { + // Service worker may be inactive — silently ignore + }); +} + +// Send on initial load +sendMetadata(); + +// Re-send on SPA navigation +window.addEventListener("popstate", sendMetadata); +window.addEventListener("hashchange", sendMetadata); diff --git a/extension/src/types/content.ts b/extension/src/types/content.ts new file mode 100644 index 0000000..bccae5c --- /dev/null +++ b/extension/src/types/content.ts @@ -0,0 +1,8 @@ +export interface PageMetadata { + url: string; + title: string; + metaDescription: string | null; + headings: string[]; // h1–h3 text content +} + +export type ContentMessage = { type: "PAGE_METADATA"; payload: PageMetadata }; diff --git a/extension/src/types/session.ts b/extension/src/types/session.ts new file mode 100644 index 0000000..5da74da --- /dev/null +++ b/extension/src/types/session.ts @@ -0,0 +1,14 @@ +export interface Session { + id: string; + startedAt: number; // Unix ms + totalActiveMs: number; // accumulated active time (for future pause support) +} + +export type SessionMessage = + | { type: "SESSION_START" } + | { type: "SESSION_STOP" } + | { type: "SESSION_GET_STATE" }; + +export type SessionResponse = + | { success: true; session: Session | null } + | { success: false; error: string }; diff --git a/plans/week2/AC2-AC3-content-sessions.md b/plans/week2/AC2-AC3-content-sessions.md new file mode 100644 index 0000000..aed7d10 --- /dev/null +++ b/plans/week2/AC2-AC3-content-sessions.md @@ -0,0 +1,197 @@ +# Plan: Week 2 AC 2+3 — Content Script + Session Manager + +**Branch:** `feature/extension-content-sessions` +**Closes:** Week 2 AC 2, AC 3 ([docs/Task.md L75–L77](../../docs/Task.md#L75)) +**Status:** implemented — gaps identified, see section below + +--- + +## Scope + +**AC 2 — Content Script:** парсить технічний контент поточної сторінки (url, title, meta description, h1–h3) і надсилає до service worker. + +**AC 3 — Session Manager:** старт/стоп сесії вручну, таймер активного часу, збереження стану у `chrome.storage.local` з відновленням після рестарту service worker. + +Разом вони формують **pipeline збору даних**: content script знає *що* зібрати, session manager знає *коли* це актуально. AC 5 (Data Sync) з'єднає їх з API. + +--- + +## Commits (ordered) + +``` +docs(plans): add week 2 AC 2+3 content script and session manager plan +feat(extension): add content script page metadata parser (AC 2) +feat(extension): add session manager with start/stop/timer and storage (AC 3) +``` + +--- + +## Files + +| File | Action | Commit | +|---|---|---| +| `plans/week2/AC2-AC3-content-sessions.md` | **new** | commit 1 | +| `extension/src/types/content.ts` | **new** | commit 2 | +| `extension/src/content/index.ts` | **rewrite** | commit 2 | +| `extension/src/types/session.ts` | **new** | commit 3 | +| `extension/src/background/session.ts` | **new** | commit 3 | +| `extension/src/background/index.ts` | modify — add session message handlers | commit 3 | + +--- + +## Design decisions + +### AC 2 — Content Script + +#### 1. Що парсимо і як + +``` +url → window.location.href +title → document.title +metaDescription → document.querySelector('meta[name="description"]')?.content ?? null +headings → Array.from(document.querySelectorAll("h1, h2, h3")) + .map(el => el.textContent?.trim()) + .filter(Boolean) +``` + +Все в один об'єкт `PageMetadata`, надсилається через `chrome.runtime.sendMessage`. + +#### 2. Коли надсилати + +- При завантаженні (`document_idle` — вже є в manifest) +- При зміні URL у SPA: слухаємо `popstate` + `hashchange` + +Без polling — event-driven підхід, без зайвих запитів. + +#### 3. Чи відправляємо якщо немає активної сесії? + +Ні — background ігнорує `PAGE_METADATA` якщо `session === null`. Це означає content script завжди надсилає (дешево), а фільтрація на стороні background. + +--- + +### AC 3 — Session Manager + +#### 4. Структура Session + +```ts +interface Session { + id: string; // crypto.randomUUID() + startedAt: number; // Unix ms + totalActiveMs: number; // накопичений активний час (для паузи в AC 4) +} +``` + +Таймер **не зберігає `endedAt`** — поточний elapsed розраховується як: +``` +elapsed = totalActiveMs + (Date.now() - startedAt) +``` + +Це безпечно після рестарту SW: значення `startedAt` і `totalActiveMs` є в storage. + +#### 5. Persistence: чому storage, а не тільки пам'ять + +MV3 service worker може бути зупинений браузером у будь-який момент. Якщо сесія тільки в пам'яті — після рестарту вона зникає. Тому `Session` одразу пишеться в `chrome.storage.local` і читається при старті. + +#### 6. Модульність: `background/session.ts` окремо від `index.ts` + +`index.ts` залишається orchestrator (слухає повідомлення, делегує). Вся логіка сесій — у `session.ts`. Так само `apiFetch` / auth — теж уже там. Це підготовка до AC 5 де буде ще батчинг подій. + +#### 7. `chrome.storage.local` ключі для сесії + +``` +activeSession: Session | null +``` + +Один ключ із повним об'єктом — атомарний read/write, без race conditions між кількома `set` викликами. + +#### 8. Message types + +```ts +type SessionMessage = + | { type: "SESSION_START" } + | { type: "SESSION_STOP" } + | { type: "SESSION_GET_STATE" }; + +type SessionResponse = + | { success: true; session: Session | null } + | { success: false; error: string }; +``` + +Popup (AC 4) використовуватиме `SESSION_GET_STATE` для відображення таймера і статусу. + +--- + +## Verification checklist + +- [ ] `cd extension && npx tsc --noEmit` — без помилок +- [ ] `npm run build` — без помилок +- [ ] `SESSION_START` → session з'являється в `chrome.storage.local` +- [ ] `SESSION_STOP` → `activeSession: null` в storage +- [ ] `SESSION_GET_STATE` → повертає поточну сесію або null +- [ ] `PAGE_METADATA` надсилається при load і при навігації в SPA +- [ ] `PAGE_METADATA` ігнорується якщо сесія не активна + +--- + +## Out of scope + +- Пауза сесії — AC 4 (потрібна кнопка в popup) +- Відправка зібраних подій на API — AC 5 +- Відображення таймера і статусу — AC 4 + +--- + +## ⚠️ Gaps identified after implementation (впливають на AC 4 і AC 5) + +### Gap 1 — PAUSE/RESUME відсутні в session.ts → блокер для AC 4 + +AC 4 вимагає "кнопку паузи збору". Логіка паузи — в `background/session.ts`, а не в попапі. `totalActiveMs` вже готовий для цього, але `SESSION_PAUSE` / `SESSION_RESUME` повідомлень і методів у `session.ts` немає. + +**Рішення для AC 4:** у тому самому `session.ts` додати: +```ts +export async function pauseSession(): Promise +export async function resumeSession(): Promise +``` +При паузі: `totalActiveMs += Date.now() - startedAt`, `startedAt = null`. +При відновленні: `startedAt = Date.now()`. +Потрібно розширити тип `Session` полем `pausedAt: number | null`. + +--- + +### Gap 2 — Немає `POST /api/v1/sessions` → блокер для AC 5 + +Task.md не описує цей endpoint, але він необхідний: `Event.sessionId` — FK до `Session` у БД. Локальний `session.id = crypto.randomUUID()` ≠ CUID з БД. + +**Рішення для AC 5:** +- Додати `POST /api/v1/sessions` (створює Session в БД, повертає `{ id }`) +- Додати `PATCH /api/v1/sessions/:id` (закриває сесію — записує `endedAt`) +- При `SESSION_START` у service worker → одразу викликати `apiFetch("/api/v1/sessions", { method: "POST" })` і зберегти DB-шний `sessionId` поруч з локальною сесією + +Розширення локального типу: +```ts +interface Session { + id: string; // локальний UUID + dbSessionId: string | null; // CUID з БД, null до першого sync + ... +} +``` + +--- + +### Gap 3 — Нотатки з AC 4 popup нікуди не потраплять + +AC 4: "поле для швидких нотаток і тегів". Модель `Session` не має поля `notes`. Модель `Event` має `content: String?` і `tags: String[]`. + +**Рішення:** нотатку зберігати як окремий `Event` з `tags: ["note"]` і `content: <текст нотатки>`. Не потрібна міграція схеми. + +--- + +### Gap 4 — Формат `Event.content` не визначено + +`Event.content: String?` є в схемі, але Task.md не описує що туди класти. По логіці з `PageMetadata`: + +``` +content = [metaDescription, ...headings].filter(Boolean).join(" | ") +``` + +Фіксуємо цей формат тут, щоб AC 5 і Week 3 dashboard читали однаково. From 68bc2abb69e7a9825518bf39b0f2e853709801bc Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Fri, 22 May 2026 01:13:54 +0300 Subject: [PATCH 09/24] feat(extension): popup UI with session controls, auth flow, and notes (Week 2 AC 4) (#9) * docs(plans): add week 2 AC 4 popup UI plan * feat(extension): add session pause/resume to session manager (Gap 1 from AC 3) * feat(extension): implement popup UI with session controls and timer (AC 4) * docs(backlog): add email and password auth plan with smtp verification * feat(extension): add logout button and note save feedback to popup * feat(extension): add dev mode fake auth bypass via VITE_DEV_MODE --- extension/.env.example | 5 + extension/src/background/index.ts | 80 ++++++- extension/src/background/session.ts | 28 +++ extension/src/popup/index.html | 58 ++++- extension/src/popup/popup.css | 317 ++++++++++++++++++++++++--- extension/src/popup/popup.ts | 223 +++++++++++++++++-- extension/src/types/session.ts | 16 +- plans/backlog/email-password-auth.md | 134 +++++++++++ plans/week2/AC4-popup.md | 120 ++++++++++ 9 files changed, 926 insertions(+), 55 deletions(-) create mode 100644 plans/backlog/email-password-auth.md create mode 100644 plans/week2/AC4-popup.md diff --git a/extension/.env.example b/extension/.env.example index 867e941..fd8a15f 100644 --- a/extension/.env.example +++ b/extension/.env.example @@ -10,3 +10,8 @@ VITE_DASHBOARD_URL="http://localhost:3000" # Application ID: your unpacked extension ID from chrome://extensions # → copy the generated Client ID here (same value as GOOGLE_CLIENT_ID in dashboard/.env) VITE_GOOGLE_CLIENT_ID="" + +# ─── Dev mode ─────────────────────────────────────────────────────────────────── +# true → "Sign in" bypasses Google OAuth and stores a fake JWT (for local UI testing) +# false → real Google OAuth flow (requires valid VITE_GOOGLE_CLIENT_ID + GCC setup) +VITE_DEV_MODE="false" diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index c627ae0..6fa8bd4 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -5,11 +5,14 @@ import { getSession, startSession, stopSession, + pauseSession, + resumeSession, getElapsedMs, } from "./session"; const DASHBOARD_URL = import.meta.env.VITE_DASHBOARD_URL as string; const GOOGLE_CLIENT_ID = import.meta.env.VITE_GOOGLE_CLIENT_ID as string; +const DEV_MODE = import.meta.env.VITE_DEV_MODE === "true"; const EXPIRY_BUFFER_MS = 60_000; // ─── Storage ─────────────────────────────────────────────────────────────────── @@ -114,6 +117,17 @@ type IncomingMessage = AuthMessage | SessionMessage | ContentMessage; chrome.runtime.onMessage.addListener( (message: IncomingMessage, _sender, sendResponse: (r: AuthResponse | SessionResponse) => void) => { if (message.type === "AUTH_LOGIN") { + if (DEV_MODE) { + storeAuth("dev.fake.jwt", Date.now() + 7 * 24 * 60 * 60 * 1000) + .then(() => sendResponse({ success: true, jwt: "dev.fake.jwt" })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } ensureAuthenticated() .then((jwt) => sendResponse({ success: true, jwt })) .catch((err: unknown) => @@ -158,7 +172,12 @@ chrome.runtime.onMessage.addListener( if (message.type === "SESSION_START") { startSession() - .then((session) => sendResponse({ success: true, session })) + .then((session) => + sendResponse({ + success: true, + session: { ...session, elapsedMs: getElapsedMs(session) }, + }), + ) .catch((err: unknown) => sendResponse({ success: false, @@ -170,7 +189,12 @@ chrome.runtime.onMessage.addListener( if (message.type === "SESSION_STOP") { stopSession() - .then((session) => sendResponse({ success: true, session })) + .then((session) => + sendResponse({ + success: true, + session: session ? { ...session, elapsedMs: getElapsedMs(session) } : null, + }), + ) .catch((err: unknown) => sendResponse({ success: false, @@ -203,6 +227,58 @@ chrome.runtime.onMessage.addListener( return true; } + if (message.type === "SESSION_PAUSE") { + pauseSession() + .then((session) => + sendResponse({ + success: true, + session: session ? { ...session, elapsedMs: getElapsedMs(session) } : null, + }), + ) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "SESSION_RESUME") { + resumeSession() + .then((session) => + sendResponse({ + success: true, + session: session ? { ...session, elapsedMs: getElapsedMs(session) } : null, + }), + ) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "NOTE_ADD") { + getSession().then((session) => { + if (!session || session.pausedAt !== null) return; + chrome.storage.local.get("pendingEvents").then((r) => { + const pending = (r["pendingEvents"] as unknown[]) ?? []; + pending.push({ + url: "", + title: "Note", + content: message.text, + tags: ["note", ...message.tags], + timestamp: new Date().toISOString(), + }); + chrome.storage.local.set({ pendingEvents: pending }); + }); + }); + return false; + } + // ─── Content script messages ───────────────────────────────────────────── if (message.type === "PAGE_METADATA") { diff --git a/extension/src/background/session.ts b/extension/src/background/session.ts index a9b6a27..fa27fc3 100644 --- a/extension/src/background/session.ts +++ b/extension/src/background/session.ts @@ -21,6 +21,7 @@ async function clearSession(): Promise { // Elapsed ms is derived from stored values — safe after SW restart export function getElapsedMs(session: Session): number { + if (session.pausedAt !== null) return session.totalActiveMs; // frozen while paused return session.totalActiveMs + (Date.now() - session.startedAt); } @@ -34,6 +35,7 @@ export async function startSession(): Promise { id: crypto.randomUUID(), startedAt: Date.now(), totalActiveMs: 0, + pausedAt: null, }; await saveSession(session); return session; @@ -45,3 +47,29 @@ export async function stopSession(): Promise { await clearSession(); return session; } + +export async function pauseSession(): Promise { + const session = await getSession(); + if (!session || session.pausedAt !== null) return session; // idempotent + + const updated: Session = { + ...session, + totalActiveMs: session.totalActiveMs + (Date.now() - session.startedAt), + pausedAt: Date.now(), + }; + await saveSession(updated); + return updated; +} + +export async function resumeSession(): Promise { + const session = await getSession(); + if (!session || session.pausedAt === null) return session; // idempotent + + const updated: Session = { + ...session, + startedAt: Date.now(), + pausedAt: null, + }; + await saveSession(updated); + return updated; +} diff --git a/extension/src/popup/index.html b/extension/src/popup/index.html index 068fed1..dafcacf 100644 --- a/extension/src/popup/index.html +++ b/extension/src/popup/index.html @@ -7,14 +7,58 @@ -
-

WorkTrace

-
-

Checking...

- - +
+ + +
+ +
+
+ + IDLE +
+ +
+
+ + +
+ +
+ + +
+
00:00:00
+
+ + + +
+
+ + +
+ ⚡ + 0 events queued
-
+ + +
+
+ + +
+
+ + +
+ +
+ + diff --git a/extension/src/popup/popup.css b/extension/src/popup/popup.css index cc10e08..7dbd01e 100644 --- a/extension/src/popup/popup.css +++ b/extension/src/popup/popup.css @@ -1,39 +1,306 @@ +/* ─── Tokens ─────────────────────────────────────────────────────────────────── */ :root { - color-scheme: light dark; - font-family: - system-ui, - -apple-system, - "Segoe UI", - Roboto, - sans-serif; + --c-cyan: #00e5b0; + --c-purple: #7c3aff; + --c-yellow: #f0d000; + --c-pink: #ff0070; + --c-bg: #080812; + --c-surface:#0f0f20; + --c-border: #1c1c38; + --c-text: #c8d0f0; + --c-muted: #3e3e60; } -html, -body { - margin: 0; - padding: 0; -} +/* ─── Reset ──────────────────────────────────────────────────────────────────── */ +*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; } body { width: 320px; - min-height: 200px; - background: #0f172a; - color: #e2e8f0; + background: var(--c-bg); + color: var(--c-text); + font-family: "Courier New", Courier, monospace; + font-size: 12px; + letter-spacing: 0.03em; +} + +/* ═══════════════════════════════════════════════════════════════════════════════ + BLOCK: popup +═══════════════════════════════════════════════════════════════════════════════ */ +.popup { + padding: 16px; + display: flex; + flex-direction: column; + gap: 12px; +} + +/* ── popup__header ─────────────────────────────────────────────────────────── */ +.popup__header { + display: flex; + align-items: center; + justify-content: space-between; +} + +.popup__logo { + display: flex; + align-items: center; + gap: 6px; +} + +.popup__logo-icon { + font-size: 17px; + color: var(--c-cyan); + filter: drop-shadow(0 0 4px var(--c-cyan)); +} + +.popup__logo-text { + font-size: 13px; + font-weight: 700; + color: var(--c-cyan); + text-shadow: 0 0 6px color-mix(in srgb, var(--c-cyan) 60%, transparent); +} + +/* ── popup__status ─────────────────────────────────────────────────────────── */ +.popup__header-right { + display: flex; + align-items: center; + gap: 6px; +} + +.popup__status { + display: flex; + align-items: center; + gap: 6px; + background: var(--c-surface); + border: 1px solid var(--c-border); + border-radius: 20px; + padding: 3px 10px; +} + +.popup__status-dot { + width: 7px; + height: 7px; + border-radius: 50%; + background: var(--c-muted); + transition: background 0.3s, box-shadow 0.3s; +} + +.popup__status-dot--active { + background: var(--c-cyan); + box-shadow: 0 0 5px var(--c-cyan); + animation: dot-pulse 2s infinite; +} + +.popup__status-dot--paused { + background: var(--c-yellow); + box-shadow: 0 0 5px var(--c-yellow); +} + +.popup__status-label { + font-size: 10px; + font-weight: 700; + color: var(--c-muted); + transition: color 0.3s; +} + +.popup__status-label--active { color: var(--c-cyan); } +.popup__status-label--paused { color: var(--c-yellow); } + +@keyframes dot-pulse { + 0%, 100% { opacity: 1; } + 50% { opacity: 0.3; } +} + +/* ── popup__auth ───────────────────────────────────────────────────────────── */ +.popup__auth { + display: flex; + justify-content: center; + padding: 6px 0; +} + +/* ── popup__timer ──────────────────────────────────────────────────────────── */ +.popup__timer { + display: flex; + flex-direction: column; + align-items: center; + gap: 12px; + padding: 8px 0 2px; +} + +/* ── popup__time ───────────────────────────────────────────────────────────── */ +.popup__time { + font-size: 42px; + font-weight: 700; + letter-spacing: 0.05em; + color: var(--c-muted); + transition: color 0.3s, text-shadow 0.3s; +} + +.popup__time--active { + color: var(--c-cyan); + text-shadow: 0 0 12px color-mix(in srgb, var(--c-cyan) 50%, transparent); +} + +.popup__time--paused { + color: var(--c-yellow); + text-shadow: 0 0 10px color-mix(in srgb, var(--c-yellow) 40%, transparent); +} + +/* ── popup__controls ───────────────────────────────────────────────────────── */ +.popup__controls { + display: flex; + gap: 8px; +} + +/* ── popup__sync ───────────────────────────────────────────────────────────── */ +.popup__sync { + display: flex; + align-items: center; + gap: 6px; + background: var(--c-surface); + border: 1px solid var(--c-border); + border-radius: 4px; + padding: 6px 10px; + font-size: 11px; + color: var(--c-muted); + transition: border-color 0.3s, color 0.3s; +} + +.popup__sync-icon { color: var(--c-yellow); } + +.popup__sync--has-events { + border-color: color-mix(in srgb, var(--c-yellow) 25%, transparent); + color: var(--c-yellow); +} + +/* ── popup__notes ──────────────────────────────────────────────────────────── */ +.popup__notes { + display: flex; + flex-direction: column; + gap: 8px; + border-top: 1px solid var(--c-border); + padding-top: 12px; +} + +/* ── popup__field ──────────────────────────────────────────────────────────── */ +.popup__field { + display: grid; + grid-template-columns: 40px 1fr; + align-items: center; + gap: 8px; } -main { - padding: 20px 24px; +.popup__field-label { + font-size: 10px; + font-weight: 700; + color: var(--c-muted); } -h1 { - margin: 0 0 8px; - font-size: 18px; - font-weight: 600; - letter-spacing: -0.01em; +.popup__field-input { + background: var(--c-surface); + border: 1px solid var(--c-border); + border-radius: 4px; + color: var(--c-text); + font-family: inherit; + font-size: 11px; + padding: 5px 8px; + outline: none; + transition: border-color 0.2s, box-shadow 0.2s; } -p { - margin: 0; +.popup__field-input::placeholder { color: var(--c-muted); } + +.popup__field-input:focus { + border-color: color-mix(in srgb, var(--c-purple) 70%, transparent); + box-shadow: 0 0 6px color-mix(in srgb, var(--c-purple) 20%, transparent); +} + +/* ═══════════════════════════════════════════════════════════════════════════════ + BLOCK: btn +═══════════════════════════════════════════════════════════════════════════════ */ +.btn { + background: transparent; + border: 1px solid var(--c-muted); + color: var(--c-muted); + border-radius: 4px; + padding: 6px 12px; + font-family: inherit; + font-size: 11px; + font-weight: 700; + letter-spacing: 0.05em; + cursor: pointer; + transition: background 0.15s, border-color 0.15s, color 0.15s, box-shadow 0.15s; +} + +.btn:disabled { + opacity: 0.2; + cursor: not-allowed; +} + +/* btn--primary */ +.btn--primary { + border-color: var(--c-purple); + color: var(--c-purple); + width: 100%; + padding: 10px; + font-size: 12px; +} + +.btn--primary:hover:not(:disabled) { + background: color-mix(in srgb, var(--c-purple) 10%, transparent); + box-shadow: 0 0 10px color-mix(in srgb, var(--c-purple) 20%, transparent); +} + +/* btn--start */ +.btn--start:not(:disabled) { + border-color: var(--c-cyan); + color: var(--c-cyan); +} + +.btn--start:hover:not(:disabled) { + background: color-mix(in srgb, var(--c-cyan) 8%, transparent); + box-shadow: 0 0 8px color-mix(in srgb, var(--c-cyan) 20%, transparent); +} + +/* btn--pause */ +.btn--pause:not(:disabled) { + border-color: var(--c-yellow); + color: var(--c-yellow); +} + +.btn--pause:hover:not(:disabled) { + background: color-mix(in srgb, var(--c-yellow) 8%, transparent); +} + +/* btn--stop */ +.btn--stop:not(:disabled) { + border-color: var(--c-pink); + color: var(--c-pink); +} + +.btn--stop:hover:not(:disabled) { + background: color-mix(in srgb, var(--c-pink) 8%, transparent); +} + +/* btn--logout */ +.btn--logout { + border-color: transparent; + color: var(--c-muted); + padding: 3px 6px; font-size: 13px; - color: #94a3b8; +} + +.btn--logout:hover { + color: var(--c-pink); + border-color: color-mix(in srgb, var(--c-pink) 30%, transparent); +} + +/* btn--note */ +.btn--note { + border-color: var(--c-purple); + color: var(--c-purple); + width: 100%; +} + +.btn--note:hover:not(:disabled) { + background: color-mix(in srgb, var(--c-purple) 8%, transparent); } diff --git a/extension/src/popup/popup.ts b/extension/src/popup/popup.ts index b5d394d..60d381b 100644 --- a/extension/src/popup/popup.ts +++ b/extension/src/popup/popup.ts @@ -1,31 +1,218 @@ import type { AuthMessage, AuthResponse } from "../types/auth"; +import type { SessionMessage, SessionResponse, SessionState } from "../types/session"; -function sendMessage(message: AuthMessage): Promise { - return new Promise((resolve) => { - chrome.runtime.sendMessage(message, resolve); - }); +// ─── Messaging helpers ───────────────────────────────────────────────────────── + +function sendAuth(msg: AuthMessage): Promise { + return new Promise((resolve, reject) => + chrome.runtime.sendMessage(msg, (res: AuthResponse | undefined) => { + if (chrome.runtime.lastError) return reject(new Error(chrome.runtime.lastError.message)); + if (!res) return reject(new Error("No response from background")); + resolve(res); + }), + ); +} + +function sendSession(msg: SessionMessage): Promise { + return new Promise((resolve, reject) => + chrome.runtime.sendMessage(msg, (res: SessionResponse | undefined) => { + if (chrome.runtime.lastError) return reject(new Error(chrome.runtime.lastError.message)); + if (!res) return reject(new Error("No response from background")); + resolve(res); + }), + ); } -const statusEl = document.getElementById("auth-status") as HTMLParagraphElement; -const btnLogin = document.getElementById("btn-login") as HTMLButtonElement; -const btnLogout = document.getElementById("btn-logout") as HTMLButtonElement; +// ─── DOM refs ────────────────────────────────────────────────────────────────── + +const statusDot = document.getElementById("status-dot") as HTMLSpanElement; +const statusLabel = document.getElementById("status-label") as HTMLSpanElement; +const authSection = document.getElementById("auth-section") as HTMLElement; +const timerSection = document.getElementById("timer-section") as HTMLElement; +const timerEl = document.getElementById("timer") as HTMLDivElement; +const btnLogin = document.getElementById("btn-login") as HTMLButtonElement; +const btnLogout = document.getElementById("btn-logout") as HTMLButtonElement; +const btnStart = document.getElementById("btn-start") as HTMLButtonElement; +const btnPause = document.getElementById("btn-pause") as HTMLButtonElement; +const btnStop = document.getElementById("btn-stop") as HTMLButtonElement; +const syncEl = document.getElementById("sync-indicator") as HTMLDivElement; +const syncLabel = document.getElementById("sync-label") as HTMLSpanElement; +const noteInput = document.getElementById("note-input") as HTMLInputElement; +const tagsInput = document.getElementById("tags-input") as HTMLInputElement; +const btnNote = document.getElementById("btn-note") as HTMLButtonElement; + +// ─── Timer formatting ────────────────────────────────────────────────────────── + +function formatMs(ms: number): string { + const totalSec = Math.floor(ms / 1000); + const h = Math.floor(totalSec / 3600); + const m = Math.floor((totalSec % 3600) / 60); + const s = totalSec % 60; + return [h, m, s].map((n) => String(n).padStart(2, "0")).join(":"); +} + +// ─── UI state ────────────────────────────────────────────────────────────────── + +type UIState = "idle" | "active" | "paused"; + +function applyState(state: UIState, elapsedMs = 0): void { + timerEl.textContent = state === "idle" ? "00:00:00" : formatMs(elapsedMs); + + timerEl.className = `popup__time popup__time--${state}`; + statusDot.className = `popup__status-dot${state !== "idle" ? ` popup__status-dot--${state}` : ""}`; + statusLabel.className = `popup__status-label${state !== "idle" ? ` popup__status-label--${state}` : ""}`; + statusLabel.textContent = state.toUpperCase(); + + btnStart.disabled = state !== "idle"; + btnPause.disabled = state === "idle"; + btnStop.disabled = state === "idle"; + btnPause.textContent = state === "paused" ? "▶ RESUME" : "⏸ PAUSE"; + btnNote.disabled = state !== "active"; +} + +function showAuthenticated(): void { + authSection.style.display = "none"; + timerSection.style.display = "flex"; + btnLogout.hidden = false; +} + +function showUnauthenticated(): void { + authSection.style.display = "flex"; + timerSection.style.display = "none"; + btnLogout.hidden = true; + stopPolling(); + applyState("idle"); +} + +async function refreshSyncIndicator(): Promise { + const r = await chrome.storage.local.get("pendingEvents"); + const count = ((r["pendingEvents"] as unknown[]) ?? []).length; + syncLabel.textContent = `${count} event${count !== 1 ? "s" : ""} queued`; + syncEl.classList.toggle("popup__sync--has-events", count > 0); +} + +// ─── Session polling ─────────────────────────────────────────────────────────── + +let pollInterval: ReturnType | null = null; + +function startPolling(): void { + if (pollInterval) return; + pollInterval = setInterval(async () => { + const res = await sendSession({ type: "SESSION_GET_STATE" }).catch(() => null); + if (!res || !res.success || !("session" in res)) return; + const session = res.session as SessionState | null; + if (!session) { + applyState("idle"); + } else if (session.pausedAt !== null) { + applyState("paused", session.elapsedMs); + } else { + applyState("active", session.elapsedMs); + } + await refreshSyncIndicator(); + }, 1000); +} + +function stopPolling(): void { + if (pollInterval) clearInterval(pollInterval); + pollInterval = null; +} -// Check auth status when popup opens -sendMessage({ type: "AUTH_GET_STATUS" }).then((res) => { - if (res.success && "isAuthenticated" in res) { - statusEl.textContent = res.isAuthenticated ? "✅ Signed in" : "❌ Not signed in"; +// ─── Auth flow ───────────────────────────────────────────────────────────────── + +async function init(): Promise { + const authRes = await sendAuth({ type: "AUTH_GET_STATUS" }).catch(() => null); + + if (!authRes || !authRes.success || !("isAuthenticated" in authRes) || !authRes.isAuthenticated) { + showUnauthenticated(); + return; + } + + showAuthenticated(); + + const res = await sendSession({ type: "SESSION_GET_STATE" }).catch(() => null); + if (res?.success && "session" in res) { + const session = res.session as SessionState | null; + if (!session) applyState("idle"); + else if (session.pausedAt !== null) applyState("paused", session.elapsedMs); + else applyState("active", session.elapsedMs); } -}); + + await refreshSyncIndicator(); + startPolling(); +} + +// ─── Controls ───────────────────────────────────────────────────────────────── btnLogin.addEventListener("click", async () => { btnLogin.disabled = true; - statusEl.textContent = "Signing in..."; - const res = await sendMessage({ type: "AUTH_LOGIN" }); - statusEl.textContent = res.success ? "✅ Signed in" : `❌ ${!res.success ? res.error : ""}`; - btnLogin.disabled = false; + btnLogin.textContent = "Signing in..."; + const res = await sendAuth({ type: "AUTH_LOGIN" }).catch(() => null); + if (res?.success) { + await init(); + } else { + btnLogin.disabled = false; + btnLogin.textContent = "Sign in with Google"; + } }); btnLogout.addEventListener("click", async () => { - await sendMessage({ type: "AUTH_LOGOUT" }); - statusEl.textContent = "❌ Not signed in"; + await sendAuth({ type: "AUTH_LOGOUT" }).catch(() => null); + showUnauthenticated(); +}); + +btnStart.addEventListener("click", async () => { + await sendSession({ type: "SESSION_START" }); + applyState("active", 0); + startPolling(); }); + +btnPause.addEventListener("click", async () => { + const isPaused = btnPause.textContent?.includes("RESUME"); + if (isPaused) { + const res = await sendSession({ type: "SESSION_RESUME" }); + if (res.success && "session" in res && res.session) { + applyState("active", res.session.elapsedMs); + } + } else { + const res = await sendSession({ type: "SESSION_PAUSE" }); + if (res.success && "session" in res && res.session) { + applyState("paused", res.session.elapsedMs); + } + } +}); + +btnStop.addEventListener("click", async () => { + await sendSession({ type: "SESSION_STOP" }); + stopPolling(); + applyState("idle"); + await refreshSyncIndicator(); +}); + +btnNote.addEventListener("click", async () => { + const text = noteInput.value.trim(); + if (!text) return; + const tags = tagsInput.value + .split(",") + .map((t) => t.trim()) + .filter(Boolean); + + await sendSession({ type: "NOTE_ADD", text, tags }); + noteInput.value = ""; + tagsInput.value = ""; + + // Visual feedback + const prev = btnNote.textContent; + btnNote.textContent = "✓ SAVED"; + btnNote.disabled = true; + setTimeout(() => { + btnNote.textContent = prev; + btnNote.disabled = false; + }, 1500); + + await refreshSyncIndicator(); +}); + +// ─── Boot ────────────────────────────────────────────────────────────────────── + +window.addEventListener("unload", stopPolling); +void init(); diff --git a/extension/src/types/session.ts b/extension/src/types/session.ts index 5da74da..93597b3 100644 --- a/extension/src/types/session.ts +++ b/extension/src/types/session.ts @@ -1,14 +1,24 @@ export interface Session { id: string; startedAt: number; // Unix ms - totalActiveMs: number; // accumulated active time (for future pause support) + totalActiveMs: number; // accumulated active time + pausedAt: number | null; // null = active, number = paused since +} + +// Returned by SESSION_GET_STATE — includes computed elapsed +export interface SessionState extends Session { + elapsedMs: number; } export type SessionMessage = | { type: "SESSION_START" } | { type: "SESSION_STOP" } - | { type: "SESSION_GET_STATE" }; + | { type: "SESSION_GET_STATE" } + | { type: "SESSION_PAUSE" } + | { type: "SESSION_RESUME" } + | { type: "NOTE_ADD"; text: string; tags: string[] }; export type SessionResponse = - | { success: true; session: Session | null } + | { success: true; session: SessionState | null } + | { success: true } | { success: false; error: string }; diff --git a/plans/backlog/email-password-auth.md b/plans/backlog/email-password-auth.md new file mode 100644 index 0000000..43dd200 --- /dev/null +++ b/plans/backlog/email-password-auth.md @@ -0,0 +1,134 @@ +# Backlog: Email + Password Auth (альтернатива Google OAuth) + +**Пріоритет:** обов'язково, після Week 2–3 +**Залежить від:** Week 3 AC 1 (middleware + JWT вже є) +**Статус:** не розпочато + +--- + +## Мета + +Дати можливість реєструватись і логінитись через email + пароль без Google акаунту. Один акаунт на один email. Реєстрація підтверджується листом на пошту. + +--- + +## Scope + +### Dashboard (Next.js) + +**Нові Route Handlers:** + +| Endpoint | Що робить | +| -------------------------------- | ---------------------------------------------------------------------------- | +| `POST /api/auth/register` | Реєстрація: email + password → хеш → User у БД → надсилає verification email | +| `POST /api/auth/verify-email` | Приймає токен з листа → позначає email як підтверджений | +| `POST /api/auth/login` | email + password → перевіряє хеш → видає JWT | +| `POST /api/auth/login/extension` | Те саме але для extension (повертає JWT в тілі відповіді) | + +**Зміни в Prisma-схемі:** +```prisma +model User { + // ... існуючі поля + passwordHash String? // null якщо реєстрація через Google + emailVerified Boolean @default(false) + verificationToken String? // одноразовий токен для підтвердження + verificationExp DateTime? // термін дії токену +} +``` +→ потрібна міграція + +**Нові server-модулі:** +- `dashboard/server/password.ts` — `hashPassword`, `verifyPassword` (bcrypt або argon2) +- `dashboard/server/mailer.ts` — SMTP клієнт (nodemailer), `sendVerificationEmail` + +### Extension + +Альтернативний UI в popup: форма email + password замість (або поруч з) "Sign in with Google". + +--- + +## Технічний стек + +| Що | Пакет | +| ----------------- | ------------------------------------------- | +| Хешування паролів | `bcryptjs` (pure JS, без native deps) | +| SMTP | `nodemailer` | +| Email-провайдер | Mailtrap (dev) / Resend або SendGrid (prod) | + +--- + +## SMTP — що треба налаштувати + +**Dev (Mailtrap):** +```env +SMTP_HOST=sandbox.smtp.mailtrap.io +SMTP_PORT=2525 +SMTP_USER= +SMTP_PASS= +SMTP_FROM=noreply@worktrace.dev +``` +Mailtrap перехоплює всі листи — не відправляє реальним юзерам. Безпечно для розробки. + +**Prod (Resend — безкоштовний tier: 3000 листів/міс):** +```env +SMTP_HOST=smtp.resend.com +SMTP_PORT=465 +SMTP_USER=resend +SMTP_PASS= +``` + +--- + +## Сценарій: реєстрація з підтвердженням email + +``` +1. Юзер вводить email + password → POST /api/auth/register +2. Сервер: bcrypt.hash(password) → зберігає User { emailVerified: false, verificationToken: uuid, verificationExp: now+24h } +3. Сервер: nodemailer надсилає лист з посиланням: + https://worktrace.app/api/auth/verify-email?token= +4. Юзер клікає посилання → GET /api/auth/verify-email?token=... +5. Сервер: перевіряє token + exp → User.emailVerified = true, видаляє token +6. Юзер логіниться: POST /api/auth/login → email + password → bcrypt.compare → JWT +``` + +--- + +## Сценарій: логін в extension + +``` +1. Popup показує форму: email + password +2. Юзер вводить → popup надсилає NOTE_ADD (або новий тип) до background +3. Background: POST /api/auth/login/extension { email, password } +4. Dashboard: верифікує → повертає { token: JWT } +5. Background: зберігає JWT в chrome.storage.local (той самий формат що і Google OAuth) +``` + +--- + +## Зміни в popup + +Додати вкладки або toggle: +``` +[Google] [Email] +───────────────── +Email: [__________] +Password: [__________] + [Sign In] + [Register] +``` + +--- + +## Out of scope для цього backlog-item + +- Forgot password / reset (окремий backlog) +- 2FA +- OAuth провайдери крім Google +- Rate limiting на auth endpoints (хоча бажано) + +--- + +## Коли робити + +Після Week 3 (коли middleware і JWT flow вже стабільні). Не блокує Week 2–3. +Орієнтовно: між Week 3 і Week 4, або як окремий PR після Week 4. diff --git a/plans/week2/AC4-popup.md b/plans/week2/AC4-popup.md new file mode 100644 index 0000000..dec090f --- /dev/null +++ b/plans/week2/AC4-popup.md @@ -0,0 +1,120 @@ +# Plan: Week 2 AC 4 — Popup UI + +**Branch:** `feature/extension-popup` +**Closes:** Week 2 AC 4 ([docs/Task.md L77](../../docs/Task.md#L77)) +**Status:** plan, awaiting review + +--- + +## Scope + +**AC 4 — Popup UI:** відображає статус сесії, таймер, індикатор синхронізації, кнопку паузи, поле нотаток і тегів. + +Також закриває **Gap 1** з AC 3 плану: `SESSION_PAUSE` / `SESSION_RESUME` — логіка в `session.ts`, тригер у попапі. + +--- + +## Commits (ordered) + +``` +docs(plans): add week 2 AC 4 popup UI plan +feat(extension): add session pause/resume to session manager (Gap 1 from AC 3) +feat(extension): implement popup UI with session controls, timer, notes and tags (AC 4) +``` + +--- + +## Files + +| File | Action | Commit | +|---|---|---| +| `plans/week2/AC4-popup.md` | **new** | commit 1 | +| `extension/src/types/session.ts` | modify — add `pausedAt`, `SESSION_PAUSE/RESUME` | commit 2 | +| `extension/src/background/session.ts` | modify — add `pauseSession`, `resumeSession` | commit 2 | +| `extension/src/background/index.ts` | modify — add PAUSE/RESUME message handlers | commit 2 | +| `extension/src/popup/index.html` | **rewrite** | commit 3 | +| `extension/src/popup/popup.css` | **rewrite** | commit 3 | +| `extension/src/popup/popup.ts` | **rewrite** | commit 3 | + +--- + +## Design decisions + +### 1. Pause/Resume — розширення Session + +```ts +interface Session { + id: string; + startedAt: number; // Unix ms, null поки на паузі + totalActiveMs: number; // накопичений час до паузи + pausedAt: number | null; // null = активна, число = на паузі +} +``` + +При паузі: `totalActiveMs += Date.now() - startedAt`, `pausedAt = Date.now()`, `startedAt` зберігаємо (для відновлення). +При відновленні: `startedAt = Date.now()`, `pausedAt = null`. + +`getElapsedMs` враховує стан паузи: +``` +якщо pausedAt → повертаємо totalActiveMs (фіксований) +інакше → totalActiveMs + (Date.now() - startedAt) +``` + +### 2. Таймер у popup — polling через `setInterval` + +Popup не може підписатися на зміни storage. Найпростіше рішення: `setInterval` кожну секунду надсилає `SESSION_GET_STATE` і оновлює DOM. Інтервал очищається при закритті попапа (`window.addEventListener("unload")`). + +Альтернатива — `chrome.storage.onChanged` — складніша і надлишкова для таймера. + +### 3. Нотатки — надсилаються як `NOTE_ADD` повідомлення + +Кнопка "Додати нотатку" → `chrome.runtime.sendMessage({ type: "NOTE_ADD", text, tags })` → background зберігає в `pendingEvents` як `{ ...note, tags: ["note", ...userTags], timestamp }`. Вже узгоджено з Gap 3 з AC 3 плану. + +Нотатка надсилається тільки якщо сесія активна (не на паузі і не зупинена). + +### 4. Теги — comma-separated input + +Поле `` → `value.split(",").map(t => t.trim()).filter(Boolean)`. Прості, без autocomplete (AC 4 MVP). + +### 5. Індикатор синхронізації + +Відображає кількість `pendingEvents` з `chrome.storage.local` — це показує скільки подій чекають на AC 5 sync. Формат: `⏳ 12 events pending`. Оновлюється разом з таймером (той самий `setInterval`). + +### 6. Структура popup HTML + +``` +┌─────────────────────────┐ +│ WorkTrace [●] │ ← статус (active / paused / idle) +├─────────────────────────┤ +│ 00:12:34 │ ← таймер +│ [▶ Start] [⏸ Pause] │ ← або [■ Stop] залежно від стану +├─────────────────────────┤ +│ ⏳ 5 events pending │ ← sync indicator +├─────────────────────────┤ +│ Note: [____________] │ +│ Tags: [____________] │ +│ [+ Add note] │ +└─────────────────────────┘ +``` + +--- + +## Verification checklist + +- [ ] `npx tsc --noEmit` — без помилок +- [ ] `npm run build` — без помилок +- [ ] Start → таймер тікає, статус "active" +- [ ] Pause → таймер зупиняється на поточному значенні, статус "paused" +- [ ] Resume → таймер продовжує з того ж місця +- [ ] Stop → таймер скидається, статус "idle" +- [ ] `SESSION_PAUSE` → `pausedAt` з'являється в `chrome.storage.local` +- [ ] Note + tags → з'являються в `pendingEvents` з `tags: ["note", ...]` +- [ ] Sync indicator показує реальну кількість `pendingEvents` + +--- + +## Out of scope + +- Фактична відправка подій на API — AC 5 +- Стилізація анімацій — Week 4 +- Autocomplete для тегів — Week 4 From c627da8bffe82f814aff564ad47f61e4911ff0b2 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Sat, 23 May 2026 13:52:55 +0300 Subject: [PATCH 10/24] feat(extension): batched data sync with retry (Week 2 AC 5) (#10) * docs(plans): add week 2 AC 5 data sync plan * feat(dashboard): add requireUser JWT helper and protect /api/v1/events Verifies Bearer token via JWT_SECRET, checks session ownership on POST. * feat(dashboard): add POST and PATCH /api/v1/sessions endpoints POST creates a session for the authenticated user. PATCH /:id sets endedAt, scoped to the user's own sessions. * feat(extension): create DB session on SESSION_START with best-effort retry Adds dbSessionId to local Session, fire-and-forget POST /api/v1/sessions on start and PATCH on stop. Failures left for sync alarm to retry. * feat(extension): normalize pending event payload shape PageMetadata flattens to content via metaDescription + headings. Notes get worktrace://note/ URL so z.url() passes without schema changes. * feat(extension): add batched event sync with alarm and retry Every 30s a chrome.alarms tick flushes up to 50 queued events. Final flush also fires on SESSION_STOP. 4xx drops poison events, 401 stops until re-login, network and 5xx keep the queue for the next tick. * feat(extension): show sync status in popup Adds a SYNC_GET_STATUS message that returns lastSyncedAt, lastError and queueSize. Popup renders a second line under the queue count showing time since last sync or the error message. * chore(dashboard): pin turbopack root to dashboard directory Two lockfiles (root husky/lint-staged and dashboard) made Turbopack infer the repo root as workspace root, watching extension and unrelated paths and slowing dev. Setting turbopack.root scopes the watcher. * feat(extension): show logged-in user email in popup header AUTH_GET_STATUS now returns the email decoded from the JWT payload. Popup renders it under the logo while authenticated, hides on logout. --- dashboard/app/api/v1/events/route.ts | 24 ++- dashboard/app/api/v1/sessions/[id]/route.ts | 44 +++++ dashboard/app/api/v1/sessions/route.ts | 23 +++ dashboard/next.config.ts | 5 +- dashboard/server/events.ts | 18 +- dashboard/server/jwt.ts | 42 +++++ dashboard/server/schemas/sessions.ts | 7 + dashboard/server/sessions.ts | 28 +++ extension/src/background/index.ts | 144 +++++++++++--- extension/src/background/session.ts | 9 + extension/src/background/sync.ts | 114 +++++++++++ extension/src/manifest.ts | 2 +- extension/src/popup/index.html | 12 +- extension/src/popup/popup.css | 36 +++- extension/src/popup/popup.ts | 53 +++++- extension/src/types/auth.ts | 2 +- extension/src/types/pending.ts | 9 + extension/src/types/session.ts | 1 + extension/src/types/sync.ts | 10 + plans/week2/AC5-data-sync.md | 198 ++++++++++++++++++++ 20 files changed, 733 insertions(+), 48 deletions(-) create mode 100644 dashboard/app/api/v1/sessions/[id]/route.ts create mode 100644 dashboard/app/api/v1/sessions/route.ts create mode 100644 dashboard/server/jwt.ts create mode 100644 dashboard/server/schemas/sessions.ts create mode 100644 dashboard/server/sessions.ts create mode 100644 extension/src/background/sync.ts create mode 100644 extension/src/types/pending.ts create mode 100644 extension/src/types/sync.ts create mode 100644 plans/week2/AC5-data-sync.md diff --git a/dashboard/app/api/v1/events/route.ts b/dashboard/app/api/v1/events/route.ts index cd3cde8..78eeb8d 100644 --- a/dashboard/app/api/v1/events/route.ts +++ b/dashboard/app/api/v1/events/route.ts @@ -1,18 +1,36 @@ import { NextRequest, NextResponse } from "next/server"; import { z } from "zod"; -import { createEvent } from "@/server/events"; +import { createEventForUser, SessionNotFoundError } from "@/server/events"; import { CreateEventInput } from "@/server/schemas/events"; import { withCors, corsPreflight } from "@/server/cors"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; export const POST = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + const body = await req.json(); const parsed = CreateEventInput.safeParse(body); if (!parsed.success) { return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); } - const event = await createEvent(parsed.data); - return NextResponse.json(event, { status: 201 }); + try { + const event = await createEventForUser(user.id, parsed.data); + return NextResponse.json(event, { status: 201 }); + } catch (err) { + if (err instanceof SessionNotFoundError) { + return NextResponse.json({ error: "Session not found" }, { status: 404 }); + } + throw err; + } }); export function OPTIONS(req: NextRequest) { diff --git a/dashboard/app/api/v1/sessions/[id]/route.ts b/dashboard/app/api/v1/sessions/[id]/route.ts new file mode 100644 index 0000000..1c90544 --- /dev/null +++ b/dashboard/app/api/v1/sessions/[id]/route.ts @@ -0,0 +1,44 @@ +import { NextRequest, NextResponse } from "next/server"; +import { z } from "zod"; +import { endSessionForUser, SessionNotFoundError } from "@/server/sessions"; +import { SessionIdParam } from "@/server/schemas/sessions"; +import { withCors, corsPreflight } from "@/server/cors"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; + +interface RouteContext { + params: Promise<{ id: string }>; +} + +export function PATCH(req: NextRequest, ctx: RouteContext): Promise { + return withCors(async (r) => { + let user; + try { + user = requireUser(r); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + const params = await ctx.params; + const parsed = SessionIdParam.safeParse(params); + if (!parsed.success) { + return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + } + + try { + const session = await endSessionForUser(user.id, parsed.data.id); + return NextResponse.json(session, { status: 200 }); + } catch (err) { + if (err instanceof SessionNotFoundError) { + return NextResponse.json({ error: "Session not found" }, { status: 404 }); + } + throw err; + } + })(req); +} + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/app/api/v1/sessions/route.ts b/dashboard/app/api/v1/sessions/route.ts new file mode 100644 index 0000000..b6efa75 --- /dev/null +++ b/dashboard/app/api/v1/sessions/route.ts @@ -0,0 +1,23 @@ +import { NextRequest, NextResponse } from "next/server"; +import { createSessionForUser } from "@/server/sessions"; +import { withCors, corsPreflight } from "@/server/cors"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; + +export const POST = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + const session = await createSessionForUser(user.id); + return NextResponse.json(session, { status: 201 }); +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/next.config.ts b/dashboard/next.config.ts index e9ffa30..c475b2a 100644 --- a/dashboard/next.config.ts +++ b/dashboard/next.config.ts @@ -1,7 +1,10 @@ +import path from "node:path"; import type { NextConfig } from "next"; const nextConfig: NextConfig = { - /* config options here */ + turbopack: { + root: path.resolve(import.meta.dirname), + }, }; export default nextConfig; diff --git a/dashboard/server/events.ts b/dashboard/server/events.ts index e0084f8..cc0d046 100644 --- a/dashboard/server/events.ts +++ b/dashboard/server/events.ts @@ -1,6 +1,22 @@ import type { CreateEventInput } from "./schemas/events"; import { prisma } from "./db"; -export function createEvent(input: CreateEventInput) { +export class SessionNotFoundError extends Error { + constructor() { + super("Session not found"); + this.name = "SessionNotFoundError"; + } +} + +export async function createEventForUser( + userId: string, + input: CreateEventInput, +) { + const session = await prisma.session.findFirst({ + where: { id: input.sessionId, userId }, + select: { id: true }, + }); + if (!session) throw new SessionNotFoundError(); + return prisma.event.create({ data: input }); } diff --git a/dashboard/server/jwt.ts b/dashboard/server/jwt.ts new file mode 100644 index 0000000..ae01485 --- /dev/null +++ b/dashboard/server/jwt.ts @@ -0,0 +1,42 @@ +import type { NextRequest } from "next/server"; +import jwt from "jsonwebtoken"; + +export class UnauthorizedError extends Error { + constructor(message = "Unauthorized") { + super(message); + this.name = "UnauthorizedError"; + } +} + +interface JwtPayload { + sub: string; + email: string; +} + +function isPayload(v: unknown): v is JwtPayload { + if (typeof v !== "object" || v === null) return false; + const r = v as Record; + return typeof r["sub"] === "string" && typeof r["email"] === "string"; +} + +export function requireUser(req: NextRequest): { id: string; email: string } { + const header = req.headers.get("authorization"); + if (!header?.startsWith("Bearer ")) { + throw new UnauthorizedError("Missing or malformed Authorization header"); + } + const token = header.slice("Bearer ".length).trim(); + if (!token) throw new UnauthorizedError("Empty bearer token"); + + const secret = process.env.JWT_SECRET; + if (!secret) throw new Error("JWT_SECRET is not set"); + + let decoded: unknown; + try { + decoded = jwt.verify(token, secret); + } catch { + throw new UnauthorizedError("Invalid or expired token"); + } + if (!isPayload(decoded)) throw new UnauthorizedError("Invalid token payload"); + + return { id: decoded.sub, email: decoded.email }; +} diff --git a/dashboard/server/schemas/sessions.ts b/dashboard/server/schemas/sessions.ts new file mode 100644 index 0000000..4183852 --- /dev/null +++ b/dashboard/server/schemas/sessions.ts @@ -0,0 +1,7 @@ +import { z } from "zod"; + +export const SessionIdParam = z.object({ + id: z.string().regex(/^c[a-z0-9]{24}$/, "must be a CUID"), +}); + +export type SessionIdParam = z.infer; diff --git a/dashboard/server/sessions.ts b/dashboard/server/sessions.ts new file mode 100644 index 0000000..5aea255 --- /dev/null +++ b/dashboard/server/sessions.ts @@ -0,0 +1,28 @@ +import { prisma } from "./db"; + +export class SessionNotFoundError extends Error { + constructor() { + super("Session not found"); + this.name = "SessionNotFoundError"; + } +} + +export function createSessionForUser(userId: string) { + return prisma.session.create({ + data: { userId }, + select: { id: true, startedAt: true }, + }); +} + +export async function endSessionForUser(userId: string, sessionId: string) { + const result = await prisma.session.updateMany({ + where: { id: sessionId, userId, endedAt: null }, + data: { endedAt: new Date() }, + }); + if (result.count === 0) throw new SessionNotFoundError(); + + return prisma.session.findUniqueOrThrow({ + where: { id: sessionId }, + select: { id: true, endedAt: true }, + }); +} diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index 6fa8bd4..f765d5b 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -1,6 +1,8 @@ import type { AuthMessage, AuthResponse, StoredAuth } from "../types/auth"; import type { ContentMessage } from "../types/content"; +import type { PendingEvent } from "../types/pending"; import type { SessionMessage, SessionResponse } from "../types/session"; +import type { SyncMessage, SyncResponse } from "../types/sync"; import { getSession, startSession, @@ -8,7 +10,9 @@ import { pauseSession, resumeSession, getElapsedMs, + attachDbSessionId, } from "./session"; +import { initSync, flush, getStatus } from "./sync"; const DASHBOARD_URL = import.meta.env.VITE_DASHBOARD_URL as string; const GOOGLE_CLIENT_ID = import.meta.env.VITE_GOOGLE_CLIENT_ID as string; @@ -35,6 +39,17 @@ function isExpired(expiresAt: number): boolean { return Date.now() >= expiresAt - EXPIRY_BUFFER_MS; } +function decodeEmail(jwt: string): string | null { + try { + const payloadB64 = jwt.split(".")[1]; + if (!payloadB64) return null; + const payload = JSON.parse(atob(payloadB64)) as { email?: string }; + return payload.email ?? null; + } catch { + return null; + } +} + // ─── Google OAuth ────────────────────────────────────────────────────────────── async function launchGoogleOAuth(): Promise { @@ -110,12 +125,54 @@ export async function apiFetch( }); } +// ─── DB session lifecycle ────────────────────────────────────────────────────── + +// Best-effort: ensures the active local session has a DB-backed CUID. +// Called on SESSION_START and again by the sync alarm before each flush. +// Returns the dbSessionId on success, null otherwise. +export async function ensureDbSession(): Promise { + const session = await getSession(); + if (!session) return null; + if (session.dbSessionId) return session.dbSessionId; + + try { + const res = await apiFetch("/api/v1/sessions", { method: "POST" }); + if (!res.ok) return null; + const { id } = await res.json() as { id: string }; + const updated = await attachDbSessionId(id); + return updated?.dbSessionId ?? id; + } catch { + return null; + } +} + +async function tryEndDbSession(dbSessionId: string): Promise { + try { + await apiFetch(`/api/v1/sessions/${dbSessionId}`, { method: "PATCH" }); + } catch { + // Best-effort — losing endedAt is acceptable per AC 5 plan + } +} + +// ─── Pending event queue ─────────────────────────────────────────────────────── + +async function enqueuePending(event: PendingEvent): Promise { + const r = await chrome.storage.local.get("pendingEvents"); + const pending = (r["pendingEvents"] as PendingEvent[] | undefined) ?? []; + pending.push(event); + await chrome.storage.local.set({ pendingEvents: pending }); +} + // ─── Message listener ────────────────────────────────────────────────────────── -type IncomingMessage = AuthMessage | SessionMessage | ContentMessage; +type IncomingMessage = AuthMessage | SessionMessage | ContentMessage | SyncMessage; chrome.runtime.onMessage.addListener( - (message: IncomingMessage, _sender, sendResponse: (r: AuthResponse | SessionResponse) => void) => { + ( + message: IncomingMessage, + _sender, + sendResponse: (r: AuthResponse | SessionResponse | SyncResponse) => void, + ) => { if (message.type === "AUTH_LOGIN") { if (DEV_MODE) { storeAuth("dev.fake.jwt", Date.now() + 7 * 24 * 60 * 60 * 1000) @@ -153,12 +210,14 @@ chrome.runtime.onMessage.addListener( if (message.type === "AUTH_GET_STATUS") { getStoredAuth() - .then((stored) => + .then((stored) => { + const authed = stored !== null && !isExpired(stored.jwtExpiresAt); sendResponse({ success: true, - isAuthenticated: stored !== null && !isExpired(stored.jwtExpiresAt), - }), - ) + isAuthenticated: authed, + email: authed && stored ? decodeEmail(stored.jwt) : null, + }); + }) .catch((err: unknown) => sendResponse({ success: false, @@ -172,12 +231,14 @@ chrome.runtime.onMessage.addListener( if (message.type === "SESSION_START") { startSession() - .then((session) => + .then((session) => { sendResponse({ success: true, session: { ...session, elapsedMs: getElapsedMs(session) }, - }), - ) + }); + // Fire-and-forget DB session creation — retried by sync alarm if it fails + if (!session.dbSessionId) void ensureDbSession(); + }) .catch((err: unknown) => sendResponse({ success: false, @@ -188,13 +249,18 @@ chrome.runtime.onMessage.addListener( } if (message.type === "SESSION_STOP") { - stopSession() - .then((session) => + (async () => { + // Drain before clearing the session — once cleared, flush would exit early + await flush(); + return stopSession(); + })() + .then((session) => { sendResponse({ success: true, session: session ? { ...session, elapsedMs: getElapsedMs(session) } : null, - }), - ) + }); + if (session?.dbSessionId) void tryEndDbSession(session.dbSessionId); + }) .catch((err: unknown) => sendResponse({ success: false, @@ -264,33 +330,48 @@ chrome.runtime.onMessage.addListener( if (message.type === "NOTE_ADD") { getSession().then((session) => { if (!session || session.pausedAt !== null) return; - chrome.storage.local.get("pendingEvents").then((r) => { - const pending = (r["pendingEvents"] as unknown[]) ?? []; - pending.push({ - url: "", - title: "Note", - content: message.text, - tags: ["note", ...message.tags], - timestamp: new Date().toISOString(), - }); - chrome.storage.local.set({ pendingEvents: pending }); - }); + const event: PendingEvent = { + url: `worktrace://note/${crypto.randomUUID()}`, + title: message.text.slice(0, 80) || "Note", + content: message.text, + tags: ["note", ...message.tags], + timestamp: new Date().toISOString(), + }; + void enqueuePending(event); }); return false; } + // ─── Sync messages ─────────────────────────────────────────────────────── + + if (message.type === "SYNC_GET_STATUS") { + getStatus() + .then((status) => sendResponse({ success: true, ...status })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + // ─── Content script messages ───────────────────────────────────────────── if (message.type === "PAGE_METADATA") { // Store metadata only when a session is active (AC 5 will batch-send it) getSession().then((session) => { if (!session) return; - // Stored for AC 5 batch sync — no response needed - chrome.storage.local.get("pendingEvents").then((r) => { - const pending = (r["pendingEvents"] as unknown[]) ?? []; - pending.push({ ...message.payload, timestamp: new Date().toISOString() }); - chrome.storage.local.set({ pendingEvents: pending }); - }); + const { url, title, metaDescription, headings } = message.payload; + const content = [metaDescription, ...headings].filter(Boolean).join(" | ") || null; + const event: PendingEvent = { + url, + title, + content, + tags: [], + timestamp: new Date().toISOString(), + }; + void enqueuePending(event); }); return false; // no async response needed } @@ -304,3 +385,6 @@ chrome.runtime.onMessage.addListener( chrome.runtime.onInstalled.addListener((details) => { console.log("[worktrace] service worker installed:", details.reason); }); + +// Boot sync alarm — runs every service-worker startup, idempotent under chrome.alarms +initSync({ apiFetch, ensureDbSession }); diff --git a/extension/src/background/session.ts b/extension/src/background/session.ts index fa27fc3..ee81208 100644 --- a/extension/src/background/session.ts +++ b/extension/src/background/session.ts @@ -33,6 +33,7 @@ export async function startSession(): Promise { const session: Session = { id: crypto.randomUUID(), + dbSessionId: null, startedAt: Date.now(), totalActiveMs: 0, pausedAt: null, @@ -41,6 +42,14 @@ export async function startSession(): Promise { return session; } +export async function attachDbSessionId(dbSessionId: string): Promise { + const session = await getSession(); + if (!session || session.dbSessionId) return session; + const updated: Session = { ...session, dbSessionId }; + await saveSession(updated); + return updated; +} + export async function stopSession(): Promise { const session = await getSession(); if (!session) return null; diff --git a/extension/src/background/sync.ts b/extension/src/background/sync.ts new file mode 100644 index 0000000..1618af9 --- /dev/null +++ b/extension/src/background/sync.ts @@ -0,0 +1,114 @@ +import type { PendingEvent } from "../types/pending"; +import { getSession } from "./session"; + +const ALARM_NAME = "worktrace-sync"; +const PERIOD_MIN = 0.5; // 30 seconds +const BATCH_SIZE = 50; +const STATUS_KEY = "syncStatus"; +const PENDING_KEY = "pendingEvents"; + +export interface SyncStatus { + lastSyncedAt: number | null; + lastError: string | null; +} + +// Functions injected at startup to avoid circular import with background/index.ts +type ApiFetch = (path: string, init?: RequestInit) => Promise; +type EnsureDbSession = () => Promise; + +let apiFetchFn: ApiFetch | null = null; +let ensureDbSessionFn: EnsureDbSession | null = null; + +export function initSync(deps: { apiFetch: ApiFetch; ensureDbSession: EnsureDbSession }): void { + apiFetchFn = deps.apiFetch; + ensureDbSessionFn = deps.ensureDbSession; + + chrome.alarms.create(ALARM_NAME, { periodInMinutes: PERIOD_MIN }); + chrome.alarms.onAlarm.addListener((alarm) => { + if (alarm.name === ALARM_NAME) void flush(); + }); +} + +// ─── Status ──────────────────────────────────────────────────────────────────── + +export async function getStatus(): Promise { + const r = await chrome.storage.local.get([STATUS_KEY, PENDING_KEY]); + const status = (r[STATUS_KEY] as SyncStatus | undefined) ?? { lastSyncedAt: null, lastError: null }; + const pending = (r[PENDING_KEY] as PendingEvent[] | undefined) ?? []; + return { ...status, queueSize: pending.length }; +} + +async function setStatus(patch: Partial): Promise { + const r = await chrome.storage.local.get(STATUS_KEY); + const current = (r[STATUS_KEY] as SyncStatus | undefined) ?? { lastSyncedAt: null, lastError: null }; + await chrome.storage.local.set({ [STATUS_KEY]: { ...current, ...patch } }); +} + +// ─── Flush ───────────────────────────────────────────────────────────────────── + +export async function flush(): Promise { + if (!apiFetchFn || !ensureDbSessionFn) return; + + const session = await getSession(); + if (!session) return; + + const dbSessionId = session.dbSessionId ?? (await ensureDbSessionFn()); + if (!dbSessionId) { + await setStatus({ lastError: "DB session not available" }); + return; + } + + const r = await chrome.storage.local.get(PENDING_KEY); + const queue = (r[PENDING_KEY] as PendingEvent[] | undefined) ?? []; + if (queue.length === 0) return; + + const batch = queue.slice(0, BATCH_SIZE); + let sentCount = 0; + let lastError: string | null = null; + + for (let i = 0; i < batch.length; i++) { + const event = batch[i]!; + let res: Response; + try { + res = await apiFetchFn("/api/v1/events", { + method: "POST", + body: JSON.stringify({ ...event, sessionId: dbSessionId }), + }); + } catch (err) { + // Network error — keep this event and everything after it for the next flush + lastError = err instanceof Error ? err.message : "Network error"; + break; + } + + if (res.ok) { + sentCount++; + continue; + } + + if (res.status === 401) { + // Token rotated/expired — stop, queue waits for next login + lastError = "Unauthorized — please sign in again"; + break; + } + + if (res.status >= 400 && res.status < 500) { + // Poisonous payload — drop it, keep going so it can't block the queue + sentCount++; + lastError = `Dropped invalid event (HTTP ${String(res.status)})`; + continue; + } + + // 5xx — retry next alarm + lastError = `Server error (HTTP ${String(res.status)})`; + break; + } + + if (sentCount > 0) { + const remaining = queue.slice(sentCount); + await chrome.storage.local.set({ [PENDING_KEY]: remaining }); + } + await setStatus({ + lastSyncedAt: sentCount > 0 ? Date.now() : (await getStatus()).lastSyncedAt, + lastError, + }); +} diff --git a/extension/src/manifest.ts b/extension/src/manifest.ts index 6330a4e..024b576 100644 --- a/extension/src/manifest.ts +++ b/extension/src/manifest.ts @@ -27,7 +27,7 @@ export default defineManifest({ run_at: "document_idle", }, ], - permissions: ["storage", "activeTab", "tabs", "identity"], + permissions: ["storage", "activeTab", "tabs", "identity", "alarms"], host_permissions: [ "http://localhost:3000/*", "https://worktrace-ecru.vercel.app/*", diff --git a/extension/src/popup/index.html b/extension/src/popup/index.html index dafcacf..15e9bcb 100644 --- a/extension/src/popup/index.html +++ b/extension/src/popup/index.html @@ -13,7 +13,10 @@
@@ -41,8 +44,11 @@
- ⚡ - 0 events queued +
+ ⚡ + 0 events queued +
+
not synced yet
diff --git a/extension/src/popup/popup.css b/extension/src/popup/popup.css index 7dbd01e..142ce4e 100644 --- a/extension/src/popup/popup.css +++ b/extension/src/popup/popup.css @@ -52,6 +52,13 @@ body { filter: drop-shadow(0 0 4px var(--c-cyan)); } +.popup__logo-stack { + display: flex; + flex-direction: column; + gap: 1px; + min-width: 0; +} + .popup__logo-text { font-size: 13px; font-weight: 700; @@ -59,6 +66,15 @@ body { text-shadow: 0 0 6px color-mix(in srgb, var(--c-cyan) 60%, transparent); } +.popup__user-email { + font-size: 9px; + color: var(--c-muted); + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; + max-width: 180px; +} + /* ── popup__status ─────────────────────────────────────────────────────────── */ .popup__header-right { display: flex; @@ -154,8 +170,8 @@ body { /* ── popup__sync ───────────────────────────────────────────────────────────── */ .popup__sync { display: flex; - align-items: center; - gap: 6px; + flex-direction: column; + gap: 4px; background: var(--c-surface); border: 1px solid var(--c-border); border-radius: 4px; @@ -165,8 +181,24 @@ body { transition: border-color 0.3s, color 0.3s; } +.popup__sync-row { + display: flex; + align-items: center; + gap: 6px; +} + .popup__sync-icon { color: var(--c-yellow); } +.popup__sync-meta { + font-size: 10px; + color: var(--c-muted); + padding-left: 18px; +} + +.popup__sync-meta--error { + color: var(--c-pink); +} + .popup__sync--has-events { border-color: color-mix(in srgb, var(--c-yellow) 25%, transparent); color: var(--c-yellow); diff --git a/extension/src/popup/popup.ts b/extension/src/popup/popup.ts index 60d381b..d76f318 100644 --- a/extension/src/popup/popup.ts +++ b/extension/src/popup/popup.ts @@ -1,5 +1,6 @@ import type { AuthMessage, AuthResponse } from "../types/auth"; import type { SessionMessage, SessionResponse, SessionState } from "../types/session"; +import type { SyncMessage, SyncResponse } from "../types/sync"; // ─── Messaging helpers ───────────────────────────────────────────────────────── @@ -23,6 +24,16 @@ function sendSession(msg: SessionMessage): Promise { ); } +function sendSync(msg: SyncMessage): Promise { + return new Promise((resolve, reject) => + chrome.runtime.sendMessage(msg, (res: SyncResponse | undefined) => { + if (chrome.runtime.lastError) return reject(new Error(chrome.runtime.lastError.message)); + if (!res) return reject(new Error("No response from background")); + resolve(res); + }), + ); +} + // ─── DOM refs ────────────────────────────────────────────────────────────────── const statusDot = document.getElementById("status-dot") as HTMLSpanElement; @@ -37,6 +48,8 @@ const btnPause = document.getElementById("btn-pause") as HTMLButtonEle const btnStop = document.getElementById("btn-stop") as HTMLButtonElement; const syncEl = document.getElementById("sync-indicator") as HTMLDivElement; const syncLabel = document.getElementById("sync-label") as HTMLSpanElement; +const syncMeta = document.getElementById("sync-meta") as HTMLDivElement; +const userEmail = document.getElementById("user-email") as HTMLSpanElement; const noteInput = document.getElementById("note-input") as HTMLInputElement; const tagsInput = document.getElementById("tags-input") as HTMLInputElement; const btnNote = document.getElementById("btn-note") as HTMLButtonElement; @@ -70,25 +83,53 @@ function applyState(state: UIState, elapsedMs = 0): void { btnNote.disabled = state !== "active"; } -function showAuthenticated(): void { +function showAuthenticated(email: string | null): void { authSection.style.display = "none"; timerSection.style.display = "flex"; btnLogout.hidden = false; + if (email) { + userEmail.textContent = email; + userEmail.hidden = false; + } else { + userEmail.hidden = true; + } } function showUnauthenticated(): void { authSection.style.display = "flex"; timerSection.style.display = "none"; btnLogout.hidden = true; + userEmail.hidden = true; + userEmail.textContent = ""; stopPolling(); applyState("idle"); } +function formatAgo(ts: number): string { + const sec = Math.floor((Date.now() - ts) / 1000); + if (sec < 5) return "just now"; + if (sec < 60) return `${String(sec)}s ago`; + if (sec < 3600) return `${String(Math.floor(sec / 60))}m ago`; + return `${String(Math.floor(sec / 3600))}h ago`; +} + async function refreshSyncIndicator(): Promise { - const r = await chrome.storage.local.get("pendingEvents"); - const count = ((r["pendingEvents"] as unknown[]) ?? []).length; - syncLabel.textContent = `${count} event${count !== 1 ? "s" : ""} queued`; - syncEl.classList.toggle("popup__sync--has-events", count > 0); + const res = await sendSync({ type: "SYNC_GET_STATUS" }).catch(() => null); + if (!res || !res.success) return; + + syncLabel.textContent = `${String(res.queueSize)} event${res.queueSize !== 1 ? "s" : ""} queued`; + syncEl.classList.toggle("popup__sync--has-events", res.queueSize > 0); + + if (res.lastError) { + syncMeta.textContent = `error: ${res.lastError}`; + syncMeta.classList.add("popup__sync-meta--error"); + } else if (res.lastSyncedAt) { + syncMeta.textContent = `synced ${formatAgo(res.lastSyncedAt)}`; + syncMeta.classList.remove("popup__sync-meta--error"); + } else { + syncMeta.textContent = "not synced yet"; + syncMeta.classList.remove("popup__sync-meta--error"); + } } // ─── Session polling ─────────────────────────────────────────────────────────── @@ -127,7 +168,7 @@ async function init(): Promise { return; } - showAuthenticated(); + showAuthenticated(authRes.email); const res = await sendSession({ type: "SESSION_GET_STATE" }).catch(() => null); if (res?.success && "session" in res) { diff --git a/extension/src/types/auth.ts b/extension/src/types/auth.ts index 259bcf5..adfc05f 100644 --- a/extension/src/types/auth.ts +++ b/extension/src/types/auth.ts @@ -10,6 +10,6 @@ export type AuthMessage = export type AuthResponse = | { success: true; jwt: string } - | { success: true; isAuthenticated: boolean } + | { success: true; isAuthenticated: boolean; email: string | null } | { success: true } | { success: false; error: string }; diff --git a/extension/src/types/pending.ts b/extension/src/types/pending.ts new file mode 100644 index 0000000..91559b9 --- /dev/null +++ b/extension/src/types/pending.ts @@ -0,0 +1,9 @@ +// Wire shape for queued events — matches dashboard's CreateEventInput +// (minus sessionId, which is attached at flush time from local Session.dbSessionId) +export interface PendingEvent { + url: string; // must satisfy z.url() (worktrace://note/... for notes) + title: string; // min 1 char + content: string | null; + tags: string[]; + timestamp: string; // ISO 8601 +} diff --git a/extension/src/types/session.ts b/extension/src/types/session.ts index 93597b3..a1791c9 100644 --- a/extension/src/types/session.ts +++ b/extension/src/types/session.ts @@ -1,5 +1,6 @@ export interface Session { id: string; + dbSessionId: string | null; // CUID returned by POST /api/v1/sessions, null until first sync startedAt: number; // Unix ms totalActiveMs: number; // accumulated active time pausedAt: number | null; // null = active, number = paused since diff --git a/extension/src/types/sync.ts b/extension/src/types/sync.ts new file mode 100644 index 0000000..c156c4e --- /dev/null +++ b/extension/src/types/sync.ts @@ -0,0 +1,10 @@ +export type SyncMessage = { type: "SYNC_GET_STATUS" }; + +export type SyncResponse = + | { + success: true; + lastSyncedAt: number | null; + lastError: string | null; + queueSize: number; + } + | { success: false; error: string }; diff --git a/plans/week2/AC5-data-sync.md b/plans/week2/AC5-data-sync.md new file mode 100644 index 0000000..156ccdb --- /dev/null +++ b/plans/week2/AC5-data-sync.md @@ -0,0 +1,198 @@ +# Plan: Week 2 AC 5 — Data Sync + +**Branch:** `feature/extension-data-sync` +**Closes:** Week 2 AC 5 ([docs/Task.md L78](../../docs/Task.md#L78)) +**Status:** plan, awaiting review + +--- + +## Scope + +**AC 5 — Передача даних:** зібрані події надсилаються батчами на `POST /api/v1/events` з Bearer token. Є retry-логіка при помилці мережі. + +Закриває також **Gap 2, 3, 4** з [AC2-AC3-content-sessions.md](./AC2-AC3-content-sessions.md#L144) — без них AC 5 не запрацює, бо в БД `Event.sessionId` — FK на CUID, локальний UUID не пройде валідацію. + +--- + +## Commits (ordered) + +``` +1. docs(plans): add week 2 AC 5 data sync plan +2. feat(dashboard): add requireUser JWT helper and apply to /api/v1/events +3. feat(dashboard): add POST and PATCH /api/v1/sessions endpoints +4. feat(extension): create DB session on SESSION_START with retry (Gap 2) +5. feat(extension): normalize pending event payload shape (Gaps 3, 4) +6. feat(extension): add batched event sync with alarm and retry (AC 5) +7. feat(extension): show sync errors and last-synced state in popup +``` + +--- + +## Files + +| File | Action | Commit | +|---|---|---| +| `plans/week2/AC5-data-sync.md` | **new** | 1 | +| `dashboard/server/jwt.ts` | **new** — `requireUser(req): { id, email }` | 2 | +| `dashboard/app/api/v1/events/route.ts` | modify — call `requireUser`, restrict body to current user's sessions | 2 | +| `dashboard/server/schemas/sessions.ts` | **new** | 3 | +| `dashboard/server/sessions.ts` | **new** — `createSession`, `endSession` | 3 | +| `dashboard/app/api/v1/sessions/route.ts` | **new** — POST | 3 | +| `dashboard/app/api/v1/sessions/[id]/route.ts` | **new** — PATCH | 3 | +| `extension/src/types/session.ts` | modify — add `dbSessionId: string \| null` | 4 | +| `extension/src/background/session.ts` | modify — `startSession` triggers DB-session create with retry | 4 | +| `extension/src/types/pending.ts` | **new** — shared shape for queued events | 5 | +| `extension/src/background/index.ts` | modify — normalize payloads at enqueue time | 5 | +| `extension/src/background/sync.ts` | **new** — batching, alarms, retry | 6 | +| `extension/src/background/index.ts` | modify — wire sync, flush on `SESSION_STOP` | 6 | +| `extension/src/manifest.ts` | modify — add `"alarms"` permission | 6 | +| `extension/src/types/sync.ts` | **new** — `SYNC_GET_STATUS` message | 7 | +| `extension/src/popup/popup.ts` | modify — show last sync ts / error | 7 | +| `extension/src/popup/index.html` + `.css` | modify — sync status row | 7 | + +--- + +## Design decisions + +### 1. JWT helper — shared between sessions and events + +Окремий модуль `dashboard/server/jwt.ts`: + +```ts +export function requireUser(req: NextRequest): { id: string; email: string } +``` + +Кидає `UnauthorizedError` (новий клас) при відсутньому/невалідному токені. Route handlers ловлять і повертають 401. Сам verify через `jsonwebtoken.verify(token, JWT_SECRET)` — той самий secret, що в `server/auth.ts:issueJWT`. + +**Чому окремий файл, а не middleware:** Next.js middleware на edge runtime, а нам тут потрібно перевірити `userId` проти БД у деяких флоу (наприклад: `POST /api/v1/events` повинен впевнитись, що `sessionId` належить юзеру). Реальний middleware — Week 3 AC 1 для `/dashboard/*` сторінок. + +**Чому застосовуємо до `/api/v1/events` теж:** без цього будь-хто з `chrome-extension://*` Origin може писати в чужі сесії. CORS дозволяє origin, але не авторизує користувача. Краще зробити правильно зараз, ніж лишити дірку до Week 3. + +**Перевірка ownership при POST /api/v1/events:** окрім JWT, переконуємось, що `event.sessionId` належить `userId` з токена. Без цього JWT-helper лише наполовину закриває проблему. + +### 2. Sessions API + +``` +POST /api/v1/sessions → { id: string } створює Session(userId from JWT, startedAt=now) +PATCH /api/v1/sessions/:id → { id, endedAt } перевіряє ownership, пише endedAt=now +``` + +Обидва — `withCors`, обидва — через `requireUser`. Zod схеми мінімальні (POST — порожнє body, PATCH — без body). + +### 3. Local Session → DB Session mapping + +Розширення типу: +```ts +interface Session { + id: string; // local UUID — для popup/storage + dbSessionId: string | null; // CUID з БД, null поки не дійшло + startedAt: number; + totalActiveMs: number; + pausedAt: number | null; +} +``` + +**`SESSION_START` flow:** +1. створити local session (як зараз) +2. одразу зробити `POST /api/v1/sessions`. На успіх — записати `dbSessionId` у storage. +3. на помилку мережі — лишити `dbSessionId: null` і покластись на sync alarm, який спробує знову (див. §6). + +**Без `dbSessionId` нічого не sync-иться.** Sync пропускає batch, якщо сесія ще не зареєстрована в БД. Це послідовно і безпечно — батч-запит або повністю успішний, або повністю відкладений. + +**`SESSION_STOP` flow:** локальна частина — як зараз. Якщо є `dbSessionId` — `PATCH /api/v1/sessions/:id` для `endedAt`. Якщо немає (офлайн весь час) — не пробуємо. Втрата `endedAt` — допустима втрата. + +### 4. Pending event shape — нормалізуємо при enqueue + +Зараз у `pendingEvents` потрапляють два різні shape'и: +- з `PAGE_METADATA` — повний `PageMetadata` payload (`{ url, title, metaDescription, headings, timestamp }`) +- з `NOTE_ADD` — `{ url: "", title: "Note", content, tags, timestamp }` + +Обидва _не співпадають_ з `Event` моделлю (`headings` нема, `metaDescription` нема, `url: ""` фейлить `z.url()`). + +**Нормалізуємо одразу при enqueue.** Новий тип: +```ts +interface PendingEvent { + url: string; // valid URL (для нотатки — worktrace://note/) + title: string; + content: string | null; + tags: string[]; + timestamp: string; // ISO +} +``` + +Перетворення: +- **PAGE_METADATA** → `content = [metaDescription, ...headings].filter(Boolean).join(" | ") || null`, `tags = []`. +- **NOTE_ADD** → `url = "worktrace://note/" + crypto.randomUUID()`, `title = text.slice(0, 80) || "Note"`, `content = text`, `tags = ["note", ...userTags]`. + +`worktrace://` — кастомна URL-схема, Zod `z.url()` приймає її (URL parser спецификації не вимагає http/https). + +### 5. Validation: `CreateEventInput` лишається без змін + +Сторона dashboard'у не вимагає змін схеми — `url: z.url()`, `title: z.string().min(1)`, `sessionId: CUID` всі задовольняються нормалізованим payload. + +Єдина зміна route handler'а — додати `requireUser` + перевірку `session.userId === user.id` через `prisma.session.findFirst({ where: { id, userId } })`. + +### 6. Batching & retry — `chrome.alarms` кожні 30 секунд + +``` +chrome.alarms.create("sync", { periodInMinutes: 0.5 }); +chrome.alarms.onAlarm.addListener(name => name === "sync" && flush()); +``` + +**`flush()`:** +1. читаємо `activeSession` — якщо `dbSessionId == null`, спершу пробуємо `POST /api/v1/sessions`. Не вдалось — exit (наступний alarm спробує знову). +2. читаємо `pendingEvents`. Порожньо — exit. +3. беремо до `BATCH_SIZE = 50` подій (FIFO). +4. шлемо `POST /api/v1/events` _по одній_ (route handler приймає одну, не масив — поточний контракт). Кожна успішна → видаляється з черги. Помилка мережі → стоп, лишити решту в черзі. +5. при `401` → не ретраїти, очистити jwt і черга чекає (юзер залогіниться, наступний flush спрацює). +6. при `4xx` (валідація) → подія відкидається з логом — інакше "отруйна" подія заблокує всю чергу. + +**Backoff per-alarm:** в межах одного `flush` — без додаткових ретраїв. Наступний alarm через 30s — це і є backoff. Простіше і достатньо для AC 5 (не CI з мільйонами реквестів). + +**Flush на `SESSION_STOP`:** одразу викликаємо `flush()` (поза alarm), щоб закрити сесію з мінімальною кількістю pending events. + +**Чому окремий файл `background/sync.ts`:** `index.ts` уже 300 рядків. Sync — самостійна одиниця з власним станом (lastSyncedAt, lastError). Окремий модуль = легше тестувати локально (можна замокати `apiFetch`). + +### 7. Sync status у popup + +Новий тип повідомлення: +```ts +{ type: "SYNC_GET_STATUS" } + → { lastSyncedAt: number | null; lastError: string | null; queueSize: number } +``` + +`queueSize` — те саме що зараз показує popup (`pendingEvents.length`), просто переносимо в один RPC замість прямого читання storage. Це чистіше — popup не залежить від ключів storage. + +UI: під поточним `sync-indicator` додаємо одне поле "last sync: 2 min ago" / "error: ...". Без перебудови верстки. + +### 8. Чого НЕ робимо тут (out of scope) + +- **JWT validation у Next.js middleware** — Week 3 AC 1. Тут тільки server-side helper для конкретних route handlers. +- **Track endpoint** — `Track` модель ще не використовується (Week 2 AC 6 бонус). +- **Forgot password / email-password auth** — окремий backlog, явно "after Week 3" ([plans/backlog/email-password-auth.md:131](../backlog/email-password-auth.md#L131)). +- **Bulk events endpoint** (`POST /api/v1/events` приймає масив) — поточний контракт приймає одну подію, міняти його — окремий рефактор. Послідовний POST з batch-обмеженням 50 достатньо для MVP. +- **Note як окрема Prisma модель** — синтетичний URL покриває потреби AC 5 без міграції. + +--- + +## Verification checklist + +### Dashboard +- [ ] `cd dashboard && npx tsc --noEmit` без помилок +- [ ] `POST /api/v1/sessions` без `Authorization` → 401 +- [ ] `POST /api/v1/sessions` з валідним JWT → 201 `{ id }`, рядок у БД +- [ ] `PATCH /api/v1/sessions/` → 200, `endedAt` записано +- [ ] `PATCH /api/v1/sessions/` → 404 (не 403 — не зливаємо існування) +- [ ] `POST /api/v1/events` для чужої сесії → 404 +- [ ] `POST /api/v1/events` для своєї сесії з валідним body → 201 + +### Extension +- [ ] `cd extension && npm run build` без помилок +- [ ] `SESSION_START` → `activeSession.dbSessionId` з'являється протягом ~1 alarm +- [ ] Офлайн + `SESSION_START` → `dbSessionId: null`, після відновлення мережі → заповнюється +- [ ] `pendingEvents` після PAGE_METADATA має формат `{ url, title, content, tags, timestamp }` +- [ ] Нотатка з'являється з `url: worktrace://note/...`, `tags: ["note", ...]` +- [ ] Alarm кожні 30s робить POST. Успіх → подія зникає з `pendingEvents`. +- [ ] 401 від API → черга лишається, після повторного login → flush очищає її +- [ ] `SESSION_STOP` → одразу POST до events для решти черги + PATCH session.endedAt +- [ ] Popup показує `last sync: ...` і `error: ...` коли актуально From 06f4dd7132e15194f40ad9d755c8ceef6cfd010e Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Mon, 25 May 2026 00:39:42 +0300 Subject: [PATCH 11/24] feat(AC6): music capture - YTM + SoundCloud track tracking with listenedMs (#11) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(plans): add AC6 music capture plan * feat(extension): add TrackInfo types and music message definitions * feat(extension): add YouTube Music content script with MutationObserver * feat(extension): add SoundCloud content script with MutationObserver * feat(extension): update manifest with music content scripts and host_permissions * feat(extension): handle TRACK_CAPTURED in background and save to DB * feat(dashboard): add POST /api/v1/tracks route handler * feat(extension): display now-playing track in popup UI * fix(extension): skip sync flush when unauthenticated to stop retry flood * fix(extension): fix track section visibility and show auth error in popup * fix(extension): add TRACK_REQUEST on-demand pull to fix SW race condition * docs: add local dev checklist to CLAUDE.md * fix(extension): save track to DB on on-demand TRACK_REQUEST pull * feat(extension): show track listening duration timer in popup * docs(plans): update AC6 plan with actual commits and bug log * feat(db): add endedAt to Track model for listen duration analytics * feat(dashboard): add PATCH /api/v1/tracks/:id to record track endedAt * feat(extension): track endedAt per song via currentDbTrackId and PATCH on change or session stop * feat: accumulate listenedMs, pause track timer, gray out music block on pause * fix(extension): detect music pause via .time-info DOM polling on YTM Use ytmusic-player-bar .time-info textContent instead of broken slider aria-valuenow (returned a static value). Popup now freezes the track duration timer when the song is paused. * docs(plans): finalize AC6 plan — mark all commits done, add commit 16 YTM pause fix --- CLAUDE.md | 15 + dashboard/app/api/v1/tracks/[id]/route.ts | 46 +++ dashboard/app/api/v1/tracks/route.ts | 38 +++ .../migration.sql | 5 + .../migration.sql | 8 + dashboard/prisma/schema.prisma | 11 +- dashboard/server/cors.ts | 2 +- dashboard/server/schemas/tracks.ts | 19 ++ dashboard/server/tracks.ts | 70 ++++ extension/src/background/index.ts | 183 ++++++++++- extension/src/background/sync.ts | 15 +- extension/src/content/soundcloud.ts | 132 ++++++++ extension/src/content/ytm.ts | 137 ++++++++ extension/src/manifest.ts | 12 + extension/src/popup/index.html | 13 + extension/src/popup/popup.css | 84 +++++ extension/src/popup/popup.ts | 107 +++++- extension/src/types/music.ts | 21 ++ plans/week2/AC6-music-capture.md | 307 ++++++++++++++++++ 19 files changed, 1208 insertions(+), 17 deletions(-) create mode 100644 dashboard/app/api/v1/tracks/[id]/route.ts create mode 100644 dashboard/app/api/v1/tracks/route.ts create mode 100644 dashboard/prisma/migrations/20260524200039_add_track_endedat/migration.sql create mode 100644 dashboard/prisma/migrations/20260524_add_track_listenedms_unique/migration.sql create mode 100644 dashboard/server/schemas/tracks.ts create mode 100644 dashboard/server/tracks.ts create mode 100644 extension/src/content/soundcloud.ts create mode 100644 extension/src/content/ytm.ts create mode 100644 extension/src/types/music.ts create mode 100644 plans/week2/AC6-music-capture.md diff --git a/CLAUDE.md b/CLAUDE.md index 152a045..89e596a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -3,6 +3,21 @@ Chrome extension + Next.js dashboard for capturing dev session context and generating AI session reports. +## ⚡ Local dev checklist — verify before starting work + +1. **Docker Desktop is running** — open it from the Start menu or tray. +2. **PostgreSQL container is up** — `docker-compose up -d` from repo root. + - Verify: `docker ps` → should show `worktrace-postgres` with status `Up`. + - If Prisma throws `upsert / query` errors → DB is down, start Docker first. +3. **Dashboard dev server** — `npm run dev` inside `/dashboard` (port 3000). +4. **Extension points to localhost** — `extension/.env` has `VITE_DASHBOARD_URL=http://localhost:3000`. + - After any `.env` change → rebuild: `npm run build` inside `/extension`. + +> **Symptom guide** +> - `ERR_CONNECTION_REFUSED` on fetch → dashboard not running or wrong URL +> - `Invalid prisma.X() invocation` / `Can't reach database` → Docker / PostgreSQL not running +> - Extension shows `⚠ JWT exchange failed` → dashboard not reachable (check steps 2–3 above) + ## Repo layout - `/dashboard` — Next.js 16 (App Router) web app - `/extension` — Chrome Extension (Manifest V3) — coming in AC 4 diff --git a/dashboard/app/api/v1/tracks/[id]/route.ts b/dashboard/app/api/v1/tracks/[id]/route.ts new file mode 100644 index 0000000..60d6184 --- /dev/null +++ b/dashboard/app/api/v1/tracks/[id]/route.ts @@ -0,0 +1,46 @@ +import { NextRequest, NextResponse } from "next/server"; +import { z } from "zod"; +import { endTrackForUser, TrackNotFoundError } from "@/server/tracks"; +import { UpdateTrackInput } from "@/server/schemas/tracks"; +import { withCors, corsPreflight } from "@/server/cors"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; + +interface RouteContext { + params: Promise<{ id: string }>; +} + +export function PATCH(req: NextRequest, ctx: RouteContext): Promise { + return withCors(async (r) => { + let user; + try { + user = requireUser(r); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + const { id } = await ctx.params; + + const body = await r.json(); + const parsed = UpdateTrackInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + } + + try { + const track = await endTrackForUser(user.id, id, parsed.data); + return NextResponse.json(track, { status: 200 }); + } catch (err) { + if (err instanceof TrackNotFoundError) { + return NextResponse.json({ error: "Track not found" }, { status: 404 }); + } + throw err; + } + })(req); +} + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/app/api/v1/tracks/route.ts b/dashboard/app/api/v1/tracks/route.ts new file mode 100644 index 0000000..5f3b8dd --- /dev/null +++ b/dashboard/app/api/v1/tracks/route.ts @@ -0,0 +1,38 @@ +import { NextRequest, NextResponse } from "next/server"; +import { z } from "zod"; +import { createTrackForUser, SessionNotFoundError } from "@/server/tracks"; +import { CreateTrackInput } from "@/server/schemas/tracks"; +import { withCors, corsPreflight } from "@/server/cors"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; + +export const POST = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + const body = await req.json(); + const parsed = CreateTrackInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + } + + try { + const track = await createTrackForUser(user.id, parsed.data); + return NextResponse.json(track, { status: 201 }); + } catch (err) { + if (err instanceof SessionNotFoundError) { + return NextResponse.json({ error: "Session not found" }, { status: 404 }); + } + throw err; + } +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/prisma/migrations/20260524200039_add_track_endedat/migration.sql b/dashboard/prisma/migrations/20260524200039_add_track_endedat/migration.sql new file mode 100644 index 0000000..fa6c6d8 --- /dev/null +++ b/dashboard/prisma/migrations/20260524200039_add_track_endedat/migration.sql @@ -0,0 +1,5 @@ +-- AlterTable +ALTER TABLE "Track" ADD COLUMN "endedAt" TIMESTAMP(3); + +-- CreateIndex +CREATE INDEX "Track_capturedAt_idx" ON "Track"("capturedAt"); diff --git a/dashboard/prisma/migrations/20260524_add_track_listenedms_unique/migration.sql b/dashboard/prisma/migrations/20260524_add_track_listenedms_unique/migration.sql new file mode 100644 index 0000000..825830c --- /dev/null +++ b/dashboard/prisma/migrations/20260524_add_track_listenedms_unique/migration.sql @@ -0,0 +1,8 @@ +-- DropIndex +DROP INDEX "Track_sessionId_idx"; + +-- AlterTable +ALTER TABLE "Track" ADD COLUMN "listenedMs" INTEGER NOT NULL DEFAULT 0; + +-- CreateIndex +CREATE UNIQUE INDEX "Track_sessionId_artist_title_key" ON "Track"("sessionId", "artist", "title"); diff --git a/dashboard/prisma/schema.prisma b/dashboard/prisma/schema.prisma index 3f2dd19..ab46363 100644 --- a/dashboard/prisma/schema.prisma +++ b/dashboard/prisma/schema.prisma @@ -51,12 +51,15 @@ model Event { } model Track { - id String @id @default(cuid()) + id String @id @default(cuid()) sessionId String artist String title String - capturedAt DateTime @default(now()) - session Session @relation(fields: [sessionId], references: [id], onDelete: Cascade) + listenedMs Int @default(0) // accumulated listening time across repeated plays + capturedAt DateTime @default(now()) // first detected in this session + endedAt DateTime? // latest end time (overwritten on each play) + session Session @relation(fields: [sessionId], references: [id], onDelete: Cascade) - @@index([sessionId]) + @@unique([sessionId, artist, title]) // one record per song per session; enables upsert + @@index([capturedAt]) } diff --git a/dashboard/server/cors.ts b/dashboard/server/cors.ts index f6f52e6..8edd9f3 100644 --- a/dashboard/server/cors.ts +++ b/dashboard/server/cors.ts @@ -6,7 +6,7 @@ function corsHeaders(origin: string | null): Record { const allow = origin && ALLOWED_ORIGIN_PATTERN.test(origin) ? origin : "null"; return { "Access-Control-Allow-Origin": allow, - "Access-Control-Allow-Methods": "GET, POST, OPTIONS", + "Access-Control-Allow-Methods": "GET, POST, PATCH, OPTIONS", "Access-Control-Allow-Headers": "Authorization, Content-Type", Vary: "Origin", }; diff --git a/dashboard/server/schemas/tracks.ts b/dashboard/server/schemas/tracks.ts new file mode 100644 index 0000000..7a50e84 --- /dev/null +++ b/dashboard/server/schemas/tracks.ts @@ -0,0 +1,19 @@ +import { z } from "zod"; + +// Derived manually — Track model has only artist, title, sessionId as required input. +// capturedAt is @default(now()) in Prisma; id is @default(cuid()) — never sent by client. +export const CreateTrackInput = z.object({ + sessionId: z.string().regex(/^c[a-z0-9]{24}$/, "must be a CUID"), + artist: z.string().min(1), + title: z.string().min(1), +}); + +export type CreateTrackInput = z.infer; + +// PATCH — endedAt and accumulated listening time +export const UpdateTrackInput = z.object({ + endedAt: z.string().datetime(), + listenedMs: z.number().int().min(0), +}); + +export type UpdateTrackInput = z.infer; diff --git a/dashboard/server/tracks.ts b/dashboard/server/tracks.ts new file mode 100644 index 0000000..f5e740f --- /dev/null +++ b/dashboard/server/tracks.ts @@ -0,0 +1,70 @@ +import type { CreateTrackInput, UpdateTrackInput } from "./schemas/tracks"; +import { prisma } from "./db"; + +export class SessionNotFoundError extends Error { + constructor() { + super("Session not found"); + this.name = "SessionNotFoundError"; + } +} + +export class TrackNotFoundError extends Error { + constructor() { + super("Track not found"); + this.name = "TrackNotFoundError"; + } +} + +export async function createTrackForUser( + userId: string, + input: CreateTrackInput, +) { + // Verify the session belongs to this user before writing + const session = await prisma.session.findFirst({ + where: { id: input.sessionId, userId }, + select: { id: true }, + }); + if (!session) throw new SessionNotFoundError(); + + // Upsert by [sessionId, artist, title] — same song in same session + // gets a single record; capturedAt stays from first detection. + return prisma.track.upsert({ + where: { + sessionId_artist_title: { + sessionId: input.sessionId, + artist: input.artist, + title: input.title, + }, + }, + create: { + sessionId: input.sessionId, + artist: input.artist, + title: input.title, + }, + update: { + // Reset endedAt on re-play so the record stays "open" + endedAt: null, + }, + }); +} + +export async function endTrackForUser( + userId: string, + trackId: string, + input: UpdateTrackInput, +) { + // Verify the track belongs to a session owned by this user + const track = await prisma.track.findFirst({ + where: { id: trackId, session: { userId } }, + select: { id: true }, + }); + if (!track) throw new TrackNotFoundError(); + + return prisma.track.update({ + where: { id: trackId }, + data: { + endedAt: new Date(input.endedAt), + listenedMs: { increment: input.listenedMs }, + }, + }); +} diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index f765d5b..963fafb 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -1,5 +1,6 @@ import type { AuthMessage, AuthResponse, StoredAuth } from "../types/auth"; import type { ContentMessage } from "../types/content"; +import type { MusicMessage, MusicResponse, TrackInfo } from "../types/music"; import type { PendingEvent } from "../types/pending"; import type { SessionMessage, SessionResponse } from "../types/session"; import type { SyncMessage, SyncResponse } from "../types/sync"; @@ -154,6 +155,103 @@ async function tryEndDbSession(dbSessionId: string): Promise { } } +// ─── Music: pull track from active tab ──────────────────────────────────────── + +// Returns current playbackTime from the music tab without any side effects. +// Used by TRACK_GET_CURRENT every popup tick so the popup always has a fresh +// playback position — changes every ~1s when playing, stays constant on pause. +async function queryLivePlaybackTime(): Promise { + const [ytmTabs, scTabs] = await Promise.all([ + chrome.tabs.query({ url: "https://music.youtube.com/*" }), + chrome.tabs.query({ url: "https://soundcloud.com/*" }), + ]); + const tab = ([...ytmTabs, ...scTabs].find((t) => t.active) ?? [...ytmTabs, ...scTabs][0]); + if (!tab?.id) return null; + try { + const track = await chrome.tabs.sendMessage(tab.id, { type: "TRACK_REQUEST" }) as TrackInfo | null; + return track?.playbackTime ?? null; + } catch { + return null; + } +} + +// Queries the active YTM or SoundCloud tab directly via content script. +// Used as fallback when currentTrack is not yet in storage (SW was inactive at +// the time the content script first ran and the message was dropped). +async function queryActiveTabForTrack(): Promise { + // Search by URL — more reliable than active/currentWindow from a service worker context + const [ytmTabs, scTabs] = await Promise.all([ + chrome.tabs.query({ url: "https://music.youtube.com/*" }), + chrome.tabs.query({ url: "https://soundcloud.com/*" }), + ]); + + const candidates = [...ytmTabs, ...scTabs]; + if (candidates.length === 0) return null; + + // Prefer an active tab; otherwise use the first match + const tab = candidates.find((t) => t.active) ?? candidates[0]; + if (!tab?.id) return null; + + try { + const track = await chrome.tabs.sendMessage(tab.id, { type: "TRACK_REQUEST" }) as TrackInfo | null; + if (track) { + await chrome.storage.local.set({ currentTrack: track }); + // Save to DB only if we don't already have a DB record for this tab pull + const existing = await chrome.storage.local.get("currentDbTrackId"); + if (!existing["currentDbTrackId"]) { + const session = await getSession(); + if (session && session.pausedAt === null && session.dbSessionId) { + void saveTrackToDb(track, session.dbSessionId); + } + } + } + return track; + } catch { + return null; + } +} + +// ─── Music: save / end track in DB ──────────────────────────────────────────── + +// Saves a new track to DB and stores its id + period start for listenedMs accumulation. +// Best-effort — errors are logged but never surface to the user. +async function saveTrackToDb(track: TrackInfo, dbSessionId: string): Promise { + try { + const res = await apiFetch("/api/v1/tracks", { + method: "POST", + body: JSON.stringify({ sessionId: dbSessionId, artist: track.artist, title: track.title }), + }); + if (!res.ok) return; + const { id } = await res.json() as { id: string }; + // Store id and the moment this listening period started (for listenedMs delta) + await chrome.storage.local.set({ currentDbTrackId: id, currentPeriodStartMs: Date.now() }); + } catch (err) { + console.warn("[worktrace] track save failed:", err); + } +} + +// Closes the previous DB track record: sends endedAt + listenedMs delta. +async function endCurrentDbTrack(): Promise { + const r = await chrome.storage.local.get(["currentDbTrackId", "currentPeriodStartMs"]); + const id = r["currentDbTrackId"] as string | undefined; + const periodStart = r["currentPeriodStartMs"] as number | undefined; + if (!id) return; + + const now = Date.now(); + const listenedMs = periodStart ? Math.max(0, now - periodStart) : 0; + + try { + await apiFetch(`/api/v1/tracks/${id}`, { + method: "PATCH", + body: JSON.stringify({ endedAt: new Date(now).toISOString(), listenedMs }), + }); + } catch (err) { + console.warn("[worktrace] track end failed:", err); + } finally { + await chrome.storage.local.remove(["currentDbTrackId", "currentPeriodStartMs"]); + } +} + // ─── Pending event queue ─────────────────────────────────────────────────────── async function enqueuePending(event: PendingEvent): Promise { @@ -165,13 +263,13 @@ async function enqueuePending(event: PendingEvent): Promise { // ─── Message listener ────────────────────────────────────────────────────────── -type IncomingMessage = AuthMessage | SessionMessage | ContentMessage | SyncMessage; +type IncomingMessage = AuthMessage | SessionMessage | ContentMessage | SyncMessage | MusicMessage; chrome.runtime.onMessage.addListener( ( message: IncomingMessage, _sender, - sendResponse: (r: AuthResponse | SessionResponse | SyncResponse) => void, + sendResponse: (r: AuthResponse | SessionResponse | SyncResponse | MusicResponse) => void, ) => { if (message.type === "AUTH_LOGIN") { if (DEV_MODE) { @@ -250,7 +348,7 @@ chrome.runtime.onMessage.addListener( if (message.type === "SESSION_STOP") { (async () => { - // Drain before clearing the session — once cleared, flush would exit early + await endCurrentDbTrack(); // record endedAt for the last playing track await flush(); return stopSession(); })() @@ -294,7 +392,14 @@ chrome.runtime.onMessage.addListener( } if (message.type === "SESSION_PAUSE") { - pauseSession() + (async () => { + // pauseSession() first — updates storage immediately so SESSION_GET_STATE + // returns "paused" before the (slow) endCurrentDbTrack API call finishes. + // This prevents the popup poll from seeing "active" and re-enabling the timer. + const session = await pauseSession(); + await endCurrentDbTrack(); // record listenedMs up to pause point + return session; + })() .then((session) => sendResponse({ success: true, @@ -312,12 +417,18 @@ chrome.runtime.onMessage.addListener( if (message.type === "SESSION_RESUME") { resumeSession() - .then((session) => + .then(async (session) => { sendResponse({ success: true, session: session ? { ...session, elapsedMs: getElapsedMs(session) } : null, - }), - ) + }); + // Re-open a DB track record for the currently playing song (if any) + if (session?.dbSessionId) { + const r = await chrome.storage.local.get("currentTrack"); + const track = r["currentTrack"] as TrackInfo | undefined; + if (track) void saveTrackToDb(track, session.dbSessionId); + } + }) .catch((err: unknown) => sendResponse({ success: false, @@ -356,6 +467,55 @@ chrome.runtime.onMessage.addListener( return true; } + // ─── Music messages ────────────────────────────────────────────────────── + + if (message.type === "TRACK_CAPTURED") { + const track = message.payload; + void chrome.storage.local.set({ currentTrack: track }); + + // Close the previous track then save the new one + getSession().then(async (session) => { + await endCurrentDbTrack(); // no-op if no previous track + if (session && session.pausedAt === null && session.dbSessionId) { + void saveTrackToDb(track, session.dbSessionId); + } + }); + + return false; + } + + if (message.type === "TRACK_GET_CURRENT") { + (async () => { + const r = await chrome.storage.local.get("currentTrack"); + const stored = (r["currentTrack"] as TrackInfo | undefined) ?? null; + + if (!stored) { + // No stored track — full tab query (saves to storage + DB if needed) + const track = await queryActiveTabForTrack(); + sendResponse({ success: true, track }); + return; + } + + // Track exists in storage. SW is already awake (popup just woke it), so + // querying the content script directly is reliable and gives fresh + // playbackTime — the current position from the player bar DOM. + // This changes every ~1s when playing and stays constant on pause, + // letting the popup detect pause state by comparing consecutive values. + const livePlaybackTime = await queryLivePlaybackTime(); + const track: TrackInfo = livePlaybackTime !== null + ? { ...stored, playbackTime: livePlaybackTime } + : stored; + + sendResponse({ success: true, track }); + })().catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + // ─── Content script messages ───────────────────────────────────────────── if (message.type === "PAGE_METADATA") { @@ -387,4 +547,11 @@ chrome.runtime.onInstalled.addListener((details) => { }); // Boot sync alarm — runs every service-worker startup, idempotent under chrome.alarms -initSync({ apiFetch, ensureDbSession }); +initSync({ + apiFetch, + ensureDbSession, + checkAuth: async () => { + const stored = await getStoredAuth(); + return stored !== null && !isExpired(stored.jwtExpiresAt); + }, +}); diff --git a/extension/src/background/sync.ts b/extension/src/background/sync.ts index 1618af9..467def8 100644 --- a/extension/src/background/sync.ts +++ b/extension/src/background/sync.ts @@ -15,13 +15,20 @@ export interface SyncStatus { // Functions injected at startup to avoid circular import with background/index.ts type ApiFetch = (path: string, init?: RequestInit) => Promise; type EnsureDbSession = () => Promise; +type CheckAuth = () => Promise; let apiFetchFn: ApiFetch | null = null; let ensureDbSessionFn: EnsureDbSession | null = null; +let checkAuthFn: CheckAuth | null = null; -export function initSync(deps: { apiFetch: ApiFetch; ensureDbSession: EnsureDbSession }): void { +export function initSync(deps: { + apiFetch: ApiFetch; + ensureDbSession: EnsureDbSession; + checkAuth: CheckAuth; +}): void { apiFetchFn = deps.apiFetch; ensureDbSessionFn = deps.ensureDbSession; + checkAuthFn = deps.checkAuth; chrome.alarms.create(ALARM_NAME, { periodInMinutes: PERIOD_MIN }); chrome.alarms.onAlarm.addListener((alarm) => { @@ -47,7 +54,11 @@ async function setStatus(patch: Partial): Promise { // ─── Flush ───────────────────────────────────────────────────────────────────── export async function flush(): Promise { - if (!apiFetchFn || !ensureDbSessionFn) return; + if (!apiFetchFn || !ensureDbSessionFn || !checkAuthFn) return; + + // Skip flush entirely if the user is not authenticated — avoids ERR_CONNECTION_REFUSED spam + const isAuth = await checkAuthFn(); + if (!isAuth) return; const session = await getSession(); if (!session) return; diff --git a/extension/src/content/soundcloud.ts b/extension/src/content/soundcloud.ts new file mode 100644 index 0000000..809d7dc --- /dev/null +++ b/extension/src/content/soundcloud.ts @@ -0,0 +1,132 @@ +import type { TrackInfo, MusicMessage } from "../types/music"; + +// ─── DOM parsing ─────────────────────────────────────────────────────────────── + +/** + * Read current playback position from the SoundCloud player bar. + * Changes every ~1 second when playing, stays constant when paused. + */ +function getPlaybackTime(): string { + // Time passed element (e.g. "1:23") + const timeEl = document.querySelector( + ".playbackTimeline__timePassed, " + + "[class*='timePassed'], " + + ".playControls__time", + ); + if (timeEl) { + const t = timeEl.textContent?.trim() ?? ""; + if (t && t !== "0:00") return t; + } + + // Progress bar aria-valuenow (percentage 0-100 or seconds) + const bar = document.querySelector( + ".playbackTimeline__progressWrapper, " + + "[class*='progressWrapper']", + ); + if (bar) { + const val = bar.getAttribute("aria-valuenow"); + if (val && val !== "0") return val; + } + + return ""; +} + +function parseTrack(): TrackInfo | null { + const titleEl = document.querySelector( + ".playbackSoundBadge__titleLink span:not(.sc-visuallyhidden)", + ); + const artistEl = document.querySelector( + ".playbackSoundBadge__lightLink", + ); + + const titleDOM = titleEl?.textContent?.trim() ?? ""; + const artistDOM = artistEl?.textContent?.trim() ?? ""; + + if (titleDOM && artistDOM) { + return { + title: titleDOM, + artist: artistDOM, + source: "soundcloud", + capturedAt: new Date().toISOString(), + playbackTime: getPlaybackTime(), + }; + } + + const byMatch = /^(.+?) by (.+?) \| /.exec(document.title); + if (byMatch) { + const [, title, artist] = byMatch; + if (title && artist) { + return { + title, + artist, + source: "soundcloud", + capturedAt: new Date().toISOString(), + playbackTime: getPlaybackTime(), + }; + } + } + + return null; +} + +// ─── Deduplication ──────────────────────────────────────────────────────────── + +let previousKey = ""; + +function sendIfChanged(track: TrackInfo | null): void { + if (!track) return; + const key = `${track.title}::${track.artist}`; + if (key === previousKey) return; + previousKey = key; + + const message: MusicMessage = { type: "TRACK_CAPTURED", payload: track }; + chrome.runtime.sendMessage(message).catch(() => { /* SW inactive — ignore */ }); +} + +// ─── MutationObserver ───────────────────────────────────────────────────────── + +function observeChanges(): void { + const titleNode = document.querySelector("title"); + if (titleNode) { + new MutationObserver(() => sendIfChanged(parseTrack())).observe(titleNode, { + childList: true, characterData: true, subtree: true, + }); + } + + const badge = document.querySelector(".playbackSoundBadge"); + if (badge) { + new MutationObserver(() => sendIfChanged(parseTrack())).observe(badge, { + childList: true, subtree: true, characterData: true, + }); + } else { + const bodyObserver = new MutationObserver(() => { + const b = document.querySelector(".playbackSoundBadge"); + if (b) { + bodyObserver.disconnect(); + new MutationObserver(() => sendIfChanged(parseTrack())).observe(b, { + childList: true, subtree: true, characterData: true, + }); + sendIfChanged(parseTrack()); + } + }); + bodyObserver.observe(document.body, { childList: true, subtree: true }); + } +} + +// ─── On-demand request from background ──────────────────────────────────────── + +chrome.runtime.onMessage.addListener( + (msg: unknown, _sender, sendResponse: (track: TrackInfo | null) => void) => { + const type = (msg as Record | null)?.["type"]; + if (type === "TRACK_REQUEST") { + sendResponse(parseTrack()); + return false; + } + return false; + }, +); + +// ─── Boot ───────────────────────────────────────────────────────────────────── + +sendIfChanged(parseTrack()); +observeChanges(); diff --git a/extension/src/content/ytm.ts b/extension/src/content/ytm.ts new file mode 100644 index 0000000..5f65258 --- /dev/null +++ b/extension/src/content/ytm.ts @@ -0,0 +1,137 @@ +import type { TrackInfo, MusicMessage } from "../types/music"; + +// ─── DOM parsing ─────────────────────────────────────────────────────────────── + +function firstText(...selectors: string[]): string { + for (const sel of selectors) { + const text = document.querySelector(sel)?.textContent?.trim(); + if (text) return text; + } + return ""; +} + +/** + * Read current playback position from the player bar. + * Returns a string that changes every ~1 second when playing and stays + * constant when paused — used by the popup to detect pause state. + * + * Uses .time-info textContent ("1:34 / 4:56") — confirmed to update in + * real-time while playing and stay constant on pause. + * The slider aria-valuenow was tried but returns a static value. + */ +function getPlaybackTime(): string { + // Time info text "1:34 / 4:56" — take the left side (current position) + const timeEl = document.querySelector( + "ytmusic-player-bar .time-info, " + + "#left-controls .time-info", + ); + if (timeEl) { + const raw = timeEl.textContent?.trim() ?? ""; + const curr = raw.split("/")[0]?.trim() ?? ""; + if (curr) return curr; + } + + return ""; +} + +function parseTrack(): TrackInfo | null { + const title = firstText( + "ytmusic-player-bar yt-formatted-string.title", + "ytmusic-player-bar .title.ytmusic-player-bar", + "ytmusic-player-bar .title", + ); + + const artist = firstText( + "ytmusic-player-bar yt-formatted-string.byline a:first-child", + "ytmusic-player-bar .byline.ytmusic-player-bar a:first-child", + "ytmusic-player-bar .subtitle.ytmusic-player-bar a:first-child", + "ytmusic-player-bar yt-formatted-string.byline", + "ytmusic-player-bar .byline", + "ytmusic-player-bar .subtitle", + ); + + if (title && artist) { + return { + title, + artist, + source: "youtube-music", + capturedAt: new Date().toISOString(), + playbackTime: getPlaybackTime(), + }; + } + + const titleFromDoc = document.title.replace(/\s*[-·]\s*YouTube Music\s*$/i, "").trim(); + if (titleFromDoc && titleFromDoc !== "YouTube Music" && artist) { + return { + title: titleFromDoc, + artist, + source: "youtube-music", + capturedAt: new Date().toISOString(), + playbackTime: getPlaybackTime(), + }; + } + + return null; +} + +// ─── Deduplication ──────────────────────────────────────────────────────────── + +let previousKey = ""; + +function sendIfChanged(track: TrackInfo | null): void { + if (!track) return; + const key = `${track.title}::${track.artist}`; + if (key === previousKey) return; + previousKey = key; + + const message: MusicMessage = { type: "TRACK_CAPTURED", payload: track }; + chrome.runtime.sendMessage(message).catch(() => { /* SW inactive — ignore */ }); +} + +// ─── MutationObserver ───────────────────────────────────────────────────────── + +function observeChanges(): void { + const titleNode = document.querySelector("title"); + if (titleNode) { + new MutationObserver(() => sendIfChanged(parseTrack())).observe(titleNode, { + childList: true, characterData: true, subtree: true, + }); + } + + const playerBar = document.querySelector("ytmusic-player-bar"); + if (playerBar) { + new MutationObserver(() => sendIfChanged(parseTrack())).observe(playerBar, { + childList: true, subtree: true, characterData: true, + }); + } else { + const bodyObserver = new MutationObserver(() => { + const bar = document.querySelector("ytmusic-player-bar"); + if (bar) { + bodyObserver.disconnect(); + new MutationObserver(() => sendIfChanged(parseTrack())).observe(bar, { + childList: true, subtree: true, characterData: true, + }); + sendIfChanged(parseTrack()); + } + }); + bodyObserver.observe(document.body, { childList: true, subtree: true }); + } +} + +// ─── On-demand request from background ──────────────────────────────────────── + +chrome.runtime.onMessage.addListener( + (msg: unknown, _sender, sendResponse: (track: TrackInfo | null) => void) => { + const type = (msg as Record | null)?.["type"]; + if (type === "TRACK_REQUEST") { + sendResponse(parseTrack()); + return false; + } + return false; + }, +); + +// ─── Boot ───────────────────────────────────────────────────────────────────── + +sendIfChanged(parseTrack()); +observeChanges(); diff --git a/extension/src/manifest.ts b/extension/src/manifest.ts index 024b576..174da6a 100644 --- a/extension/src/manifest.ts +++ b/extension/src/manifest.ts @@ -26,10 +26,22 @@ export default defineManifest({ js: ["src/content/index.ts"], run_at: "document_idle", }, + { + matches: ["https://music.youtube.com/*"], + js: ["src/content/ytm.ts"], + run_at: "document_idle", + }, + { + matches: ["https://soundcloud.com/*"], + js: ["src/content/soundcloud.ts"], + run_at: "document_idle", + }, ], permissions: ["storage", "activeTab", "tabs", "identity", "alarms"], host_permissions: [ "http://localhost:3000/*", "https://worktrace-ecru.vercel.app/*", + "https://music.youtube.com/*", + "https://soundcloud.com/*", ], }); diff --git a/extension/src/popup/index.html b/extension/src/popup/index.html index 15e9bcb..7789919 100644 --- a/extension/src/popup/index.html +++ b/extension/src/popup/index.html @@ -51,6 +51,19 @@
not synced yet
+ + +
diff --git a/extension/src/popup/popup.css b/extension/src/popup/popup.css index 142ce4e..963f51b 100644 --- a/extension/src/popup/popup.css +++ b/extension/src/popup/popup.css @@ -204,6 +204,90 @@ body { color: var(--c-yellow); } +/* ── popup__track ──────────────────────────────────────────────────────────── */ +.popup__track { + display: flex; + align-items: center; + gap: 8px; + background: var(--c-surface); + border: 1px solid var(--c-border); + border-radius: 4px; + padding: 6px 10px; + font-size: 11px; + color: var(--c-text); + transition: border-color 0.3s; +} + +.popup__track-icon { + flex-shrink: 0; + font-size: 13px; + color: var(--c-purple); + filter: drop-shadow(0 0 3px var(--c-purple)); +} + +.popup__track-info { + display: flex; + flex-direction: column; + gap: 2px; + min-width: 0; + flex: 1; +} + +.popup__track-title { + font-weight: 700; + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; + color: var(--c-text); +} + +.popup__track-artist { + font-size: 10px; + color: var(--c-muted); + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} + +.popup__track-right { + display: flex; + flex-direction: column; + align-items: flex-end; + gap: 3px; + flex-shrink: 0; +} + +.popup__track-source { + font-size: 9px; + font-weight: 700; + letter-spacing: 0.05em; + padding: 2px 5px; + border-radius: 3px; + border: 1px solid currentColor; +} + +.popup__track-duration { + font-size: 9px; + color: var(--c-muted); + font-variant-numeric: tabular-nums; +} + +.popup__track-source--ytm { + color: var(--c-cyan); + border-color: color-mix(in srgb, var(--c-cyan) 40%, transparent); +} + +.popup__track-source--sc { + color: #ff5500; + border-color: color-mix(in srgb, #ff5500 40%, transparent); +} + +/* Gray-out music block when session is not actively running */ +.popup__track--inactive { + opacity: 0.35; + pointer-events: none; +} + /* ── popup__notes ──────────────────────────────────────────────────────────── */ .popup__notes { display: flex; diff --git a/extension/src/popup/popup.ts b/extension/src/popup/popup.ts index d76f318..7810817 100644 --- a/extension/src/popup/popup.ts +++ b/extension/src/popup/popup.ts @@ -1,4 +1,5 @@ import type { AuthMessage, AuthResponse } from "../types/auth"; +import type { MusicMessage, MusicResponse, TrackInfo } from "../types/music"; import type { SessionMessage, SessionResponse, SessionState } from "../types/session"; import type { SyncMessage, SyncResponse } from "../types/sync"; @@ -34,6 +35,16 @@ function sendSync(msg: SyncMessage): Promise { ); } +function sendMusic(msg: MusicMessage): Promise { + return new Promise((resolve, reject) => + chrome.runtime.sendMessage(msg, (res: MusicResponse | undefined) => { + if (chrome.runtime.lastError) return reject(new Error(chrome.runtime.lastError.message)); + if (!res) return reject(new Error("No response from background")); + resolve(res); + }), + ); +} + // ─── DOM refs ────────────────────────────────────────────────────────────────── const statusDot = document.getElementById("status-dot") as HTMLSpanElement; @@ -53,6 +64,11 @@ const userEmail = document.getElementById("user-email") as HTMLSpanEleme const noteInput = document.getElementById("note-input") as HTMLInputElement; const tagsInput = document.getElementById("tags-input") as HTMLInputElement; const btnNote = document.getElementById("btn-note") as HTMLButtonElement; +const trackSection = document.getElementById("track-section") as HTMLDivElement; +const trackTitle = document.getElementById("track-title") as HTMLSpanElement; +const trackArtist = document.getElementById("track-artist") as HTMLSpanElement; +const trackSource = document.getElementById("track-source") as HTMLSpanElement; +const trackDuration = document.getElementById("track-duration") as HTMLSpanElement; // ─── Timer formatting ────────────────────────────────────────────────────────── @@ -68,7 +84,11 @@ function formatMs(ms: number): string { type UIState = "idle" | "active" | "paused"; +let isSessionActive = false; // true only when state === "active" + function applyState(state: UIState, elapsedMs = 0): void { + isSessionActive = state === "active"; + timerEl.textContent = state === "idle" ? "00:00:00" : formatMs(elapsedMs); timerEl.className = `popup__time popup__time--${state}`; @@ -81,6 +101,9 @@ function applyState(state: UIState, elapsedMs = 0): void { btnStop.disabled = state === "idle"; btnPause.textContent = state === "paused" ? "▶ RESUME" : "⏸ PAUSE"; btnNote.disabled = state !== "active"; + + // Gray out the music block when session is not actively running + trackSection.classList.toggle("popup__track--inactive", !isSessionActive); } function showAuthenticated(email: string | null): void { @@ -132,6 +155,76 @@ async function refreshSyncIndicator(): Promise { } } +// ─── Now Playing ────────────────────────────────────────────────────────────── + +let activeTrack: TrackInfo | null = null; +// Accumulated display duration in ms — only increments while session is active +// AND music is actually playing (detected by playbackTime changing). +// Reset to 0 on track change; initialised from capturedAt on first popup load. +let displayDurationMs = 0; +// Previous playbackTime value — compared each tick to detect play vs pause. +// null = not yet initialised (first tick after track appears). +let prevPlaybackTime: string | null = null; + +function formatTrackDuration(ms: number): string { + const totalSec = Math.floor(ms / 1000); + const m = Math.floor(totalSec / 60); + const s = totalSec % 60; + return `${String(m)}:${String(s).padStart(2, "0")}`; +} + +function applyTrack(track: TrackInfo | null): void { + const prevKey = activeTrack ? `${activeTrack.title}::${activeTrack.artist}` : null; + const newKey = track ? `${track.title}::${track.artist}` : null; + + // Reset duration counter and playback-time baseline when track changes + if (newKey !== prevKey) { + displayDurationMs = track + ? Math.max(0, Date.now() - new Date(track.capturedAt).getTime()) + : 0; + prevPlaybackTime = null; + } + + activeTrack = track; + + if (!track) { + trackSection.style.display = "none"; + return; + } + + trackSection.style.display = "flex"; + trackTitle.textContent = track.title; + trackArtist.textContent = track.artist; + trackDuration.textContent = formatTrackDuration(displayDurationMs); + + const isYTM = track.source === "youtube-music"; + trackSource.textContent = isYTM ? "YTM" : "SC"; + trackSource.className = `popup__track-source popup__track-source--${isYTM ? "ytm" : "sc"}`; +} + +function refreshDuration(): void { + if (!activeTrack) return; + + // Detect play/pause by comparing consecutive playbackTime values from the DOM. + // If playbackTime changed since last tick → playing. Same → paused. + // prevPlaybackTime = null on first tick → skip increment (safe default). + const curr = activeTrack.playbackTime ?? ""; + const trackIsPlaying = + prevPlaybackTime !== null && // not first tick + curr !== "" && // player returned a position + curr !== prevPlaybackTime; // position advanced since last tick + prevPlaybackTime = curr; + + if (isSessionActive && trackIsPlaying) displayDurationMs += 1000; + trackDuration.textContent = formatTrackDuration(displayDurationMs); +} + +async function refreshTrack(): Promise { + const res = await sendMusic({ type: "TRACK_GET_CURRENT" }).catch(() => null); + if (!res || !res.success) return; + applyTrack(res.track); +} + // ─── Session polling ─────────────────────────────────────────────────────────── let pollInterval: ReturnType | null = null; @@ -150,6 +243,8 @@ function startPolling(): void { applyState("active", session.elapsedMs); } await refreshSyncIndicator(); + await refreshTrack(); + refreshDuration(); // update elapsed time without extra round-trip }, 1000); } @@ -179,6 +274,7 @@ async function init(): Promise { } await refreshSyncIndicator(); + await refreshTrack(); startPolling(); } @@ -187,12 +283,19 @@ async function init(): Promise { btnLogin.addEventListener("click", async () => { btnLogin.disabled = true; btnLogin.textContent = "Signing in..."; - const res = await sendAuth({ type: "AUTH_LOGIN" }).catch(() => null); + const res = await sendAuth({ type: "AUTH_LOGIN" }).catch((err: unknown) => { + const msg = err instanceof Error ? err.message : "Unknown error"; + return { success: false as const, error: msg }; + }); if (res?.success) { await init(); } else { btnLogin.disabled = false; - btnLogin.textContent = "Sign in with Google"; + const errMsg = "error" in res && res.error ? res.error : "Sign-in failed"; + // Trim long error to keep the button readable; full error is in SW inspector + const short = errMsg.length > 40 ? `${errMsg.slice(0, 40)}…` : errMsg; + btnLogin.textContent = `⚠ ${short}`; + setTimeout(() => { btnLogin.textContent = "Sign in with Google"; }, 4000); } }); diff --git a/extension/src/types/music.ts b/extension/src/types/music.ts new file mode 100644 index 0000000..d29758b --- /dev/null +++ b/extension/src/types/music.ts @@ -0,0 +1,21 @@ +export interface TrackInfo { + title: string; + artist: string; + source: "youtube-music" | "soundcloud"; + capturedAt: string; // ISO 8601 + playbackTime: string; // current playback position from DOM (e.g. "1:23" or "94.5") + // changes every ~1s when playing, stays constant on pause + // empty string if the player bar is not yet rendered +} + +export type MusicMessage = + | { type: "TRACK_CAPTURED"; payload: TrackInfo } + | { type: "TRACK_GET_CURRENT" }; + +export type MusicResponse = + | { success: true; track: TrackInfo | null } + | { success: false; error: string }; + +// Sent background → content script to pull the current track on demand +// (handles SW race condition: content script ran before SW was active) +export type MusicTabMessage = { type: "TRACK_REQUEST" }; diff --git a/plans/week2/AC6-music-capture.md b/plans/week2/AC6-music-capture.md new file mode 100644 index 0000000..55d5c6f --- /dev/null +++ b/plans/week2/AC6-music-capture.md @@ -0,0 +1,307 @@ +# Plan: AC6 — Music Capture (Bonus) + +**Branch:** `feature/extension-music-capture` +**PR target:** `development` +**Scope:** Content script захоплює метадані поточного треку з YouTube Music і SoundCloud (назва, виконавець). Оновлюється в реальному часі через `MutationObserver`. Поточний трек відображається в popup. При активній сесії трек зберігається в DB через новий Route Handler. + +--- + +## Acceptance Criteria (з Task.md) + +- [x] Content script захоплює назву та виконавця на YouTube Music (`music.youtube.com`) +- [x] Content script захоплює назву та виконавця на SoundCloud (`soundcloud.com`) +- [x] Дані оновлюються в реальному часі через `MutationObserver` +- [x] Поточний трек відображається в popup +- [x] При активній сесії трек зберігається в DB (модель `Track` вже існує в schema) + +## Додаткові вимоги (виявлені під час тестування) + +- [x] При **паузі** сесії — зупиняти лічильник тривалості треку + відправляти `endedAt` в БД +- [x] При **відновленні** сесії — відкривати новий DB-запис для поточного треку (акумуляція `listenedMs`) +- [x] Якщо пісня вже є в сесії в БД — **акумулювати `listenedMs`** через upsert (не дублювати запис) +- [x] `endedAt` встановлюється одразу при зміні/закінченні треку +- [x] Музика зберігається в БД **тільки під час активного таймера** (не під час паузи) +- [x] Коли таймер неактивний (пауза/idle) — **підсвічувати блок музики сірим** в popup + +--- + +## Архітектурні рішення + +### 1. Окремі content scripts для кожної платформи + +Замість модифікації `extension/src/content/index.ts` — додаємо два окремих файли: +- `extension/src/content/ytm.ts` — YouTube Music +- `extension/src/content/soundcloud.ts` — SoundCloud + +**Чому:** URL-матчинг і DOM-структура повністю різні. Один universal script з platform-detection — більш складний і важко тестувати окремо. + +### 2. Типи в окремому `extension/src/types/music.ts` + +```ts +export interface TrackInfo { + title: string; + artist: string; + source: "youtube-music" | "soundcloud"; + capturedAt: string; // ISO 8601 +} + +export type MusicMessage = + | { type: "TRACK_CAPTURED"; payload: TrackInfo } + | { type: "TRACK_GET_CURRENT" }; + +export type MusicResponse = + | { success: true; track: TrackInfo | null } + | { success: false; error: string }; +``` + +### 3. Message flow (строго дотримуємось CLAUDE.md) + +``` +ytm.ts / soundcloud.ts + └── chrome.runtime.sendMessage({ type: "TRACK_CAPTURED", payload }) + ↓ + background/index.ts + ├── chrome.storage.local.set({ currentTrack }) + └── якщо сесія активна → POST /api/v1/tracks (upsert) + ↓ (fail → best-effort, не ламає flow) + +popup.ts + └── TRACK_GET_CURRENT → background → повертає currentTrack з storage +``` + +### 4. DOM селектори + +**YouTube Music** (`music.youtube.com`): + +| Елемент | Селектор | +|---------|---------| +| Назва треку | `ytmusic-player-bar .title.ytmusic-player-bar` | +| Виконавець | `ytmusic-player-bar .subtitle.ytmusic-player-bar a:first-child` | +| Fallback (title tag) | `document.title` — формат: `"Назва - Виконавець - YouTube Music"` | + +MutationObserver спостерігає за `ytmusic-player-bar` або ``. Якщо `<title>` змінюється — парсимо через regex: `/^(.+?) - (.+?) - YouTube Music$/`. + +**SoundCloud** (`soundcloud.com`): + +| Елемент | Селектор | +|---------|---------| +| Назва треку | `.playbackSoundBadge__titleLink span:not(.sc-visuallyhidden)` | +| Виконавець | `.playbackSoundBadge__lightLink` | +| Fallback (title tag) | `document.title` — формат: `"Назва by Виконавець \| SoundCloud"` | + +MutationObserver спостерігає за `.playbackSoundBadge` або `<title>`. + +### 5. Дедуплікація трека + +Зберігаємо `previousTrack` в пам'яті content script. Відправляємо `TRACK_CAPTURED` тільки якщо `title !== previousTrack.title || artist !== previousTrack.artist`. Це запобігає flood-у повідомлень при кожній мутації DOM. + +### 6. Route Handler `POST /api/v1/tracks` + +Тонкий route handler: parse → Zod validate → `server/tracks.ts` → DB. + +**Body schema** (похідна від `Track` моделі): +```ts +z.object({ + sessionId: z.string().cuid(), + artist: z.string().min(1), + title: z.string().min(1), +}) +``` +`capturedAt` — `@default(now())` в Prisma, не передаємо з клієнта. + +### 7. `PATCH /api/v1/tracks/:id` — endedAt + listenedMs + +```ts +z.object({ + endedAt: z.string().datetime(), + listenedMs: z.number().int().min(0), +}) +``` + +Накопичувальне: `prisma.track.update({ data: { endedAt, listenedMs: { increment: delta } } })`. + +### 8. Upsert замість create + +`POST /api/v1/tracks` → `prisma.track.upsert` по `@@unique([sessionId, artist, title])`. +При повторному запуску тої самої пісні в сесії — запис оновлюється (endedAt: null), `listenedMs` акумулюється через наступний PATCH. + +### 9. Облік `listenedMs` — `currentPeriodStartMs` + +Background зберігає `currentPeriodStartMs = Date.now()` при POST. +При PATCH (`endCurrentDbTrack`) — обчислює `listenedMs = Date.now() - currentPeriodStartMs`. + +### 10. Popup UI — секція "NOW PLAYING" + +- HTML: секція `#track-section` з `♪` іконкою, title, artist, source badge, duration +- CSS: `.popup__track--inactive { opacity: 0.35 }` — сіра підсвітка коли таймер неактивний +- TS: `displayDurationMs` — локальний лічильник, інкрементується лише при `isSessionActive = true` + +--- + +## Файли, що змінюються / додаються + +| Файл | Дія | +|------|-----| +| `extension/src/types/music.ts` | **NEW** — TrackInfo, MusicMessage, MusicResponse | +| `extension/src/content/ytm.ts` | **NEW** — YouTube Music content script | +| `extension/src/content/soundcloud.ts` | **NEW** — SoundCloud content script | +| `extension/src/manifest.ts` | **EDIT** — додати content_scripts + host_permissions | +| `extension/src/background/index.ts` | **EDIT** — handle TRACK_CAPTURED, TRACK_GET_CURRENT, pause/resume | +| `extension/src/popup/index.html` | **EDIT** — секція NOW PLAYING | +| `extension/src/popup/popup.ts` | **EDIT** — sendMusic, track timer, gray-out state | +| `extension/src/popup/popup.css` | **EDIT** — стилі .popup__track, .popup__track--inactive | +| `dashboard/prisma/schema.prisma` | **EDIT** — listenedMs field + @@unique constraint | +| `dashboard/prisma/migrations/...` | **NEW** — migration for listenedMs + unique | +| `dashboard/app/api/v1/tracks/route.ts` | **NEW** — POST /api/v1/tracks | +| `dashboard/app/api/v1/tracks/[id]/route.ts` | **NEW** — PATCH /api/v1/tracks/:id | +| `dashboard/server/tracks.ts` | **NEW** — createTrack (upsert), endTrack (increment) | +| `dashboard/server/schemas/tracks.ts` | **NEW** — Zod schema для Track | +| `dashboard/server/cors.ts` | **EDIT** — додати PATCH до Allow-Methods | + +--- + +## Детальний план комітів + +### Коміт 1 — docs (після апруву плану) +``` +docs(plans): add AC6 music capture plan +``` + +### Коміт 2 — Types +``` +feat(extension): add TrackInfo types and music message definitions +``` + +### Коміт 3 — YouTube Music content script +``` +feat(extension): add YouTube Music content script with MutationObserver +``` + +### Коміт 4 — SoundCloud content script +``` +feat(extension): add SoundCloud content script with MutationObserver +``` + +### Коміт 5 — Manifest update +``` +feat(extension): update manifest with music content scripts and host_permissions +``` + +### Коміт 6 — Background: handle music messages + save to DB +``` +feat(extension): handle TRACK_CAPTURED in background and save to DB +``` + +### Коміт 7 — Dashboard: POST /api/v1/tracks +``` +feat(dashboard): add POST /api/v1/tracks route handler +``` + +### Коміт 8 — Popup: now-playing UI +``` +feat(extension): display now-playing track in popup UI +``` + +### Коміт 9 — fix: skip sync when unauth +``` +fix(extension): skip sync flush when unauthenticated to stop retry flood +``` + +### Коміт 10 — fix: popup visibility + auth error +``` +fix(extension): fix track section visibility and show auth error in popup +``` + +### Коміт 11 — fix: on-demand pull +``` +fix(extension): add TRACK_REQUEST on-demand pull to fix SW race condition +``` + +### Коміт 12 — docs: dev checklist +``` +docs: add local dev checklist to CLAUDE.md +``` + +### Коміт 13 — fix: save on-demand pull to DB +``` +fix(extension): save track to DB on on-demand TRACK_REQUEST pull +``` + +### Коміт 14 — feat: duration timer +``` +feat(extension): show track listening duration timer in popup +``` + +### Коміт 15 — feat: listenedMs accumulation + pause/resume + gray-out +``` +feat: accumulate listenedMs per track, pause timer, gray out music block +``` + +Зміни: +- `dashboard/prisma/schema.prisma` — `listenedMs Int @default(0)` + `@@unique([sessionId, artist, title])` +- `dashboard/prisma/migrations/...` — нова міграція +- `dashboard/server/schemas/tracks.ts` — `UpdateTrackInput` додає `listenedMs` +- `dashboard/server/tracks.ts` — `createTrackForUser` → upsert; `endTrackForUser` → `listenedMs: { increment }` +- `dashboard/server/cors.ts` — `PATCH` в `Allow-Methods` +- `extension/src/background/index.ts` — `currentPeriodStartMs`, `SESSION_PAUSE` → `endCurrentDbTrack`, `SESSION_RESUME` → `saveTrackToDb` +- `extension/src/popup/popup.ts` — `isSessionActive`, `displayDurationMs`, gray-out toggle +- `extension/src/popup/popup.css` — `.popup__track--inactive` + +--- + +## Ризики та рішення + +| Ризик | Рішення | +|-------|---------| +| YouTube Music змінить DOM між версіями | Fallback на `document.title` + обидва підходи спочатку | +| SoundCloud не оновлює `<title>` при зміні треку | Observer на обидва: `<title>` + `.playbackSoundBadge` | +| Content script injection race (page not loaded) | `run_at: "document_idle"` + initial send при завантаженні | +| DB save failing silently | Best-effort: помилки логуються в console, не ламають UX | +| MutationObserver spam | Дедуплікація за `title+artist` в `previousTrack` | +| Подвійні записи для тої самої пісні | `@@unique([sessionId, artist, title])` + upsert в Prisma | +| listenedMs не рахується при паузі | `currentPeriodStartMs` reset on pause, re-save on resume | + +--- + +## Що НЕ входить в цей PR + +- Dashboard сторінка `/dashboard/music` з аналітикою — це Week 3 AC 4 (окремий PR) +- Ретрай-черга для треків — tracks є best-effort, на відміну від events +- Відображення треку в event feed — не частина AC 6 + +--- + +## Кількість комітів: 16 (8 план + 4 фікси під час тестування + 2 доповнення + 1 складний фіча-коміт + 1 bugfix пауза YTM) + +| # | Type | Scope | Description | Статус | +|---|------|-------|-------------|--------| +| 1 | docs | plans | add AC6 music capture plan | ✅ | +| 2 | feat | extension | add TrackInfo types and music message definitions | ✅ | +| 3 | feat | extension | add YouTube Music content script with MutationObserver | ✅ | +| 4 | feat | extension | add SoundCloud content script with MutationObserver | ✅ | +| 5 | feat | extension | update manifest with music content scripts and host_permissions | ✅ | +| 6 | feat | extension | handle TRACK_CAPTURED in background and save to DB | ✅ | +| 7 | feat | dashboard | add POST /api/v1/tracks route handler | ✅ | +| 8 | feat | extension | display now-playing track in popup UI | ✅ | +| 9 | fix | extension | skip sync flush when unauthenticated to stop retry flood | ✅ | +| 10 | fix | extension | fix track section visibility and show auth error in popup | ✅ | +| 11 | fix | extension | add TRACK_REQUEST on-demand pull to fix SW race condition | ✅ | +| 12 | docs | — | add local dev checklist to CLAUDE.md | ✅ | +| 13 | fix | extension | save track to DB on on-demand TRACK_REQUEST pull | ✅ | +| 14 | feat | extension | show track listening duration timer in popup | ✅ | +| 15 | feat | — | accumulate listenedMs per track, pause timer, gray out music block | ✅ | +| 16 | fix | extension | detect music pause via .time-info DOM polling on YTM | ✅ | + +## Виявлені баги під час тестування та їх рішення + +| Баг | Причина | Рішення | +|-----|---------|---------| +| ERR_CONNECTION_REFUSED на auth | Dashboard не запущений / Docker не стартував | Документовано в CLAUDE.md | +| Retry flood при відсутності JWT | sync alarm кожні 30 сек навіть без auth | `checkAuth()` guard у `flush()` | +| `♪ —` завжди видима | CSS `.popup__track { display:flex }` перекриває `[hidden]` | `style.display` через JS | +| Трек не відображається після reload | SW race: content script надіслав до SW при inactive SW | `TRACK_REQUEST` on-demand pull via `chrome.tabs.sendMessage` | +| `chrome.tabs.query({ active, currentWindow })` повертає не YTM | SW не має "current window" | Пошук по URL: `{ url: "https://music.youtube.com/*" }` | +| On-demand pull не зберігав у БД | `queryActiveTabForTrack` тільки писав у storage | Додано `saveTrackToDb` у on-demand flow | +| PATCH повертає CORS error | `cors.ts` мав тільки GET/POST/OPTIONS | Додано PATCH до `Access-Control-Allow-Methods` | +| listenedMs рахується під час паузи | Timer tick не знав про стан сесії | `isSessionActive` flag у popup, `endCurrentDbTrack` при паузі | +| Таймер пісні не зупинявся на паузі YTM | `tp-yt-paper-slider aria-valuenow` повертав статичне значення | Перейшли на `ytmusic-player-bar .time-info` textContent, порівнюємо consecutive значення | From 6b0007c874874ac9cec8ee5e4a9f6682da06b5e6 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Mon, 25 May 2026 12:52:03 +0300 Subject: [PATCH 12/24] feat(extension): privacy domain blocklist (Week 2 AC7) (#12) * docs(plans): add AC7 privacy blocklist plan * feat(extension): blocklist storage module and background message handlers * feat(extension): filter blocked domains in content scripts before sending * feat(extension): add privacy blocklist section to popup * fix(extension): accordion not closing - isAccordionOpen state + CSS hidden override --- extension/src/background/blocklist.ts | 44 ++++ extension/src/background/index.ts | 87 +++++++- extension/src/content/index.ts | 27 ++- extension/src/content/soundcloud.ts | 21 +- extension/src/content/ytm.ts | 21 +- extension/src/popup/index.html | 24 +++ extension/src/popup/popup.css | 125 ++++++++++++ extension/src/popup/popup.ts | 130 ++++++++++++ extension/src/types/blocklist.ts | 9 + plans/week2/AC7-privacy-blocklist.md | 283 ++++++++++++++++++++++++++ 10 files changed, 754 insertions(+), 17 deletions(-) create mode 100644 extension/src/background/blocklist.ts create mode 100644 extension/src/types/blocklist.ts create mode 100644 plans/week2/AC7-privacy-blocklist.md diff --git a/extension/src/background/blocklist.ts b/extension/src/background/blocklist.ts new file mode 100644 index 0000000..33ac416 --- /dev/null +++ b/extension/src/background/blocklist.ts @@ -0,0 +1,44 @@ +export const BLOCKLIST_KEY = "blockedDomains"; + +/** + * Extracts the hostname from a URL string. + * Returns null if the URL is unparseable (e.g. chrome://, about:blank). + */ +export function extractHostname(url: string): string | null { + try { + return new URL(url).hostname || null; + } catch { + return null; + } +} + +export async function getBlocklist(): Promise<string[]> { + const r = await chrome.storage.local.get(BLOCKLIST_KEY); + return (r[BLOCKLIST_KEY] as string[] | undefined) ?? []; +} + +export async function addDomain(domain: string): Promise<void> { + const current = await getBlocklist(); + if (current.includes(domain)) return; + await chrome.storage.local.set({ [BLOCKLIST_KEY]: [...current, domain] }); +} + +export async function removeDomain(domain: string): Promise<void> { + const current = await getBlocklist(); + await chrome.storage.local.set({ + [BLOCKLIST_KEY]: current.filter((d) => d !== domain), + }); +} + +/** + * Returns true if the given URL's hostname matches any blocked domain. + * Subdomain matching: blocking "google.com" also blocks "mail.google.com". + */ +export async function isDomainBlocked(url: string): Promise<boolean> { + const hostname = extractHostname(url); + if (!hostname) return false; + const blocklist = await getBlocklist(); + return blocklist.some( + (blocked) => hostname === blocked || hostname.endsWith(`.${blocked}`), + ); +} diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index 963fafb..602939f 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -1,9 +1,16 @@ import type { AuthMessage, AuthResponse, StoredAuth } from "../types/auth"; +import type { BlocklistMessage, BlocklistResponse } from "../types/blocklist"; import type { ContentMessage } from "../types/content"; import type { MusicMessage, MusicResponse, TrackInfo } from "../types/music"; import type { PendingEvent } from "../types/pending"; import type { SessionMessage, SessionResponse } from "../types/session"; import type { SyncMessage, SyncResponse } from "../types/sync"; +import { + getBlocklist, + addDomain, + removeDomain, + isDomainBlocked, +} from "./blocklist"; import { getSession, startSession, @@ -195,6 +202,13 @@ async function queryActiveTabForTrack(): Promise<TrackInfo | null> { try { const track = await chrome.tabs.sendMessage(tab.id, { type: "TRACK_REQUEST" }) as TrackInfo | null; if (track) { + // Blocklist check before storing or persisting to DB + const sourceUrl = `https://${ + track.source === "youtube-music" ? "music.youtube.com" : "soundcloud.com" + }`; + const blocked = await isDomainBlocked(sourceUrl); + if (blocked) return null; + await chrome.storage.local.set({ currentTrack: track }); // Save to DB only if we don't already have a DB record for this tab pull const existing = await chrome.storage.local.get("currentDbTrackId"); @@ -263,13 +277,13 @@ async function enqueuePending(event: PendingEvent): Promise<void> { // ─── Message listener ────────────────────────────────────────────────────────── -type IncomingMessage = AuthMessage | SessionMessage | ContentMessage | SyncMessage | MusicMessage; +type IncomingMessage = AuthMessage | SessionMessage | ContentMessage | SyncMessage | MusicMessage | BlocklistMessage; chrome.runtime.onMessage.addListener( ( message: IncomingMessage, _sender, - sendResponse: (r: AuthResponse | SessionResponse | SyncResponse | MusicResponse) => void, + sendResponse: (r: AuthResponse | SessionResponse | SyncResponse | MusicResponse | BlocklistResponse) => void, ) => { if (message.type === "AUTH_LOGIN") { if (DEV_MODE) { @@ -471,15 +485,26 @@ chrome.runtime.onMessage.addListener( if (message.type === "TRACK_CAPTURED") { const track = message.payload; - void chrome.storage.local.set({ currentTrack: track }); - // Close the previous track then save the new one - getSession().then(async (session) => { + // Background-level blocklist check: second line of defence after content script + // Derive the domain from the known source → hostname mapping + const trackSourceDomain: Record<TrackInfo["source"], string> = { + "youtube-music": "music.youtube.com", + "soundcloud": "soundcloud.com", + }; + void (async () => { + const blocked = await isDomainBlocked(`https://${trackSourceDomain[track.source]}`); + if (blocked) return; + + void chrome.storage.local.set({ currentTrack: track }); + + // Close the previous track then save the new one + const session = await getSession(); await endCurrentDbTrack(); // no-op if no previous track if (session && session.pausedAt === null && session.dbSessionId) { void saveTrackToDb(track, session.dbSessionId); } - }); + })(); return false; } @@ -520,9 +545,15 @@ chrome.runtime.onMessage.addListener( if (message.type === "PAGE_METADATA") { // Store metadata only when a session is active (AC 5 will batch-send it) - getSession().then((session) => { - if (!session) return; + // Background-level blocklist check: second line of defence after content script + void (async () => { const { url, title, metaDescription, headings } = message.payload; + const blocked = await isDomainBlocked(url); + if (blocked) return; + + const session = await getSession(); + if (!session) return; + const content = [metaDescription, ...headings].filter(Boolean).join(" | ") || null; const event: PendingEvent = { url, @@ -532,10 +563,48 @@ chrome.runtime.onMessage.addListener( timestamp: new Date().toISOString(), }; void enqueuePending(event); - }); + })(); return false; // no async response needed } + // ─── Blocklist messages ────────────────────────────────────────────────── + + if (message.type === "BLOCKLIST_GET") { + getBlocklist() + .then((domains) => sendResponse({ success: true, domains })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "BLOCKLIST_ADD") { + addDomain(message.domain) + .then(() => sendResponse({ success: true })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "BLOCKLIST_REMOVE") { + removeDomain(message.domain) + .then(() => sendResponse({ success: true })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + return false; }, ); diff --git a/extension/src/content/index.ts b/extension/src/content/index.ts index 99292e2..6b37ba5 100644 --- a/extension/src/content/index.ts +++ b/extension/src/content/index.ts @@ -1,5 +1,20 @@ import type { ContentMessage, PageMetadata } from "../types/content"; +const BLOCKLIST_KEY = "blockedDomains"; + +/** + * Returns true if the current page's hostname is in the blocklist. + * Reads directly from chrome.storage.local — no round-trip to background. + */ +async function isCurrentHostnameBlocked(): Promise<boolean> { + const r = await chrome.storage.local.get(BLOCKLIST_KEY); + const blocklist = (r[BLOCKLIST_KEY] as string[] | undefined) ?? []; + const hostname = window.location.hostname; + return blocklist.some( + (blocked) => hostname === blocked || hostname.endsWith(`.${blocked}`), + ); +} + function parseMetadata(): PageMetadata { const headings = Array.from(document.querySelectorAll("h1, h2, h3")) .map((el) => el.textContent?.trim() ?? "") @@ -15,7 +30,11 @@ function parseMetadata(): PageMetadata { }; } -function sendMetadata(): void { +async function sendMetadata(): Promise<void> { + // First-level filter: do not parse or send data for blocked domains + const blocked = await isCurrentHostnameBlocked(); + if (blocked) return; + const message: ContentMessage = { type: "PAGE_METADATA", payload: parseMetadata(), @@ -26,8 +45,8 @@ function sendMetadata(): void { } // Send on initial load -sendMetadata(); +void sendMetadata(); // Re-send on SPA navigation -window.addEventListener("popstate", sendMetadata); -window.addEventListener("hashchange", sendMetadata); +window.addEventListener("popstate", () => { void sendMetadata(); }); +window.addEventListener("hashchange", () => { void sendMetadata(); }); diff --git a/extension/src/content/soundcloud.ts b/extension/src/content/soundcloud.ts index 809d7dc..0a1115f 100644 --- a/extension/src/content/soundcloud.ts +++ b/extension/src/content/soundcloud.ts @@ -1,5 +1,16 @@ import type { TrackInfo, MusicMessage } from "../types/music"; +const BLOCKLIST_KEY = "blockedDomains"; + +async function isCurrentHostnameBlocked(): Promise<boolean> { + const r = await chrome.storage.local.get(BLOCKLIST_KEY); + const blocklist = (r[BLOCKLIST_KEY] as string[] | undefined) ?? []; + const hostname = window.location.hostname; + return blocklist.some( + (blocked) => hostname === blocked || hostname.endsWith(`.${blocked}`), + ); +} + // ─── DOM parsing ─────────────────────────────────────────────────────────────── /** @@ -79,8 +90,14 @@ function sendIfChanged(track: TrackInfo | null): void { if (key === previousKey) return; previousKey = key; - const message: MusicMessage = { type: "TRACK_CAPTURED", payload: track }; - chrome.runtime.sendMessage(message).catch(() => { /* SW inactive — ignore */ }); + // First-level filter: do not send track data for blocked domains + isCurrentHostnameBlocked() + .then((blocked) => { + if (blocked) return; + const message: MusicMessage = { type: "TRACK_CAPTURED", payload: track }; + chrome.runtime.sendMessage(message).catch(() => { /* SW inactive — ignore */ }); + }) + .catch(() => { /* storage read failed — skip silently */ }); } // ─── MutationObserver ───────────────────────────────────────────────────────── diff --git a/extension/src/content/ytm.ts b/extension/src/content/ytm.ts index 5f65258..19c79c5 100644 --- a/extension/src/content/ytm.ts +++ b/extension/src/content/ytm.ts @@ -1,5 +1,16 @@ import type { TrackInfo, MusicMessage } from "../types/music"; +const BLOCKLIST_KEY = "blockedDomains"; + +async function isCurrentHostnameBlocked(): Promise<boolean> { + const r = await chrome.storage.local.get(BLOCKLIST_KEY); + const blocklist = (r[BLOCKLIST_KEY] as string[] | undefined) ?? []; + const hostname = window.location.hostname; + return blocklist.some( + (blocked) => hostname === blocked || hostname.endsWith(`.${blocked}`), + ); +} + // ─── DOM parsing ─────────────────────────────────────────────────────────────── function firstText(...selectors: string[]): string { @@ -84,8 +95,14 @@ function sendIfChanged(track: TrackInfo | null): void { if (key === previousKey) return; previousKey = key; - const message: MusicMessage = { type: "TRACK_CAPTURED", payload: track }; - chrome.runtime.sendMessage(message).catch(() => { /* SW inactive — ignore */ }); + // First-level filter: do not send track data for blocked domains + isCurrentHostnameBlocked() + .then((blocked) => { + if (blocked) return; + const message: MusicMessage = { type: "TRACK_CAPTURED", payload: track }; + chrome.runtime.sendMessage(message).catch(() => { /* SW inactive — ignore */ }); + }) + .catch(() => { /* storage read failed — skip silently */ }); } // ─── MutationObserver ───────────────────────────────────────────────────────── diff --git a/extension/src/popup/index.html b/extension/src/popup/index.html index 7789919..edc6479 100644 --- a/extension/src/popup/index.html +++ b/extension/src/popup/index.html @@ -77,6 +77,30 @@ <button class="btn btn--note" id="btn-note">+ LOG NOTE</button> </section> + <!-- Privacy / Blocklist --> + <section class="popup__blocklist"> + + <div class="popup__field-label">PRIVACY</div> + + <!-- 4а: основний тоггл — поточний сайт --> + <div class="popup__blocklist-current"> + <span class="popup__blocklist-domain" id="current-domain">—</span> + <label class="popup__toggle" title="Block this site"> + <input type="checkbox" id="toggle-current-domain" /> + <span class="popup__toggle-track"></span> + </label> + </div> + + <!-- 4б: акордеон зі списком заблокованих --> + <button class="popup__blocklist-accordion" id="btn-blocklist-accordion" hidden> + <span id="blocklist-count-label">▾ 0 BLOCKED</span> + </button> + <div class="popup__blocklist-list" id="blocklist-list" hidden> + <!-- dynamically filled: one .popup__blocklist-item per blocked domain --> + </div> + + </section> + </div> <script type="module" src="./popup.ts"></script> </body> diff --git a/extension/src/popup/popup.css b/extension/src/popup/popup.css index 963f51b..cb70c13 100644 --- a/extension/src/popup/popup.css +++ b/extension/src/popup/popup.css @@ -14,6 +14,9 @@ /* ─── Reset ──────────────────────────────────────────────────────────────────── */ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; } +/* Enforce the HTML hidden attribute — overrides any display: flex/block from classes */ +[hidden] { display: none !important; } + body { width: 320px; background: var(--c-bg); @@ -420,3 +423,125 @@ body { .btn--note:hover:not(:disabled) { background: color-mix(in srgb, var(--c-purple) 8%, transparent); } + +/* ═══════════════════════════════════════════════════════════════════════════════ + BLOCK: popup__blocklist +═══════════════════════════════════════════════════════════════════════════════ */ +.popup__blocklist { + display: flex; + flex-direction: column; + gap: 8px; + border-top: 1px solid var(--c-border); + padding-top: 12px; +} + +/* ── Current-site row ─────────────────────────────────────────────────────── */ +.popup__blocklist-current { + display: flex; + align-items: center; + justify-content: space-between; + gap: 8px; +} + +.popup__blocklist-domain { + font-size: 11px; + color: var(--c-text); + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; + max-width: 210px; +} + +/* ── CSS-only toggle pill ─────────────────────────────────────────────────── */ +.popup__toggle { + position: relative; + display: inline-block; + width: 32px; + height: 18px; + flex-shrink: 0; + cursor: pointer; +} + +.popup__toggle input { + opacity: 0; + width: 0; + height: 0; + position: absolute; +} + +.popup__toggle-track { + position: absolute; + inset: 0; + background: var(--c-muted); + border-radius: 18px; + transition: background 0.2s; +} + +.popup__toggle-track::after { + content: ""; + position: absolute; + width: 12px; + height: 12px; + left: 3px; + top: 3px; + background: var(--c-bg); + border-radius: 50%; + transition: transform 0.2s; +} + +.popup__toggle input:checked + .popup__toggle-track { + background: var(--c-pink); + box-shadow: 0 0 6px color-mix(in srgb, var(--c-pink) 40%, transparent); +} + +.popup__toggle input:checked + .popup__toggle-track::after { + transform: translateX(14px); +} + +/* ── Accordion button ─────────────────────────────────────────────────────── */ +.popup__blocklist-accordion { + display: flex; + align-items: center; + gap: 4px; + background: transparent; + border: none; + padding: 0; + font-family: inherit; + font-size: 10px; + font-weight: 700; + letter-spacing: 0.05em; + color: var(--c-muted); + cursor: pointer; + transition: color 0.15s; +} + +.popup__blocklist-accordion:hover { + color: var(--c-text); +} + +/* ── Blocked-domains list ─────────────────────────────────────────────────── */ +.popup__blocklist-list { + display: flex; + flex-direction: column; + gap: 6px; + background: var(--c-surface); + border: 1px solid var(--c-border); + border-radius: 4px; + padding: 8px 10px; +} + +.popup__blocklist-item { + display: flex; + align-items: center; + justify-content: space-between; + gap: 8px; +} + +.popup__blocklist-item-domain { + font-size: 11px; + color: var(--c-text); + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; + max-width: 200px; +} diff --git a/extension/src/popup/popup.ts b/extension/src/popup/popup.ts index 7810817..f997af1 100644 --- a/extension/src/popup/popup.ts +++ b/extension/src/popup/popup.ts @@ -1,4 +1,5 @@ import type { AuthMessage, AuthResponse } from "../types/auth"; +import type { BlocklistMessage, BlocklistResponse } from "../types/blocklist"; import type { MusicMessage, MusicResponse, TrackInfo } from "../types/music"; import type { SessionMessage, SessionResponse, SessionState } from "../types/session"; import type { SyncMessage, SyncResponse } from "../types/sync"; @@ -45,6 +46,16 @@ function sendMusic(msg: MusicMessage): Promise<MusicResponse> { ); } +function sendBlocklist(msg: BlocklistMessage): Promise<BlocklistResponse> { + return new Promise((resolve, reject) => + chrome.runtime.sendMessage(msg, (res: BlocklistResponse | undefined) => { + if (chrome.runtime.lastError) return reject(new Error(chrome.runtime.lastError.message)); + if (!res) return reject(new Error("No response from background")); + resolve(res); + }), + ); +} + // ─── DOM refs ────────────────────────────────────────────────────────────────── const statusDot = document.getElementById("status-dot") as HTMLSpanElement; @@ -70,6 +81,13 @@ const trackArtist = document.getElementById("track-artist") as HTMLSpanElem const trackSource = document.getElementById("track-source") as HTMLSpanElement; const trackDuration = document.getElementById("track-duration") as HTMLSpanElement; +// ─── Blocklist DOM refs ──────────────────────────────────────────────────────── +const currentDomainEl = document.getElementById("current-domain") as HTMLSpanElement; +const toggleCurrentDomain = document.getElementById("toggle-current-domain") as HTMLInputElement; +const btnAccordion = document.getElementById("btn-blocklist-accordion") as HTMLButtonElement; +const blocklistCountLabel = document.getElementById("blocklist-count-label") as HTMLSpanElement; +const blocklistList = document.getElementById("blocklist-list") as HTMLDivElement; + // ─── Timer formatting ────────────────────────────────────────────────────────── function formatMs(ms: number): string { @@ -225,6 +243,116 @@ async function refreshTrack(): Promise<void> { applyTrack(res.track); } +// ─── Blocklist ───────────────────────────────────────────────────────────────── + +// Tracks accordion open/closed state independently of DOM so refreshBlocklist +// never accidentally resets the visual state between user interactions. +let isAccordionOpen = false; + +/** Returns the hostname of the current active tab, or null if unavailable. */ +async function getCurrentHostname(): Promise<string | null> { + try { + const [tab] = await chrome.tabs.query({ active: true, currentWindow: true }); + if (!tab?.url) return null; + return new URL(tab.url).hostname || null; + } catch { + return null; + } +} + +async function refreshBlocklist(): Promise<void> { + const [res, hostname] = await Promise.all([ + sendBlocklist({ type: "BLOCKLIST_GET" }).catch(() => null), + getCurrentHostname(), + ]); + + if (!res || !res.success || !("domains" in res)) return; + const { domains } = res; + + // 4а: update current-site toggle + const displayHost = hostname ?? "—"; + currentDomainEl.textContent = displayHost; + toggleCurrentDomain.disabled = hostname === null; + toggleCurrentDomain.checked = + hostname !== null && + domains.some((d) => hostname === d || hostname.endsWith(`.${d}`)); + + // 4б: update accordion + list + const count = domains.length; + if (count === 0) { + isAccordionOpen = false; // reset state when list becomes empty + btnAccordion.hidden = true; + blocklistList.hidden = true; + } else { + btnAccordion.hidden = false; + // Respect the current open/closed state — don't reset what the user chose + blocklistList.hidden = !isAccordionOpen; + blocklistCountLabel.textContent = `${isAccordionOpen ? "▴" : "▾"} ${String(count)} BLOCKED`; + } + + // Re-render list items + blocklistList.innerHTML = ""; + for (const domain of domains) { + const item = document.createElement("div"); + item.className = "popup__blocklist-item"; + + const label = document.createElement("span"); + label.className = "popup__blocklist-item-domain"; + label.textContent = domain; + + const toggleLabel = document.createElement("label"); + toggleLabel.className = "popup__toggle"; + toggleLabel.title = `Unblock ${domain}`; + + const cb = document.createElement("input"); + cb.type = "checkbox"; + cb.checked = true; // all items in the list are blocked by definition + cb.dataset["domain"] = domain; + + const track = document.createElement("span"); + track.className = "popup__toggle-track"; + + toggleLabel.appendChild(cb); + toggleLabel.appendChild(track); + item.appendChild(label); + item.appendChild(toggleLabel); + blocklistList.appendChild(item); + } +} + +// ─── Blocklist event handlers ────────────────────────────────────────────────── + +toggleCurrentDomain.addEventListener("change", async () => { + const hostname = await getCurrentHostname(); + if (!hostname) return; + if (toggleCurrentDomain.checked) { + await sendBlocklist({ type: "BLOCKLIST_ADD", domain: hostname }).catch(() => null); + } else { + await sendBlocklist({ type: "BLOCKLIST_REMOVE", domain: hostname }).catch(() => null); + } + await refreshBlocklist(); +}); + +btnAccordion.addEventListener("click", () => { + isAccordionOpen = !isAccordionOpen; + blocklistList.hidden = !isAccordionOpen; + blocklistCountLabel.textContent = `${isAccordionOpen ? "▴" : "▾"} ${String(blocklistList.children.length)} BLOCKED`; +}); + +// Delegated handler for per-domain toggles inside the list +blocklistList.addEventListener("change", async (e) => { + const target = e.target as HTMLInputElement | null; + if (!target || target.type !== "checkbox") return; + const domain = target.dataset["domain"]; + if (!domain) return; + // Unchecking = unblock (remove from list); re-checking from the list is impossible + // because items disappear when removed, but guard anyway + if (!target.checked) { + await sendBlocklist({ type: "BLOCKLIST_REMOVE", domain }).catch(() => null); + await refreshBlocklist(); + } +}); + // ─── Session polling ─────────────────────────────────────────────────────────── let pollInterval: ReturnType<typeof setInterval> | null = null; @@ -245,6 +373,7 @@ function startPolling(): void { await refreshSyncIndicator(); await refreshTrack(); refreshDuration(); // update elapsed time without extra round-trip + await refreshBlocklist(); }, 1000); } @@ -275,6 +404,7 @@ async function init(): Promise<void> { await refreshSyncIndicator(); await refreshTrack(); + await refreshBlocklist(); startPolling(); } diff --git a/extension/src/types/blocklist.ts b/extension/src/types/blocklist.ts new file mode 100644 index 0000000..5def704 --- /dev/null +++ b/extension/src/types/blocklist.ts @@ -0,0 +1,9 @@ +export type BlocklistMessage = + | { type: "BLOCKLIST_GET" } + | { type: "BLOCKLIST_ADD"; domain: string } + | { type: "BLOCKLIST_REMOVE"; domain: string }; + +export type BlocklistResponse = + | { success: true; domains: string[] } + | { success: true } + | { success: false; error: string }; diff --git a/plans/week2/AC7-privacy-blocklist.md b/plans/week2/AC7-privacy-blocklist.md new file mode 100644 index 0000000..db7f1d3 --- /dev/null +++ b/plans/week2/AC7-privacy-blocklist.md @@ -0,0 +1,283 @@ +# Plan: AC7 — Privacy / Domain Blocklist + +**Branch:** `feature/extension-privacy-blocklist` +**Scope:** Extension only — no dashboard changes needed. + +--- + +## Мета + +Реалізувати чорний список доменів у Chrome-розширенні: +- сторінки зі списку **не парсяться** (content script мовчить) +- **не відправляються** (background service worker ігнорує) +- фільтрація відбувається **локально**, до будь-якої мережевої передачі + +--- + +## Аналіз поточного стану + +| Точка | Файл | Що відбувається зараз | +|---|---|---| +| Content script (general) | `content/index.ts` | Завжди парсить + надсилає `PAGE_METADATA` | +| Content script (YTM) | `content/ytm.ts` | Завжди надсилає `TRACK_CAPTURED` | +| Content script (SoundCloud) | `content/soundcloud.ts` | Завжди надсилає `TRACK_CAPTURED` | +| Background — PAGE_METADATA | `background/index.ts` | Одразу ставить у чергу без перевірки | +| Background — TRACK_CAPTURED | `background/index.ts` | Одразу зберігає без перевірки | + +**Проблема:** жодної перевірки домену немає — будь-яка сторінка парситься і відправляється. + +--- + +## Архітектурні рішення + +### 1. Де зберігати список + +`chrome.storage.local` під ключем `"blockedDomains": string[]`. +Причина: той самий storage, що і решта стану розширення; доступний з усіх контекстів; не втрачається при перезавантаженні SW. + +### 2. Де фільтрувати (два рівні захисту) + +**Рівень 1 — Content script (основний фільтр):** +До відправлення будь-якого повідомлення content script читає `chrome.storage.local["blockedDomains"]` і перевіряє `window.location.hostname`. Якщо домен заблокований — повідомлення **не надсилається** взагалі. + +**Рівень 2 — Background service worker (захист від витоку):** +При отриманні `PAGE_METADATA` або `TRACK_CAPTURED` background також перевіряє домен з `payload.url`. Якщо заблокований — ігнорує, не ставить у чергу. + +> Два рівні — бо MV3 content scripts не можуть бути 100% надійними (edge cases: race conditions при першому завантаженні). Background є кінцевою гарантією. + +### 3. Зіставлення доменів + +`hostname === blocked || hostname.endsWith(`.${blocked}`)` + +Приклад: заблокований `google.com` → також блокуються `mail.google.com`, `docs.google.com`. + +### 4. UI у popup + +Секція **PRIVACY** складається з двох частин: + +#### 4а. Основний тоггл — поточний сайт + +Рядок з назвою домену поточної вкладки (з `chrome.tabs.query({ active: true, currentWindow: true })`) та тогглом праворуч: + +``` +PRIVACY +────────────────────────────────── +github.com [●──] ← toggle вкл/викл блокування +``` + +- Домен береться з активної вкладки при кожному відкритті popup та в polling-циклі +- Тоггл: **ON** (червоний `--c-pink`) = заблокований, **OFF** (сірий `--c-muted`) = дозволений +- При перемиканні — надсилає `BLOCKLIST_ADD` або `BLOCKLIST_REMOVE` до background + +#### 4б. Випадаючий список заблокованих доменів + +Кнопка-акордеон `▾ N BLOCKED` (де N — кількість заблокованих доменів) розкриває список: + +``` +▾ 2 BLOCKED + ┌────────────────────────────────┐ + │ google.com [●──] │ ← тоггл для кожного (вимикає = видаляє з списку) + │ facebook.com [●──] │ + └────────────────────────────────┘ +``` + +- Якщо список порожній — акордеон прихований або показує `▾ 0 BLOCKED` (не розкривається) +- Кожен тоггл навпроти домену: виключити тоггл = `BLOCKLIST_REMOVE` (видаляє домен зі списку) +- Список оновлюється при кожному `refreshBlocklist()` call + +> `chrome.tabs.query` можна викликати з popup напряму — це внутрішній Chrome API, а не dashboard fetch. +> Dashboard fetch — тільки через background (правило CLAUDE.md). + +--- + +## Нові файли + +### `extension/src/types/blocklist.ts` + +```ts +export type BlocklistMessage = + | { type: "BLOCKLIST_GET" } + | { type: "BLOCKLIST_ADD"; domain: string } + | { type: "BLOCKLIST_REMOVE"; domain: string }; + +export type BlocklistResponse = + | { success: true; domains: string[] } + | { success: true } + | { success: false; error: string }; +``` + +### `extension/src/background/blocklist.ts` + +Утилітарний модуль для роботи з blocklist storage: + +```ts +export const BLOCKLIST_KEY = "blockedDomains"; + +export function extractHostname(url: string): string | null // new URL(url).hostname +export async function getBlocklist(): Promise<string[]> +export async function addDomain(domain: string): Promise<void> +export async function removeDomain(domain: string): Promise<void> +export async function isDomainBlocked(url: string): Promise<boolean> +// Перевіряє: hostname === blocked || hostname.endsWith(`.${blocked}`) +``` + +--- + +## Зміни у існуючих файлах + +### `extension/src/content/index.ts` + +`sendMetadata()` стає `async`: +1. Читає `chrome.storage.local.get("blockedDomains")` +2. Перевіряє `window.location.hostname` +3. Якщо заблокований → `return` (нічого не надсилає) +4. Якщо ні → надсилає `PAGE_METADATA` як раніше + +### `extension/src/content/ytm.ts` та `soundcloud.ts` + +У функції що надсилає `TRACK_CAPTURED`: +1. Перевіряє `chrome.storage.local.get("blockedDomains")` +2. Якщо `music.youtube.com` / `soundcloud.com` заблокований → не надсилає + +### `extension/src/background/index.ts` + +1. Імпортує `isDomainBlocked` з `./blocklist` +2. У handlers `PAGE_METADATA` та `TRACK_CAPTURED` — до `enqueuePending` / `saveTrackToDb` додає перевірку `isDomainBlocked(url)` +3. Додає handlers для нових message types: `BLOCKLIST_GET`, `BLOCKLIST_ADD`, `BLOCKLIST_REMOVE` + +Новий `IncomingMessage` union: +```ts +type IncomingMessage = AuthMessage | SessionMessage | ContentMessage | SyncMessage | MusicMessage | BlocklistMessage; +``` + +### `extension/src/popup/index.html` + +Нова секція `<!-- Blocklist -->` після `<!-- Notes -->`: +```html +<section class="popup__blocklist" id="blocklist-section"> + + <!-- 4а: основний тоггл — поточний сайт --> + <div class="popup__blocklist-header"> + <span class="popup__field-label">PRIVACY</span> + </div> + <div class="popup__blocklist-current"> + <span class="popup__blocklist-domain" id="current-domain">—</span> + <label class="popup__toggle"> + <input type="checkbox" id="toggle-current-domain" /> + <span class="popup__toggle-track"></span> + </label> + </div> + + <!-- 4б: акордеон зі списком заблокованих --> + <button class="popup__blocklist-accordion" id="btn-blocklist-accordion" hidden> + <span id="blocklist-count-label">▾ 0 BLOCKED</span> + </button> + <div class="popup__blocklist-list" id="blocklist-list" hidden> + <!-- dynamically filled: one .popup__blocklist-item per domain --> + </div> + +</section> +``` + +### `extension/src/popup/popup.ts` + +1. Нові DOM refs: `currentDomainEl`, `toggleCurrentDomain`, `btnAccordion`, `blocklistCountLabel`, `blocklistList` +2. `sendBlocklist(msg: BlocklistMessage): Promise<BlocklistResponse>` — helper за патерном `sendAuth`/`sendSession` +3. `refreshBlocklist(currentHostname: string)`: + - Викликає `BLOCKLIST_GET` → отримує масив заблокованих доменів + - Оновлює `currentDomainEl.textContent = currentHostname` + - Встановлює `toggleCurrentDomain.checked = domains.includes(currentHostname)` + - Рендерить `blocklistList`: по одному `<div class="popup__blocklist-item">` на домен зі своїм `<input type="checkbox" checked>` та `<span>hostname</span>` + - Оновлює `blocklistCountLabel` та показує/ховає акордеон +4. `toggleCurrentDomain` `change` handler: + - `chrome.tabs.query({ active: true, currentWindow: true })` → hostname + - `checked` → `BLOCKLIST_ADD`, `!checked` → `BLOCKLIST_REMOVE` +5. Делегований `change` на `blocklistList` для checkbox-ів кожного домену → `BLOCKLIST_REMOVE` при `!checked` +6. `btnAccordion` click → toggle `hidden` на `blocklistList` +7. `refreshBlocklist()` викликається у `init()` (одноразово при відкритті popup) та всередині `setInterval` у `startPolling()` — разом з іншими refresh-ами + +### `extension/src/popup/popup.css` + +Нові стилі: +- `.popup__blocklist` — секція (gap, border-top як у інших секцій) +- `.popup__blocklist-current` — flex row, `justify-content: space-between`, `align-items: center` +- `.popup__blocklist-domain` — `color: var(--c-text)`, truncate довгі домени (`max-width`, `overflow: hidden`, `text-overflow: ellipsis`) +- `.popup__toggle` / `.popup__toggle-track` — CSS-only toggle: pill `background: var(--c-muted)`, checked → `var(--c-pink)` (заблокований = червоний) +- `.popup__blocklist-accordion` — кнопка-рядок без border, `color: var(--c-muted)`, cursor pointer +- `.popup__blocklist-list` — стек `.popup__blocklist-item` +- `.popup__blocklist-item` — flex row між `<span>` доменом та `<label class="popup__toggle">` + +--- + +## Порядок реалізації та коміти + +### Коміт 1 — документація (апрув плану) +``` +docs(plans): add AC7 privacy blocklist plan +``` +Файли: `plans/week2/AC7-privacy-blocklist.md` + +--- + +### Коміт 2 — storage-модуль + background handlers +``` +feat(extension): blocklist storage module and background message handlers +``` +Файли: +- `extension/src/types/blocklist.ts` — нові типи `BlocklistMessage` / `BlocklistResponse` +- `extension/src/background/blocklist.ts` — `getBlocklist`, `addDomain`, `removeDomain`, `isDomainBlocked`, `extractHostname` +- `extension/src/background/index.ts` — handlers `BLOCKLIST_GET/ADD/REMOVE` + подвійна перевірка у `PAGE_METADATA` та `TRACK_CAPTURED` + +--- + +### Коміт 3 — фільтри у content scripts +``` +feat(extension): filter blocked domains in content scripts before sending +``` +Файли: +- `extension/src/content/index.ts` — `sendMetadata()` → async, перевірка blocklist до відправки +- `extension/src/content/ytm.ts` — перевірка blocklist до `TRACK_CAPTURED` +- `extension/src/content/soundcloud.ts` — перевірка blocklist до `TRACK_CAPTURED` + +--- + +### Коміт 4 — popup UI +``` +feat(extension): add privacy blocklist section to popup +``` +Файли: +- `extension/src/popup/index.html` — секція PRIVACY (тоггл поточного сайту + акордеон) +- `extension/src/popup/popup.css` — CSS toggle pill, стилі секції та списку +- `extension/src/popup/popup.ts` — `sendBlocklist`, `refreshBlocklist`, handlers тогглів і акордеону + +--- + +### Коміт 5+ — фікси (можливо кілька) +``` +fix(extension): <конкретний опис після тестування> +``` +> Можливо кілька fix-комітів після ручного тестування у Chrome (наприклад: race condition при першому завантаженні content script, некоректний hostname для chrome:// сторінок, тоггл не оновлюється при навігації між вкладками тощо). + +--- + +## Що НЕ змінюється + +- Dashboard (`/dashboard`) — жодних змін; blocklist — суто локальна функція розширення +- Manifest (`manifest.ts`) — жодних нових permissions; `storage` і `tabs` вже є +- Prisma schema — жодних змін; blocklist не синхронізується з сервером +- `background/sync.ts` — жодних змін; перевірка відбувається до потрапляння у чергу + +--- + +## Definition of Done + +- [ ] `blockedDomains` зберігається в `chrome.storage.local` +- [ ] Content script **не надсилає** `PAGE_METADATA` для заблокованих доменів +- [ ] Background **не ставить у чергу** `PAGE_METADATA`/`TRACK_CAPTURED` для заблокованих доменів +- [ ] Popup показує поточний статус (blocked/allowed) для активного сайту +- [ ] Popup показує назву домену поточної вкладки з тогглом (ON=червоний=заблокований) +- [ ] Тоггл поточного сайту блокує/розблоковує домен одним кліком +- [ ] Акордеон "▾ N BLOCKED" розкриває список всіх заблокованих доменів +- [ ] Напроти кожного домену у списку є тоггл — вимкнути тоггл = видалити домен зі списку +- [ ] `TypeScript strict` — немає `any` +- [ ] Збірка: `npm run build` у `/extension` проходить без помилок From fbd681491898f4705b5cfa4e617fd0b4328d5ede Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Mon, 25 May 2026 23:01:38 +0300 Subject: [PATCH 13/24] feat(extension): parsing modes + SW-sleep & track-timer fixes (Week 2 AC8) (#13) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(backlog): music track duration display bug — popup-local state lost on reopen * docs(plans): add AC8 parsing modes plan * feat(extension): parsing mode storage module and background message handlers * feat(extension): apply parsing mode in content script metadata collection * feat(extension): add parsing mode segmented control to popup * fix(extension): write page events directly to storage to survive SW sleep * fix(extension): freeze track timer on session pause, restore correctly on popup reopen Closes the music track duration display bug from backlog. Three independent issues, three priorities in the new initDurationFromStorage: P1 — session paused/stopped: freeze at the last snapshot value, ignore any delta. Session pause does not pause the music player, so DOM playbackTime keeps advancing in the YTM/SoundCloud tab — we must not count that. P2 — session active + matching snapshot: compute delta from the snapshot's saved playbackTime to the current DOM playbackTime. The song's own playback position is the source of truth for "did music actually play while popup was closed" — it only advances when music is playing. delta > 0 → add deltaSec*1000 to snapshot.displayDurationMs delta = 0 → music was paused in the player → keep snapshot value delta < 0 → user seeked backward → keep snapshot value (best effort) P3 — fallback: background-accumulated trackListenedMs (correct for session pause path through endCurrentDbTrack, best-effort otherwise). Storage additions: - trackListenedMs: accumulated by background in endCurrentDbTrack on every session pause / track change. Reset to 0 in TRACK_CAPTURED, removed in SESSION_STOP. - popupSnapshot { trackKey, playbackTime, displayDurationMs, capturedAt }: written every popup tick in refreshDuration. Removed in TRACK_CAPTURED and SESSION_STOP so a stale snapshot from a previous track never wins. Popup changes: - applyTrack: drop capturedAt-based initialisation, set needsStorageInit=true on track change so the next refreshTrack reads from storage. - refreshTrack: one-shot await initDurationFromStorage when flag is set. - parsePlaybackTime: handles M:SS and H:MM:SS DOM formats. Known edge cases (acceptable as best-effort, DB listenedMs remains accurate): - Song looped/replayed → playbackTime resets to 0, second play undercounts. - Popup closed longer than song length → playbackTime caps, undercounts. --- extension/src/background/index.ts | 72 +++++++------ extension/src/background/parsing.ts | 14 +++ extension/src/content/index.ts | 101 +++++++++++------- extension/src/popup/index.html | 10 ++ extension/src/popup/popup.css | 43 ++++++++ extension/src/popup/popup.ts | 152 ++++++++++++++++++++++++++-- extension/src/types/content.ts | 2 - extension/src/types/parsing.ts | 9 ++ plans/week2/AC8-parsing-modes.md | 151 +++++++++++++++++++++++++++ 9 files changed, 480 insertions(+), 74 deletions(-) create mode 100644 extension/src/background/parsing.ts create mode 100644 extension/src/types/parsing.ts create mode 100644 plans/week2/AC8-parsing-modes.md diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index 602939f..e734a45 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -1,7 +1,7 @@ import type { AuthMessage, AuthResponse, StoredAuth } from "../types/auth"; import type { BlocklistMessage, BlocklistResponse } from "../types/blocklist"; -import type { ContentMessage } from "../types/content"; import type { MusicMessage, MusicResponse, TrackInfo } from "../types/music"; +import type { ParsingModeMessage, ParsingModeResponse } from "../types/parsing"; import type { PendingEvent } from "../types/pending"; import type { SessionMessage, SessionResponse } from "../types/session"; import type { SyncMessage, SyncResponse } from "../types/sync"; @@ -11,6 +11,7 @@ import { removeDomain, isDomainBlocked, } from "./blocklist"; +import { getParsingMode, setParsingMode } from "./parsing"; import { getSession, startSession, @@ -246,7 +247,7 @@ async function saveTrackToDb(track: TrackInfo, dbSessionId: string): Promise<voi // Closes the previous DB track record: sends endedAt + listenedMs delta. async function endCurrentDbTrack(): Promise<void> { - const r = await chrome.storage.local.get(["currentDbTrackId", "currentPeriodStartMs"]); + const r = await chrome.storage.local.get(["currentDbTrackId", "currentPeriodStartMs", "trackListenedMs"]); const id = r["currentDbTrackId"] as string | undefined; const periodStart = r["currentPeriodStartMs"] as number | undefined; if (!id) return; @@ -254,6 +255,11 @@ async function endCurrentDbTrack(): Promise<void> { const now = Date.now(); const listenedMs = periodStart ? Math.max(0, now - periodStart) : 0; + // Accumulate into trackListenedMs so the popup can restore correct display + // duration without jumping when it's reopened after a pause. + const prevDisplayMs = (r["trackListenedMs"] as number | undefined) ?? 0; + await chrome.storage.local.set({ trackListenedMs: prevDisplayMs + listenedMs }); + try { await apiFetch(`/api/v1/tracks/${id}`, { method: "PATCH", @@ -277,13 +283,13 @@ async function enqueuePending(event: PendingEvent): Promise<void> { // ─── Message listener ────────────────────────────────────────────────────────── -type IncomingMessage = AuthMessage | SessionMessage | ContentMessage | SyncMessage | MusicMessage | BlocklistMessage; +type IncomingMessage = AuthMessage | SessionMessage | SyncMessage | MusicMessage | BlocklistMessage | ParsingModeMessage; chrome.runtime.onMessage.addListener( ( message: IncomingMessage, _sender, - sendResponse: (r: AuthResponse | SessionResponse | SyncResponse | MusicResponse | BlocklistResponse) => void, + sendResponse: (r: AuthResponse | SessionResponse | SyncResponse | MusicResponse | BlocklistResponse | ParsingModeResponse) => void, ) => { if (message.type === "AUTH_LOGIN") { if (DEV_MODE) { @@ -372,6 +378,7 @@ chrome.runtime.onMessage.addListener( session: session ? { ...session, elapsedMs: getElapsedMs(session) } : null, }); if (session?.dbSessionId) void tryEndDbSession(session.dbSessionId); + void chrome.storage.local.remove(["trackListenedMs", "popupSnapshot"]); }) .catch((err: unknown) => sendResponse({ @@ -500,7 +507,10 @@ chrome.runtime.onMessage.addListener( // Close the previous track then save the new one const session = await getSession(); - await endCurrentDbTrack(); // no-op if no previous track + await endCurrentDbTrack(); // no-op if no previous track; also accumulates trackListenedMs + // Reset display accumulators — new track starts fresh + await chrome.storage.local.set({ trackListenedMs: 0 }); + await chrome.storage.local.remove("popupSnapshot"); if (session && session.pausedAt === null && session.dbSessionId) { void saveTrackToDb(track, session.dbSessionId); } @@ -541,32 +551,6 @@ chrome.runtime.onMessage.addListener( return true; } - // ─── Content script messages ───────────────────────────────────────────── - - if (message.type === "PAGE_METADATA") { - // Store metadata only when a session is active (AC 5 will batch-send it) - // Background-level blocklist check: second line of defence after content script - void (async () => { - const { url, title, metaDescription, headings } = message.payload; - const blocked = await isDomainBlocked(url); - if (blocked) return; - - const session = await getSession(); - if (!session) return; - - const content = [metaDescription, ...headings].filter(Boolean).join(" | ") || null; - const event: PendingEvent = { - url, - title, - content, - tags: [], - timestamp: new Date().toISOString(), - }; - void enqueuePending(event); - })(); - return false; // no async response needed - } - // ─── Blocklist messages ────────────────────────────────────────────────── if (message.type === "BLOCKLIST_GET") { @@ -605,6 +589,32 @@ chrome.runtime.onMessage.addListener( return true; } + // ─── Parsing mode messages ─────────────────────────────────────────────── + + if (message.type === "PARSING_MODE_GET") { + getParsingMode() + .then((mode) => sendResponse({ success: true, mode })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + + if (message.type === "PARSING_MODE_SET") { + setParsingMode(message.mode) + .then(() => sendResponse({ success: true, mode: message.mode })) + .catch((err: unknown) => + sendResponse({ + success: false, + error: err instanceof Error ? err.message : "Unknown error", + }), + ); + return true; + } + return false; }, ); diff --git a/extension/src/background/parsing.ts b/extension/src/background/parsing.ts new file mode 100644 index 0000000..ecda4ec --- /dev/null +++ b/extension/src/background/parsing.ts @@ -0,0 +1,14 @@ +import type { ParsingMode } from "../types/parsing"; + +const PARSING_MODE_KEY = "parsingMode"; + +/** Reads the stored parsing mode; returns "full" if not yet set. */ +export async function getParsingMode(): Promise<ParsingMode> { + const r = await chrome.storage.local.get(PARSING_MODE_KEY); + return (r[PARSING_MODE_KEY] as ParsingMode | undefined) ?? "full"; +} + +/** Persists the chosen parsing mode to chrome.storage.local. */ +export async function setParsingMode(mode: ParsingMode): Promise<void> { + await chrome.storage.local.set({ [PARSING_MODE_KEY]: mode }); +} diff --git a/extension/src/content/index.ts b/extension/src/content/index.ts index 6b37ba5..6666386 100644 --- a/extension/src/content/index.ts +++ b/extension/src/content/index.ts @@ -1,52 +1,83 @@ -import type { ContentMessage, PageMetadata } from "../types/content"; +import type { PageMetadata } from "../types/content"; +import type { PendingEvent } from "../types/pending"; +import type { ParsingMode } from "../types/parsing"; -const BLOCKLIST_KEY = "blockedDomains"; +/** Music sites always get full parsing regardless of the global mode setting. */ +const MUSIC_HOSTNAMES = new Set(["music.youtube.com", "soundcloud.com"]); -/** - * Returns true if the current page's hostname is in the blocklist. - * Reads directly from chrome.storage.local — no round-trip to background. - */ -async function isCurrentHostnameBlocked(): Promise<boolean> { - const r = await chrome.storage.local.get(BLOCKLIST_KEY); - const blocklist = (r[BLOCKLIST_KEY] as string[] | undefined) ?? []; - const hostname = window.location.hostname; - return blocklist.some( - (blocked) => hostname === blocked || hostname.endsWith(`.${blocked}`), - ); -} +function parseMetadata(mode: ParsingMode): PageMetadata { + const headings = + mode !== "meta" + ? Array.from(document.querySelectorAll("h1, h2, h3")) + .map((el) => el.textContent?.trim() ?? "") + .filter((text) => text.length > 0) + : []; -function parseMetadata(): PageMetadata { - const headings = Array.from(document.querySelectorAll("h1, h2, h3")) - .map((el) => el.textContent?.trim() ?? "") - .filter((text) => text.length > 0); + const metaDescription = + mode !== "headings" + ? (document.querySelector<HTMLMetaElement>('meta[name="description"]') + ?.content ?? null) + : null; return { url: window.location.href, title: document.title, - metaDescription: - document.querySelector<HTMLMetaElement>('meta[name="description"]') - ?.content ?? null, + metaDescription, headings, }; } -async function sendMetadata(): Promise<void> { - // First-level filter: do not parse or send data for blocked domains - const blocked = await isCurrentHostnameBlocked(); +async function captureMetadata(): Promise<void> { + // Single read — everything needed to decide and act, except pendingEvents + const r = await chrome.storage.local.get([ + "blockedDomains", + "parsingMode", + "activeSession", + ]); + + // Level-1 blocklist filter: blocked domains are never parsed + const blocklist = (r["blockedDomains"] as string[] | undefined) ?? []; + const hostname = window.location.hostname; + const blocked = blocklist.some( + (d) => hostname === d || hostname.endsWith(`.${d}`), + ); if (blocked) return; - const message: ContentMessage = { - type: "PAGE_METADATA", - payload: parseMetadata(), + // No session or paused session → do not collect + const session = r["activeSession"] as { pausedAt: number | null } | undefined; + if (!session || session.pausedAt !== null) return; + + // Music sites always use full mode to preserve album/playlist context + const globalMode = (r["parsingMode"] as ParsingMode | undefined) ?? "full"; + const effectiveMode: ParsingMode = MUSIC_HOSTNAMES.has(hostname) + ? "full" + : globalMode; + + const meta = parseMetadata(effectiveMode); + const content = + [meta.metaDescription, ...meta.headings].filter(Boolean).join(" | ") || + null; + + const event: PendingEvent = { + url: meta.url, + title: meta.title, + content, + tags: [], + timestamp: new Date().toISOString(), }; - chrome.runtime.sendMessage(message).catch(() => { - // Service worker may be inactive — silently ignore - }); + + // Fresh read of pendingEvents right before writing to avoid stale overwrites + // when multiple tabs capture simultaneously. + // Writing directly to storage bypasses the service worker entirely — + // events are never dropped due to SW sleep (MV3 limitation). + const fresh = await chrome.storage.local.get("pendingEvents"); + const pending = (fresh["pendingEvents"] as PendingEvent[] | undefined) ?? []; + await chrome.storage.local.set({ pendingEvents: [...pending, event] }); } -// Send on initial load -void sendMetadata(); +// Capture on initial page load +void captureMetadata(); -// Re-send on SPA navigation -window.addEventListener("popstate", () => { void sendMetadata(); }); -window.addEventListener("hashchange", () => { void sendMetadata(); }); +// Re-capture on SPA navigation +window.addEventListener("popstate", () => { void captureMetadata(); }); +window.addEventListener("hashchange", () => { void captureMetadata(); }); diff --git a/extension/src/popup/index.html b/extension/src/popup/index.html index edc6479..9477633 100644 --- a/extension/src/popup/index.html +++ b/extension/src/popup/index.html @@ -77,6 +77,16 @@ <button class="btn btn--note" id="btn-note">+ LOG NOTE</button> </section> + <!-- Parsing Mode --> + <section class="popup__parsing"> + <div class="popup__field-label">CAPTURE</div> + <div class="popup__parsing-group" id="parsing-group" role="group" aria-label="Parsing mode"> + <button class="popup__parsing-btn" data-mode="full">FULL</button> + <button class="popup__parsing-btn" data-mode="headings">HEADINGS</button> + <button class="popup__parsing-btn" data-mode="meta">META</button> + </div> + </section> + <!-- Privacy / Blocklist --> <section class="popup__blocklist"> diff --git a/extension/src/popup/popup.css b/extension/src/popup/popup.css index cb70c13..8b438c5 100644 --- a/extension/src/popup/popup.css +++ b/extension/src/popup/popup.css @@ -545,3 +545,46 @@ body { text-overflow: ellipsis; max-width: 200px; } + +/* ═══════════════════════════════════════════════════════════════════════════════ + BLOCK: popup__parsing +═══════════════════════════════════════════════════════════════════════════════ */ +.popup__parsing { + display: flex; + flex-direction: column; + gap: 8px; + border-top: 1px solid var(--c-border); + padding-top: 12px; +} + +.popup__parsing-group { + display: flex; + gap: 4px; +} + +.popup__parsing-btn { + flex: 1; + background: transparent; + border: 1px solid var(--c-muted); + color: var(--c-muted); + border-radius: 4px; + padding: 5px 0; + font-family: inherit; + font-size: 10px; + font-weight: 700; + letter-spacing: 0.05em; + cursor: pointer; + transition: background 0.15s, border-color 0.15s, color 0.15s, box-shadow 0.15s; +} + +.popup__parsing-btn:hover:not(.popup__parsing-btn--active) { + border-color: var(--c-text); + color: var(--c-text); +} + +.popup__parsing-btn--active { + border-color: var(--c-cyan); + color: var(--c-cyan); + background: color-mix(in srgb, var(--c-cyan) 8%, transparent); + box-shadow: 0 0 6px color-mix(in srgb, var(--c-cyan) 20%, transparent); +} diff --git a/extension/src/popup/popup.ts b/extension/src/popup/popup.ts index f997af1..f8c0e8f 100644 --- a/extension/src/popup/popup.ts +++ b/extension/src/popup/popup.ts @@ -1,6 +1,7 @@ import type { AuthMessage, AuthResponse } from "../types/auth"; import type { BlocklistMessage, BlocklistResponse } from "../types/blocklist"; import type { MusicMessage, MusicResponse, TrackInfo } from "../types/music"; +import type { ParsingMode, ParsingModeMessage, ParsingModeResponse } from "../types/parsing"; import type { SessionMessage, SessionResponse, SessionState } from "../types/session"; import type { SyncMessage, SyncResponse } from "../types/sync"; @@ -56,6 +57,16 @@ function sendBlocklist(msg: BlocklistMessage): Promise<BlocklistResponse> { ); } +function sendParsingMode(msg: ParsingModeMessage): Promise<ParsingModeResponse> { + return new Promise((resolve, reject) => + chrome.runtime.sendMessage(msg, (res: ParsingModeResponse | undefined) => { + if (chrome.runtime.lastError) return reject(new Error(chrome.runtime.lastError.message)); + if (!res) return reject(new Error("No response from background")); + resolve(res); + }), + ); +} + // ─── DOM refs ────────────────────────────────────────────────────────────────── const statusDot = document.getElementById("status-dot") as HTMLSpanElement; @@ -88,6 +99,9 @@ const btnAccordion = document.getElementById("btn-blocklist-accordion") const blocklistCountLabel = document.getElementById("blocklist-count-label") as HTMLSpanElement; const blocklistList = document.getElementById("blocklist-list") as HTMLDivElement; +// ─── Parsing mode DOM refs ───────────────────────────────────────────────────── +const parsingGroup = document.getElementById("parsing-group") as HTMLDivElement; + // ─── Timer formatting ────────────────────────────────────────────────────────── function formatMs(ms: number): string { @@ -178,11 +192,15 @@ async function refreshSyncIndicator(): Promise<void> { let activeTrack: TrackInfo | null = null; // Accumulated display duration in ms — only increments while session is active // AND music is actually playing (detected by playbackTime changing). -// Reset to 0 on track change; initialised from capturedAt on first popup load. +// Initialised from storage (trackListenedMs + currentPeriodStartMs) on popup open +// so the value does not jump after pause or popup reopen. let displayDurationMs = 0; // Previous playbackTime value — compared each tick to detect play vs pause. // null = not yet initialised (first tick after track appears). let prevPlaybackTime: string | null = null; +// Set to true when track changes — triggers a one-time storage read to restore +// the correct displayDurationMs (avoids the jump-on-reopen bug). +let needsStorageInit = false; function formatTrackDuration(ms: number): string { const totalSec = Math.floor(ms / 1000); @@ -191,16 +209,33 @@ function formatTrackDuration(ms: number): string { return `${String(m)}:${String(s).padStart(2, "0")}`; } +/** Parses "M:SS" or "H:MM:SS" → seconds. Returns null for invalid input. */ +function parsePlaybackTime(t: string): number | null { + if (!t.trim()) return null; + const parts = t.trim().split(":").map((n) => parseInt(n, 10)); + if (parts.some((p) => isNaN(p))) return null; + if (parts.length === 2) return (parts[0] ?? 0) * 60 + (parts[1] ?? 0); + if (parts.length === 3) return (parts[0] ?? 0) * 3600 + (parts[1] ?? 0) * 60 + (parts[2] ?? 0); + return null; +} + +interface PopupSnapshot { + trackKey: string; + playbackTime: string; // raw DOM value e.g. "1:23" + displayDurationMs: number; + capturedAt: number; +} + function applyTrack(track: TrackInfo | null): void { const prevKey = activeTrack ? `${activeTrack.title}::${activeTrack.artist}` : null; const newKey = track ? `${track.title}::${track.artist}` : null; - // Reset duration counter and playback-time baseline when track changes + // On track change: reset counters and schedule a storage read to restore + // the correct accumulated duration (fixes jump-on-reopen bug). if (newKey !== prevKey) { - displayDurationMs = track - ? Math.max(0, Date.now() - new Date(track.capturedAt).getTime()) - : 0; - prevPlaybackTime = null; + displayDurationMs = 0; + prevPlaybackTime = null; + needsStorageInit = !!track; } activeTrack = track; @@ -220,6 +255,68 @@ function applyTrack(track: TrackInfo | null): void { trackSource.className = `popup__track-source popup__track-source--${isYTM ? "ytm" : "sc"}`; } +/** + * Restores displayDurationMs from storage after popup opens or track changes. + * + * PRIORITY 1 — session not active (paused / stopped): the track timer must be + * frozen, period. Use the snapshot value as-is (no delta). The DOM playbackTime + * may still be advancing because session pause does not pause the music player, + * but we must NOT count that time. + * + * PRIORITY 2 — session active: compute delta from the snapshot's playbackTime + * to the current DOM playbackTime. This is the source of truth for "was the + * music actually playing while popup was closed". + * - delta > 0 → music played for `delta` seconds → add to snapshot value + * - delta = 0 → music was paused in the player → keep snapshot value + * - delta < 0 → user seeked backward → keep snapshot value (best effort) + * + * PRIORITY 3 — no snapshot for this track: fall back to background-accumulated + * trackListenedMs (correct for session pauses, best-effort otherwise). + */ +async function initDurationFromStorage(): Promise<void> { + if (!activeTrack) return; + const trackKey = `${activeTrack.title}::${activeTrack.artist}`; + const r = await chrome.storage.local.get([ + "popupSnapshot", + "trackListenedMs", + "currentPeriodStartMs", + ]); + const snap = r["popupSnapshot"] as PopupSnapshot | undefined; + + // PRIORITY 1: session paused/stopped → freeze track timer, no delta. + if (!isSessionActive) { + if (snap && snap.trackKey === trackKey) { + displayDurationMs = snap.displayDurationMs; + } else { + displayDurationMs = (r["trackListenedMs"] as number | undefined) ?? 0; + } + trackDuration.textContent = formatTrackDuration(displayDurationMs); + return; + } + + // PRIORITY 2: session active + matching snapshot → playbackTime delta. + if (snap && snap.trackKey === trackKey) { + const prevSec = parsePlaybackTime(snap.playbackTime); + const currSec = parsePlaybackTime(activeTrack.playbackTime ?? ""); + if (prevSec !== null && currSec !== null) { + const deltaSec = currSec - prevSec; + const addMs = deltaSec > 0 ? deltaSec * 1000 : 0; + displayDurationMs = snap.displayDurationMs + addMs; + } else { + displayDurationMs = snap.displayDurationMs; + } + trackDuration.textContent = formatTrackDuration(displayDurationMs); + return; + } + + // PRIORITY 3: fallback — background-accumulated value. + const accumulated = (r["trackListenedMs"] as number | undefined) ?? 0; + const periodStart = r["currentPeriodStartMs"] as number | undefined; + const currentPeriodMs = periodStart ? Math.max(0, Date.now() - periodStart) : 0; + displayDurationMs = accumulated + currentPeriodMs; + trackDuration.textContent = formatTrackDuration(displayDurationMs); +} + function refreshDuration(): void { if (!activeTrack) return; @@ -235,12 +332,27 @@ function refreshDuration(): void { if (isSessionActive && trackIsPlaying) displayDurationMs += 1000; trackDuration.textContent = formatTrackDuration(displayDurationMs); + + // Save snapshot every tick — initDurationFromStorage will compare its + // playbackTime against fresh DOM value on reopen to compute true delta. + const snap: PopupSnapshot = { + trackKey: `${activeTrack.title}::${activeTrack.artist}`, + playbackTime: curr, + displayDurationMs, + capturedAt: Date.now(), + }; + void chrome.storage.local.set({ popupSnapshot: snap }); } async function refreshTrack(): Promise<void> { const res = await sendMusic({ type: "TRACK_GET_CURRENT" }).catch(() => null); if (!res || !res.success) return; applyTrack(res.track); + // One-time storage read when track is new — restores correct duration without jump + if (needsStorageInit) { + needsStorageInit = false; + await initDurationFromStorage(); + } } // ─── Blocklist ───────────────────────────────────────────────────────────────── @@ -353,6 +465,32 @@ blocklistList.addEventListener("change", async (e) => { } }); +// ─── Parsing mode ───────────────────────────────────────────────────────────── + +async function refreshParsingMode(): Promise<void> { + const res = await sendParsingMode({ type: "PARSING_MODE_GET" }).catch(() => null); + if (!res || !res.success) return; + applyParsingModeUI(res.mode); +} + +function applyParsingModeUI(mode: ParsingMode): void { + parsingGroup.querySelectorAll<HTMLButtonElement>(".popup__parsing-btn").forEach((btn) => { + btn.classList.toggle("popup__parsing-btn--active", btn.dataset["mode"] === mode); + }); +} + +parsingGroup.addEventListener("click", async (e) => { + const target = e.target as HTMLButtonElement | null; + if (!target?.classList.contains("popup__parsing-btn")) return; + const mode = target.dataset["mode"] as ParsingMode | undefined; + if (!mode) return; + // Optimistic UI update — apply immediately before the round-trip + applyParsingModeUI(mode); + await sendParsingMode({ type: "PARSING_MODE_SET", mode }).catch(() => null); + // Confirm from storage (catches any error / mismatch) + await refreshParsingMode(); +}); + // ─── Session polling ─────────────────────────────────────────────────────────── let pollInterval: ReturnType<typeof setInterval> | null = null; @@ -374,6 +512,7 @@ function startPolling(): void { await refreshTrack(); refreshDuration(); // update elapsed time without extra round-trip await refreshBlocklist(); + await refreshParsingMode(); }, 1000); } @@ -405,6 +544,7 @@ async function init(): Promise<void> { await refreshSyncIndicator(); await refreshTrack(); await refreshBlocklist(); + await refreshParsingMode(); startPolling(); } diff --git a/extension/src/types/content.ts b/extension/src/types/content.ts index bccae5c..768b29f 100644 --- a/extension/src/types/content.ts +++ b/extension/src/types/content.ts @@ -4,5 +4,3 @@ export interface PageMetadata { metaDescription: string | null; headings: string[]; // h1–h3 text content } - -export type ContentMessage = { type: "PAGE_METADATA"; payload: PageMetadata }; diff --git a/extension/src/types/parsing.ts b/extension/src/types/parsing.ts new file mode 100644 index 0000000..58d5162 --- /dev/null +++ b/extension/src/types/parsing.ts @@ -0,0 +1,9 @@ +export type ParsingMode = "full" | "headings" | "meta"; + +export type ParsingModeMessage = + | { type: "PARSING_MODE_GET" } + | { type: "PARSING_MODE_SET"; mode: ParsingMode }; + +export type ParsingModeResponse = + | { success: true; mode: ParsingMode } + | { success: false; error: string }; diff --git a/plans/week2/AC8-parsing-modes.md b/plans/week2/AC8-parsing-modes.md new file mode 100644 index 0000000..dcaadc5 --- /dev/null +++ b/plans/week2/AC8-parsing-modes.md @@ -0,0 +1,151 @@ +# Plan: AC8 — Parsing Modes + +**Branch:** `feature/extension-parsing-modes` +**Scope:** Extension only — no dashboard changes needed. + +--- + +## Мета + +Надати користувачу контроль над тим, **що саме** content script витягує зі сторінки: + +| Режим | Що збирається | Use-case | +|---|---|---| +| `full` | title + metaDescription + h1–h3 | дефолт; максимум контексту | +| `headings` | title + h1–h3 | статті/docs — структура важливіша за мету | +| `meta` | title + metaDescription | легкий режим; ніяких заголовків | + +Режим зберігається в `chrome.storage.local`, застосовується в content script **після** фільтра blocklist, і перемикається прямо з popup. + +--- + +## Аналіз поточного стану + +| Точка | Файл | Поточна поведінка | +|---|---|---| +| Content script | `content/index.ts` | `parseMetadata()` завжди збирає title + metaDescription + всі h1–h3 | +| Background | `background/index.ts` | обробляє `PAGE_METADATA` — про режим не знає | +| Popup | `popup/index.html` + `popup.ts` | немає жодного контролю режиму | + +--- + +## Архітектурні рішення + +### 1. Де зберігати режим + +`chrome.storage.local`, ключ `"parsingMode"`, дефолт `"full"` — зворотна сумісність. + +### 2. Де застосовувати режим + +**Тільки в content script** — `parseMetadata()` стає mode-aware. Background не знає про режим, отримує вже відфільтровані дані. Одне місце логіки. + +### 3. Порядок перевірок у `sendMetadata()` + +1. Читає `blockedDomains` + `parsingMode` **одним** `chrome.storage.local.get()` — один I/O замість двох +2. Перевіряє blocklist → заблоковано? → `return` +3. Визначає `effectiveMode`: якщо hostname в `MUSIC_HOSTNAMES` → завжди `"full"`, інакше — значення зі storage + +### 4. Виняток для музичних сайтів + +`music.youtube.com` і `soundcloud.com` **завжди парсяться у `full`** незалежно від глобального режиму. +Реалізується як константа-множина в content script — нуль нових storage reads, нуль нових message types. + +**Чому:** general content script збирає контекст сторінки на цих доменах (назва плейлиста, опис альбому), доповнюючи музичні content scripts. Обрізати цей контекст без користі для privacy немає сенсу. + +### 5. `PageMetadata` — не змінюється + +При `meta`-режимі `headings = []`, при `headings`-режимі `metaDescription = null`. Background, API та Prisma schema без змін. + +### 6. Messages між popup і background + +Два нові типи повідомлень: `PARSING_MODE_GET` та `PARSING_MODE_SET`. Патерн той самий що у blocklist. + +### 7. UI у popup — сегментований контрол + +Нова секція **CAPTURE** після PRIVACY/Blocklist з трьома кнопками у flex-ряд. +Активна кнопка — cyan border + glow (стиль відповідає START-кнопці). +Натиск оновлює UI оптимістично та надсилає `PARSING_MODE_SET`. +`refreshParsingMode()` викликається в `init()` та в `setInterval` разом з `refreshBlocklist`. + +--- + +## Нові файли + +| Файл | Що містить | +|---|---| +| `extension/src/types/parsing.ts` | `ParsingMode` = `"full" \| "headings" \| "meta"`, union `ParsingModeMessage` (`GET`/`SET`), `ParsingModeResponse` | +| `extension/src/background/parsing.ts` | `getParsingMode()` — читає storage, повертає `"full"` за замовчуванням; `setParsingMode(mode)` — записує в storage | + +--- + +## Зміни у існуючих файлах + +### `extension/src/content/index.ts` + +- `parseMetadata()` приймає `mode: ParsingMode` — при `meta` не збирає headings, при `headings` не збирає metaDescription +- `sendMetadata()` — об'єднаний storage read (blocklist + mode), логіка `MUSIC_HOSTNAMES` override, видалення окремої `isCurrentHostnameBlocked()` + +### `extension/src/background/index.ts` + +- Імпорти `ParsingModeMessage`, `ParsingModeResponse`, `getParsingMode`, `setParsingMode` +- `IncomingMessage` union розширюється `| ParsingModeMessage` +- Нові handlers `PARSING_MODE_GET` і `PARSING_MODE_SET` (після блоку blocklist-handlers) + +### `extension/src/popup/index.html` + +- Нова секція `<!-- Parsing Mode -->` після `<!-- Privacy / Blocklist -->` +- Мітка `CAPTURE` + три кнопки з `data-mode` атрибутом: `full`, `headings`, `meta` + +### `extension/src/popup/popup.ts` + +- Імпорт `ParsingMode` і нових message-типів +- DOM ref на групу кнопок +- `sendParsingMode()` — helper за патерном `sendBlocklist` +- `refreshParsingMode()` — викликає `PARSING_MODE_GET`, ставить клас `--active` на потрібну кнопку +- Delegated `click` на групі кнопок → `PARSING_MODE_SET` + оптимістичний UI update +- `refreshParsingMode()` викликається в `init()` та `setInterval` + +### `extension/src/popup/popup.css` + +- `.popup__parsing` — секція (flex column, gap, border-top як у інших секцій) +- `.popup__parsing-group` — flex row, gap між кнопками +- `.popup__parsing-btn` — кнопка зі стилем як у `.btn` але `flex: 1`, менший padding +- `.popup__parsing-btn--active` — cyan border + background + glow + +--- + +## Порядок реалізації та коміти + +| Коміт | Повідомлення | Файли | +|---|---|---| +| ✅ вже є | `docs(backlog): music track duration display bug` | — | +| 2 | `docs(plans): add AC8 parsing modes plan` | `plans/week2/AC8-parsing-modes.md` | +| 3 | `feat(extension): parsing mode storage module and background message handlers` | `types/parsing.ts`, `background/parsing.ts`, `background/index.ts` | +| 4 | `feat(extension): apply parsing mode in content script metadata collection` | `content/index.ts` | +| 5 | `feat(extension): add parsing mode segmented control to popup` | `popup/index.html`, `popup/popup.css`, `popup/popup.ts` | +| 6+ | `fix(extension): <конкретний опис після тестування>` | — | + +> **Можливі edge cases для fix-комітів:** event delegation (`e.target` vs `currentTarget`) на кнопках; режим не підхоплюється content script при SPA-навігації; race між `setParsingMode` і наступним `sendMetadata`. + +--- + +## Що НЕ змінюється + +- Dashboard, Prisma schema, `background/sync.ts` — жодних змін +- `content/ytm.ts`, `content/soundcloud.ts` — не знають про `parsingMode`, завжди збирають тільки трек +- Manifest — нових permissions не потрібно (`storage` вже є) + +--- + +## Definition of Done + +- [ ] `"parsingMode"` зберігається в storage; дефолт `"full"` +- [ ] `full` — title + metaDescription + h1–h3 +- [ ] `headings` — title + h1–h3; metaDescription = null +- [ ] `meta` — title + metaDescription; headings = [] +- [ ] `music.youtube.com` і `soundcloud.com` завжди парсяться у `full` +- [ ] Content script читає blocklist + mode одним storage call +- [ ] Popup: сегментований контрол, активна кнопка виділена cyan +- [ ] Зміна режиму — миттєвий оптимістичний UI + збереження в storage +- [ ] Режим зберігається між перезавантаженнями extension +- [ ] TypeScript strict — немає `any`; `npm run build` без помилок From 52fa00bfb62971e97c3010fefbd665dae27a7677 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Tue, 26 May 2026 20:19:35 +0300 Subject: [PATCH 14/24] feat(dashboard): week 3 AC 1 - google login, session cookie and middleware guard (#14) * docs(plans): add week 3 AC 1 dashboard auth plan * feat(dashboard): add web google login + logout routes and session cookie helper * feat(dashboard): add /login page with google identity services button * feat(dashboard): add middleware guarding /dashboard and placeholder page * fix(dashboard): force english locale for google sign-in button * chore(dashboard): remove default next.js boilerplate and set worktrace metadata --- dashboard/.env.example | 5 + dashboard/app/api/auth/extension/route.ts | 4 +- dashboard/app/api/auth/google/route.ts | 30 +++++ dashboard/app/api/auth/logout/route.ts | 8 ++ dashboard/app/dashboard/logout-button.tsx | 28 ++++ dashboard/app/dashboard/page.tsx | 31 +++++ dashboard/app/layout.tsx | 4 +- dashboard/app/login/google-button.tsx | 64 +++++++++ dashboard/app/login/page.tsx | 32 +++++ dashboard/app/page.tsx | 64 +-------- dashboard/middleware.ts | 35 +++++ dashboard/package-lock.json | 10 ++ dashboard/package.json | 1 + dashboard/public/file.svg | 1 - dashboard/public/globe.svg | 1 - dashboard/public/next.svg | 1 - dashboard/public/vercel.svg | 1 - dashboard/public/window.svg | 1 - dashboard/server/auth.ts | 2 +- dashboard/server/cookies.ts | 36 +++++ dashboard/server/jwt.ts | 18 ++- dashboard/server/schemas/auth.ts | 7 +- dashboard/types/google-identity.d.ts | 36 +++++ plans/week3/AC1-dashboard-auth.md | 155 ++++++++++++++++++++++ 24 files changed, 501 insertions(+), 74 deletions(-) create mode 100644 dashboard/app/api/auth/google/route.ts create mode 100644 dashboard/app/api/auth/logout/route.ts create mode 100644 dashboard/app/dashboard/logout-button.tsx create mode 100644 dashboard/app/dashboard/page.tsx create mode 100644 dashboard/app/login/google-button.tsx create mode 100644 dashboard/app/login/page.tsx create mode 100644 dashboard/middleware.ts delete mode 100644 dashboard/public/file.svg delete mode 100644 dashboard/public/globe.svg delete mode 100644 dashboard/public/next.svg delete mode 100644 dashboard/public/vercel.svg delete mode 100644 dashboard/public/window.svg create mode 100644 dashboard/server/cookies.ts create mode 100644 dashboard/types/google-identity.d.ts create mode 100644 plans/week3/AC1-dashboard-auth.md diff --git a/dashboard/.env.example b/dashboard/.env.example index e9bf733..0699d43 100644 --- a/dashboard/.env.example +++ b/dashboard/.env.example @@ -18,6 +18,11 @@ DATABASE_URL="postgresql://postgres:postgres@localhost:5433/worktrace" # Authorized redirect URIs: http://localhost:3000/api/auth/callback/google GOOGLE_CLIENT_ID="" +# Same value as GOOGLE_CLIENT_ID — exposed to the browser so the GIS +# "Sign in with Google" button can initialize. Backend still verifies +# via GOOGLE_CLIENT_ID, this one is read by the client bundle only. +NEXT_PUBLIC_GOOGLE_CLIENT_ID="" + # Client secret — needed in Week 3 for the web dashboard authorization code flow. # Same credentials page as GOOGLE_CLIENT_ID (Web application type). GOOGLE_CLIENT_SECRET="" diff --git a/dashboard/app/api/auth/extension/route.ts b/dashboard/app/api/auth/extension/route.ts index 8a5fc5d..ca0710e 100644 --- a/dashboard/app/api/auth/extension/route.ts +++ b/dashboard/app/api/auth/extension/route.ts @@ -1,7 +1,7 @@ import { NextRequest, NextResponse } from "next/server"; import { withCors, corsPreflight } from "@/server/cors"; import { ExtensionAuthInput } from "@/server/schemas/auth"; -import { authenticateExtensionUser } from "@/server/auth"; +import { authenticateGoogleUser } from "@/server/auth"; export const POST = withCors(async (req: NextRequest) => { let body: unknown; @@ -17,7 +17,7 @@ export const POST = withCors(async (req: NextRequest) => { } try { - const token = await authenticateExtensionUser(parsed.data.googleToken); + const token = await authenticateGoogleUser(parsed.data.googleToken); return NextResponse.json({ token }, { status: 200 }); } catch (err) { const message = err instanceof Error ? err.message : "Authentication failed"; diff --git a/dashboard/app/api/auth/google/route.ts b/dashboard/app/api/auth/google/route.ts new file mode 100644 index 0000000..06a81b8 --- /dev/null +++ b/dashboard/app/api/auth/google/route.ts @@ -0,0 +1,30 @@ +import { NextRequest, NextResponse } from "next/server"; +import { WebAuthInput } from "@/server/schemas/auth"; +import { authenticateGoogleUser } from "@/server/auth"; +import { SESSION_COOKIE, sessionCookieOptions } from "@/server/cookies"; + +export async function POST(req: NextRequest) { + let body: unknown; + try { + body = await req.json(); + } catch { + return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); + } + + const parsed = WebAuthInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: parsed.error.format() }, { status: 400 }); + } + + let token: string; + try { + token = await authenticateGoogleUser(parsed.data.googleToken); + } catch (err) { + const message = err instanceof Error ? err.message : "Authentication failed"; + return NextResponse.json({ error: message }, { status: 401 }); + } + + const res = NextResponse.json({ ok: true }, { status: 200 }); + res.cookies.set(SESSION_COOKIE, token, sessionCookieOptions()); + return res; +} diff --git a/dashboard/app/api/auth/logout/route.ts b/dashboard/app/api/auth/logout/route.ts new file mode 100644 index 0000000..19d4391 --- /dev/null +++ b/dashboard/app/api/auth/logout/route.ts @@ -0,0 +1,8 @@ +import { NextResponse } from "next/server"; +import { SESSION_COOKIE, clearedCookieOptions } from "@/server/cookies"; + +export function POST() { + const res = NextResponse.json({ ok: true }, { status: 200 }); + res.cookies.set(SESSION_COOKIE, "", clearedCookieOptions()); + return res; +} diff --git a/dashboard/app/dashboard/logout-button.tsx b/dashboard/app/dashboard/logout-button.tsx new file mode 100644 index 0000000..d8bc84d --- /dev/null +++ b/dashboard/app/dashboard/logout-button.tsx @@ -0,0 +1,28 @@ +"use client"; + +import { useState } from "react"; +import { useRouter } from "next/navigation"; + +export function LogoutButton() { + const router = useRouter(); + const [pending, setPending] = useState(false); + + return ( + <button + type="button" + disabled={pending} + onClick={async () => { + setPending(true); + try { + await fetch("/api/auth/logout", { method: "POST" }); + } finally { + router.replace("/login"); + router.refresh(); + } + }} + className="flex h-10 items-center justify-center rounded-full border border-black/[.08] px-5 text-sm font-medium transition-colors hover:bg-black/[.04] disabled:opacity-50 dark:border-white/[.145] dark:hover:bg-white/[.06]" + > + {pending ? "Signing out…" : "Sign out"} + </button> + ); +} diff --git a/dashboard/app/dashboard/page.tsx b/dashboard/app/dashboard/page.tsx new file mode 100644 index 0000000..059f299 --- /dev/null +++ b/dashboard/app/dashboard/page.tsx @@ -0,0 +1,31 @@ +import { cookies } from "next/headers"; +import { redirect } from "next/navigation"; +import { SESSION_COOKIE } from "@/server/cookies"; +import { verifyJwt } from "@/server/jwt"; +import { LogoutButton } from "./logout-button"; + +export default async function DashboardPage() { + const token = (await cookies()).get(SESSION_COOKIE)?.value; + if (!token) redirect("/login"); + + let email: string; + try { + ({ email } = await verifyJwt(token)); + } catch { + redirect("/login"); + } + + return ( + <main className="flex flex-1 items-center justify-center bg-zinc-50 dark:bg-black"> + <div className="flex w-full max-w-md flex-col items-center gap-6 rounded-2xl border border-black/[.08] bg-white p-10 dark:border-white/[.145] dark:bg-zinc-950"> + <h1 className="text-2xl font-semibold tracking-tight text-black dark:text-zinc-50"> + Welcome to WorkTrace + </h1> + <p className="text-sm text-zinc-600 dark:text-zinc-400"> + Signed in as <span className="font-medium text-black dark:text-zinc-50">{email}</span> + </p> + <LogoutButton /> + </div> + </main> + ); +} diff --git a/dashboard/app/layout.tsx b/dashboard/app/layout.tsx index 976eb90..d35774f 100644 --- a/dashboard/app/layout.tsx +++ b/dashboard/app/layout.tsx @@ -13,8 +13,8 @@ const geistMono = Geist_Mono({ }); export const metadata: Metadata = { - title: "Create Next App", - description: "Generated by create next app", + title: "WorkTrace", + description: "Capture and analyze your development session context.", }; export default function RootLayout({ diff --git a/dashboard/app/login/google-button.tsx b/dashboard/app/login/google-button.tsx new file mode 100644 index 0000000..0110dba --- /dev/null +++ b/dashboard/app/login/google-button.tsx @@ -0,0 +1,64 @@ +"use client"; + +import { useEffect, useRef, useState } from "react"; +import { useRouter } from "next/navigation"; + +export function GoogleLoginButton({ clientId }: { clientId: string }) { + const buttonRef = useRef<HTMLDivElement>(null); + const router = useRouter(); + const [error, setError] = useState<string | null>(null); + + useEffect(() => { + const tryInit = () => { + if (!window.google?.accounts.id || !buttonRef.current) return false; + + window.google.accounts.id.initialize({ + client_id: clientId, + callback: async ({ credential }) => { + setError(null); + try { + const res = await fetch("/api/auth/google", { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify({ googleToken: credential }), + }); + if (!res.ok) { + const data: unknown = await res.json().catch(() => ({})); + const msg = isErrorBody(data) ? data.error : "Login failed"; + setError(typeof msg === "string" ? msg : "Login failed"); + return; + } + router.replace("/dashboard"); + router.refresh(); + } catch { + setError("Network error, please try again."); + } + }, + }); + + window.google.accounts.id.renderButton(buttonRef.current, { + type: "standard", + theme: "outline", + size: "large", + text: "signin_with", + shape: "pill", + }); + return true; + }; + + if (tryInit()) return; + const interval = window.setInterval(() => { if (tryInit()) window.clearInterval(interval); }, 100); + return () => window.clearInterval(interval); + }, [clientId, router]); + + return ( + <div className="flex flex-col items-center gap-3"> + <div ref={buttonRef} /> + {error && <p className="text-sm text-red-600 dark:text-red-400">{error}</p>} + </div> + ); +} + +function isErrorBody(v: unknown): v is { error: unknown } { + return typeof v === "object" && v !== null && "error" in v; +} diff --git a/dashboard/app/login/page.tsx b/dashboard/app/login/page.tsx new file mode 100644 index 0000000..259547a --- /dev/null +++ b/dashboard/app/login/page.tsx @@ -0,0 +1,32 @@ +import Script from "next/script"; +import { GoogleLoginButton } from "./google-button"; + +export default function LoginPage() { + const clientId = process.env.NEXT_PUBLIC_GOOGLE_CLIENT_ID; + + return ( + <main className="flex flex-1 items-center justify-center bg-zinc-50 dark:bg-black"> + <div className="flex w-full max-w-sm flex-col items-center gap-8 rounded-2xl border border-black/[.08] bg-white p-10 dark:border-white/[.145] dark:bg-zinc-950"> + <div className="flex flex-col items-center gap-2 text-center"> + <h1 className="text-2xl font-semibold tracking-tight text-black dark:text-zinc-50"> + Sign in to WorkTrace + </h1> + <p className="text-sm text-zinc-600 dark:text-zinc-400"> + Continue with the same Google account you use in the extension. + </p> + </div> + + {clientId ? ( + <> + <Script src="https://accounts.google.com/gsi/client?hl=en" strategy="afterInteractive" /> + <GoogleLoginButton clientId={clientId} /> + </> + ) : ( + <p className="text-sm text-red-600 dark:text-red-400"> + NEXT_PUBLIC_GOOGLE_CLIENT_ID is not configured. + </p> + )} + </div> + </main> + ); +} diff --git a/dashboard/app/page.tsx b/dashboard/app/page.tsx index 3f36f7c..a74cb27 100644 --- a/dashboard/app/page.tsx +++ b/dashboard/app/page.tsx @@ -1,65 +1,5 @@ -import Image from "next/image"; +import { redirect } from "next/navigation"; export default function Home() { - return ( - <div className="flex flex-col flex-1 items-center justify-center bg-zinc-50 font-sans dark:bg-black"> - <main className="flex flex-1 w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start"> - <Image - className="dark:invert" - src="/next.svg" - alt="Next.js logo" - width={100} - height={20} - priority - /> - <div className="flex flex-col items-center gap-6 text-center sm:items-start sm:text-left"> - <h1 className="max-w-xs text-3xl font-semibold leading-10 tracking-tight text-black dark:text-zinc-50"> - To get started, edit the page.tsx file. - </h1> - <p className="max-w-md text-lg leading-8 text-zinc-600 dark:text-zinc-400"> - Looking for a starting point or more instructions? Head over to{" "} - <a - href="https://vercel.com/templates?framework=next.js&utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app" - className="font-medium text-zinc-950 dark:text-zinc-50" - > - Templates - </a>{" "} - or the{" "} - <a - href="https://nextjs.org/learn?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app" - className="font-medium text-zinc-950 dark:text-zinc-50" - > - Learning - </a>{" "} - center. - </p> - </div> - <div className="flex flex-col gap-4 text-base font-medium sm:flex-row"> - <a - className="flex h-12 w-full items-center justify-center gap-2 rounded-full bg-foreground px-5 text-background transition-colors hover:bg-[#383838] dark:hover:bg-[#ccc] md:w-[158px]" - href="https://vercel.com/new?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app" - target="_blank" - rel="noopener noreferrer" - > - <Image - className="dark:invert" - src="/vercel.svg" - alt="Vercel logomark" - width={16} - height={16} - /> - Deploy Now - </a> - <a - className="flex h-12 w-full items-center justify-center rounded-full border border-solid border-black/[.08] px-5 transition-colors hover:border-transparent hover:bg-black/[.04] dark:border-white/[.145] dark:hover:bg-[#1a1a1a] md:w-[158px]" - href="https://nextjs.org/docs?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app" - target="_blank" - rel="noopener noreferrer" - > - Documentation - </a> - </div> - </main> - </div> - ); + redirect("/dashboard"); } diff --git a/dashboard/middleware.ts b/dashboard/middleware.ts new file mode 100644 index 0000000..b8db4aa --- /dev/null +++ b/dashboard/middleware.ts @@ -0,0 +1,35 @@ +import { NextRequest, NextResponse } from "next/server"; +import { verifyJwt } from "@/server/jwt"; +import { SESSION_COOKIE, clearedCookieOptions } from "@/server/cookies"; + +export const config = { + matcher: ["/dashboard/:path*", "/login"], +}; + +export async function middleware(req: NextRequest) { + const token = req.cookies.get(SESSION_COOKIE)?.value; + const isAuth = token ? await isValid(token) : false; + + const onLogin = req.nextUrl.pathname === "/login"; + + if (onLogin && isAuth) { + return NextResponse.redirect(new URL("/dashboard", req.url)); + } + + if (!onLogin && !isAuth) { + const res = NextResponse.redirect(new URL("/login", req.url)); + if (token) res.cookies.set(SESSION_COOKIE, "", clearedCookieOptions()); + return res; + } + + return NextResponse.next(); +} + +async function isValid(token: string): Promise<boolean> { + try { + await verifyJwt(token); + return true; + } catch { + return false; + } +} diff --git a/dashboard/package-lock.json b/dashboard/package-lock.json index 642f17f..88ac933 100644 --- a/dashboard/package-lock.json +++ b/dashboard/package-lock.json @@ -14,6 +14,7 @@ "d3": "^7.9.0", "framer-motion": "^12.38.0", "google-auth-library": "^10.6.2", + "jose": "^6.2.3", "jsonwebtoken": "^9.0.3", "next": "16.2.6", "pg": "^8.20.0", @@ -6668,6 +6669,15 @@ "jiti": "lib/jiti-cli.mjs" } }, + "node_modules/jose": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/jose/-/jose-6.2.3.tgz", + "integrity": "sha512-YYVDInQKFJfR/xa3ojUTl8c2KoTwiL1R5Wg9YCydwH0x0B9grbzlg5HC7mMjCtUJjbQ/YnGEZIhI5tCgfTb4Hw==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/panva" + } + }, "node_modules/js-tokens": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", diff --git a/dashboard/package.json b/dashboard/package.json index d5dc9f5..7a73104 100644 --- a/dashboard/package.json +++ b/dashboard/package.json @@ -15,6 +15,7 @@ "d3": "^7.9.0", "framer-motion": "^12.38.0", "google-auth-library": "^10.6.2", + "jose": "^6.2.3", "jsonwebtoken": "^9.0.3", "next": "16.2.6", "pg": "^8.20.0", diff --git a/dashboard/public/file.svg b/dashboard/public/file.svg deleted file mode 100644 index 004145c..0000000 --- a/dashboard/public/file.svg +++ /dev/null @@ -1 +0,0 @@ -<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg> \ No newline at end of file diff --git a/dashboard/public/globe.svg b/dashboard/public/globe.svg deleted file mode 100644 index 567f17b..0000000 --- a/dashboard/public/globe.svg +++ /dev/null @@ -1 +0,0 @@ -<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg> \ No newline at end of file diff --git a/dashboard/public/next.svg b/dashboard/public/next.svg deleted file mode 100644 index 5174b28..0000000 --- a/dashboard/public/next.svg +++ /dev/null @@ -1 +0,0 @@ -<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg> \ No newline at end of file diff --git a/dashboard/public/vercel.svg b/dashboard/public/vercel.svg deleted file mode 100644 index 7705396..0000000 --- a/dashboard/public/vercel.svg +++ /dev/null @@ -1 +0,0 @@ -<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg> \ No newline at end of file diff --git a/dashboard/public/window.svg b/dashboard/public/window.svg deleted file mode 100644 index b2b2a44..0000000 --- a/dashboard/public/window.svg +++ /dev/null @@ -1 +0,0 @@ -<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg> \ No newline at end of file diff --git a/dashboard/server/auth.ts b/dashboard/server/auth.ts index 693e378..2e4e307 100644 --- a/dashboard/server/auth.ts +++ b/dashboard/server/auth.ts @@ -50,7 +50,7 @@ function issueJWT(userId: string, email: string): string { ); } -export async function authenticateExtensionUser(googleIdToken: string): Promise<string> { +export async function authenticateGoogleUser(googleIdToken: string): Promise<string> { const googleUser = await verifyGoogleToken(googleIdToken); const user = await upsertUser(googleUser); return issueJWT(user.id, user.email); diff --git a/dashboard/server/cookies.ts b/dashboard/server/cookies.ts new file mode 100644 index 0000000..68e73ed --- /dev/null +++ b/dashboard/server/cookies.ts @@ -0,0 +1,36 @@ +export const SESSION_COOKIE = "wt_session"; + +function parseDurationSeconds(raw: string): number { + const m = /^(\d+)\s*([smhdw])?$/.exec(raw.trim()); + if (!m) throw new Error(`Invalid duration: ${raw}`); + const n = Number(m[1]); + const unit = m[2] ?? "s"; + const multipliers: Record<string, number> = { s: 1, m: 60, h: 3600, d: 86400, w: 604800 }; + return n * multipliers[unit]; +} + +function jwtMaxAgeSeconds(): number { + return parseDurationSeconds(process.env.JWT_EXPIRES_IN ?? "7d"); +} + +type CookieOptions = { + httpOnly: true; + secure: boolean; + sameSite: "lax"; + path: "/"; + maxAge: number; +}; + +export function sessionCookieOptions(): CookieOptions { + return { + httpOnly: true, + secure: process.env.NODE_ENV === "production", + sameSite: "lax", + path: "/", + maxAge: jwtMaxAgeSeconds(), + }; +} + +export function clearedCookieOptions(): CookieOptions { + return { ...sessionCookieOptions(), maxAge: 0 }; +} diff --git a/dashboard/server/jwt.ts b/dashboard/server/jwt.ts index ae01485..0df97e0 100644 --- a/dashboard/server/jwt.ts +++ b/dashboard/server/jwt.ts @@ -1,5 +1,6 @@ import type { NextRequest } from "next/server"; import jwt from "jsonwebtoken"; +import { jwtVerify } from "jose"; export class UnauthorizedError extends Error { constructor(message = "Unauthorized") { @@ -8,7 +9,7 @@ export class UnauthorizedError extends Error { } } -interface JwtPayload { +export interface JwtPayload { sub: string; email: string; } @@ -19,6 +20,21 @@ function isPayload(v: unknown): v is JwtPayload { return typeof r["sub"] === "string" && typeof r["email"] === "string"; } +export async function verifyJwt(token: string): Promise<JwtPayload> { + const secret = process.env.JWT_SECRET; + if (!secret) throw new Error("JWT_SECRET is not set"); + + let payload: unknown; + try { + const result = await jwtVerify(token, new TextEncoder().encode(secret)); + payload = result.payload; + } catch { + throw new UnauthorizedError("Invalid or expired token"); + } + if (!isPayload(payload)) throw new UnauthorizedError("Invalid token payload"); + return payload; +} + export function requireUser(req: NextRequest): { id: string; email: string } { const header = req.headers.get("authorization"); if (!header?.startsWith("Bearer ")) { diff --git a/dashboard/server/schemas/auth.ts b/dashboard/server/schemas/auth.ts index a62489e..e98a9e1 100644 --- a/dashboard/server/schemas/auth.ts +++ b/dashboard/server/schemas/auth.ts @@ -1,6 +1,11 @@ import { z } from "zod"; -export const ExtensionAuthInput = z.object({ +const GoogleTokenInput = z.object({ googleToken: z.string().min(1, "googleToken is required"), }); + +export const ExtensionAuthInput = GoogleTokenInput; export type ExtensionAuthInput = z.infer<typeof ExtensionAuthInput>; + +export const WebAuthInput = GoogleTokenInput; +export type WebAuthInput = z.infer<typeof WebAuthInput>; diff --git a/dashboard/types/google-identity.d.ts b/dashboard/types/google-identity.d.ts new file mode 100644 index 0000000..b5d2b76 --- /dev/null +++ b/dashboard/types/google-identity.d.ts @@ -0,0 +1,36 @@ +interface GoogleCredentialResponse { + credential: string; + select_by: string; +} + +interface GoogleIdConfig { + client_id: string; + callback: (response: GoogleCredentialResponse) => void; + auto_select?: boolean; + cancel_on_tap_outside?: boolean; +} + +interface GoogleButtonConfig { + type?: "standard" | "icon"; + theme?: "outline" | "filled_blue" | "filled_black"; + size?: "large" | "medium" | "small"; + text?: "signin_with" | "signup_with" | "continue_with" | "signin"; + shape?: "rectangular" | "pill" | "circle" | "square"; + width?: number; +} + +interface GoogleAccountsId { + initialize: (config: GoogleIdConfig) => void; + renderButton: (parent: HTMLElement, config: GoogleButtonConfig) => void; + prompt: () => void; + cancel: () => void; + disableAutoSelect: () => void; +} + +interface Window { + google?: { + accounts: { + id: GoogleAccountsId; + }; + }; +} diff --git a/plans/week3/AC1-dashboard-auth.md b/plans/week3/AC1-dashboard-auth.md new file mode 100644 index 0000000..7903889 --- /dev/null +++ b/plans/week3/AC1-dashboard-auth.md @@ -0,0 +1,155 @@ +# Plan: Week 3 AC 1 — Dashboard Auth (middleware + Google login) + +**Branch:** `feature/dashboard-auth-google-oauth` +**Closes:** Week 3 AC 1 ([docs/Task.md L87](../../docs/Task.md#L87)) +**Status:** plan, awaiting review + +--- + +## Scope + +Веб-юзер логіниться у дашборд через **той самий** Google OAuth, що і extension у [Week 2 AC 1](../week2/AC1-auth.md), і отримує **JWT того ж формату** (HS256, payload `{ sub, email }`, секрет `JWT_SECRET`). Різниця тільки в transport-у: extension зберігає JWT у `chrome.storage.local`, дашборд — у HttpOnly cookie. + +Сторінка `/login` запускає Google Identity Services (GIS) "Sign in with Google" → backend верифікує Google ID token і ставить cookie з нашим JWT. Middleware перевіряє cookie на кожному запиті до `/dashboard/*` і редіректить неавторизованих на `/login`. + +--- + +## Commits (ordered) + +``` +1. docs(plans): add week 3 AC 1 dashboard auth plan +2. feat(dashboard): extract google-auth helper and add /api/auth/google + /api/auth/logout +3. feat(dashboard): add /login page with google identity services button +4. feat(dashboard): add middleware guarding /dashboard and a placeholder /dashboard page +5. fix(dashboard): address review feedback for week 3 AC 1 ← reserved, only if review requests changes +``` + +> **Convention** — commit 1 is "plan only", commit 5 is reserved для правок після код-рев'ю PR. Якщо рев'юер апрувить без зауважень — 5-й комміт не створюється. + +--- + +## Files + +| File | Action | Commit | +|---|---|---| +| `plans/week3/AC1-dashboard-auth.md` | **new** | 1 | +| `dashboard/server/auth.ts` | modify — rename `authenticateExtensionUser` → `authenticateGoogleUser` (extension-agnostic) | 2 | +| `dashboard/app/api/auth/extension/route.ts` | modify — update import name only | 2 | +| `dashboard/server/cookies.ts` | **new** — `SESSION_COOKIE`, `sessionCookieOptions()`, `clearedCookieOptions()` | 2 | +| `dashboard/app/api/auth/google/route.ts` | **new** — POST, web login (sets HttpOnly cookie) | 2 | +| `dashboard/app/api/auth/logout/route.ts` | **new** — POST, clears cookie | 2 | +| `dashboard/server/schemas/auth.ts` | modify — додати alias `WebAuthInput` = той самий шейп `{ googleToken }` | 2 | +| `dashboard/.env.example` | modify — додати `NEXT_PUBLIC_GOOGLE_CLIENT_ID` | 2 | +| `dashboard/app/login/page.tsx` | **new** — Server Component layout + Client island for GIS button | 3 | +| `dashboard/app/login/google-button.tsx` | **new** — Client Component (renders GIS, posts to `/api/auth/google`, redirects) | 3 | +| `dashboard/types/google-identity.d.ts` | **new** — мінімальні types для `window.google.accounts.id` (замість `any`) | 3 | +| `dashboard/middleware.ts` | **new** — guard `/dashboard/:path*`, verify JWT via `jose`, redirect | 4 | +| `dashboard/server/jwt.ts` | modify — додати `verifyJwt(token: string)` (для middleware через `jose`) | 4 | +| `dashboard/app/dashboard/page.tsx` | **new** — placeholder (привітання + logout button) | 4 | +| `dashboard/app/dashboard/logout-button.tsx` | **new** — Client Component, POST `/api/auth/logout` → router.push("/login") | 4 | +| `dashboard/package.json` | modify — add `jose` | 4 | + +--- + +## Design decisions + +### 1. Той самий JWT для web і extension + +`authenticateGoogleUser(googleIdToken): Promise<string>` — єдиний фасад на бекенді. Обидва вхідні роути (`/api/auth/extension` і `/api/auth/google`) викликають його однаково. JWT-payload не змінюється: `{ sub, email }`. Це й означає "один JWT" з ТЗ — токени фізично різні (різні сесії), але формат, секрет і authorize-логіка спільні: будь-який наш JWT валідний на будь-якому `/api/v1/*` через `requireUser()`. + +### 2. JWT у HttpOnly cookie, не localStorage + +``` +Name: wt_session +HttpOnly: true // не доступний з JS — захист від XSS +Secure: prod only // dev на http://localhost +SameSite: lax // дозволяє редіректи з GIS (top-level navigation) +Path: / +MaxAge: JWT_EXPIRES_IN у секундах (default 7d) +``` + +`maxAge` cookie і `expiresIn` JWT — однакові; рахуються через `ms()` хелпер (`ms` уже транзитивна залежність `jsonwebtoken`). + +### 3. Google Sign-In: Google Identity Services (GIS), не OAuth redirect flow + +GIS-бібліотека (`https://accounts.google.com/gsi/client`) рендерить кнопку "Sign in with Google" і повертає **готовий ID token** у JS-колбек. Це дозволяє: + +- **повторно використати** наявний `verifyIdToken()` через `google-auth-library` (один і той самий `GOOGLE_CLIENT_ID`) +- **не плодити** callback роутів, authorization-code обміну, redirect-URI у Google Console +- `GOOGLE_CLIENT_SECRET` все ще **не потрібен** (як і у Week 2 AC 1) + +Google Console required (manual setup, не в коді): +- існуючий `GOOGLE_CLIENT_ID` — вже **Web application** type, переюзаємо як є +- **Authorized JavaScript origins:** додати `http://localhost:3000` (dev) і `https://<vercel-url>` (prod) +- redirect URI не потрібні взагалі (GIS працює без них) + +Клієнтська сторона потребує client ID у `<script>`-ініціалізації GIS — тому додамо `NEXT_PUBLIC_GOOGLE_CLIENT_ID` у `.env.example` (значення = `GOOGLE_CLIENT_ID`; дублювання нормальне, бо `NEXT_PUBLIC_*` експонується клієнту, а серверний — ні). Backend `verifyIdToken({ audience: GOOGLE_CLIENT_ID })` валідує його ж. + +### 4. Middleware: edge runtime + `jose` для верифікації + +`jsonwebtoken` — Node-only (`Buffer`, `node:crypto`), у edge runtime не запускається. Middleware за замовчуванням edge → потрібна edge-compatible JWT-бібліотека. + +**`jose`** — бібліотека на Web Crypto API, працює і у Node, і у browser, і у edge. HS256-підпис, який видає `jsonwebtoken.sign`, валідується через `jose.jwtVerify(token, secret)` 1-в-1 (той самий HMAC-SHA256 над `JWT_SECRET`). На стороні видачі нічого не змінюється. + +Розподіл: +- **видача** JWT — у Route Handlers (Node, `jsonwebtoken.sign` у `server/auth.ts:issueJWT`) — без змін +- **верифікація для API роутів** — Node, `jsonwebtoken.verify` у `requireUser(req)` — без змін +- **верифікація для middleware** — edge, новий експорт `verifyJwt(token)` у `server/jwt.ts` на `jose` + +Один секрет `JWT_SECRET` обслуговує обидва шляхи верифікації. `jose` — єдине нове dep, імпортується тільки у `verifyJwt` (tree-shake до самого `jwtVerify`, ~12 KB у bundle). + +### 5. Matcher і редірект + +```ts +export const config = { + matcher: ["/dashboard/:path*"], // тільки /dashboard/* — login, /api, /, static — поза охороною +}; +``` + +Якщо JWT відсутній/невалідний → `NextResponse.redirect(new URL("/login", req.url))`. +На сторінці `/login` додатково перевіряємо cookie у Server Component: якщо валідна — `redirect("/dashboard")` (щоб залогінений юзер не бачив форми логіну). + +### 6. Logout + +`POST /api/auth/logout` — лише ставить `wt_session` з `maxAge: 0`. Не торкається БД (JWT stateless, інвалідація через short TTL). Якщо колись знадобиться примусово вибивати юзера — додаємо `tokenVersion` у `User` і у JWT-claims; зараз out of scope. + +### 7. `/dashboard` placeholder — мінімум + +AC 1 закриває **тільки** auth, не event feed (це AC 2). Тому `/dashboard/page.tsx` — Server Component, який читає cookie, decode-ить (через `verifyJwt`), показує `Hello, ${email}` + кнопку Logout. Це достатньо щоб задемонструвати middleware і повний цикл login → guarded page → logout у demo. + +--- + +## Verification checklist + +### Backend +- [ ] `cd dashboard && npx tsc --noEmit` — без помилок +- [ ] `npm run build` — без помилок (включно з типами middleware) +- [ ] `POST /api/auth/google` без body → 400 +- [ ] `POST /api/auth/google` з невалідним токеном → 401, cookie **не** виставляється +- [ ] `POST /api/auth/google` з валідним GIS credential → 200, `Set-Cookie: wt_session=…; HttpOnly; SameSite=Lax` +- [ ] `POST /api/auth/logout` → 200, `Set-Cookie: wt_session=; Max-Age=0` +- [ ] Існуючий `POST /api/auth/extension` — без регресій (той самий контракт, повертає `{ token }`) + +### Middleware / pages +- [ ] `GET /dashboard` без cookie → 307 → `/login` +- [ ] `GET /dashboard` з expired/підробленим cookie → 307 → `/login` + cookie очищується +- [ ] `GET /dashboard` з валідним JWT → 200, рендер placeholder +- [ ] `GET /login` коли вже залогінений → 307 → `/dashboard` +- [ ] `GET /` (root) і `/api/*` — middleware **не** запускається (matcher) + +### End-to-end +- [ ] Перший вхід через GIS button → cookie встановлено → редірект на `/dashboard` → ім'я/email юзера видно +- [ ] Той самий JWT (з DevTools → Application → Cookies → `wt_session`) використати як `Authorization: Bearer …` для `POST /api/v1/events` → 200 (доводить "один JWT" з ТЗ) +- [ ] Logout → cookie очищене → `/dashboard` знову редіректить на `/login` +- [ ] User у БД (`prisma studio`) — той самий запис, що і коли логіниться extension з того ж Google акаунту (`googleId` matches) + +--- + +## Out of scope + +- Event feed на `/dashboard` — Week 3 AC 2 +- AI session report — Week 3 AC 3 +- Sign-out на стороні extension при logout у вебі — JWT stateless, синхронізації не буде; додамо `tokenVersion` коли знадобиться (post-MVP) +- Refresh token / sliding session — 7d TTL достатньо для MVP (як домовлено у Week 2 AC 1) +- Error toasts на сторінці логіну — Week 3 бонус AC 5 +- Animations переходів — Week 4 бонус AC 4 From d79ed5da571fbac0b5b4c852595b76e6263b52f7 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Wed, 27 May 2026 22:54:17 +0300 Subject: [PATCH 15/24] feat(dashboard): Week 3 AC 2 - event feed, charts, top sessions (#15) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(plans): add week 3 AC 2 event feed plan * style(dashboard): port extension color tokens and add sticky app header * feat(dashboard): allow cookie auth in requireUser and add GET /api/v1/events * feat(dashboard): event feed with infinite-scroll cursor pagination * feat(dashboard): add events-per-day and top-tags charts with aggregated stats endpoint * style(dashboard): add cursor-pointer + hover states on filters, logout, cards + future-date guard * feat(dashboard): top-3 sessions panel with per-host duration breakdown - adds GET /api/v1/sessions/top route + getTopSessionsForUser server module - per-event duration computed via LEAD window function over (sessionId, timestamp) - last event of a session contributes 0s so totals = max(ts) - min(ts), gaps capped at 30 min - top host per session via DISTINCT ON ordered by host duration - renders alongside charts in a 3-col grid; client component prefetched on /dashboard * feat(dashboard): match extension favicon and add seo metadata - adopt extension icon-128.png as app/icon.png + apple-icon.png (Next App Router convention) - drop default favicon.ico - root metadata: title template, description, OG and Twitter cards, theme color - /login and /dashboard get page-specific titles and are excluded from index/follow * style(dashboard): widen content container and vertically center events-per-day chart * docs(plans): add stale-session cleanup to backlog Discovered during Week 3 AC 2 — leftover sessions (endedAt=NULL after browser close / SW sleep) can dominate the TOP 3 panel even when nominally 'active'. Other metrics (byDay, topTags, host durations) compute correctly; only session ranking is affected. Documents 4 mitigation strategies, recommends Vercel Cron route for cleanup. * refactor(dashboard): share getCurrentUser helper and useClientLocalized hook * chore(dashboard): zod-validate api responses, align page size, scope top-sessions to 90d * docs(plans): backlog jwt unification and post-logout cache reset --- dashboard/app/api/v1/events/route.ts | 29 ++- dashboard/app/api/v1/events/stats/route.ts | 31 +++ dashboard/app/api/v1/sessions/top/route.ts | 23 ++ dashboard/app/apple-icon.png | Bin 0 -> 936 bytes dashboard/app/dashboard/app-header.tsx | 54 ++++ dashboard/app/dashboard/charts.tsx | 65 +++++ dashboard/app/dashboard/event-card.tsx | 75 ++++++ dashboard/app/dashboard/event-feed.tsx | 130 ++++++++++ dashboard/app/dashboard/event-filters.tsx | 79 ++++++ .../app/dashboard/events-by-day-chart.tsx | 82 +++++++ dashboard/app/dashboard/feed-root.tsx | 26 ++ dashboard/app/dashboard/feed-shared.ts | 106 ++++++++ dashboard/app/dashboard/layout.tsx | 17 ++ dashboard/app/dashboard/logout-button.tsx | 6 +- dashboard/app/dashboard/page.tsx | 72 ++++-- dashboard/app/dashboard/top-sessions.tsx | 118 +++++++++ dashboard/app/dashboard/top-tags-chart.tsx | 56 +++++ .../app/dashboard/use-client-localized.ts | 19 ++ dashboard/app/favicon.ico | Bin 25931 -> 0 bytes dashboard/app/globals.css | 40 +-- dashboard/app/icon.png | Bin 0 -> 936 bytes dashboard/app/layout.tsx | 56 ++++- dashboard/app/login/google-button.tsx | 2 +- dashboard/app/login/page.tsx | 36 ++- dashboard/app/providers.tsx | 20 ++ dashboard/package-lock.json | 12 + dashboard/package.json | 2 + dashboard/server/current-user.ts | 25 ++ dashboard/server/events.ts | 104 +++++++- dashboard/server/jwt.ts | 16 +- dashboard/server/schemas/events.ts | 28 +++ dashboard/server/sessions.ts | 90 +++++++ dashboard/server/users.ts | 14 ++ dashboard/types/event.ts | 26 ++ plans/backlog/post-week3-tech-debt.md | 75 ++++++ plans/backlog/stale-sessions-cleanup.md | 74 ++++++ plans/week3/AC2-event-feed.md | 231 ++++++++++++++++++ 37 files changed, 1770 insertions(+), 69 deletions(-) create mode 100644 dashboard/app/api/v1/events/stats/route.ts create mode 100644 dashboard/app/api/v1/sessions/top/route.ts create mode 100644 dashboard/app/apple-icon.png create mode 100644 dashboard/app/dashboard/app-header.tsx create mode 100644 dashboard/app/dashboard/charts.tsx create mode 100644 dashboard/app/dashboard/event-card.tsx create mode 100644 dashboard/app/dashboard/event-feed.tsx create mode 100644 dashboard/app/dashboard/event-filters.tsx create mode 100644 dashboard/app/dashboard/events-by-day-chart.tsx create mode 100644 dashboard/app/dashboard/feed-root.tsx create mode 100644 dashboard/app/dashboard/feed-shared.ts create mode 100644 dashboard/app/dashboard/layout.tsx create mode 100644 dashboard/app/dashboard/top-sessions.tsx create mode 100644 dashboard/app/dashboard/top-tags-chart.tsx create mode 100644 dashboard/app/dashboard/use-client-localized.ts delete mode 100644 dashboard/app/favicon.ico create mode 100644 dashboard/app/icon.png create mode 100644 dashboard/app/providers.tsx create mode 100644 dashboard/server/current-user.ts create mode 100644 dashboard/server/users.ts create mode 100644 dashboard/types/event.ts create mode 100644 plans/backlog/post-week3-tech-debt.md create mode 100644 plans/backlog/stale-sessions-cleanup.md create mode 100644 plans/week3/AC2-event-feed.md diff --git a/dashboard/app/api/v1/events/route.ts b/dashboard/app/api/v1/events/route.ts index 78eeb8d..ec1fef6 100644 --- a/dashboard/app/api/v1/events/route.ts +++ b/dashboard/app/api/v1/events/route.ts @@ -1,10 +1,35 @@ import { NextRequest, NextResponse } from "next/server"; import { z } from "zod"; -import { createEventForUser, SessionNotFoundError } from "@/server/events"; -import { CreateEventInput } from "@/server/schemas/events"; +import { + createEventForUser, + listEventsForUser, + SessionNotFoundError, +} from "@/server/events"; +import { CreateEventInput, EventListFilters } from "@/server/schemas/events"; import { withCors, corsPreflight } from "@/server/cors"; import { requireUser, UnauthorizedError } from "@/server/jwt"; +export const GET = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + const params = Object.fromEntries(req.nextUrl.searchParams); + const parsed = EventListFilters.safeParse(params); + if (!parsed.success) { + return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + } + + const page = await listEventsForUser(user.id, parsed.data); + return NextResponse.json(page); +}); + export const POST = withCors(async (req) => { let user; try { diff --git a/dashboard/app/api/v1/events/stats/route.ts b/dashboard/app/api/v1/events/stats/route.ts new file mode 100644 index 0000000..6ad3b89 --- /dev/null +++ b/dashboard/app/api/v1/events/stats/route.ts @@ -0,0 +1,31 @@ +import { NextRequest, NextResponse } from "next/server"; +import { z } from "zod"; +import { getEventStatsForUser } from "@/server/events"; +import { EventStatsFilters } from "@/server/schemas/events"; +import { withCors, corsPreflight } from "@/server/cors"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; + +export const GET = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + const params = Object.fromEntries(req.nextUrl.searchParams); + const parsed = EventStatsFilters.safeParse(params); + if (!parsed.success) { + return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + } + + const stats = await getEventStatsForUser(user.id, parsed.data); + return NextResponse.json(stats); +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/app/api/v1/sessions/top/route.ts b/dashboard/app/api/v1/sessions/top/route.ts new file mode 100644 index 0000000..0c625f3 --- /dev/null +++ b/dashboard/app/api/v1/sessions/top/route.ts @@ -0,0 +1,23 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getTopSessionsForUser } from "@/server/sessions"; +import { withCors, corsPreflight } from "@/server/cors"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; + +export const GET = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + const sessions = await getTopSessionsForUser(user.id, 3); + return NextResponse.json({ sessions }); +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/app/apple-icon.png b/dashboard/app/apple-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..06012ed545b51b58f6d789b315ffd08803a56029 GIT binary patch literal 936 zcmeAS@N?(olHy`uVBq!ia0vp^4Is?H1|$#LC7uRSjKx9jP7LeL$-D$|SkfJR9T^xl z_H+M9WCij$3p^r=85sBugD~Uq{1qt-49vEkE{-7;ac?gv`nfWSFb96~I&>(|;~$sZ zwxmhR6kiH&e{`bn)$!-oU)z?yWjIbdWLwwpe*XRXh07NCHqGiX<IFO9%fMzTnk#fA z=N2PRmewtm6*spqOI!)r;u)|xligs&%8bbi(k}BQ1O#7Hb3D6D_P_$LR$uD|M_<?3 yET*%|7@9{78o6O4XMeyZo82OhX6WtLf6ScjUe9&7K63(d7lWs(pUXO@geCw&XmJGq literal 0 HcmV?d00001 diff --git a/dashboard/app/dashboard/app-header.tsx b/dashboard/app/dashboard/app-header.tsx new file mode 100644 index 0000000..8569173 --- /dev/null +++ b/dashboard/app/dashboard/app-header.tsx @@ -0,0 +1,54 @@ +import { LogoutButton } from "./logout-button"; + +type Props = { + email: string; + name: string | null; + picture: string | null; +}; + +export function AppHeader({ email, name, picture }: Props) { + const initial = (name ?? email).trim().charAt(0).toUpperCase() || "?"; + const displayName = name ?? email; + + return ( + <header className="sticky top-0 z-10 flex items-center justify-between border-b border-border bg-bg/95 px-6 py-3 backdrop-blur"> + <div className="flex items-center gap-2"> + <span + className="text-xl text-cyan" + style={{ filter: "drop-shadow(0 0 4px var(--c-cyan))" }} + > + ⬡ + </span> + <span + className="text-sm font-bold tracking-widest text-cyan" + style={{ textShadow: "0 0 6px color-mix(in srgb, var(--c-cyan) 60%, transparent)" }} + > + WORKTRACE + </span> + </div> + + <div className="flex items-center gap-3"> + {picture ? ( + // eslint-disable-next-line @next/next/no-img-element + <img + src={picture} + alt="" + referrerPolicy="no-referrer" + className="h-7 w-7 rounded-full border border-border" + /> + ) : ( + <span className="flex h-7 w-7 items-center justify-center rounded-full border border-border bg-surface text-xs font-bold text-purple"> + {initial} + </span> + )} + <span + className="hidden max-w-[200px] truncate text-xs text-muted sm:inline" + title={displayName} + > + {displayName} + </span> + <LogoutButton /> + </div> + </header> + ); +} diff --git a/dashboard/app/dashboard/charts.tsx b/dashboard/app/dashboard/charts.tsx new file mode 100644 index 0000000..ff91231 --- /dev/null +++ b/dashboard/app/dashboard/charts.tsx @@ -0,0 +1,65 @@ +"use client"; + +import { keepPreviousData, useQuery } from "@tanstack/react-query"; +import { + ArcElement, + CategoryScale, + Chart as ChartJS, + Filler, + LineElement, + LinearScale, + PointElement, + Tooltip, + Legend, +} from "chart.js"; +import { + fetchEventStats, + statsQueryKey, + type FeedFilters, +} from "./feed-shared"; +import { EventsByDayChart } from "./events-by-day-chart"; +import { TopTagsChart } from "./top-tags-chart"; + +ChartJS.register( + CategoryScale, + LinearScale, + PointElement, + LineElement, + ArcElement, + Filler, + Tooltip, + Legend, +); + +export function Charts({ filters }: { filters: FeedFilters }) { + const { data, isLoading, isError } = useQuery({ + queryKey: statsQueryKey(filters), + queryFn: () => fetchEventStats(filters), + placeholderData: keepPreviousData, + staleTime: 30_000, + }); + + if (isLoading) { + return ( + <> + <div className="h-52 animate-pulse rounded border border-border bg-surface" /> + <div className="h-52 animate-pulse rounded border border-border bg-surface" /> + </> + ); + } + + if (isError || !data) { + return ( + <div className="col-span-full rounded border border-pink/40 bg-surface px-4 py-6 text-center text-[10px] tracking-widest text-pink"> + FAILED TO LOAD CHART DATA + </div> + ); + } + + return ( + <> + <EventsByDayChart byDay={data.byDay} /> + <TopTagsChart top={data.topTags} /> + </> + ); +} diff --git a/dashboard/app/dashboard/event-card.tsx b/dashboard/app/dashboard/event-card.tsx new file mode 100644 index 0000000..3002d16 --- /dev/null +++ b/dashboard/app/dashboard/event-card.tsx @@ -0,0 +1,75 @@ +"use client"; + +import type { EventDTO } from "@/types/event"; +import { useClientLocalized } from "./use-client-localized"; + +function hostnameOf(url: string): string { + try { + return new URL(url).hostname; + } catch { + return url; + } +} + +function utcShort(iso: string): string { + return iso.slice(0, 16).replace("T", " ") + " UTC"; +} + +function localShort(iso: string): string { + const d = new Date(iso); + return d.toLocaleString(undefined, { + year: "numeric", + month: "short", + day: "2-digit", + hour: "2-digit", + minute: "2-digit", + }); +} + +export function EventCard({ event }: { event: EventDTO }) { + const time = useClientLocalized(event.timestamp, utcShort, localShort); + + return ( + <article className="flex flex-col gap-2 rounded border border-border bg-surface p-3 transition-colors hover:border-purple/60"> + <div className="flex items-baseline justify-between gap-3"> + <a + href={event.url} + target="_blank" + rel="noreferrer noopener" + className="cursor-pointer truncate text-sm font-bold text-text transition-colors hover:text-cyan" + title={event.title} + > + {event.title} + </a> + <time + className="shrink-0 text-[10px] text-muted" + dateTime={event.timestamp} + > + {time} + </time> + </div> + + <div className="flex items-center gap-2 text-[11px] text-muted"> + <span className="text-purple">⟶</span> + <span className="truncate">{hostnameOf(event.url)}</span> + </div> + + {event.content ? ( + <p className="line-clamp-2 text-xs text-text/80">{event.content}</p> + ) : null} + + {event.tags.length ? ( + <div className="flex flex-wrap gap-1"> + {event.tags.map((t) => ( + <span + key={t} + className="rounded border border-cyan/40 px-1.5 py-0.5 text-[10px] font-bold tracking-wider text-cyan" + > + {t} + </span> + ))} + </div> + ) : null} + </article> + ); +} diff --git a/dashboard/app/dashboard/event-feed.tsx b/dashboard/app/dashboard/event-feed.tsx new file mode 100644 index 0000000..bc56865 --- /dev/null +++ b/dashboard/app/dashboard/event-feed.tsx @@ -0,0 +1,130 @@ +"use client"; + +import { useEffect, useMemo, useRef } from "react"; +import { keepPreviousData, useInfiniteQuery } from "@tanstack/react-query"; +import { EventCard } from "./event-card"; +import { + eventsQueryKey, + fetchEventsPage, + type FeedFilters, +} from "./feed-shared"; + +type Props = { + filters: FeedFilters; + onClearFilters: () => void; +}; + +export function EventFeed({ filters, onClearFilters }: Props) { + const { + data, + isLoading, + isError, + refetch, + fetchNextPage, + hasNextPage, + isFetchingNextPage, + isFetching, + } = useInfiniteQuery({ + queryKey: eventsQueryKey(filters), + queryFn: ({ pageParam }) => fetchEventsPage(filters, pageParam), + initialPageParam: null as string | null, + getNextPageParam: (last) => last.nextCursor, + placeholderData: keepPreviousData, + staleTime: 30_000, + }); + + const events = useMemo( + () => data?.pages.flatMap((p) => p.events) ?? [], + [data], + ); + + const sentinelRef = useRef<HTMLDivElement | null>(null); + + useEffect(() => { + const el = sentinelRef.current; + if (!el || !hasNextPage) return; + + const io = new IntersectionObserver( + (entries) => { + if (entries[0]?.isIntersecting && !isFetchingNextPage) { + fetchNextPage(); + } + }, + { rootMargin: "200px" }, + ); + io.observe(el); + return () => io.disconnect(); + }, [hasNextPage, isFetchingNextPage, fetchNextPage]); + + if (isLoading) return <FeedSkeleton />; + if (isError) return <ErrorState onRetry={() => refetch()} />; + if (events.length === 0) return <EmptyState onClear={onClearFilters} />; + + return ( + <> + <ul className="flex flex-col gap-3" aria-busy={isFetching}> + {events.map((event) => ( + <li key={event.id}> + <EventCard event={event} /> + </li> + ))} + </ul> + + {hasNextPage ? ( + <div + ref={sentinelRef} + className="flex justify-center py-4 text-[10px] tracking-widest text-muted" + > + {isFetchingNextPage ? "LOADING…" : "SCROLL TO LOAD MORE"} + </div> + ) : ( + <div className="flex justify-center py-4 text-[10px] tracking-widest text-muted"> + END OF FEED + </div> + )} + </> + ); +} + +function FeedSkeleton() { + return ( + <div className="flex flex-col gap-3"> + {[0, 1, 2].map((i) => ( + <div + key={i} + className="h-20 animate-pulse rounded border border-border bg-surface" + /> + ))} + </div> + ); +} + +function EmptyState({ onClear }: { onClear: () => void }) { + return ( + <div className="flex flex-col items-center gap-2 rounded border border-border bg-surface px-4 py-10 text-center"> + <p className="text-xs text-muted">No events match the current filters.</p> + <button + type="button" + onClick={onClear} + className="cursor-pointer text-[10px] font-bold tracking-widest text-purple transition-colors hover:text-cyan" + > + CLEAR FILTERS + </button> + </div> + ); +} + +function ErrorState({ onRetry }: { onRetry: () => void }) { + return ( + <div className="flex flex-col items-center gap-2 rounded border border-pink/40 bg-surface px-4 py-10 text-center"> + <p className="text-xs text-pink">Failed to load events.</p> + <button + type="button" + onClick={onRetry} + className="cursor-pointer rounded border border-pink/40 px-3 py-1.5 text-[10px] font-bold tracking-widest text-pink transition-colors hover:bg-pink/10" + > + RETRY + </button> + </div> + ); +} diff --git a/dashboard/app/dashboard/event-filters.tsx b/dashboard/app/dashboard/event-filters.tsx new file mode 100644 index 0000000..bc87a17 --- /dev/null +++ b/dashboard/app/dashboard/event-filters.tsx @@ -0,0 +1,79 @@ +"use client"; + +import { DEFAULT_FILTERS, type FeedFilters } from "./feed-shared"; + +type Props = { + value: FeedFilters; + onChange: (next: FeedFilters) => void; +}; + +function todayISO(): string { + const d = new Date(); + const pad = (n: number) => String(n).padStart(2, "0"); + return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`; +} + +const INPUT_CLASS = + "rounded border border-border bg-bg px-2 py-1.5 text-xs text-text " + + "outline-none transition-colors hover:border-purple/60 focus:border-purple " + + "[color-scheme:dark]"; + +export function EventFilters({ value, onChange }: Props) { + const set = <K extends keyof FeedFilters>(k: K, v: FeedFilters[K]) => + onChange({ ...value, [k]: v }); + + const today = todayISO(); + const isDirty = value.from !== "" || value.to !== "" || value.tags !== ""; + + return ( + <section className="grid grid-cols-1 gap-3 rounded border border-border bg-surface p-4 sm:grid-cols-[1fr_1fr_2fr_auto]"> + <Field label="FROM"> + <input + type="date" + value={value.from} + max={value.to || today} + onChange={(e) => set("from", e.target.value)} + className={INPUT_CLASS} + /> + </Field> + <Field label="TO"> + <input + type="date" + value={value.to} + min={value.from || undefined} + max={today} + onChange={(e) => set("to", e.target.value)} + className={INPUT_CLASS} + /> + </Field> + <Field label="TAGS"> + <input + type="text" + value={value.tags} + onChange={(e) => set("tags", e.target.value)} + placeholder="react, typescript" + className={INPUT_CLASS + " placeholder:text-muted"} + /> + </Field> + <div className="flex items-end"> + <button + type="button" + onClick={() => onChange(DEFAULT_FILTERS)} + disabled={!isDirty} + className="cursor-pointer rounded border border-muted px-3 py-1.5 text-[10px] font-bold tracking-widest text-muted transition-colors enabled:hover:border-pink enabled:hover:text-pink disabled:cursor-not-allowed disabled:opacity-30" + > + CLEAR + </button> + </div> + </section> + ); +} + +function Field({ label, children }: { label: string; children: React.ReactNode }) { + return ( + <label className="flex flex-col gap-1"> + <span className="text-[10px] font-bold tracking-widest text-muted">{label}</span> + {children} + </label> + ); +} diff --git a/dashboard/app/dashboard/events-by-day-chart.tsx b/dashboard/app/dashboard/events-by-day-chart.tsx new file mode 100644 index 0000000..c0f20f1 --- /dev/null +++ b/dashboard/app/dashboard/events-by-day-chart.tsx @@ -0,0 +1,82 @@ +"use client"; + +import { Line } from "react-chartjs-2"; +import type { DayBucket } from "@/types/event"; + +function rangeDays(from: string, to: string): string[] { + const out: string[] = []; + const start = new Date(from + "T00:00:00.000Z"); + const end = new Date(to + "T00:00:00.000Z"); + for (const cur = new Date(start); cur <= end; cur.setUTCDate(cur.getUTCDate() + 1)) { + out.push(cur.toISOString().slice(0, 10)); + } + return out; +} + +function fillGaps(byDay: DayBucket[]): DayBucket[] { + if (byDay.length === 0) return []; + const present = new Map(byDay.map((b) => [b.date, b.count])); + const labels = rangeDays(byDay[0].date, byDay[byDay.length - 1].date); + return labels.map((date) => ({ date, count: present.get(date) ?? 0 })); +} + +export function EventsByDayChart({ byDay }: { byDay: DayBucket[] }) { + const filled = fillGaps(byDay); + + if (filled.length === 0) { + return ( + <div className="flex h-52 items-center justify-center rounded border border-border bg-surface text-[10px] tracking-widest text-muted"> + NO EVENTS TO CHART + </div> + ); + } + + return ( + <div className="flex h-full flex-col rounded border border-border bg-surface p-4"> + <div className="mb-3 text-[10px] font-bold tracking-widest text-muted"> + EVENTS PER DAY + </div> + <div className="flex flex-1 items-center"> + <div className="h-40 w-full"> + <Line + data={{ + labels: filled.map((d) => d.date.slice(5)), + datasets: [ + { + data: filled.map((d) => d.count), + borderColor: "#00e5b0", + backgroundColor: "rgba(0, 229, 176, 0.15)", + pointBackgroundColor: "#00e5b0", + pointRadius: 3, + tension: 0.3, + fill: true, + }, + ], + }} + options={{ + responsive: true, + maintainAspectRatio: false, + plugins: { legend: { display: false }, tooltip: { intersect: false, mode: "index" } }, + scales: { + x: { + ticks: { color: "#3e3e60", font: { size: 9, family: "Courier New" } }, + grid: { color: "rgba(28, 28, 56, 0.5)" }, + }, + y: { + beginAtZero: true, + ticks: { + color: "#3e3e60", + font: { size: 9, family: "Courier New" }, + precision: 0, + stepSize: 1, + }, + grid: { color: "rgba(28, 28, 56, 0.5)" }, + }, + }, + }} + /> + </div> + </div> + </div> + ); +} diff --git a/dashboard/app/dashboard/feed-root.tsx b/dashboard/app/dashboard/feed-root.tsx new file mode 100644 index 0000000..53f8520 --- /dev/null +++ b/dashboard/app/dashboard/feed-root.tsx @@ -0,0 +1,26 @@ +"use client"; + +import { useState } from "react"; +import { DEFAULT_FILTERS, type FeedFilters } from "./feed-shared"; +import { EventFilters } from "./event-filters"; +import { EventFeed } from "./event-feed"; +import { Charts } from "./charts"; +import { TopSessions } from "./top-sessions"; + +export function FeedRoot() { + const [filters, setFilters] = useState<FeedFilters>(DEFAULT_FILTERS); + + return ( + <div className="flex flex-col gap-4"> + <EventFilters value={filters} onChange={setFilters} /> + + <div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3"> + <Charts filters={filters} /> + {/* Top sessions intentionally ignores feed filters: it is an all-time leaderboard (90-day window). */} + <TopSessions /> + </div> + + <EventFeed filters={filters} onClearFilters={() => setFilters(DEFAULT_FILTERS)} /> + </div> + ); +} diff --git a/dashboard/app/dashboard/feed-shared.ts b/dashboard/app/dashboard/feed-shared.ts new file mode 100644 index 0000000..a91ebc6 --- /dev/null +++ b/dashboard/app/dashboard/feed-shared.ts @@ -0,0 +1,106 @@ +import { z } from "zod"; +import type { EventDTO, EventStats, TopSession } from "@/types/event"; + +export type FeedFilters = { + from: string; + to: string; + tags: string; +}; + +export const DEFAULT_FILTERS: FeedFilters = { from: "", to: "", tags: "" }; +export const PAGE_SIZE = 30; + +export type EventsPage = { + events: EventDTO[]; + nextCursor: string | null; +}; + +export function eventsQueryKey(filters: FeedFilters) { + return ["events", filters] as const; +} + +export function statsQueryKey(filters: FeedFilters) { + return ["event-stats", filters] as const; +} + +export const topSessionsQueryKey = ["top-sessions"] as const; + +// ─── Response schemas ───────────────────────────────────────────────────────── + +const EventDtoSchema: z.ZodType<EventDTO> = z.object({ + id: z.string(), + sessionId: z.string(), + url: z.string(), + title: z.string(), + content: z.string().nullable(), + tags: z.array(z.string()), + timestamp: z.string(), +}); + +const EventsPageSchema: z.ZodType<EventsPage> = z.object({ + events: z.array(EventDtoSchema), + nextCursor: z.string().nullable(), +}); + +const EventStatsSchema: z.ZodType<EventStats> = z.object({ + byDay: z.array(z.object({ date: z.string(), count: z.number() })), + topTags: z.array(z.object({ tag: z.string(), count: z.number() })), +}); + +const TopSessionSchema: z.ZodType<TopSession> = z.object({ + id: z.string(), + startedAt: z.string(), + endedAt: z.string().nullable(), + totalSeconds: z.number(), + topHost: z.string().nullable(), + topHostSeconds: z.number(), +}); + +const TopSessionsResponse = z.object({ sessions: z.array(TopSessionSchema) }); + +// ─── URL builders ───────────────────────────────────────────────────────────── + +function applyFilters(sp: URLSearchParams, filters: FeedFilters): void { + if (filters.from) sp.set("from", filters.from); + if (filters.to) sp.set("to", filters.to); + if (filters.tags) sp.set("tags", filters.tags); +} + +export function buildEventsUrl(filters: FeedFilters, cursor: string | null): string { + const sp = new URLSearchParams(); + applyFilters(sp, filters); + if (cursor) sp.set("cursor", cursor); + sp.set("limit", String(PAGE_SIZE)); + return `/api/v1/events?${sp.toString()}`; +} + +export function buildStatsUrl(filters: FeedFilters): string { + const sp = new URLSearchParams(); + applyFilters(sp, filters); + const qs = sp.toString(); + return qs ? `/api/v1/events/stats?${qs}` : "/api/v1/events/stats"; +} + +// ─── Fetchers ───────────────────────────────────────────────────────────────── + +async function getJson(url: string): Promise<unknown> { + const res = await fetch(url, { credentials: "same-origin" }); + if (!res.ok) throw new Error(`Request failed: ${url} → ${res.status}`); + return res.json(); +} + +export async function fetchEventsPage( + filters: FeedFilters, + cursor: string | null, +): Promise<EventsPage> { + return EventsPageSchema.parse(await getJson(buildEventsUrl(filters, cursor))); +} + +export async function fetchEventStats(filters: FeedFilters): Promise<EventStats> { + return EventStatsSchema.parse(await getJson(buildStatsUrl(filters))); +} + +export async function fetchTopSessions(): Promise<TopSession[]> { + const parsed = TopSessionsResponse.parse(await getJson("/api/v1/sessions/top")); + return parsed.sessions; +} diff --git a/dashboard/app/dashboard/layout.tsx b/dashboard/app/dashboard/layout.tsx new file mode 100644 index 0000000..9f9b61c --- /dev/null +++ b/dashboard/app/dashboard/layout.tsx @@ -0,0 +1,17 @@ +import { redirect } from "next/navigation"; +import { getCurrentUser } from "@/server/current-user"; +import { AppHeader } from "./app-header"; + +export default async function DashboardLayout({ + children, +}: Readonly<{ children: React.ReactNode }>) { + const user = await getCurrentUser(); + if (!user) redirect("/login"); + + return ( + <div className="flex min-h-full flex-1 flex-col bg-bg text-text"> + <AppHeader email={user.email} name={user.name} picture={user.picture} /> + <main className="flex-1">{children}</main> + </div> + ); +} diff --git a/dashboard/app/dashboard/logout-button.tsx b/dashboard/app/dashboard/logout-button.tsx index d8bc84d..a77a994 100644 --- a/dashboard/app/dashboard/logout-button.tsx +++ b/dashboard/app/dashboard/logout-button.tsx @@ -20,9 +20,11 @@ export function LogoutButton() { router.refresh(); } }} - className="flex h-10 items-center justify-center rounded-full border border-black/[.08] px-5 text-sm font-medium transition-colors hover:bg-black/[.04] disabled:opacity-50 dark:border-white/[.145] dark:hover:bg-white/[.06]" + title="Sign out" + aria-label="Sign out" + className="flex h-7 w-7 cursor-pointer items-center justify-center rounded border border-border bg-surface text-base text-muted transition-all hover:border-pink hover:bg-pink/10 hover:text-pink hover:shadow-[0_0_8px_color-mix(in_srgb,var(--c-pink)_30%,transparent)] disabled:cursor-not-allowed disabled:opacity-30" > - {pending ? "Signing out…" : "Sign out"} + {pending ? "…" : "⎋"} </button> ); } diff --git a/dashboard/app/dashboard/page.tsx b/dashboard/app/dashboard/page.tsx index 059f299..be2f72d 100644 --- a/dashboard/app/dashboard/page.tsx +++ b/dashboard/app/dashboard/page.tsx @@ -1,31 +1,59 @@ -import { cookies } from "next/headers"; +import type { Metadata } from "next"; import { redirect } from "next/navigation"; -import { SESSION_COOKIE } from "@/server/cookies"; -import { verifyJwt } from "@/server/jwt"; -import { LogoutButton } from "./logout-button"; +import { + HydrationBoundary, + QueryClient, + dehydrate, +} from "@tanstack/react-query"; +import { getCurrentUser } from "@/server/current-user"; +import { getEventStatsForUser, listEventsForUser } from "@/server/events"; +import { getTopSessionsForUser } from "@/server/sessions"; +import { + DEFAULT_FILTERS, + PAGE_SIZE, + eventsQueryKey, + statsQueryKey, + topSessionsQueryKey, +} from "./feed-shared"; +import { FeedRoot } from "./feed-root"; + +export const metadata: Metadata = { + title: "Dashboard", + description: "Browse captured events, filter by date or tag, and review your top sessions.", + robots: { index: false, follow: false }, +}; export default async function DashboardPage() { - const token = (await cookies()).get(SESSION_COOKIE)?.value; - if (!token) redirect("/login"); + const user = await getCurrentUser(); + if (!user) redirect("/login"); - let email: string; - try { - ({ email } = await verifyJwt(token)); - } catch { - redirect("/login"); - } + const qc = new QueryClient(); + await Promise.all([ + qc.prefetchInfiniteQuery({ + queryKey: eventsQueryKey(DEFAULT_FILTERS), + queryFn: () => + listEventsForUser(user.id, { tags: [], limit: PAGE_SIZE }), + initialPageParam: null as string | null, + }), + qc.prefetchQuery({ + queryKey: statsQueryKey(DEFAULT_FILTERS), + queryFn: () => getEventStatsForUser(user.id, { tags: [] }), + }), + qc.prefetchQuery({ + queryKey: topSessionsQueryKey, + queryFn: () => getTopSessionsForUser(user.id, 3), + }), + ]); return ( - <main className="flex flex-1 items-center justify-center bg-zinc-50 dark:bg-black"> - <div className="flex w-full max-w-md flex-col items-center gap-6 rounded-2xl border border-black/[.08] bg-white p-10 dark:border-white/[.145] dark:bg-zinc-950"> - <h1 className="text-2xl font-semibold tracking-tight text-black dark:text-zinc-50"> - Welcome to WorkTrace - </h1> - <p className="text-sm text-zinc-600 dark:text-zinc-400"> - Signed in as <span className="font-medium text-black dark:text-zinc-50">{email}</span> - </p> - <LogoutButton /> + <div className="mx-auto flex w-full max-w-6xl flex-col gap-6 px-6 py-8"> + <div className="flex items-baseline justify-between"> + <h1 className="text-base font-bold tracking-widest text-cyan">EVENT FEED</h1> </div> - </main> + + <HydrationBoundary state={dehydrate(qc)}> + <FeedRoot /> + </HydrationBoundary> + </div> ); } diff --git a/dashboard/app/dashboard/top-sessions.tsx b/dashboard/app/dashboard/top-sessions.tsx new file mode 100644 index 0000000..bc1f30f --- /dev/null +++ b/dashboard/app/dashboard/top-sessions.tsx @@ -0,0 +1,118 @@ +"use client"; + +import { useQuery } from "@tanstack/react-query"; +import type { TopSession } from "@/types/event"; +import { fetchTopSessions, topSessionsQueryKey } from "./feed-shared"; +import { useClientLocalized } from "./use-client-localized"; + +function formatDuration(seconds: number): string { + const total = Math.max(0, Math.round(seconds)); + const h = Math.floor(total / 3600); + const m = Math.floor((total % 3600) / 60); + if (h === 0 && m === 0) return `${total}s`; + if (h === 0) return `${m}m`; + return `${h}h ${m}m`; +} + +function utcDay(iso: string): string { + return iso.slice(0, 10); +} + +function localDay(iso: string): string { + return new Date(iso).toLocaleDateString(undefined, { + month: "short", + day: "2-digit", + }); +} + +export function TopSessions() { + const { data, isLoading, isError } = useQuery({ + queryKey: topSessionsQueryKey, + queryFn: fetchTopSessions, + staleTime: 30_000, + }); + + if (isLoading) { + return <div className="h-full min-h-52 animate-pulse rounded border border-border bg-surface" />; + } + + if (isError || !data) { + return ( + <div className="flex h-full min-h-52 items-center justify-center rounded border border-pink/40 bg-surface text-[10px] tracking-widest text-pink"> + FAILED TO LOAD SESSIONS + </div> + ); + } + + if (data.length === 0) { + return ( + <div className="flex h-full min-h-52 items-center justify-center rounded border border-border bg-surface text-[10px] tracking-widest text-muted"> + NO SESSIONS YET + </div> + ); + } + + return ( + <div className="flex h-full flex-col rounded border border-border bg-surface p-4"> + <div className="mb-3 text-[10px] font-bold tracking-widest text-muted"> + TOP 3 SESSIONS + </div> + <ul className="flex flex-col gap-2"> + {data.map((session) => ( + <li key={session.id}> + <SessionRow session={session} /> + </li> + ))} + </ul> + </div> + ); +} + +function SessionRow({ session }: { session: TopSession }) { + const day = useClientLocalized(session.startedAt, utcDay, localDay); + const isActive = session.endedAt === null; + + const ratio = session.totalSeconds > 0 + ? Math.min(1, session.topHostSeconds / session.totalSeconds) + : 0; + + return ( + <div className="flex flex-col gap-1 rounded border border-border/50 bg-bg px-2 py-1.5 transition-colors hover:border-purple/60"> + <div className="flex items-baseline justify-between gap-2"> + <div className="flex items-center gap-1.5 text-[11px]"> + <span + className={isActive ? "text-cyan" : "text-muted"} + title={isActive ? "Active session" : "Ended session"} + > + ● + </span> + <span className="font-bold text-text">{day}</span> + </div> + <span className="text-[11px] font-bold text-cyan tabular-nums"> + {formatDuration(session.totalSeconds)} + </span> + </div> + + {session.topHost ? ( + <> + <div className="flex items-baseline justify-between gap-2 pl-3"> + <span className="truncate text-[10px] text-muted" title={session.topHost}> + ⟶ {session.topHost} + </span> + <span className="shrink-0 text-[10px] text-purple tabular-nums"> + {formatDuration(session.topHostSeconds)} + </span> + </div> + <div className="ml-3 h-1 overflow-hidden rounded-sm bg-border"> + <div + className="h-full bg-purple" + style={{ width: `${(ratio * 100).toFixed(1)}%` }} + /> + </div> + </> + ) : ( + <div className="pl-3 text-[10px] text-muted">no parsed pages</div> + )} + </div> + ); +} diff --git a/dashboard/app/dashboard/top-tags-chart.tsx b/dashboard/app/dashboard/top-tags-chart.tsx new file mode 100644 index 0000000..ea88b7e --- /dev/null +++ b/dashboard/app/dashboard/top-tags-chart.tsx @@ -0,0 +1,56 @@ +"use client"; + +import { Doughnut } from "react-chartjs-2"; +import type { TagCount } from "@/types/event"; + +const PALETTE = ["#00e5b0", "#7c3aff", "#f0d000", "#ff0070", "#3e9bff", "#ff8a00", "#a0e000"]; + +export function TopTagsChart({ top }: { top: TagCount[] }) { + if (top.length === 0) { + return ( + <div className="flex h-52 items-center justify-center rounded border border-border bg-surface text-[10px] tracking-widest text-muted"> + NO TAGS IN RANGE + </div> + ); + } + + return ( + <div className="flex h-full flex-col rounded border border-border bg-surface p-4"> + <div className="mb-3 text-[10px] font-bold tracking-widest text-muted"> + TOP TAGS + </div> + <div className="flex flex-1 items-center justify-center"> + <div className="h-40 w-full max-w-[320px]"> + <Doughnut + data={{ + labels: top.map((t) => t.tag), + datasets: [ + { + data: top.map((t) => t.count), + backgroundColor: top.map((_, i) => PALETTE[i % PALETTE.length]), + borderColor: "#0f0f20", + borderWidth: 2, + }, + ], + }} + options={{ + responsive: true, + maintainAspectRatio: false, + cutout: "60%", + plugins: { + legend: { + position: "right", + labels: { + color: "#c8d0f0", + font: { size: 10, family: "Courier New" }, + boxWidth: 12, + }, + }, + }, + }} + /> + </div> + </div> + </div> + ); +} diff --git a/dashboard/app/dashboard/use-client-localized.ts b/dashboard/app/dashboard/use-client-localized.ts new file mode 100644 index 0000000..75fca82 --- /dev/null +++ b/dashboard/app/dashboard/use-client-localized.ts @@ -0,0 +1,19 @@ +"use client"; + +import { useSyncExternalStore } from "react"; + +const subscribe = () => () => {}; + +// Renders a stable server-snapshot during SSR, swaps to the client-snapshot after hydration. +// Designed for locale-/timezone-dependent values that would otherwise mismatch between server and client. +export function useClientLocalized<T>( + iso: string, + getServerSnap: (iso: string) => T, + getClientSnap: (iso: string) => T, +): T { + return useSyncExternalStore( + subscribe, + () => getClientSnap(iso), + () => getServerSnap(iso), + ); +} diff --git a/dashboard/app/favicon.ico b/dashboard/app/favicon.ico deleted file mode 100644 index 718d6fea4835ec2d246af9800eddb7ffb276240c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 25931 zcmeHv30#a{`}aL_*G&7qml|y<+KVaDM2m#dVr!KsA!#An?kSQM(q<_dDNCpjEux83 zLb9Z^XxbDl(w>%i@8hT6>)&Gu{h#Oeyszu?xtw#Zb1mO<?sK2}EE5RAKnxHU7lft+ zNRAPL3?T?25I&drAjl1ssi=G|D?(7bFsgtO(2o>{pgX9699l+Qppw7jXaYf~-84xW z)w4x8?=youko|}Vr~(D$UX<xm7|19n6Hxvd5m6xx<*9a4%RmR{en}E&p$X-wy5A}T zU0^dwXVA>IbiXABHh`p1?nn8Po~fxRJv}|0e(BPs|G`(TT%kKVJAdg5*Z|x0leQq0 zkdUBvb#>9F()jo|T~kx@OM8$9wzs~t2l;K=woNssA3l6|sx2r3+kdfVW@e^8e*E}v zA1y5{bRi+3Z`uD3{F7LgFJDdvm;nJilkzDku>BwXH(8ItVCXk*-lSJnR?-2UN%<G) zWdETe=&R39RaKR)udn|#TOgZ!e!yM=<=+`Uz{l^5UtkZ2fHDQ;UwMB}v%l$A-`~F- z{Qr^x^CSUf63Sry{6y#+`<sMA?dPFvg)$lC_RkFRKnCi7&P<a6>hJ){&rlvg`CDTj z)Bzo!3v7Ou#83zEDEFcKt(f1E0~=rqeEbTnMvWR#{+9pg%7G8y>u1OVRUSoox-ovF z2Ydma(;=YuBY(eI|04{hXzZD6_f(v~H;C~y5=DhAC{MMS>2fm~1H_t2$56pc$NH8( z5bH|<)71dV-_oCHIrzrT`2s-5w_+2CM0$95I6X8p^r!gHp+j_gd;9O<1~CEQQGS8) zS9Qh3#p&JM-G8rHekNmKVewU;pJRcTAog68KYo^dRo}(M<!8cv(gkb9@A>>36U4Us zfgYWSiHZL3;lpWT=<n~R&zm>zNAW>Dh#mB!_@Lg%$ms8N-;aPqMn+C2HqZgz&9~Eu z4|Kp<`$q)Uw1R?y(~S>ePdonHxpV1#eSP1B;Ogo+-Pk}6#0GsZZ5!||ev2MGdh}_m z{DeR7?0-1^zVs&`AV6<!ZvGbtU{7FdY&`9DeD(=q|M30$GCs(E?S0J1$e@G0#Z=wz zl)*a>Vt;r3`I`OI_wgs*w=eO%_#7Kepl{B<UyBc9U%rn&@xFZ-e{%i>@xiyCANc(l zzIyd4y|c6PXWq9-|KM8(zIk8LPk(>a)zyFWjhT!$HJ$qX1vo@d25W<<x-(q{Yn-pG zKTz?fwGmh&&2-F3f57**)?Xk#p#S9h^DhK{VVKE&0KR^-_MMD9nf@pDACnmVll!kp z3?Tha?LWW70P;AL{}cP~sW|?W|MbA09{7Kt2f!i(y>fvZQ2zUz5WRc(UnFMKHwe1| zWmlB1qdbiA(C0jmnV<}GfbKtmcu^2*P^O?<jWWPHxu*D53Uq)j1!ZtH3Vi&#Nd^rV zj`B>MBLZKt|As~ge8&AAO~2K@zbXelK|4T<{|y4`raF{=72kC2Kn(L4YyenWgrPiv z@^mr$t{#X5VuIMeL!7Ab6_kG$&#&5p*Z{+?5U|TZ`B!7llpVmp@skYz&n^8QfPJzL z0G6K_OJM9x+Wu2gfN45phANGt{7=C>i34CV{Xqlx(fWpeAoj^N0Biu`w+MVcCUyU* zDZuzO0>4Z6fbu^T_arWW5n!E45vX8N=bxTVeFoep_G#VmNlQzAI_KTIc{6>c+04vr zx@W}zE5JNSU>!THJ{J=cqjz+4{L4A{Ob9$ZJ*S1?Ggg3klFp!+Y1@K+pK1DqI|_gq z5ZDXVpge8-cs!o|;K73#YXZ3AShj50wBvuq3NTOZ`M&qtjj#GOFfgExjg8Gn8>Vq5 z`85n+9|!iLCZF5$HJ$Iu($dm?8~-ofu}tEc+-pyke=3!im#6pk_Wo8IA|fJwD&~~F zc16osQ)EBo58U7XDuMexaPRjU@h8tXe%S{fA0NH3vGJFhuyyO!Uyl2^&EOpX{9As0 zWj+P>{@}jxH)8|r;2HdupP!vie{sJ28b&bo!8`D^x}TE$%zXNb^X1p@0PJ86`dZyj z%ce7*{^oo+6%&~I!8hQy-vQ7E)0t0ybH4l%KltWOo~8cO`T=157JqL(oq_rC%ea&4 z2NcTJe-HgFjNg-gZ$6!Y`SMHrlj}Etf7<Kk?_r;;``Uc^3+u}-v3@Q8<@$Nr`<F?K z-%F>?r!zQTPPSv}{so2e>Fjs1{<qUF=hGRSFDG$<z3x<+@%{Vd%a`e+qodRP&D<om zAEn>gzk~LGeesX%r(Lh6rbhSo_n)@@G-FTQy93;l#E)hgP@d_SGvyCp0~o(Y;Ee8{ zdVUDbHm5`2taPUOY^MAGOw*<R_VaVlPH<<CgYr!E->>=s7=Gst=D+p+2yON!0%Hk` zz5mAhyT4lS*T3LS^WSxUy86q&GnoHxzQ6vm8)VS}_zuqG?+3td68_x;etQAdu@sc6 zQJ&5|4(I?~3d-QOAODHpZ=hlSg(lBZ!JZWCtHHSj`0Wh93-Uk)_S%zsJ~aD>{`A0~ z9{AG(e|q3g5B%wYKRxiL2Y$8(4w<boVrLOyLG9R$m+7N>6bzchKuloQW#e&S3n+P- z8!ds-%f;TJ1>)v)##>gd{PdS2Oc3VaR`fr=`O8QIO(6(N!A?pr5C#6fc~Ge@N%Vvu zaoAX2&(a6eWy_q&UwOhU)|P3J0Qc%OdhzW=F4D|pt0E4osw;%<%Dn58hAWD^XnZD= z>9~H(3bmLtxpF?a7su6J7M*x1By7YSUbxGi)Ot0P77`}P<HJ;%@cvfCkvm6xcMjdY zed_u6xK)F%|1Hy`)`e~K(f*MqTJ?92I+4lga{A5`-U@Cab35G6unNk<*dpB|Rtkp; z?32o^yBlJsuA-^abQ~7;%<oa^k<DbKc{lOW2!yM#nEALvv)IhY7b|Wfg(UhtiurTM zY-B6L26$JQo&Kt3nh3JTJ)garEgw^{uEM3__%b$U5{~+aMO*k)6R#grkER2`U6KS- z=j1=QhCkuy%iiHWrqH8CeGNw*C?epTpl2Bo@ugUPKRFeiVHOpL7PHu-SAgX@qmTGH z_%ePz1`io8XDfwLmip;Rn;1yo+3>3{)&5Un{KD?`-e?r21!4vTTnN(4Y6Lin?UkSM z`MXCTC1@4A4~mvz%Rh2&EwY))LeoT=*`tMoqcEXI>TZU9WTP#l?uFv+@Dn~b(>xh2 z;>B?;Tz2SR&KVb>vGiBSB`@U7VIWFSo=LDSb9F{GF^DbmWAfpms8Sx9OX4CnBJca3 zlj9(x!dIjN?OG1X4l*imJNvRCk}F%!?SOfiOq5y^mZW)jFL@<gIi}tCXee1<sGV$i z4r_`X#mEQbiDh!Efji0GjM9z-0bF}p0(*s(OzMJ|;K&OJBar<ARLp}T>a|r-@d#f7 z2gmU8L3IZq0ynIws=}~m^#@&C%J6QFo~Mo4V`>v7MI-_!EBMMtb%_M&kvAaN)@ZVw z+`toz&WG#HkWDjnZE!6nk{e-oFdL^$YnbOCN}JC&{$#$O27@|Tn-skXr)2ml2~O!5 zX+gYoxhoc7qoU?C^3~&!U?kRFtnSEecWuH0B0OvLodgUAi}8p1<ZO0#U-k07ifx!> zrO6RSXHH}D<I*>Mc$&|?D004<Y&c6)m74d`LOLU@ruR+Um4>DiOVMHV8kXCP@7NKB zgaZq^^O<7PoKEp72kby@W0Z!Y*A<g|TlOeriuPP`vK2IntATvs?Iv|J14j&;NFSFo zyJ+sca?G+8C%!b{Sq=6cJJqS>y{&vfg#C&gG@YVR9g?FEocMUi1gSN$+V+ayF45{a zuDZDT<?u;)RfLQwg>N}mS|;BO%gEf}pjBfN2-gIrU#G5~cucA;dokXW89%>AyXJJI z9X4Ul<x{xc_m~`mWBP0<g-{#wm}Vv~Ef3pKWC&N_<~88zSbEk;;+{DnJ9-u&Zc74s zJ6TCQyl_^|5cY;wmDdrU@LTL-3v0H#Ui?8ICQV{imof1MHuM$`e*ux>IWA|ZYHgbI z5?oFk@A=Ik7lrEQPDH!H+b`7_Y~aDb_qa=B2^Y&Ow41cU=4WDd40dp5(QS-WMN-=Y z9g;6_-JdNU;|6cPwf$ak*aJIcwL@1n$#l~zi{c{EW?T;DaW*E8DYq?Umtz{nJ&w-M zEMyT<MDk{HKbd#ckg5-pS_?QUVhZv?&Q-ioBS}$nvBd)nE7YO0deN~G(#zCJAbY$E z!)g3Ytl=_NDUV%pykcE+Q<{EoZ_4FR@&#d<hqs%N>DrC&9K$d|kZe2#ws6)L=7K+{ zQw{XnV6UC$6-rW0emqm8wJoeZK)wJIcV?dST}Z;G0Arq{dVDu0&4kd%N!3F1*;*pW zR&qUiFzK=@44#QGw7k1`3t_d8&*kBV->O##t|tonFc2YWrL7_eqg+=+k;!F-`^b8> z#KWCE8%u4k@EprxqiV$VmmtiWxDLgnGu$Vs<8rppV5E<MCr+anDo)-{XRlCJ;D#M( zT=3WgR02;Nm!54biUb^FtzPh8iGrf412epnki-k+G4mdkzC|lJqaRMbb0~Jjp-{}I z5Do5afZi>ajBXL4nyyZM$SWVm!wnCj-B!Wjqj5-5dNXukI2$$|Bu3Lrw}z65Lc=1G z^-#WuQOj$hwNGG?*CM_TO8Bg-1+qc>J7k5c51U8g?ZU5n?HYor;~JIjoWH-G>AoUP ztrWWLbRNqIjW#RT*WqZgPJXU7C)VaW5}MiijYbABmzoru6EmQ*N8cVK7a3|aOB#O& zBl8JY2WKfmj;h#Q!pN%9o@VNLv{OUL?rixHwOZuvX7{IJ{(EdPpuVFoQqIOa7gi<U zTpbX&UCeYeNu>LVkBOKL@^smUA!tZ1CKRK}#SSM)iQHk)*R~?M!qkCruaS!#oIL1c z<cK@1=jX>?J<BS8bpdt^R+}%A_DEhF^%o}8e!!lc`Y!qU>;U~&FfH#*98^G?i}pA{ z9Jg36t4=%6mhY(quYq*vSxptes9qy|7xSlH?G=S@>u>Ebe;|LVhs~@+06N<4CViBk zUiY$thvX;>Tby6z9Y1e<Q<iIG*|o$r?OTFp`s)@_nHs4LeWbGvg7^}NK)>dAMQaiH zm^r3v#$Q#2T=X>bsY#D%s!bhs^M9PMAcHbCc0FMHV{u-dwlL;a1eJ63v5U*?Q_8JO zT#50!RD619#j_Uf))0ooADz~*9&lN!bBDRUgE>Vud-i5ck%vT=r^yD*^?Mp@Q^v+V zG#-?gKlr}Eeqifb{|So?HM&g91<J5P5=Ly{?(NNY{6`O~L5r@sJe3rNZn06%SLk); z9?hvE^Hr{!*G$<_doyzGn#*z*#}?)8dH=eYTgvc)T~}Jw!kCv68<+KL5{5?EXtDAZ zWeNqp8%KIuBi&icn5s815Vho<+99VW1~m@L8l0=$c`t-L{q))~<!p*~vCdUcBcPz` zyUi}!-k_`G{>P8|av8hQoCmQXkd?7wIJw<dY^{|7OQJUHKB~nksN_|Xy;DL?xjxU^ zbMa`WdfTBnr<wTd$mY&SgJ4U|X``k`#`gN@M+0x2W{YgC3kbLk<uYFJWglkx_)2#b ztRiuA!EK9o)f`I2k)l;Of%E`ff91WlZh8yfRi6#N-mC`Ma(yr~U82SyAhc9B+ur!f zP-3igg*KeYs9mGOAw@OaXYy9DnGjn0<m`JH&Q^h}^!h+uS9Ct*o-oEy(?iT6Yco>b z_^v8bbg`<ZOL)a;i=IdfK0Zvw4nXsoC?eTOMpY)_ptiORm%J(1CD3dE0Z%Vy<2iHp zcp>SAn{I*4bH$u(RZ6*x<DqKJ+5;a6Jq~=Y8V&c?Vsyq88!2nD?H?Eww58Mqt$7R8 z5BMjmKx>UhuA~hc=8czK8SHEKTzSxgbwi~9(OqJB&gwb^l4+m`k*Q;_?>Y-APi1{k zAHQ)P)G)f|AyjSgcCFps)Fh6Bca*Xznq3<?y%xNvu0N78_R?~<RDFQx0ynlRG(E|j zvEGN3bF<E_9p-I!UwQXFqcSGV#e^98tgFqLp+z9eP}y!jNA{)r*a+%M-_20xg?94< zzmM{}syi0cd&P)zywMdS&Y_9k5JDtOM!L)b^2WP!+fHYGv>6!pV6Az&m{O8$wGFD? zY&O*3*J0;_EqM#jh6^gMQKpXV?#1?>$ml1xvh8nSN>-?H=V;nJIwB07YX$e6vLxH( zqYwQ>qxwR(i4f)DLd)-$P>T-no_c!LsN@)8`e;W@)-Hj0>nJ-}Kla4-ZdPJzI&Mce zv)V_j;(3ERN3_@I$N<^|4Lf`B;8n+bX@bHbcZTopEmDI*Jfl)-pFDvo6svPRoo@(x z);_{lY<;);XzT`dBFpRmGrr}z5u1=p<K1~3>C^<jVp}L(pzgMB_Vs-O?{Z?y$8M;) zi@7zwpzV9#m72%En~(9@E)GWV^(~J*@^*K*TE0mynAnGJ5YSLCEnC42H-`tr4L=oW zI}N{xQ$HT8Q6CVHf%RY&xw7!Zj(0xmg(K#UQ4u!ej95z7V4phlcTJ2&AR}$)zV-s! zO7bqY6(=?1t+JCOW_z%HRE>S-{ce6iXQlLGcItwJ^mZx{m$&DA_oEZ)B{_bYPq-HA zcH8WGoBG(aBU_j)vEy+_71T34@4dmSg!|M8Vf92Zj6WH7Q7t#OHQqWgFE3ARt+%!T z?oLovLVlnf?2c7pTc)~cc^($_8nyKwsN`RA-23ed3sdj(ys%pjjM+9JrctL;dy8a( z@en&CQmnV(()bu|Y%G1-4a(6x{aLytn$T-;(&{QIJB9vMox11U-1HpD@d(QkaJdEb zG{)+6Dos_L+O3NpWo^=gR?evp|CqEG?L&Ut#D*KLaRFOgOEK(Kq1@!EGcTfo+%A&I z=dLbB+d$u{sh?u)xP{PF8L%;YPPW53+@{>5W=Jt#wQpN;0_HYdw1{ksf_XhO4#2F= zyPx6Lx2<92L-;L5PD`zn6zwIH`Jk(<gsVPionpJ-imI56$j4P0!br@ny3=!{x2TY^ zCD=)8_PgmN)E!^nczcDGc9Wm7oo5O3@fh=k=kh8J?_3KqEp7JHdv8z_iZ5#KmbiPt z2Bt8Ro^p$7pS!xL3mtj<iN3f}#r6_&$Es0PnJTE?c;0#$%cGdu`T%~`gW;c^VD-S= zrAatMf^%Lzr*wQ4kHSOb?WOUuEsJQ3xr{Imf1t{~iNmRwb_SP9!?FFN=b-E){!8P2 ztWCT~262O8`%?3<W4Wg+ovWY<re)?^kZ|Yi>$?Qw({erA$^bC;q33hv!d!>%wRhj# zal^hk+WGNg;rJtb-EB(?czvOM=H7dl=vblBwAv>}%1@{}mnpUznfq1cE^sgsL0*4I zJ##!*B?=vI_OEVis5o+_IwMIRrpQyT_Sq~ZU%oY7c5JMIADzpD!Upz9h@iWg_>>~j zOLS;wp^i$-E?4<_cp?RiS%Rd?i;f*mOz=~(&3lo<=@(nR!_Rqiprh@weZlL!t#NCc zO!QTcInq|%#>OVgobj{~ixEUec`E25zJ~*DofsQdzIa@5^nOXj2T;8O`l--(QyU<o zeu8G~Z>^$t?TGY^7#&FQ+2SS3B#qK*k3`ye?8jUYSajE5iBbJls75CCc(m3dk{t?- zopcER9{Z?TC)mk~gpi^kbbu>b-+a{m#8-y2^p$ka4n60w;Sc2}HMf<8JUvh<G@KZw z+<GL!lpeahq2+nO{>CL0B&Btk)T`ctE$*qNW8L$`7!r^9T+>=<=2qaq-;ll2{`{Rg zc5a0ZUI$oG&j-qVOuKa=*v4aY#IsoM+1|c4Z)<}lEDvy;5huB@1RJPquU2U*U-;gu z=En2m+qjBzR#DEJDO`WU)hdd{Vj%^0V*KoyZ|5lzV87&g_j~NCjwv0uQVqXOb*QrQ zy|Qn`hxx(58c<SELWpDAg~83oY-J_WoDiI6d7>70$E;L(X0uZZ72M1!6oeg)(cdKO ze0gDaTz+ohR-#d)NbAH4x{I(21yjwvBQfmpLu$)|m{XolbgF!pmsqJ#D}(ylp6uC> z{bqtcI#hT#HW=wl7>p!38sKsJ`r8}lt-q%Keqy%u(xk=yiIJiUw6|5IvkS+#?JTBl z8H5(Q?l#wzazujH!8o>1xtn8#_w+397*<wp?Ryt$UFh41$qd}LyNJ7Oao(Aw2g|wy zH_nZ+R#~EUME^#j4$@^5&>_cy8!pQGP%K(Ga3pAjsaTbbXJlQF_+m+-UpUUent@xM zg%jqLUExj~o^vQ3Gl*>wh=_gOr2*|U64_iXb+-111a<qXXnUI&{l`dM&{4Gw)jZn; zlj{VxW@#OcVE1Y%J*u^Z@H+XSqL6SwA|^jv2RU_+d;O!mk)dw7-m9B4{6*G1zRdR6 zQ}6v&Xt7R2h3Xp}EQk4nF2TULG{Ri=D|JC<a+K7dldN1}CY_f!vK#u}K3`g#TpO&W z;!;64`0$d9raD!VbYP`kuFUasaMh!;&81y}LHS(SuGRxwEn4LZb4DS1j9iAq$MXd@ z(Ebka7_Gc(ljGaJqtI-OzmA@c@sYB$)Vg!RP4~``vaVyRq$rJXRjIPwtepN;(B%wy zmU>H}$TjeajM+I20xw(((>fej-@CIz4S1pi$(#}P7`4({6QS2CaQS4NPENDp>sAqD z$bH4KGzXGffkJ7R>V>)>tC)uax{UsN*dbeNC*v}#8Y#OWYwL4t$ePR?VTyIs!wea+ z5Urmc)X|^`MG~*dS6pGSbU+gPJoq*^a=_>$n4|P^w$sMBBy@f*Z^Jg6?n5?oId6f{ z$LW4M|4m502z0t7g<#Bx%X;9<=)smFolV&(V^(7Cv2-sxbxopQ!)*#ZRhTBpx1)Fc zNm1T%bONzv6@#|dz(w02AH8OXe>kQ#1FMCzO}2J_mST)+ExmBr9cva-@?;wnmWMOk z{3_~EX_xadgJGv&H@zK_8{(x84`}+c?oSBX*Ge3VdfTt&F}yCpFP?CpW+BE^cWY0^ zb&uBN!Ja3UzYHK-CTyA5=L<c0d<h!DNBIa<xax8W3(Ru8L0cVXQ18|Y^|*S%)R96z zBT$(=zQ}2vmt6LzN~Oyf_Y92%P@QOx{7~}5!UIqCdfu?VwC0Nb!2@iiit8-5zUWFG z*G&+GLIU#J;}hvowNJWnglvb^<2q~lS#?ixVtYT@(O3{TC|4kFJYLB*jni-4YZi0> zEMW{l3Usky#ly=7px648W31UNV@K)&Ub&zP1c7%)`{);I4b0Q<)B}3;NMG2JH=X$U zfIW4)4n9ZM`-yRj67I)YSLDK)qfUJ_ij}a#aZN~9EXrh8eZY2&=uY%2N0UFF7<~%M zsB8=erOWZ>Ct_#^tHZ|*q`H;A)5;ycw*I<Cd*bZlOJ9YmRUK2<qXkpRR3nr6r~%Jz z*(8tA&DYO)etdgVmoonqD{*<5Fog4ClIs-~_uhjuZOI}#Wy+ce${%#oyHloXelqfz z8)?D3Y_>cmVxi8_0Xk}aJA^ath+E;xg!x+As(M#0=)3!NJR6H&9+zd#iP(m0PIW8$ z1Y^VX`>jm`W!=WpF*{ioM?C9`yOR>@0q=u7o>BP-eSHqCgMDj!2anwH?s%i2p+Q7D zzszIf5XJpE)IG4;d_(La-xenmF(tgAxK`Y4sQ}BSJEPs6N_U2vI{8=0C_F?@7<(G; zo$~G=8p+076G;`}>{MQ>t>7cm=zGtfbdDXm6||jUU|?X?CaE?(<6bKDYKeHlz}DA8 zXT={X=yp_R;HfJ9h%?eWvQ!dRgz&Su*JfNt!Wu>|XfU<MM~gB&J0gc}IH}?|B4WRK zWPL0FhctFGdMucOFdhrVunIe5)4K^H9IjB#eA)p5w?c#v7kp8jx^~bxxJB{;hPFL9 zkR9Dbpj+T5ZMgHQg|oj*DS;x&jK}1rn&}Shp9sgOI*7puQD-w?3H*cg72;5H(_zW* zApJBIM-p2~F;qWDj!n|Kd=5|T8OPkQ_G;ujgvKybr5@~eci2{8WAz+%NUSp-&eoG! zOGLNLJewWl&1*NT467W3god~fYgX?!f0?NCFnjD$qE-fyQ)|Q_DLc*{olmXSVl$g_ z$vj}o?RatMy(o*j8?q1Mgw{OUOgVR6_qvS<Co*&!cR`ROi|*I`ajyG5s@L8agnX2J zF=DLkMG`z{RP&996y0yAtvJcb<cba?TV#j4VYFPC>&68iRikRrHRW|ZxzRR^`eIGt zIeiDgVS>IeExKVRWW8-=<xUfo0v~z=RA=cFWKXgcMECd}xHp7iqkBanH}TZ0h0rA= zqxUZ>A=<k-RjTtwbJkkep{8z*173wY^e%-U0{Ue!n@wbg^2q)Vx5c(_RfvuR4}XXn z+JE>yA`}`)ZkWBrZD`hpWIxBGkh&f#ijr449~m`j6{4jiJ*C!oVA8ZC?$1RM#K(_b zL9TW)kN*Y4%^-qPpMP7d4)o?Nk#>aoYHT(*g)qmRUb?**F@pnNiy6Fv9rEiUqD(^O zzyS?nBrX63BTRYduaG(0VVG2yJRe%o&rVrLjbxTaAFTd8s;<<@Qs>u(<193R8>}2_ zuwp{7;H2a*X7_jryzriZXMg?bTuegABb^87@SsKkr2)0Gyiax8KQWstw^v<oS3Xw7 zu51m`3~hoyxErcHymdFTZd#AO59{EkuFTcpAR33(3xc{zRnn1~1Ei(i*^HdCvM~;; za&}Uip|u>#ix45EVrcEhr>!NMhprl<CqZuKa#zuI&@zymVzIicetS0bq#u?m(r_@S zJ79bl%4EyHCQ3fK@en+A1@)e}HWLP|gr_zuoA{}Z<(-*53Zu@k+=^%~5F(z$EFLI; z-TQTS8$W|GRbZq93Ha1?lu+`O;rn>$InQMzjSFH54x5k9qHc`@9uKQzvL4ihcq{^B zPrVR=o_ic%Y>6&rMN)hTZsI7I<3&`#(nl+3y3ys9A~<Ao%ZuW})CJ)6^(aRV(gGxR z89#(FDW;GZEAf;rI$+PU)rEV|rASrwP0_mr^Ldv)IuUf1M>&^=4?PL&nd8)`OfG#n zwAMN$1&>K++c{^|7<<q5KGu)u(OEfEJJw2aEi(;x-i=Y=j3ram9H2n-Fuqv0dVlXJ z&WgG5X({!vJFDrEbm+CWDca^zIe2@s1@a;;Y3!U9Q)&P0UXFmCP51_!wvTfAIyR^M z7^R*O@yz1b-s4VC>4P=2y(B{jJsQ0a#U;HTo4ZmWZYvI{+s;Td{Yzem%0*k#)vjpB zia;J&>}ICate44SFYY3vEelqStQWFihx%^vQ@Do(sOy7yR2@WNv7Y9I^yL=nZr3mb zXKV5t@=?-Sk|b{XMhA7ZGB@2hqsx}4xwCW!in#C<kr{U&JG{9FhoZ<aTve_lLz39> zI@}sc<h3gsW}hp-`WUywKA>Zlr3-NFJ@NFaJlhyfcw{k^vvtGl`N9xSo**rDW4S}i zM9{fMPWo%4wYDG~BZ18BD+}h|GQKc-g^{++3MY>}W_uq7jGHx{mwE9fZiPCoxN$+7 zrODGGJrOkcPQUB(FD5aoS4g~7#6NR^ma7-!>mHuJfY5kTe6PpNNKC9GGRiu^L31uG z$7v`*JknQHsYB!Tm_W{a32TM099djW%5e+j0Ve_ct}IM>XLF1Ap+YvcrLV=|CKo6S zb+<Td{{5RWR}u2f(q<b(D$9JsF0OOzJ*+z0P5kc1t}CXlYgua%x*2lSgp|*WS3H-# zdYr7?GQOL18zUS<2|;+vi4|4sQBM2Gs&WVS!D`q5Lz;XR@5rEfa{uG-!q?R8Ncz%( z5K6~LQ@d2wp#)5q4u<ENlFbS)U4o1t9{-d>9Nl3_YdKP6%Cxy@6TxZ>;4&nTneadr z_ES90ydCev)LV!dN=#(*f}|ZORFdvkYBni^aLbUk>BajeWIOcmHP#8S)*2U~QKI%S zyrLmtPqb&TphJ;>yAxri#;{uyk`JJqODDw%(Z=2<VfJZemI(PFAD{6Sm|uE%BTbkl zROsg*MOh20YgGs3H7?@pmQ>`1uc}br^V%>j!gS)D*q*f_-qf8&D;W1dJgQMlaH5er zN2U<%Smb7==vE}dDI8K7cKz!vs^73o9f>2sgiTzWcwY|BMYHH5%Vn7#kiw&eItCqa zIkR2~Q}>X=Ar8W|^Ms41Fm8o6IB2_j60eOeBB1Br!boW7JnoeX6Gs)?7rW0^5psc- zjS16yb>dFn>KPOF;imD}e!enuIniFzv}n$m2#gCCv4jM#ArwlzZ$7@9&XkFxZ4n!V zj3dyiwW4Ki2QG{@i>yuZXQizw_OkZI^-3otXC{!(lUpJF33gI60ak;Uqitp74|B6I zgg{b=Iz}WkhCGj1M<xTd?60J5qsr1Cg7F~~U2N!(@lC<>=hu4#Aw173YxIVbISaoc z-nLZC*6Tgivd5V`K%GxhBsp@SUU60-rfc$=wb>zdJzXS&-5(NRRodFk;Kxk!S(<ov z$YXcI9;^grAyiJ4dWTv3b}K~Ww09(;mLY4+kj|$A?IMr}`7q?mIS1>O(a0e7oY=E( zAyS;Ow?6Q&XA+cnkCb{28_1N8H#?J!*$MmIwLq^*T_9-z^&UE@A(z9oGYtFy6EZef LrJugUA?W`A8`#=m diff --git a/dashboard/app/globals.css b/dashboard/app/globals.css index a2dc41e..b172a74 100644 --- a/dashboard/app/globals.css +++ b/dashboard/app/globals.css @@ -1,26 +1,34 @@ @import "tailwindcss"; :root { - --background: #ffffff; - --foreground: #171717; + --c-cyan: #00e5b0; + --c-purple: #7c3aff; + --c-yellow: #f0d000; + --c-pink: #ff0070; + --c-bg: #080812; + --c-surface: #0f0f20; + --c-border: #1c1c38; + --c-text: #c8d0f0; + --c-muted: #3e3e60; } @theme inline { - --color-background: var(--background); - --color-foreground: var(--foreground); - --font-sans: var(--font-geist-sans); - --font-mono: var(--font-geist-mono); -} - -@media (prefers-color-scheme: dark) { - :root { - --background: #0a0a0a; - --foreground: #ededed; - } + --color-bg: var(--c-bg); + --color-surface: var(--c-surface); + --color-border: var(--c-border); + --color-text: var(--c-text); + --color-muted: var(--c-muted); + --color-cyan: var(--c-cyan); + --color-purple: var(--c-purple); + --color-yellow: var(--c-yellow); + --color-pink: var(--c-pink); + --font-mono: var(--font-geist-mono); } body { - background: var(--background); - color: var(--foreground); - font-family: Arial, Helvetica, sans-serif; + background: var(--c-bg); + color: var(--c-text); + font-family: "Courier New", Courier, monospace; + font-size: 13px; + letter-spacing: 0.03em; } diff --git a/dashboard/app/icon.png b/dashboard/app/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..06012ed545b51b58f6d789b315ffd08803a56029 GIT binary patch literal 936 zcmeAS@N?(olHy`uVBq!ia0vp^4Is?H1|$#LC7uRSjKx9jP7LeL$-D$|SkfJR9T^xl z_H+M9WCij$3p^r=85sBugD~Uq{1qt-49vEkE{-7;ac?gv`nfWSFb96~I&>(|;~$sZ zwxmhR6kiH&e{`bn)$!-oU)z?yWjIbdWLwwpe*XRXh07NCHqGiX<IFO9%fMzTnk#fA z=N2PRmewtm6*spqOI!)r;u)|xligs&%8bbi(k}BQ1O#7Hb3D6D_P_$LR$uD|M_<?3 yET*%|7@9{78o6O4XMeyZo82OhX6WtLf6ScjUe9&7K63(d7lWs(pUXO@geCw&XmJGq literal 0 HcmV?d00001 diff --git a/dashboard/app/layout.tsx b/dashboard/app/layout.tsx index d35774f..c63bed9 100644 --- a/dashboard/app/layout.tsx +++ b/dashboard/app/layout.tsx @@ -1,20 +1,52 @@ -import type { Metadata } from "next"; -import { Geist, Geist_Mono } from "next/font/google"; +import type { Metadata, Viewport } from "next"; +import { Geist_Mono } from "next/font/google"; import "./globals.css"; - -const geistSans = Geist({ - variable: "--font-geist-sans", - subsets: ["latin"], -}); +import { Providers } from "./providers"; const geistMono = Geist_Mono({ variable: "--font-geist-mono", subsets: ["latin"], }); +const SITE_DESCRIPTION = + "WorkTrace captures your development sessions in the browser - pages visited, " + + "tags, music, and notes - then turns them into AI-generated session reports."; + export const metadata: Metadata = { - title: "WorkTrace", - description: "Capture and analyze your development session context.", + title: { + default: "WorkTrace - your dev sessions, captured", + template: "%s · WorkTrace", + }, + description: SITE_DESCRIPTION, + applicationName: "WorkTrace", + keywords: [ + "developer productivity", + "session tracking", + "chrome extension", + "ai session report", + "context capture", + ], + authors: [{ name: "WorkTrace" }], + openGraph: { + type: "website", + siteName: "WorkTrace", + title: "WorkTrace - your dev sessions, captured", + description: SITE_DESCRIPTION, + }, + twitter: { + card: "summary", + title: "WorkTrace - your dev sessions, captured", + description: SITE_DESCRIPTION, + }, + robots: { + index: true, + follow: true, + }, +}; + +export const viewport: Viewport = { + themeColor: "#080812", + colorScheme: "dark", }; export default function RootLayout({ @@ -25,9 +57,11 @@ export default function RootLayout({ return ( <html lang="en" - className={`${geistSans.variable} ${geistMono.variable} h-full antialiased`} + className={`${geistMono.variable} h-full antialiased`} > - <body className="min-h-full flex flex-col">{children}</body> + <body className="min-h-full flex flex-col bg-bg text-text"> + <Providers>{children}</Providers> + </body> </html> ); } diff --git a/dashboard/app/login/google-button.tsx b/dashboard/app/login/google-button.tsx index 0110dba..24c3b98 100644 --- a/dashboard/app/login/google-button.tsx +++ b/dashboard/app/login/google-button.tsx @@ -54,7 +54,7 @@ export function GoogleLoginButton({ clientId }: { clientId: string }) { return ( <div className="flex flex-col items-center gap-3"> <div ref={buttonRef} /> - {error && <p className="text-sm text-red-600 dark:text-red-400">{error}</p>} + {error && <p className="text-xs text-pink">{error}</p>} </div> ); } diff --git a/dashboard/app/login/page.tsx b/dashboard/app/login/page.tsx index 259547a..771a88e 100644 --- a/dashboard/app/login/page.tsx +++ b/dashboard/app/login/page.tsx @@ -1,18 +1,36 @@ +import type { Metadata } from "next"; import Script from "next/script"; import { GoogleLoginButton } from "./google-button"; +export const metadata: Metadata = { + title: "Sign in", + description: "Sign in to WorkTrace with Google to view your captured dev sessions.", + robots: { index: false, follow: false }, +}; + export default function LoginPage() { const clientId = process.env.NEXT_PUBLIC_GOOGLE_CLIENT_ID; return ( - <main className="flex flex-1 items-center justify-center bg-zinc-50 dark:bg-black"> - <div className="flex w-full max-w-sm flex-col items-center gap-8 rounded-2xl border border-black/[.08] bg-white p-10 dark:border-white/[.145] dark:bg-zinc-950"> - <div className="flex flex-col items-center gap-2 text-center"> - <h1 className="text-2xl font-semibold tracking-tight text-black dark:text-zinc-50"> - Sign in to WorkTrace - </h1> - <p className="text-sm text-zinc-600 dark:text-zinc-400"> - Continue with the same Google account you use in the extension. + <main className="flex flex-1 items-center justify-center bg-bg"> + <div className="flex w-full max-w-sm flex-col items-center gap-8 rounded-md border border-border bg-surface p-10"> + <div className="flex flex-col items-center gap-3 text-center"> + <div className="flex items-center gap-2"> + <span + className="text-2xl text-cyan" + style={{ filter: "drop-shadow(0 0 6px var(--c-cyan))" }} + > + ⬡ + </span> + <span + className="text-lg font-bold tracking-widest text-cyan" + style={{ textShadow: "0 0 6px color-mix(in srgb, var(--c-cyan) 60%, transparent)" }} + > + WORKTRACE + </span> + </div> + <p className="text-xs text-muted"> + Sign in with the same Google account you use in the extension. </p> </div> @@ -22,7 +40,7 @@ export default function LoginPage() { <GoogleLoginButton clientId={clientId} /> </> ) : ( - <p className="text-sm text-red-600 dark:text-red-400"> + <p className="text-xs text-pink"> NEXT_PUBLIC_GOOGLE_CLIENT_ID is not configured. </p> )} diff --git a/dashboard/app/providers.tsx b/dashboard/app/providers.tsx new file mode 100644 index 0000000..aeac157 --- /dev/null +++ b/dashboard/app/providers.tsx @@ -0,0 +1,20 @@ +"use client"; + +import { useState } from "react"; +import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; + +export function Providers({ children }: { children: React.ReactNode }) { + const [client] = useState( + () => + new QueryClient({ + defaultOptions: { + queries: { + staleTime: 30_000, + refetchOnWindowFocus: false, + }, + }, + }), + ); + + return <QueryClientProvider client={client}>{children}</QueryClientProvider>; +} diff --git a/dashboard/package-lock.json b/dashboard/package-lock.json index 88ac933..5fdf732 100644 --- a/dashboard/package-lock.json +++ b/dashboard/package-lock.json @@ -11,6 +11,7 @@ "@prisma/adapter-pg": "^7.8.0", "@prisma/client": "^7.8.0", "@tanstack/react-query": "^5.100.10", + "chart.js": "^4.5.1", "d3": "^7.9.0", "framer-motion": "^12.38.0", "google-auth-library": "^10.6.2", @@ -20,6 +21,7 @@ "pg": "^8.20.0", "prisma": "^7.8.0", "react": "19.2.4", + "react-chartjs-2": "^5.3.1", "react-dom": "19.2.4", "zod": "^4.4.3" }, @@ -8468,6 +8470,16 @@ "node": ">=0.10.0" } }, + "node_modules/react-chartjs-2": { + "version": "5.3.1", + "resolved": "https://registry.npmjs.org/react-chartjs-2/-/react-chartjs-2-5.3.1.tgz", + "integrity": "sha512-h5IPXKg9EXpjoBzUfyWJvllMjG2mQ4EiuHQFhms/AjUm0XSZHhyRy2xVmLXHKrtcdrPO4mnGqRtYoD0vp95A0A==", + "license": "MIT", + "peerDependencies": { + "chart.js": "^4.1.1", + "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" + } + }, "node_modules/react-dom": { "version": "19.2.4", "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.4.tgz", diff --git a/dashboard/package.json b/dashboard/package.json index 7a73104..8ca5646 100644 --- a/dashboard/package.json +++ b/dashboard/package.json @@ -12,6 +12,7 @@ "@prisma/adapter-pg": "^7.8.0", "@prisma/client": "^7.8.0", "@tanstack/react-query": "^5.100.10", + "chart.js": "^4.5.1", "d3": "^7.9.0", "framer-motion": "^12.38.0", "google-auth-library": "^10.6.2", @@ -21,6 +22,7 @@ "pg": "^8.20.0", "prisma": "^7.8.0", "react": "19.2.4", + "react-chartjs-2": "^5.3.1", "react-dom": "19.2.4", "zod": "^4.4.3" }, diff --git a/dashboard/server/current-user.ts b/dashboard/server/current-user.ts new file mode 100644 index 0000000..7de1203 --- /dev/null +++ b/dashboard/server/current-user.ts @@ -0,0 +1,25 @@ +import { cache } from "react"; +import { cookies } from "next/headers"; +import { SESSION_COOKIE } from "@/server/cookies"; +import { verifyJwt } from "@/server/jwt"; +import { findUserById, type UserHeader } from "@/server/users"; + +export type CurrentUser = UserHeader & { id: string }; + +// Cached per React render: layout + page in the same request share one verify + one db read. +export const getCurrentUser = cache(async (): Promise<CurrentUser | null> => { + const token = (await cookies()).get(SESSION_COOKIE)?.value; + if (!token) return null; + + let userId: string; + try { + ({ sub: userId } = await verifyJwt(token)); + } catch { + return null; + } + + const user = await findUserById(userId); + if (!user) return null; + + return { id: userId, ...user }; +}); diff --git a/dashboard/server/events.ts b/dashboard/server/events.ts index cc0d046..c926e12 100644 --- a/dashboard/server/events.ts +++ b/dashboard/server/events.ts @@ -1,4 +1,10 @@ -import type { CreateEventInput } from "./schemas/events"; +import { Prisma } from "@/generated/prisma/client"; +import type { + CreateEventInput, + EventListFilters, + EventStatsFilters, +} from "./schemas/events"; +import type { EventDTO, EventStats } from "@/types/event"; import { prisma } from "./db"; export class SessionNotFoundError extends Error { @@ -20,3 +26,99 @@ export async function createEventForUser( return prisma.event.create({ data: input }); } + +export type EventsPage = { + events: EventDTO[]; + nextCursor: string | null; +}; + +export async function listEventsForUser( + userId: string, + filters: EventListFilters, +): Promise<EventsPage> { + const timestamp: Prisma.DateTimeFilter = {}; + if (filters.from) timestamp.gte = filters.from; + if (filters.to) timestamp.lte = filters.to; + + const limit = filters.limit ?? 50; + + const rows = await prisma.event.findMany({ + where: { + session: { userId }, + ...(Object.keys(timestamp).length ? { timestamp } : {}), + ...(filters.tags.length ? { tags: { hasEvery: filters.tags } } : {}), + }, + orderBy: [{ timestamp: "desc" }, { id: "desc" }], + take: limit + 1, + ...(filters.cursor ? { cursor: { id: filters.cursor }, skip: 1 } : {}), + }); + + const hasMore = rows.length > limit; + const page = hasMore ? rows.slice(0, limit) : rows; + + return { + events: page.map((r) => ({ + id: r.id, + sessionId: r.sessionId, + url: r.url, + title: r.title, + content: r.content, + tags: r.tags, + timestamp: r.timestamp.toISOString(), + })), + nextCursor: hasMore ? page[page.length - 1].id : null, + }; +} + +const MIN_DATE = new Date("1970-01-01T00:00:00.000Z"); +const MAX_DATE = new Date("9999-12-31T23:59:59.999Z"); + +export async function getEventStatsForUser( + userId: string, + filters: EventStatsFilters, +): Promise<EventStats> { + const from = filters.from ?? MIN_DATE; + const to = filters.to ?? MAX_DATE; + const tags = filters.tags; + + const tagsFilter = tags.length + ? Prisma.sql`AND e.tags @> ${tags}::text[]` + : Prisma.empty; + + const [byDayRows, topTagRows] = await Promise.all([ + prisma.$queryRaw<{ day: Date; count: bigint }[]>(Prisma.sql` + SELECT date_trunc('day', e."timestamp") AS day, COUNT(*) AS count + FROM "Event" e + JOIN "Session" s ON s.id = e."sessionId" + WHERE s."userId" = ${userId} + AND e."timestamp" >= ${from} + AND e."timestamp" <= ${to} + ${tagsFilter} + GROUP BY day + ORDER BY day ASC + `), + prisma.$queryRaw<{ tag: string; count: bigint }[]>(Prisma.sql` + SELECT tag, COUNT(*)::bigint AS count + FROM ( + SELECT unnest(e.tags) AS tag + FROM "Event" e + JOIN "Session" s ON s.id = e."sessionId" + WHERE s."userId" = ${userId} + AND e."timestamp" >= ${from} + AND e."timestamp" <= ${to} + ${tagsFilter} + ) t + GROUP BY tag + ORDER BY count DESC + LIMIT 7 + `), + ]); + + return { + byDay: byDayRows.map((r) => ({ + date: r.day.toISOString().slice(0, 10), + count: Number(r.count), + })), + topTags: topTagRows.map((r) => ({ tag: r.tag, count: Number(r.count) })), + }; +} diff --git a/dashboard/server/jwt.ts b/dashboard/server/jwt.ts index 0df97e0..9dbae38 100644 --- a/dashboard/server/jwt.ts +++ b/dashboard/server/jwt.ts @@ -1,6 +1,7 @@ import type { NextRequest } from "next/server"; import jwt from "jsonwebtoken"; import { jwtVerify } from "jose"; +import { SESSION_COOKIE } from "@/server/cookies"; export class UnauthorizedError extends Error { constructor(message = "Unauthorized") { @@ -35,13 +36,18 @@ export async function verifyJwt(token: string): Promise<JwtPayload> { return payload; } -export function requireUser(req: NextRequest): { id: string; email: string } { +function extractToken(req: NextRequest): string | null { const header = req.headers.get("authorization"); - if (!header?.startsWith("Bearer ")) { - throw new UnauthorizedError("Missing or malformed Authorization header"); + if (header?.startsWith("Bearer ")) { + const t = header.slice("Bearer ".length).trim(); + if (t) return t; } - const token = header.slice("Bearer ".length).trim(); - if (!token) throw new UnauthorizedError("Empty bearer token"); + return req.cookies.get(SESSION_COOKIE)?.value ?? null; +} + +export function requireUser(req: NextRequest): { id: string; email: string } { + const token = extractToken(req); + if (!token) throw new UnauthorizedError("Missing authentication credentials"); const secret = process.env.JWT_SECRET; if (!secret) throw new Error("JWT_SECRET is not set"); diff --git a/dashboard/server/schemas/events.ts b/dashboard/server/schemas/events.ts index ee7ac33..d10066c 100644 --- a/dashboard/server/schemas/events.ts +++ b/dashboard/server/schemas/events.ts @@ -10,3 +10,31 @@ export const CreateEventInput = EventUncheckedCreateInputObjectZodSchema }); export type CreateEventInput = z.infer<typeof CreateEventInput>; + +const tagsSchema = z + .string() + .optional() + .transform((s) => + (s ?? "") + .split(",") + .map((t) => t.trim()) + .filter(Boolean), + ); + +export const EventListFilters = z.object({ + from: z.coerce.date().optional(), + to: z.coerce.date().optional(), + cursor: z.string().optional(), + limit: z.coerce.number().int().min(1).max(100).optional().default(30), + tags: tagsSchema, +}); + +export type EventListFilters = z.infer<typeof EventListFilters>; + +export const EventStatsFilters = z.object({ + from: z.coerce.date().optional(), + to: z.coerce.date().optional(), + tags: tagsSchema, +}); + +export type EventStatsFilters = z.infer<typeof EventStatsFilters>; diff --git a/dashboard/server/sessions.ts b/dashboard/server/sessions.ts index 5aea255..af486e1 100644 --- a/dashboard/server/sessions.ts +++ b/dashboard/server/sessions.ts @@ -1,3 +1,5 @@ +import { Prisma } from "@/generated/prisma/client"; +import type { TopSession } from "@/types/event"; import { prisma } from "./db"; export class SessionNotFoundError extends Error { @@ -26,3 +28,91 @@ export async function endSessionForUser(userId: string, sessionId: string) { select: { id: true, endedAt: true }, }); } + +// Caps a single event's "attention" at 30 min — prevents long idle gaps inflating totals. +// The final event of a session has no successor → 0s contribution, so total = last − first timestamp. +const EVENT_DURATION_CAP_S = 1800; +const RECENT_WINDOW_DAYS = 90; + +export async function getTopSessionsForUser( + userId: string, + limit = 3, +): Promise<TopSession[]> { + const rows = await prisma.$queryRaw<{ + id: string; + startedAt: Date; + endedAt: Date | null; + total_seconds: number; + top_host: string | null; + top_host_seconds: number; + }[]>(Prisma.sql` + WITH event_durations AS ( + SELECT + e."sessionId", + substring(e.url FROM '^https?://([^/]+)') AS host, + LEAST( + GREATEST( + COALESCE( + EXTRACT(EPOCH FROM ( + LEAD(e."timestamp") OVER (PARTITION BY e."sessionId" ORDER BY e."timestamp") - e."timestamp" + )), + 0 + ), + 0 + ), + ${EVENT_DURATION_CAP_S} + ) AS dur_s + FROM "Event" e + JOIN "Session" s ON s.id = e."sessionId" + WHERE s."userId" = ${userId} + AND e."timestamp" >= NOW() - (${RECENT_WINDOW_DAYS} || ' days')::interval + ), + host_totals AS ( + SELECT + "sessionId", + host, + SUM(dur_s) AS host_s + FROM event_durations + WHERE host IS NOT NULL + GROUP BY "sessionId", host + ), + session_totals AS ( + SELECT + "sessionId", + SUM(dur_s) AS total_s + FROM event_durations + GROUP BY "sessionId" + ), + top_host_per_session AS ( + SELECT DISTINCT ON ("sessionId") + "sessionId", + host AS top_host, + host_s AS top_host_s + FROM host_totals + ORDER BY "sessionId", host_s DESC + ) + SELECT + s.id, + s."startedAt" AS "startedAt", + s."endedAt" AS "endedAt", + COALESCE(st.total_s, 0)::float AS total_seconds, + th.top_host AS top_host, + COALESCE(th.top_host_s, 0)::float AS top_host_seconds + FROM "Session" s + LEFT JOIN session_totals st ON st."sessionId" = s.id + LEFT JOIN top_host_per_session th ON th."sessionId" = s.id + WHERE s."userId" = ${userId} + AND COALESCE(st.total_s, 0) > 0 + ORDER BY total_seconds DESC + LIMIT ${limit} + `); + + return rows.map((r) => ({ + id: r.id, + startedAt: r.startedAt.toISOString(), + endedAt: r.endedAt ? r.endedAt.toISOString() : null, + totalSeconds: Math.round(Number(r.total_seconds)), + topHost: r.top_host, + topHostSeconds: Math.round(Number(r.top_host_seconds)), + })); +} diff --git a/dashboard/server/users.ts b/dashboard/server/users.ts new file mode 100644 index 0000000..8b03695 --- /dev/null +++ b/dashboard/server/users.ts @@ -0,0 +1,14 @@ +import { prisma } from "@/server/db"; + +export type UserHeader = { + email: string; + name: string | null; + picture: string | null; +}; + +export async function findUserById(id: string): Promise<UserHeader | null> { + return prisma.user.findUnique({ + where: { id }, + select: { email: true, name: true, picture: true }, + }); +} diff --git a/dashboard/types/event.ts b/dashboard/types/event.ts new file mode 100644 index 0000000..0de4917 --- /dev/null +++ b/dashboard/types/event.ts @@ -0,0 +1,26 @@ +export type EventDTO = { + id: string; + sessionId: string; + url: string; + title: string; + content: string | null; + tags: string[]; + timestamp: string; +}; + +export type DayBucket = { date: string; count: number }; +export type TagCount = { tag: string; count: number }; + +export type EventStats = { + byDay: DayBucket[]; + topTags: TagCount[]; +}; + +export type TopSession = { + id: string; + startedAt: string; + endedAt: string | null; + totalSeconds: number; + topHost: string | null; + topHostSeconds: number; +}; diff --git a/plans/backlog/post-week3-tech-debt.md b/plans/backlog/post-week3-tech-debt.md new file mode 100644 index 0000000..f83df6f --- /dev/null +++ b/plans/backlog/post-week3-tech-debt.md @@ -0,0 +1,75 @@ +# Backlog: Tech debt from Week 3 AC 2 review + +**Пріоритет:** low/medium, ергономіка та чистота коду +**Залежить від:** Week 3 AC 2 (merged) +**Статус:** не розпочато + +--- + +## Контекст + +Під час self-review гілки `feature/dashboard-event-feed` виявлено два пункти, які доцільно зробити **поза цією гілкою** — бо вони зачіпають код, що написаний раніше, або міняють контракт відразу в кількох роутах. Свідомо відкладено, щоб PR залишився сфокусованим на AC 2. + +--- + +## 1. JWT-bibліотека уніфікація — `jose` всюди + +### Зараз +- `dashboard/server/jwt.ts` має **дві** функції верифікації: + - `verifyJwt(token)` — на `jose`, async, працює і в edge (middleware), і у Node (Server Components) + - `requireUser(req)` — на `jsonwebtoken`, sync, Node-only, використовується у всіх Route Handler'ах (`/api/v1/events`, `/api/v1/sessions`, `/api/v1/tracks`) +- Один і той самий HS256 секрет валідується двома різними бібліотеками. Це працює (HMAC-SHA256 — стандарт), але: + - `jsonwebtoken` + `@types/jsonwebtoken` — зайва runtime + типова залежність + - дві шляхи верифікації — два місця де треба поправити при зміні алгоритму чи rotation logic + - issue/sign все одно на `jsonwebtoken` (`server/auth.ts:issueJWT`) — половинчасто + +### Бажано +- `requireUser(req)` стає `async`, всередині викликає `verifyJwt(token)` з `jose` +- Усі route handlers додають `await` (вони вже `async`) +- `issueJWT` переписується на `new SignJWT(...)` з `jose` +- `jsonwebtoken` + `@types/jsonwebtoken` видаляються з `package.json` + +### Ризик +- Низький: підпис байт-у-байт сумісний (HS256 над тим самим секретом) +- Існуючий extension з валідним токеном залишається працювати — нічого не ротуємо +- Тестується через існуючий `POST /api/v1/events` з Bearer токеном extension'а + +### Декомпозиція +``` +1. refactor(server): port issueJWT and requireUser to jose +2. chore(deps): remove jsonwebtoken and @types/jsonwebtoken +3. test: regression — Bearer-flow from extension, cookie-flow from dashboard +``` + +--- + +## 2. QueryClient `.clear()` після logout + +### Зараз +- `dashboard/app/dashboard/logout-button.tsx` шле `POST /api/auth/logout` → `router.replace("/login")` + `router.refresh()` +- `QueryClient` живе у `dashboard/app/providers.tsx` через `useState(() => new QueryClient(...))` — це singleton поки tab live +- Якщо user A вийшов, user B зайшов **у тій самій вкладці без перезавантаження** — TanStack кеш не очищується. user B на момент першого пасивного рендеру може побачити кеш від user A (доки `staleTime` не вийшов) + +На практиці `router.refresh()` робить full Server Components re-render → новий prefetch → новий hydrate → старий кеш переписується. Але: +- Перед першим прибуттям свіжих даних може спалахнути stale UI (на 50-200 мс) +- TanStack-кеш для `["top-sessions"]` теж зберігається, бо queryKey не залежить від userId + +### Бажано +- У `LogoutButton.onClick` додати `queryClient.clear()` (через `useQueryClient()`) перед `router.replace` +- Або (стійкіше): мати у QueryClient subscriber на `wt_session` cookie change і автоматично clear + +### Ризик +- Дуже низький — це фронт-only +- Один новий рядок коду + +### Декомпозиція +``` +1. fix(dashboard): clear tanstack cache on logout +``` + +--- + +## Чому не зробили зараз + +- **JWT**: зачіпає 4+ route handlers поза scope AC 2. PR має бути сфокусованим на стрічці подій. Окремий PR `chore: jwt unification` рев'юється легше і не блокує feature merge. +- **QueryClient clear**: код у `logout-button.tsx` фактично не змінений у цій гілці (тільки стиль кнопки). Логіка logout — це AC 1 territory. Краще додати окремою fix-гілкою щоб не розмивати focus AC 2. diff --git a/plans/backlog/stale-sessions-cleanup.md b/plans/backlog/stale-sessions-cleanup.md new file mode 100644 index 0000000..97fee67 --- /dev/null +++ b/plans/backlog/stale-sessions-cleanup.md @@ -0,0 +1,74 @@ +# Backlog: Stale-session auto-cleanup + +**Пріоритет:** medium, після MVP demo +**Залежить від:** Week 2 AC 3 (session manager), Week 3 AC 2 (top-sessions panel) +**Статус:** не розпочато + +--- + +## Проблема (виявлено під час Week 3 AC 2) + +`Session.endedAt` ставиться **тільки** коли extension явно надсилає `POST /api/v1/sessions/[id]` зі stop-маркером — або з popup'у через кнопку "■ STOP", або з auto-stop-логіки в `background/session.ts`. Якщо service worker заснув, браузер закрився, або юзер просто перестав ним користуватись — запис лишається `endedAt = NULL` назавжди. + +Спостережене на dev-БД (станом 2026-05-27): +- юзер мав 2 одночасні `endedAt = NULL` сесії — одну стартовану сьогодні, другу 2 дні тому +- стара сесія мала 66 events за 1h 10m реальної активності і потрапила у `TOP 3 SESSIONS` як "активна" +- візуально у дашборді це виглядає як неточність, хоча математика правильна (`SUM(event-durations)` — точне) + +**Це не баг алгоритму:** `byDay` / `topTags` / `topHostSeconds` / `totalSeconds` рахуються коректно. Це баг **lifecycle'у сесії**: live-state не синхронізується з БД при втраті екстеншна. + +--- + +## Підходи (від найдешевшого до найповнішого) + +### 1. SQL-filter "recently active" в `getTopSessionsForUser` + +``` +AND (s."endedAt" IS NOT NULL OR <last event timestamp> >= NOW() - INTERVAL '24 hours') +``` + +- **+** zero-cost, не чіпає БД +- **−** маскує проблему; "загублені" сесії все одно сидять у БД і впливають на майбутні агрегації + +### 2. Auto-close при кожному `GET /api/v1/sessions/top` + +`UPDATE "Session" SET "endedAt" = (SELECT MAX(timestamp) FROM "Event" WHERE "sessionId" = id) WHERE "endedAt" IS NULL AND <last event> < NOW() - INTERVAL '1 hour'` + +- **+** очищує БД "by use" +- **−** write на кожному GET читачі = поганий патерн (особливо для cold-cache scenarios), porno-write при високому traffic + +### 3. Cron job (Recommended) + +Окремий джоб, який раз на 15 хв пробігається через відкриті сесії і закриває ті, де `MAX(event.timestamp) < NOW() - INTERVAL '30 minutes'`. Реалізації: + +**3a. Vercel Cron** — `vercel.json` з `crons: [{ path: "/api/cron/close-stale-sessions", schedule: "*/15 * * * *" }]`. Route Handler захищений `Authorization: Bearer ${CRON_SECRET}`. Vercel сам викликає його на schedule (free tier — 2 invocations/day, hobby — необмежено). + +**3b. PostgreSQL `pg_cron`** — суто SQL-job на стороні Neon/Postgres. Не потребує route handler, але vendor-specific (на локальному Postgres треба установлювати extension). + +**3c. Зовнішній GitHub Actions cron** — `.github/workflows/close-stale.yml` з `schedule: cron: "*/15 * * * *"` + step що шле HTTP до Vercel-роуту. Працює для будь-якого хосту, але GH-Actions schedule не гарантує точність (може спізнитись на 10+ хв при високому навантаженні). + +**Рекомендовано:** 3a (Vercel Cron) — найменше movable parts, інфра вже на Vercel. + +### 4. Client-side keepalive + server-side TTL + +Extension шле `PUT /api/v1/sessions/[id]/heartbeat` кожні 5 хв доки активна. Серверний крон закриває сесії без heartbeat'а за останні 15 хв. Близько до 3, але потребує і клієнтських змін. + +--- + +## Декомпозиція (для майбутнього плану) + +``` +1. docs(plans): stale-session cleanup plan +2. feat(server): add closeStaleSessions(thresholdMinutes) in server/sessions.ts +3. feat(dashboard): add /api/cron/close-stale-sessions route + CRON_SECRET env +4. chore: register vercel.json cron schedule */15 * * * * +5. test: write down end-to-end check (insert stale session → run cron → assert closed) +``` + +--- + +## Open questions + +- Який поріг "stale"? 30 хв безактивності — здається безпечним. Менше — ризик закрити активного юзера що зробив паузу +- Що робити з повністю "порожніми" сесіями (`startedAt` є, events = 0)? Видаляти чи закривати з `endedAt = startedAt`? +- Чи показувати у дашборді сесії що були закриті cron'ом інакше (badge "auto-closed")? diff --git a/plans/week3/AC2-event-feed.md b/plans/week3/AC2-event-feed.md new file mode 100644 index 0000000..6c6e8cd --- /dev/null +++ b/plans/week3/AC2-event-feed.md @@ -0,0 +1,231 @@ +# Plan: Week 3 AC 2 — Event Feed + +**Branch:** `feature/dashboard-event-feed` +**Closes:** Week 3 AC 2 ([docs/Task.md L88](../../docs/Task.md#L88)) +**Status:** plan, awaiting review + +--- + +## Scope + +Сторінка `/dashboard` показує хронологічну стрічку подій поточного юзера з фільтрацією по даті та тегах. Дані тягнуться через TanStack Query (вимога AC). Auth — та сама cookie `wt_session` з Week 3 AC 1. + +Додатково — згідно з умовами: +1. **Візуальна узгодженість з extension.** Виносимо токени з `extension/src/popup/popup.css` у `dashboard/app/globals.css` (CSS variables: `--c-cyan`, `--c-purple`, `--c-yellow`, `--c-pink`, `--c-bg`, `--c-surface`, `--c-border`, `--c-text`, `--c-muted`) + `Courier New` monospace. Tailwind v4 `@theme` мапить ці змінні у utility-класи (`bg-bg`, `text-cyan`, `border-border`), щоб користуватись Tailwind, а не сирим CSS. Старі `bg-zinc-*`/`dark:` класи у `/login` та `/dashboard/page.tsx` замінюються на нову палітру. +2. **Фіксована шапка.** Новий `dashboard/app/dashboard/layout.tsx` зі sticky `<header>`: ліворуч лого `⬡ WORKTRACE` (як у popup), праворуч — аватар (`picture` з Google) + email + кнопка logout. Хедер видно тільки на залогінених сторінках, відсутній на `/login`. +3. **2 графіки (Chart.js).** На головній `/dashboard` під фільтрами рендеримо два маленькі чарта над feed'ом: + - **Events per day** (line chart) — активність по днях у вибраному інтервалі. Допомагає юзеру побачити свої "робочі" та "тихі" дні. + - **Top tags** (doughnut chart) — топ-7 тегів за кількістю подій у поточному фільтрі. Допомагає зрозуміти, на що йде увага. + +Обидва чарта читають той самий кеш TanStack Query (`["events", filters]`), тобто реагують на фільтри без додаткового запиту. + +--- + +## Commits (ordered) + +``` +1. docs(plans): update week 3 AC 2 event feed plan +2. style(dashboard): port extension color tokens and add sticky app header +3. feat(dashboard): allow cookie auth in requireUser and add GET /api/v1/events +4. feat(dashboard): render event feed on /dashboard with tanstack query +5. feat(dashboard): add events-per-day and top-tags charts above the feed +6. fix(dashboard): address review feedback for week 3 AC 2 ← reserved +``` + +> Commit 1 — план. Commit 6 — резерв під правки після рев'ю PR. Якщо рев'юер апрувить без зауважень — 6-й комміт не створюється. + +--- + +## Files + +| File | Action | Commit | +|---|---|---| +| `plans/week3/AC2-event-feed.md` | **rewrite** | 1 | +| `dashboard/app/globals.css` | modify — додати extension-токени + `@theme inline` mapping для Tailwind v4 | 2 | +| `dashboard/app/layout.tsx` | modify — прибрати Geist (залишити Geist Mono як `--font-mono`), `<body>` фоном `bg-bg text-text` | 2 | +| `dashboard/app/login/page.tsx` | modify — замінити zinc/dark на нову палітру | 2 | +| `dashboard/app/login/google-button.tsx` | modify — кнопка тим самим стилем що `btn btn--primary` у popup | 2 | +| `dashboard/app/dashboard/layout.tsx` | **new** — sticky header (logo + email + avatar + logout); `<main>` нижче | 2 | +| `dashboard/app/dashboard/app-header.tsx` | **new** — Server Component, читає cookie → `verifyJwt` → `findUser`, рендерить header | 2 | +| `dashboard/server/users.ts` | **new** — `findUserById(id): { email, name, picture }` (для аватарки в header) | 2 | +| `dashboard/app/dashboard/logout-button.tsx` | modify — `btn btn--logout` стиль, той самий що в popup | 2 | +| `dashboard/server/jwt.ts` | modify — `requireUser` fallback на cookie `wt_session` (Bearer → cookie → 401) | 3 | +| `dashboard/server/schemas/events.ts` | modify — додати `EventListFilters` (from/to/tags) | 3 | +| `dashboard/server/events.ts` | modify — додати `listEventsForUser(userId, filters)` | 3 | +| `dashboard/app/api/v1/events/route.ts` | modify — додати GET handler | 3 | +| `dashboard/types/event.ts` | **new** — `EventDTO` (DTO для client+server) | 3 | +| `dashboard/app/providers.tsx` | **new** — Client `QueryClientProvider` через `useState(() => new QueryClient(...))` | 4 | +| `dashboard/app/layout.tsx` | modify — обернути `{children}` у `<Providers>` | 4 | +| `dashboard/app/dashboard/page.tsx` | **rewrite** — auth + prefetch `["events", filters]` + `<HydrationBoundary>` | 4 | +| `dashboard/app/dashboard/event-feed.tsx` | **new** — Client `useQuery` + список + empty/loading/error states | 4 | +| `dashboard/app/dashboard/event-filters.tsx` | **new** — Client форма (from, to, tags) → controlled state у parent | 4 | +| `dashboard/app/dashboard/event-card.tsx` | **new** — рендер одного event-row (картка у стилі `popup__sync` / `popup__track`) | 4 | +| `dashboard/app/dashboard/charts.tsx` | **new** — Client wrapper: `useQuery` тих самих `["events", filters]` + рендер двох канвасів | 5 | +| `dashboard/app/dashboard/events-by-day-chart.tsx` | **new** — Client Chart.js `Line` + хелпер `bucketByDay(events, from, to)` | 5 | +| `dashboard/app/dashboard/top-tags-chart.tsx` | **new** — Client Chart.js `Doughnut` + хелпер `topNTags(events, n=7)` | 5 | +| `dashboard/package.json` | modify — `chart.js`, `react-chartjs-2` | 5 | + +--- + +## Design decisions + +### 1. Auth у `requireUser` — extend, не дублювати + +Web викликає `/api/v1/events` з браузера → є тільки cookie. Extension викликає з service worker → є тільки `Authorization: Bearer`. Один endpoint обслуговує обидва. + +Розширюю існуючий `requireUser(req)`: +``` +1. Якщо є Authorization: Bearer … → поточна гілка через jsonwebtoken +2. Інакше — читаємо cookie wt_session. Якщо є → той самий verify +3. Інакше → UnauthorizedError +``` + +Той самий секрет, той самий формат, той самий публічний API → жодних змін у інших роутах і у extension. + +### 2. Дизайн-токени з extension — у Tailwind, не у сирому CSS + +В `globals.css` додаю `:root` блок з тими ж 9 змінних з `popup.css`, плюс `@theme inline { --color-cyan: var(--c-cyan); ... }` — це Tailwind v4 синтаксис, що породжує utility-класи `bg-bg`, `text-cyan`, `border-border` тощо. Шрифт — `Courier New` як у extension (через `--font-mono` змінну, що вже існує у layout). + +Чому так, а не `<style>` з класами `popup__*` у дашборді: потрібно реактивно стилізувати чарти і нові компоненти, чарти й самі є React-ами — Tailwind utility-класи інтегруються одразу. БЕМ-класи з extension'a залишаються у самому extension (popup є HTML/CSS, дашборд — JSX). + +### 3. Sticky хедер — у `/dashboard/layout.tsx`, не у root layout + +Хедер потрібен **лише** на залогінених сторінках. `/login` має бути без нього (як і зараз — повноекранна форма). Створюю `dashboard/app/dashboard/layout.tsx` — Next App Router автоматично оборачує всі `/dashboard/*` сторінки в нього. Так `/login` лишається чистим. + +`<header className="sticky top-0 z-10 ...">` + `<main className="...">{children}</main>`. Аватарка з `picture` юзера (поле вже є у Prisma-моделі `User`, заповнюється у `authenticateGoogleUser` з `verifyIdToken` payload). + +### 4. Аватарка — `<img>` з Google CDN, не `next/image` + +`next/image` потребує налаштування `images.remotePatterns` для `lh3.googleusercontent.com` і додає runtime overhead для тривіальної 32px іконки. Звичайний `<img src={user.picture}>` із fallback'ом (ініціал email у кружечку, якщо `picture === null`) — простіше і без додаткової конфігурації. + +### 5. Графіки — Chart.js (`react-chartjs-2`), не D3 + +D3 у стеці на тиждень 3 бонус AC 4 (музична аналітика). Для двох простих чартів над feed'ом — Chart.js достатній: 50 рядків коду на чарт замість 200, треекшейкається до `LineController` + `DoughnutController`. D3 лишимо для бонусу AC 4 де потрібні нестандартні візуалізації (наприклад "heatmap by hour"). + +Реєстрація скейлів — у `dashboard/app/dashboard/charts.tsx` один раз (`ChartJS.register(...)`). Кожен чарт-компонент — окремий клієнтський островок, бо Chart.js потребує DOM. + +### 6. Дані для чартів — той самий queryKey, без додаткових fetch'ів + +``` +event-feed.tsx useQuery(["events", filters]) → fetchEvents +events-by-day-chart useQuery(["events", filters]) → fetchEvents ← cache hit +top-tags-chart useQuery(["events", filters]) → fetchEvents ← cache hit +``` + +TanStack Query дедуплікує по `queryKey`, тому реально летить **один** запит за фільтр. Це й мотивація використати TanStack Query (а не Server Action) — без нього довелось би прокидати props з parent'а, або кешувати руками. + +Біз-логіку агрегації (bucketByDay, topNTags) тримаю в самих чарт-компонентах — це не "бізнес-логіка" в сенсі CLAUDE.md (там йдеться про DB-доступ і auth), це візуалізаційна агрегація даних, які вже на клієнті. + +### 7. Tag filter: `hasEvery` (AND) + +Якщо юзер обрав `["react", "next"]` — показуємо події з **обома**. Для feed'а AND — корисніший фільтр (звужує до перетину інтересів), OR — практично те саме, що "усі події". Prisma: `tags: { hasEvery: input.tags }`. Якщо `tags` порожній — фільтр не застосовуємо. + +### 8. Дати + cap 200 + +``` +where: { session: { userId }, timestamp: { gte: from, lte: to }, tags: tags.length ? { hasEvery: tags } : undefined } +orderBy: { timestamp: "desc" } +take: 200 +``` + +Pagination не входить у AC. Без cap великий діапазон може втягнути тисячі рядків + важко рендерити чарти. 200 — комфортний верхній bound. Це коментується одним рядком у `listEventsForUser` як єдиний legitimate коментар у файлі. + +### 9. TanStack Query: SSR prefetch + client hydrate + +Server Component `/dashboard/page.tsx`: +1. Verify cookie → userId (як зараз) +2. `const qc = new QueryClient()` +3. `await qc.prefetchQuery({ queryKey: ["events", filters], queryFn: () => listEventsForUser(userId, defaultFilters) })` — **прямий виклик server-модулю, без HTTP** +4. `<HydrationBoundary state={dehydrate(qc)}>` обгортає feed + charts + +Це канонічний патерн Next App Router + TanStack: швидкий first paint без spinner + клієнтська реактивність на фільтри. + +### 10. QueryClient — `defaultOptions` під SSR + +``` +queries: { staleTime: 30_000, refetchOnWindowFocus: false } +``` + +`useState(() => new QueryClient(...))` у `providers.tsx` — щоб у StrictMode не пересоздавався. + +### 11. DTO для event'у — окремий тип, не реекспорт Prisma + +```ts +// dashboard/types/event.ts +export type EventDTO = { + id: string; + sessionId: string; + url: string; + title: string; + content: string | null; + tags: string[]; + timestamp: string; // ISO; Date серіалізується для client bundle +}; +``` + +### 12. URL-state vs local — local + +MVP — `useState` фільтрів. Не серіалізуємо у URL. Share-link / back-forward для фільтрів — out of scope. + +### 13. Tags input — comma-separated, як у popup + +`<input placeholder="react, typescript" />` → `.split(",").map(t => t.trim()).filter(Boolean)`. Узгоджено з `popup__field-input` (TAGS) у extension. + +### 14. Empty / loading / error states + +- **Loading** (тільки після зміни фільтрів — перший рендер з prefetch) — три skeleton-картки кольору `--c-surface` +- **Empty** — повідомлення + підказка очистити фільтри +- **Error** — повідомлення `--c-pink` + кнопка `refetch()` + +### 15. Чарти — стан коли подій 0 + +`events-by-day` показує всі дні діапазону з `0` (line на нулі). `top-tags` — рендерить пусту doughnut + плейсхолдер "No tags in range". Це краще, ніж приховувати чарти при empty filter — UI лишається стабільним. + +--- + +## Verification checklist + +### Backend +- [ ] `cd dashboard && npx tsc --noEmit` — без помилок +- [ ] `npm run build` — без помилок +- [ ] `GET /api/v1/events` без cookie і без Bearer → 401 +- [ ] `GET /api/v1/events` з невалідною cookie → 401 +- [ ] `GET /api/v1/events` з валідною cookie → 200, події **тільки** поточного юзера +- [ ] `GET /api/v1/events` з extension Bearer token → 200 (регрес: один endpoint для обох) +- [ ] `GET /api/v1/events?from=...&to=...` — повертає лише події у діапазоні +- [ ] `GET /api/v1/events?tags=react,typescript` — повертає події з ОБОМА тегами +- [ ] `POST /api/v1/events` все ще працює (без регресу від `requireUser` змін) + +### UI / стилі +- [ ] `/dashboard` без cookie → 307 → `/login` (regression від AC 1) +- [ ] `/dashboard` з cookie → рендер feed без спіннера (prefetch ок) +- [ ] Sticky хедер видно при скролі feed'а +- [ ] Хедер показує email + аватарку Google (або fallback-ініціал) +- [ ] `/login` — без хедера, кольори у новій палітрі +- [ ] Logout працює, після logout редірект на `/login` (regression від AC 1) + +### Чарти +- [ ] Events-per-day line чарт відображає дні діапазону +- [ ] При зміні `from`/`to` чарт перемальовується без додаткового мережевого запиту (DevTools → Network) +- [ ] Top-tags doughnut показує топ-7 тегів з легендою +- [ ] При `tags=react,next` фільтрі чарт показує лише ці теги (тривіальний випадок) +- [ ] При empty result — чарти не падають, показують пусті стани + +### Feed +- [ ] Зміна `from` → запит летить, оновлений список +- [ ] Введення `react, next` у tags → запит з `tags=react%2Cnext`, лишаються події з обома +- [ ] Empty state видно коли фільтр нічого не дав +- [ ] Error state видно при `fetch` помилці (вимкнути сервер → змінити фільтр) + +--- + +## Out of scope + +- Pagination / infinite scroll — cap 200 +- Tag autocomplete / chips UI — comma input достатній +- Share / URL-state для фільтрів — local state +- Realtime push подій з extension (WebSocket / SSE) — Week 4 polish, якщо взагалі +- Bonus AC 5 (error toasts) — наступний AC у тижні +- Сесійні групи / групування подій по сесії — feed чисто хронологічний +- Анімації появи карток / переходів між сторінками — Week 4 бонус AC 4 +- Музична аналітика і D3 — Week 3 бонус AC 4 From 29207483d21722696af8b994fda6391e1dbc4274 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Thu, 28 May 2026 20:02:30 +0300 Subject: [PATCH 16/24] feat(dashboard): Week 3 AC 3 - AI session report with Groq LLM, token sampling, and API key management (#16) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(plans): add week 3 AC 3 ai session report plan * feat(dashboard): add UserSetting model and encrypted groq api key endpoints * feat(dashboard): add groq client and report context builder with token-budget sampling * feat(ai): add reports/generate route and /dashboard/reports page with markdown render and download * feat(reports): API key modal portal + fix Groq 413 token budget Lower INPUT_TOKEN_BUDGET 30k→7.5k so context fits Groq free-tier 12k TPM limit; add GroqContextLimitError (413) with user-facing message. Wire up ApiKeyModal (createPortal) with save/clear flow on /dashboard/reports. * fix(ui): chips+actions same row, burger on far right, wider logo gap --- dashboard/.env.example | 14 + .../app/api/v1/reports/generate/route.ts | 76 + dashboard/app/api/v1/user/settings/route.ts | 51 + dashboard/app/dashboard/app-header.tsx | 32 +- dashboard/app/dashboard/header-nav.tsx | 33 + dashboard/app/dashboard/mobile-nav.tsx | 76 + .../app/dashboard/reports/api-key-modal.tsx | 125 ++ .../app/dashboard/reports/markdown-view.tsx | 49 + dashboard/app/dashboard/reports/page.tsx | 24 + .../app/dashboard/reports/report-form.tsx | 257 +++ .../app/dashboard/reports/reports-client.ts | 46 + dashboard/package-lock.json | 1581 ++++++++++++++++- dashboard/package.json | 2 + .../migration.sql | 12 + dashboard/prisma/schema.prisma | 19 +- dashboard/server/cors.ts | 2 +- dashboard/server/crypto.ts | 45 + dashboard/server/groq.ts | 95 + dashboard/server/report-context.ts | 394 ++++ dashboard/server/reports.ts | 131 ++ dashboard/server/schemas/reports.ts | 27 + dashboard/server/schemas/user-settings.ts | 8 + dashboard/server/user-settings.ts | 52 + dashboard/types/report.ts | 17 + plans/week3/AC3-ai-session-report.md | 400 +++++ 25 files changed, 3486 insertions(+), 82 deletions(-) create mode 100644 dashboard/app/api/v1/reports/generate/route.ts create mode 100644 dashboard/app/api/v1/user/settings/route.ts create mode 100644 dashboard/app/dashboard/header-nav.tsx create mode 100644 dashboard/app/dashboard/mobile-nav.tsx create mode 100644 dashboard/app/dashboard/reports/api-key-modal.tsx create mode 100644 dashboard/app/dashboard/reports/markdown-view.tsx create mode 100644 dashboard/app/dashboard/reports/page.tsx create mode 100644 dashboard/app/dashboard/reports/report-form.tsx create mode 100644 dashboard/app/dashboard/reports/reports-client.ts create mode 100644 dashboard/prisma/migrations/20260528120000_add_user_setting/migration.sql create mode 100644 dashboard/server/crypto.ts create mode 100644 dashboard/server/groq.ts create mode 100644 dashboard/server/report-context.ts create mode 100644 dashboard/server/reports.ts create mode 100644 dashboard/server/schemas/reports.ts create mode 100644 dashboard/server/schemas/user-settings.ts create mode 100644 dashboard/server/user-settings.ts create mode 100644 dashboard/types/report.ts create mode 100644 plans/week3/AC3-ai-session-report.md diff --git a/dashboard/.env.example b/dashboard/.env.example index 0699d43..9bc7142 100644 --- a/dashboard/.env.example +++ b/dashboard/.env.example @@ -35,5 +35,19 @@ JWT_SECRET="" # Token lifetime — any value accepted by the `ms` library (e.g. 7d, 24h, 3600). JWT_EXPIRES_IN="7d" +# ─── AI Reports (Week 3 AC 3) ────────────────────────────────────────────────── +# Groq (free-tier llama). https://console.groq.com → API Keys → Create. +# Default key used when a user has not configured their own via the dashboard UI. +GROQ_API_KEY="" + +# Override the default model if you want to experiment. Must be an OpenAI-compatible +# model exposed by Groq (https://console.groq.com/docs/models). +GROQ_MODEL="llama-3.3-70b-versatile" + +# AES-256 key for encrypting per-user API keys stored in UserSetting.groqApiKey. +# Must be base64 of exactly 32 random bytes. Generate: +# openssl rand -base64 32 +REPORTS_ENCRYPTION_KEY="" + # ─── App ─────────────────────────────────────────────────────────────────────── NEXT_PUBLIC_APP_URL="http://localhost:3000" diff --git a/dashboard/app/api/v1/reports/generate/route.ts b/dashboard/app/api/v1/reports/generate/route.ts new file mode 100644 index 0000000..9359baa --- /dev/null +++ b/dashboard/app/api/v1/reports/generate/route.ts @@ -0,0 +1,76 @@ +import { NextRequest, NextResponse } from "next/server"; +import { z } from "zod"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { withCors, corsPreflight } from "@/server/cors"; +import { GenerateReportInput } from "@/server/schemas/reports"; +import { + generateReport, + MissingApiKeyError, + GroqAuthError, + GroqContextLimitError, + GroqTimeoutError, + GroqUpstreamError, +} from "@/server/reports"; + +export const POST = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + let body: unknown; + try { + body = await req.json(); + } catch { + return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); + } + + const parsed = GenerateReportInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + } + + try { + const result = await generateReport(user.id, parsed.data); + return NextResponse.json(result); + } catch (err) { + if (err instanceof MissingApiKeyError) { + return NextResponse.json( + { error: "No Groq API key configured. Add your own via the API KEY button." }, + { status: 503 }, + ); + } + if (err instanceof GroqContextLimitError) { + return NextResponse.json({ error: err.message }, { status: 422 }); + } + if (err instanceof GroqAuthError) { + return NextResponse.json( + { error: "Groq rejected the API key. Clear it in settings or set a valid key." }, + { status: 402 }, + ); + } + if (err instanceof GroqTimeoutError) { + return NextResponse.json( + { error: "AI request timed out. Try again in a moment." }, + { status: 504 }, + ); + } + if (err instanceof GroqUpstreamError) { + console.error("[reports] upstream error", err); + return NextResponse.json( + { error: "AI provider unavailable. Try again later." }, + { status: 502 }, + ); + } + throw err; + } +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/app/api/v1/user/settings/route.ts b/dashboard/app/api/v1/user/settings/route.ts new file mode 100644 index 0000000..93d918a --- /dev/null +++ b/dashboard/app/api/v1/user/settings/route.ts @@ -0,0 +1,51 @@ +import { NextRequest, NextResponse } from "next/server"; +import { z } from "zod"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { withCors, corsPreflight } from "@/server/cors"; +import { SetApiKeyInput } from "@/server/schemas/user-settings"; +import { getUserSettingsView, setGroqApiKey } from "@/server/user-settings"; + +export const GET = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + const view = await getUserSettingsView(user.id); + return NextResponse.json(view); +}); + +export const PUT = withCors(async (req) => { + let user; + try { + user = requireUser(req); + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + let body: unknown; + try { + body = await req.json(); + } catch { + return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); + } + + const parsed = SetApiKeyInput.safeParse(body); + if (!parsed.success) { + return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + } + + const view = await setGroqApiKey(user.id, parsed.data.groqApiKey); + return NextResponse.json(view); +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/app/dashboard/app-header.tsx b/dashboard/app/dashboard/app-header.tsx index 8569173..c2af845 100644 --- a/dashboard/app/dashboard/app-header.tsx +++ b/dashboard/app/dashboard/app-header.tsx @@ -1,4 +1,6 @@ import { LogoutButton } from "./logout-button"; +import { HeaderNav } from "./header-nav"; +import { MobileNav } from "./mobile-nav"; type Props = { email: string; @@ -12,19 +14,22 @@ export function AppHeader({ email, name, picture }: Props) { return ( <header className="sticky top-0 z-10 flex items-center justify-between border-b border-border bg-bg/95 px-6 py-3 backdrop-blur"> - <div className="flex items-center gap-2"> - <span - className="text-xl text-cyan" - style={{ filter: "drop-shadow(0 0 4px var(--c-cyan))" }} - > - ⬡ - </span> - <span - className="text-sm font-bold tracking-widest text-cyan" - style={{ textShadow: "0 0 6px color-mix(in srgb, var(--c-cyan) 60%, transparent)" }} - > - WORKTRACE - </span> + <div className="flex items-center gap-8"> + <div className="flex items-center gap-2"> + <span + className="text-xl text-cyan" + style={{ filter: "drop-shadow(0 0 4px var(--c-cyan))" }} + > + ⬡ + </span> + <span + className="text-sm font-bold tracking-widest text-cyan" + style={{ textShadow: "0 0 6px color-mix(in srgb, var(--c-cyan) 60%, transparent)" }} + > + WORKTRACE + </span> + </div> + <HeaderNav /> </div> <div className="flex items-center gap-3"> @@ -48,6 +53,7 @@ export function AppHeader({ email, name, picture }: Props) { {displayName} </span> <LogoutButton /> + <MobileNav /> </div> </header> ); diff --git a/dashboard/app/dashboard/header-nav.tsx b/dashboard/app/dashboard/header-nav.tsx new file mode 100644 index 0000000..2b31d6f --- /dev/null +++ b/dashboard/app/dashboard/header-nav.tsx @@ -0,0 +1,33 @@ +"use client"; + +import Link from "next/link"; +import { usePathname } from "next/navigation"; + +const ITEMS: { href: string; label: string }[] = [ + { href: "/dashboard", label: "FEED" }, + { href: "/dashboard/reports", label: "REPORTS" }, +]; + +export function HeaderNav() { + const pathname = usePathname(); + + return ( + <nav className="hidden items-center gap-1 text-[10px] font-bold tracking-widest sm:flex"> + {ITEMS.map((item) => { + const active = pathname === item.href; + return ( + <Link + key={item.href} + href={item.href} + className={ + "rounded px-2.5 py-1 transition-colors " + + (active ? "bg-cyan/10 text-cyan" : "text-muted hover:text-text") + } + > + {item.label} + </Link> + ); + })} + </nav> + ); +} diff --git a/dashboard/app/dashboard/mobile-nav.tsx b/dashboard/app/dashboard/mobile-nav.tsx new file mode 100644 index 0000000..a4dcb06 --- /dev/null +++ b/dashboard/app/dashboard/mobile-nav.tsx @@ -0,0 +1,76 @@ +"use client"; + +import Link from "next/link"; +import { usePathname } from "next/navigation"; +import { useState } from "react"; + +const ITEMS: { href: string; label: string }[] = [ + { href: "/dashboard", label: "FEED" }, + { href: "/dashboard/reports", label: "REPORTS" }, +]; + +export function MobileNav() { + const pathname = usePathname(); + const [open, setOpen] = useState(false); + + return ( + <> + {/* Burger button — mobile only */} + <button + type="button" + onClick={() => setOpen((v) => !v)} + aria-label={open ? "Close menu" : "Open menu"} + aria-expanded={open} + className="flex h-8 w-8 flex-col items-center justify-center gap-1.25 rounded text-muted transition-colors hover:text-text sm:hidden" + > + <span + className="block h-px w-3.75 bg-current transition-all duration-200" + style={{ transform: open ? "translateY(6px) rotate(45deg)" : "none" }} + /> + <span + className="block h-px w-3.75 bg-current transition-all duration-200" + style={{ opacity: open ? 0 : 1 }} + /> + <span + className="block h-px w-3.75 bg-current transition-all duration-200" + style={{ transform: open ? "translateY(-6px) rotate(-45deg)" : "none" }} + /> + </button> + + {/* Backdrop */} + {open && ( + <div + className="fixed inset-0 z-40 sm:hidden" + onClick={() => setOpen(false)} + /> + )} + + {/* Slide-down panel */} + <div + className={ + "fixed inset-x-0 top-13 z-50 overflow-hidden border-b border-border bg-bg/95 backdrop-blur transition-all duration-200 sm:hidden " + + (open ? "max-h-40 opacity-100" : "max-h-0 opacity-0") + } + > + <nav className="mx-auto flex max-w-6xl flex-col px-6"> + {ITEMS.map((item) => { + const active = pathname === item.href; + return ( + <Link + key={item.href} + href={item.href} + onClick={() => setOpen(false)} + className={ + "border-b border-border/40 py-3.5 text-[10px] font-bold tracking-widest transition-colors last:border-0 " + + (active ? "text-cyan" : "text-muted hover:text-text") + } + > + {item.label} + </Link> + ); + })} + </nav> + </div> + </> + ); +} diff --git a/dashboard/app/dashboard/reports/api-key-modal.tsx b/dashboard/app/dashboard/reports/api-key-modal.tsx new file mode 100644 index 0000000..6527fed --- /dev/null +++ b/dashboard/app/dashboard/reports/api-key-modal.tsx @@ -0,0 +1,125 @@ +"use client"; + +import { useEffect, useState } from "react"; +import { createPortal } from "react-dom"; +import type { UserSettingsView } from "@/server/user-settings"; +import { saveApiKey } from "./reports-client"; + +type Props = { + status: UserSettingsView; + onClose: () => void; + onSaved: (next: UserSettingsView) => void; +}; + +export function ApiKeyModal({ status, onClose, onSaved }: Props) { + const [value, setValue] = useState(""); + const [busy, setBusy] = useState(false); + const [error, setError] = useState<string | null>(null); + + useEffect(() => { + const onKey = (e: KeyboardEvent) => { if (e.key === "Escape") onClose(); }; + window.addEventListener("keydown", onKey); + return () => window.removeEventListener("keydown", onKey); + }, [onClose]); + + async function commit(key: string | null) { + setBusy(true); + setError(null); + try { + const next = await saveApiKey(key); + onSaved(next); + onClose(); + } catch (err) { + setError(err instanceof Error ? err.message : "Failed to save"); + } finally { + setBusy(false); + } + } + + return createPortal( + <div + role="dialog" + aria-modal="true" + aria-labelledby="api-key-modal-title" + className="fixed inset-0 z-50 flex items-center justify-center bg-bg/80 px-4 backdrop-blur" + onMouseDown={(e) => { if (e.target === e.currentTarget) onClose(); }} + > + <div className="w-full max-w-md rounded border border-border bg-surface p-6 shadow-xl"> + <div className="mb-4 flex items-baseline justify-between"> + <h2 + id="api-key-modal-title" + className="text-sm font-bold tracking-widest text-cyan" + > + GROQ API KEY + </h2> + <button + type="button" + onClick={onClose} + className="cursor-pointer text-muted transition-colors hover:text-pink" + aria-label="Close" + > + ✕ + </button> + </div> + + <p className="mb-4 text-xs text-muted"> + {status.hasGroqApiKey + ? <>Currently using your own key (••••{status.last4 ?? "????"}). To change, enter a new key below.</> + : <>Currently using the shared default key. Paste your own Groq API key to override.</> + } + </p> + + <label className="mb-1 block text-[10px] font-bold tracking-widest text-muted"> + NEW KEY + </label> + <input + type="password" + value={value} + onChange={(e) => setValue(e.target.value)} + placeholder="gsk_…" + disabled={busy} + autoComplete="off" + className="mb-2 w-full rounded border border-border bg-bg px-2 py-1.5 text-xs text-text outline-none transition-colors focus:border-purple disabled:opacity-50" + /> + + {error ? ( + <p className="mb-2 text-[11px] text-pink">{error}</p> + ) : null} + + <p className="mb-4 text-[10px] text-muted"> + Stored encrypted (AES-256-GCM) and never returned to the browser. + </p> + + <div className="flex flex-wrap items-center justify-end gap-2"> + {status.hasGroqApiKey ? ( + <button + type="button" + onClick={() => commit(null)} + disabled={busy} + className="cursor-pointer rounded border border-pink/60 px-3 py-1.5 text-[10px] font-bold tracking-widest text-pink transition-colors hover:bg-pink/10 disabled:opacity-50" + > + CLEAR KEY + </button> + ) : null} + <button + type="button" + onClick={onClose} + disabled={busy} + className="cursor-pointer rounded border border-muted px-3 py-1.5 text-[10px] font-bold tracking-widest text-muted transition-colors hover:text-text disabled:opacity-50" + > + CANCEL + </button> + <button + type="button" + onClick={() => commit(value)} + disabled={busy || value.trim().length < 8} + className="cursor-pointer rounded border border-cyan bg-cyan/10 px-3 py-1.5 text-[10px] font-bold tracking-widest text-cyan transition-colors hover:bg-cyan/20 disabled:cursor-not-allowed disabled:opacity-50" + > + {busy ? "SAVING…" : "SAVE"} + </button> + </div> + </div> + </div>, + document.body, + ); +} diff --git a/dashboard/app/dashboard/reports/markdown-view.tsx b/dashboard/app/dashboard/reports/markdown-view.tsx new file mode 100644 index 0000000..b571a05 --- /dev/null +++ b/dashboard/app/dashboard/reports/markdown-view.tsx @@ -0,0 +1,49 @@ +"use client"; + +import ReactMarkdown from "react-markdown"; +import remarkGfm from "remark-gfm"; + +export function MarkdownView({ markdown }: { markdown: string }) { + return ( + <div className="rounded border border-border bg-surface p-6"> + <ReactMarkdown + remarkPlugins={[remarkGfm]} + components={{ + h1: (p) => <h1 className="mb-4 text-lg font-bold tracking-widest text-cyan" {...p} />, + h2: (p) => <h2 className="mt-6 mb-3 text-base font-bold tracking-widest text-cyan" {...p} />, + h3: (p) => <h3 className="mt-4 mb-2 text-sm font-bold tracking-widest text-purple" {...p} />, + p: (p) => <p className="my-2 text-sm leading-relaxed text-text/90" {...p} />, + ul: (p) => <ul className="my-2 list-disc pl-5 text-sm text-text/90" {...p} />, + ol: (p) => <ol className="my-2 list-decimal pl-5 text-sm text-text/90" {...p} />, + li: (p) => <li className="my-1" {...p} />, + strong: (p) => <strong className="font-bold text-text" {...p} />, + em: (p) => <em className="italic text-text/80" {...p} />, + code: (p) => <code className="rounded bg-bg px-1 py-0.5 text-[12px] text-yellow" {...p} />, + a: (p) => ( + <a + className="text-cyan underline decoration-cyan/40 hover:decoration-cyan" + target="_blank" + rel="noreferrer noopener" + {...p} + /> + ), + blockquote: (p) => ( + <blockquote + className="my-3 border-l-2 border-purple/60 pl-3 text-sm text-text/80 italic" + {...p} + /> + ), + table: (p) => ( + <div className="my-3 overflow-x-auto"> + <table className="w-full border-collapse text-xs" {...p} /> + </div> + ), + th: (p) => <th className="border border-border bg-bg px-2 py-1 text-left text-cyan" {...p} />, + td: (p) => <td className="border border-border px-2 py-1" {...p} />, + }} + > + {markdown} + </ReactMarkdown> + </div> + ); +} diff --git a/dashboard/app/dashboard/reports/page.tsx b/dashboard/app/dashboard/reports/page.tsx new file mode 100644 index 0000000..1f55bf5 --- /dev/null +++ b/dashboard/app/dashboard/reports/page.tsx @@ -0,0 +1,24 @@ +import type { Metadata } from "next"; +import { redirect } from "next/navigation"; +import { getCurrentUser } from "@/server/current-user"; +import { ReportForm } from "./report-form"; + +export const metadata: Metadata = { + title: "Reports", + description: "Generate an AI-summarized session report from your captured events and music.", + robots: { index: false, follow: false }, +}; + +export default async function ReportsPage() { + const user = await getCurrentUser(); + if (!user) redirect("/login"); + + return ( + <div className="mx-auto flex w-full max-w-6xl flex-col gap-6 px-6 py-8"> + <div className="flex items-baseline justify-between"> + <h1 className="text-base font-bold tracking-widest text-cyan">AI SESSION REPORT</h1> + </div> + <ReportForm /> + </div> + ); +} diff --git a/dashboard/app/dashboard/reports/report-form.tsx b/dashboard/app/dashboard/reports/report-form.tsx new file mode 100644 index 0000000..7cefedf --- /dev/null +++ b/dashboard/app/dashboard/reports/report-form.tsx @@ -0,0 +1,257 @@ +"use client"; + +import { useEffect, useState } from "react"; +import type { GenerateReportResponse, RangePreset } from "@/types/report"; +import type { UserSettingsView } from "@/server/user-settings"; +import { + generateReport, + getApiKeyStatus, + type GenerateInput, +} from "./reports-client"; +import { MarkdownView } from "./markdown-view"; +import { ApiKeyModal } from "./api-key-modal"; + +const PRESETS: { value: RangePreset; label: string }[] = [ + { value: "today", label: "TODAY" }, + { value: "yesterday", label: "YESTERDAY" }, + { value: "last_7d", label: "LAST 7 DAYS" }, + { value: "last_30d", label: "LAST 30 DAYS" }, + { value: "all_time", label: "ALL TIME" }, + { value: "custom", label: "CUSTOM" }, +]; + +type Status = + | { kind: "idle" } + | { kind: "loading" } + | { kind: "error"; message: string } + | { kind: "success"; result: GenerateReportResponse }; + +function todayISO(): string { + const d = new Date(); + const pad = (n: number) => String(n).padStart(2, "0"); + return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`; +} + +function downloadMarkdown(markdown: string, rangeLabel: string): void { + const blob = new Blob([markdown], { type: "text/markdown" }); + const url = URL.createObjectURL(blob); + const a = document.createElement("a"); + const slug = rangeLabel.toLowerCase().replace(/\s+/g, "-"); + const ymd = new Date().toISOString().slice(0, 10); + a.href = url; + a.download = `worktrace-report-${slug}-${ymd}.md`; + document.body.appendChild(a); + a.click(); + document.body.removeChild(a); + URL.revokeObjectURL(url); +} + +export function ReportForm() { + const [range, setRange] = useState<RangePreset>("last_7d"); + const [from, setFrom] = useState<string>(""); + const [to, setTo] = useState<string>(todayISO()); + const [status, setStatus] = useState<Status>({ kind: "idle" }); + const [apiKey, setApiKey] = useState<UserSettingsView | null>(null); + const [modalOpen, setModalOpen] = useState(false); + + useEffect(() => { + let cancelled = false; + getApiKeyStatus() + .then((v) => { if (!cancelled) setApiKey(v); }) + .catch(() => { if (!cancelled) setApiKey({ hasGroqApiKey: false, last4: null }); }); + return () => { cancelled = true; }; + }, []); + + const isCustom = range === "custom"; + const isBusy = status.kind === "loading"; + + async function handleGenerate() { + setStatus({ kind: "loading" }); + const input: GenerateInput = { range }; + if (isCustom) { + if (!from || !to) { + setStatus({ kind: "error", message: "Pick a from and to date for the custom range." }); + return; + } + input.from = new Date(`${from}T00:00:00.000Z`).toISOString(); + input.to = new Date(`${to}T23:59:59.999Z`).toISOString(); + } + try { + const result = await generateReport(input); + setStatus({ kind: "success", result }); + } catch (err) { + setStatus({ + kind: "error", + message: err instanceof Error ? err.message : "Failed to generate report", + }); + } + } + + return ( + <div className="flex flex-col gap-4"> + <section className="rounded border border-border bg-surface p-4"> + <div className="mb-3 flex flex-wrap items-baseline justify-between gap-2"> + <span className="text-[10px] font-bold tracking-widest text-muted">RANGE</span> + <div className="flex items-center gap-3"> + <span className="text-[10px] tracking-widest text-muted"> + {apiKey === null + ? "…" + : apiKey.hasGroqApiKey + ? <>USING YOUR KEY (••••{apiKey.last4 ?? "????"})</> + : "USING SHARED DEFAULT KEY"} + </span> + <button + type="button" + onClick={() => setModalOpen(true)} + className="cursor-pointer rounded border border-border px-2.5 py-1 text-[10px] font-bold tracking-widest text-muted transition-colors hover:border-purple hover:text-text" + > + ⚙ API KEY + </button> + </div> + </div> + <div className="flex flex-wrap items-center gap-2"> + {PRESETS.map((p) => ( + <button + key={p.value} + type="button" + onClick={() => setRange(p.value)} + disabled={isBusy} + className={ + "cursor-pointer rounded border px-3 py-1.5 text-[10px] font-bold tracking-widest transition-colors disabled:cursor-not-allowed disabled:opacity-50 " + + (range === p.value + ? "border-cyan bg-cyan/10 text-cyan" + : "border-border text-muted hover:border-purple/60 hover:text-text") + } + > + {p.label} + </button> + ))} + + <div className="ml-auto flex flex-wrap items-center gap-2"> + {status.kind === "success" ? ( + <> + <button + type="button" + onClick={() => setStatus({ kind: "idle" })} + className="cursor-pointer rounded border border-muted px-3 py-1.5 text-[10px] font-bold tracking-widest text-muted transition-colors hover:border-pink hover:text-pink" + > + NEW REPORT + </button> + <button + type="button" + onClick={() => downloadMarkdown(status.result.markdown, status.result.range.label)} + className="cursor-pointer rounded border border-cyan px-3 py-1.5 text-[10px] font-bold tracking-widest text-cyan transition-colors hover:bg-cyan/10" + > + DOWNLOAD .MD + </button> + </> + ) : null} + <button + type="button" + onClick={handleGenerate} + disabled={isBusy} + className="cursor-pointer rounded border border-purple bg-purple/10 px-4 py-1.5 text-[10px] font-bold tracking-widest text-purple transition-colors hover:bg-purple/20 disabled:cursor-not-allowed disabled:opacity-50" + > + {isBusy ? "GENERATING…" : "GENERATE REPORT"} + </button> + </div> + </div> + + {isCustom ? ( + <div className="mt-4 grid grid-cols-1 gap-3 sm:grid-cols-2"> + <CustomField label="FROM"> + <input + type="date" + value={from} + max={to || todayISO()} + onChange={(e) => setFrom(e.target.value)} + disabled={isBusy} + className={INPUT_CLASS} + /> + </CustomField> + <CustomField label="TO"> + <input + type="date" + value={to} + min={from || undefined} + max={todayISO()} + onChange={(e) => setTo(e.target.value)} + disabled={isBusy} + className={INPUT_CLASS} + /> + </CustomField> + </div> + ) : null} + </section> + + {status.kind === "loading" ? <LoadingPanel /> : null} + {status.kind === "error" ? <ErrorPanel message={status.message} onRetry={handleGenerate} /> : null} + {status.kind === "success" ? <ResultPanel result={status.result} /> : null} + + {modalOpen && apiKey ? ( + <ApiKeyModal + status={apiKey} + onClose={() => setModalOpen(false)} + onSaved={(next) => setApiKey(next)} + /> + ) : null} + </div> + ); +} + +const INPUT_CLASS = + "rounded border border-border bg-bg px-2 py-1.5 text-xs text-text " + + "outline-none transition-colors hover:border-purple/60 focus:border-purple " + + "disabled:cursor-not-allowed disabled:opacity-50 [color-scheme:dark]"; + +function CustomField({ label, children }: { label: string; children: React.ReactNode }) { + return ( + <label className="flex flex-col gap-1"> + <span className="text-[10px] font-bold tracking-widest text-muted">{label}</span> + {children} + </label> + ); +} + +function LoadingPanel() { + return ( + <div className="overflow-hidden rounded border border-border bg-surface"> + <div className="h-1 animate-pulse bg-cyan" /> + <div className="p-6 text-center text-xs text-muted"> + Asking the model… this typically takes 10–30 seconds. + </div> + </div> + ); +} + +function ErrorPanel({ message, onRetry }: { message: string; onRetry: () => void }) { + return ( + <div className="flex flex-col items-center gap-2 rounded border border-pink/40 bg-surface px-4 py-6 text-center"> + <p className="text-xs text-pink">{message}</p> + <button + type="button" + onClick={onRetry} + className="cursor-pointer rounded border border-pink/40 px-3 py-1.5 text-[10px] font-bold tracking-widest text-pink transition-colors hover:bg-pink/10" + > + RETRY + </button> + </div> + ); +} + +function ResultPanel({ result }: { result: GenerateReportResponse }) { + return ( + <div className="flex flex-col gap-3"> + <div className="flex flex-wrap items-center gap-3 text-[10px] tracking-widest text-muted"> + <span>RANGE: <span className="text-cyan">{result.range.label.toUpperCase()}</span></span> + <span>·</span> + <span>DETAIL LEVEL: <span className="text-cyan">{result.contextLevel}</span></span> + <span>·</span> + <span>~{result.estimatedInputTokens.toLocaleString()} INPUT TOKENS</span> + <span>·</span> + <span>MODEL: <span className="text-purple">{result.model}</span></span> + </div> + <MarkdownView markdown={result.markdown} /> + </div> + ); +} diff --git a/dashboard/app/dashboard/reports/reports-client.ts b/dashboard/app/dashboard/reports/reports-client.ts new file mode 100644 index 0000000..acd4db7 --- /dev/null +++ b/dashboard/app/dashboard/reports/reports-client.ts @@ -0,0 +1,46 @@ +import type { GenerateReportResponse, RangePreset } from "@/types/report"; +import type { UserSettingsView } from "@/server/user-settings"; + +export type GenerateInput = { + range: RangePreset; + from?: string; + to?: string; +}; + +async function readError(res: Response): Promise<string> { + try { + const body = (await res.json()) as { error?: unknown }; + if (typeof body.error === "string") return body.error; + return `Request failed (${res.status})`; + } catch { + return `Request failed (${res.status})`; + } +} + +export async function generateReport(input: GenerateInput): Promise<GenerateReportResponse> { + const res = await fetch("/api/v1/reports/generate", { + method: "POST", + headers: { "Content-Type": "application/json" }, + credentials: "include", + body: JSON.stringify(input), + }); + if (!res.ok) throw new Error(await readError(res)); + return (await res.json()) as GenerateReportResponse; +} + +export async function getApiKeyStatus(): Promise<UserSettingsView> { + const res = await fetch("/api/v1/user/settings", { credentials: "include" }); + if (!res.ok) throw new Error(await readError(res)); + return (await res.json()) as UserSettingsView; +} + +export async function saveApiKey(key: string | null): Promise<UserSettingsView> { + const res = await fetch("/api/v1/user/settings", { + method: "PUT", + headers: { "Content-Type": "application/json" }, + credentials: "include", + body: JSON.stringify({ groqApiKey: key }), + }); + if (!res.ok) throw new Error(await readError(res)); + return (await res.json()) as UserSettingsView; +} diff --git a/dashboard/package-lock.json b/dashboard/package-lock.json index 5fdf732..1d01aa8 100644 --- a/dashboard/package-lock.json +++ b/dashboard/package-lock.json @@ -23,6 +23,8 @@ "react": "19.2.4", "react-chartjs-2": "^5.3.1", "react-dom": "19.2.4", + "react-markdown": "^10.1.0", + "remark-gfm": "^4.0.1", "zod": "^4.4.3" }, "devDependencies": { @@ -2421,13 +2423,30 @@ "@types/d3-selection": "*" } }, + "node_modules/@types/debug": { + "version": "4.1.13", + "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.13.tgz", + "integrity": "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==", + "license": "MIT", + "dependencies": { + "@types/ms": "*" + } + }, "node_modules/@types/estree": { "version": "1.0.9", "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", - "dev": true, "license": "MIT" }, + "node_modules/@types/estree-jsx": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/@types/estree-jsx/-/estree-jsx-1.0.5.tgz", + "integrity": "sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==", + "license": "MIT", + "dependencies": { + "@types/estree": "*" + } + }, "node_modules/@types/express": { "version": "5.0.6", "resolved": "https://registry.npmjs.org/@types/express/-/express-5.0.6.tgz", @@ -2460,6 +2479,15 @@ "dev": true, "license": "MIT" }, + "node_modules/@types/hast": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/hast/-/hast-3.0.4.tgz", + "integrity": "sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, "node_modules/@types/http-errors": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz", @@ -2492,11 +2520,19 @@ "@types/node": "*" } }, + "node_modules/@types/mdast": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz", + "integrity": "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, "node_modules/@types/ms": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz", "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==", - "dev": true, "license": "MIT" }, "node_modules/@types/node": { @@ -2573,6 +2609,12 @@ "@types/node": "*" } }, + "node_modules/@types/unist": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz", + "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==", + "license": "MIT" + }, "node_modules/@typescript-eslint/eslint-plugin": { "version": "8.59.3", "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.59.3.tgz", @@ -2868,6 +2910,12 @@ "url": "https://opencollective.com/eslint" } }, + "node_modules/@ungap/structured-clone": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.1.tgz", + "integrity": "sha512-mUFwbeTqrVgDQxFveS+df2yfap6iuP20NAKAsBt5jDEoOTDew+zwLAOilHCeQJOVSvmgCX4ogqIrA0mnyr08yQ==", + "license": "ISC" + }, "node_modules/@unrs/resolver-binding-android-arm-eabi": { "version": "1.11.1", "resolved": "https://registry.npmjs.org/@unrs/resolver-binding-android-arm-eabi/-/resolver-binding-android-arm-eabi-1.11.1.tgz", @@ -3504,6 +3552,16 @@ "node": ">= 0.4" } }, + "node_modules/bail": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz", + "integrity": "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/balanced-match": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", @@ -3782,6 +3840,16 @@ ], "license": "CC-BY-4.0" }, + "node_modules/ccount": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz", + "integrity": "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/chalk": { "version": "4.1.2", "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", @@ -3799,6 +3867,46 @@ "url": "https://github.com/chalk/chalk?sponsor=1" } }, + "node_modules/character-entities": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz", + "integrity": "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-html4": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-2.1.0.tgz", + "integrity": "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-legacy": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz", + "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-reference-invalid": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/character-reference-invalid/-/character-reference-invalid-2.0.1.tgz", + "integrity": "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/chart.js": { "version": "4.5.1", "resolved": "https://registry.npmjs.org/chart.js/-/chart.js-4.5.1.tgz", @@ -3852,6 +3960,16 @@ "dev": true, "license": "MIT" }, + "node_modules/comma-separated-tokens": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz", + "integrity": "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/commander": { "version": "7.2.0", "resolved": "https://registry.npmjs.org/commander/-/commander-7.2.0.tgz", @@ -4451,6 +4569,19 @@ } } }, + "node_modules/decode-named-character-reference": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.3.0.tgz", + "integrity": "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==", + "license": "MIT", + "dependencies": { + "character-entities": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/deep-is": { "version": "0.1.4", "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", @@ -4537,6 +4668,15 @@ "node": ">= 0.8" } }, + "node_modules/dequal": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz", + "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, "node_modules/destr": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz", @@ -4553,6 +4693,19 @@ "node": ">=8" } }, + "node_modules/devlop": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz", + "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==", + "license": "MIT", + "dependencies": { + "dequal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/doctrine": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-2.1.0.tgz", @@ -5281,6 +5434,16 @@ "node": ">=4.0" } }, + "node_modules/estree-util-is-identifier-name": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/estree-util-is-identifier-name/-/estree-util-is-identifier-name-3.0.0.tgz", + "integrity": "sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, "node_modules/esutils": { "version": "2.0.3", "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", @@ -6047,6 +6210,46 @@ "node": ">= 0.4" } }, + "node_modules/hast-util-to-jsx-runtime": { + "version": "2.3.6", + "resolved": "https://registry.npmjs.org/hast-util-to-jsx-runtime/-/hast-util-to-jsx-runtime-2.3.6.tgz", + "integrity": "sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "comma-separated-tokens": "^2.0.0", + "devlop": "^1.0.0", + "estree-util-is-identifier-name": "^3.0.0", + "hast-util-whitespace": "^3.0.0", + "mdast-util-mdx-expression": "^2.0.0", + "mdast-util-mdx-jsx": "^3.0.0", + "mdast-util-mdxjs-esm": "^2.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "style-to-js": "^1.0.0", + "unist-util-position": "^5.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-whitespace": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-whitespace/-/hast-util-whitespace-3.0.0.tgz", + "integrity": "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, "node_modules/hermes-estree": { "version": "0.25.1", "resolved": "https://registry.npmjs.org/hermes-estree/-/hermes-estree-0.25.1.tgz", @@ -6073,6 +6276,16 @@ "node": ">=16.9.0" } }, + "node_modules/html-url-attributes": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/html-url-attributes/-/html-url-attributes-3.0.1.tgz", + "integrity": "sha512-ol6UPyBWqsrO6EJySPz2O7ZSr856WDrEzM5zMqp+FJJLGMW35cLYmmZnl0vztAZxRUoNZJFTCohfjuIJ8I4QBQ==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, "node_modules/http-errors": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz", @@ -6169,6 +6382,12 @@ "dev": true, "license": "ISC" }, + "node_modules/inline-style-parser": { + "version": "0.2.7", + "resolved": "https://registry.npmjs.org/inline-style-parser/-/inline-style-parser-0.2.7.tgz", + "integrity": "sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==", + "license": "MIT" + }, "node_modules/internal-slot": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz", @@ -6203,6 +6422,30 @@ "node": ">= 0.10" } }, + "node_modules/is-alphabetical": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-2.0.1.tgz", + "integrity": "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-alphanumerical": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-alphanumerical/-/is-alphanumerical-2.0.1.tgz", + "integrity": "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==", + "license": "MIT", + "dependencies": { + "is-alphabetical": "^2.0.0", + "is-decimal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/is-array-buffer": { "version": "3.0.5", "resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.5.tgz", @@ -6361,6 +6604,16 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/is-decimal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-decimal/-/is-decimal-2.0.1.tgz", + "integrity": "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/is-extglob": { "version": "2.1.1", "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", @@ -6420,6 +6673,16 @@ "node": ">=0.10.0" } }, + "node_modules/is-hexadecimal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-hexadecimal/-/is-hexadecimal-2.0.1.tgz", + "integrity": "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/is-map": { "version": "2.0.3", "resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz", @@ -6473,6 +6736,18 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/is-plain-obj": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz", + "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/is-promise": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz", @@ -7226,6 +7501,16 @@ "integrity": "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA==", "license": "Apache-2.0" }, + "node_modules/longest-streak": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz", + "integrity": "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/loose-envify": { "version": "1.4.0", "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz", @@ -7274,6 +7559,16 @@ "@jridgewell/sourcemap-codec": "^1.5.5" } }, + "node_modules/markdown-table": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/markdown-table/-/markdown-table-3.0.4.tgz", + "integrity": "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/math-intrinsics": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", @@ -7284,101 +7579,946 @@ "node": ">= 0.4" } }, - "node_modules/media-typer": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz", - "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==", - "dev": true, + "node_modules/mdast-util-find-and-replace": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/mdast-util-find-and-replace/-/mdast-util-find-and-replace-3.0.2.tgz", + "integrity": "sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==", "license": "MIT", - "engines": { - "node": ">= 0.8" + "dependencies": { + "@types/mdast": "^4.0.0", + "escape-string-regexp": "^5.0.0", + "unist-util-is": "^6.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" } }, - "node_modules/merge-descriptors": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz", - "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==", - "dev": true, + "node_modules/mdast-util-find-and-replace/node_modules/escape-string-regexp": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz", + "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==", "license": "MIT", "engines": { - "node": ">=18" + "node": ">=12" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/merge2": { - "version": "1.4.1", - "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", - "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", - "dev": true, + "node_modules/mdast-util-from-markdown": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/mdast-util-from-markdown/-/mdast-util-from-markdown-2.0.3.tgz", + "integrity": "sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q==", "license": "MIT", - "engines": { - "node": ">= 8" + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "mdast-util-to-string": "^4.0.0", + "micromark": "^4.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-decode-string": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "unist-util-stringify-position": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" } }, - "node_modules/micromatch": { - "version": "4.0.8", - "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", - "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", - "dev": true, + "node_modules/mdast-util-gfm": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm/-/mdast-util-gfm-3.1.0.tgz", + "integrity": "sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==", "license": "MIT", "dependencies": { - "braces": "^3.0.3", - "picomatch": "^2.3.1" + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-gfm-autolink-literal": "^2.0.0", + "mdast-util-gfm-footnote": "^2.0.0", + "mdast-util-gfm-strikethrough": "^2.0.0", + "mdast-util-gfm-table": "^2.0.0", + "mdast-util-gfm-task-list-item": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" }, - "engines": { - "node": ">=8.6" + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" } }, - "node_modules/mime-db": { - "version": "1.54.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz", - "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==", - "dev": true, + "node_modules/mdast-util-gfm-autolink-literal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-autolink-literal/-/mdast-util-gfm-autolink-literal-2.0.1.tgz", + "integrity": "sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==", "license": "MIT", - "engines": { - "node": ">= 0.6" + "dependencies": { + "@types/mdast": "^4.0.0", + "ccount": "^2.0.0", + "devlop": "^1.0.0", + "mdast-util-find-and-replace": "^3.0.0", + "micromark-util-character": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" } }, - "node_modules/mime-types": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz", - "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==", - "dev": true, + "node_modules/mdast-util-gfm-footnote": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-footnote/-/mdast-util-gfm-footnote-2.1.0.tgz", + "integrity": "sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==", "license": "MIT", "dependencies": { - "mime-db": "^1.54.0" - }, - "engines": { - "node": ">=18" + "@types/mdast": "^4.0.0", + "devlop": "^1.1.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0" }, "funding": { "type": "opencollective", - "url": "https://opencollective.com/express" + "url": "https://opencollective.com/unified" } }, - "node_modules/minimatch": { - "version": "3.1.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", - "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", - "dev": true, - "license": "ISC", + "node_modules/mdast-util-gfm-strikethrough": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-strikethrough/-/mdast-util-gfm-strikethrough-2.0.0.tgz", + "integrity": "sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==", + "license": "MIT", "dependencies": { - "brace-expansion": "^1.1.7" + "@types/mdast": "^4.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" }, - "engines": { - "node": "*" + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" } }, - "node_modules/minimist": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", - "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", - "dev": true, + "node_modules/mdast-util-gfm-table": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-table/-/mdast-util-gfm-table-2.0.0.tgz", + "integrity": "sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==", "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "markdown-table": "^3.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, "funding": { - "url": "https://github.com/sponsors/ljharb" + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-task-list-item": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-task-list-item/-/mdast-util-gfm-task-list-item-2.0.0.tgz", + "integrity": "sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-mdx-expression": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mdast-util-mdx-expression/-/mdast-util-mdx-expression-2.0.1.tgz", + "integrity": "sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-mdx-jsx": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/mdast-util-mdx-jsx/-/mdast-util-mdx-jsx-3.2.0.tgz", + "integrity": "sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "ccount": "^2.0.0", + "devlop": "^1.1.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0", + "parse-entities": "^4.0.0", + "stringify-entities": "^4.0.0", + "unist-util-stringify-position": "^4.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-mdxjs-esm": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mdast-util-mdxjs-esm/-/mdast-util-mdxjs-esm-2.0.1.tgz", + "integrity": "sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-phrasing": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-phrasing/-/mdast-util-phrasing-4.1.0.tgz", + "integrity": "sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-hast": { + "version": "13.2.1", + "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz", + "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "@ungap/structured-clone": "^1.0.0", + "devlop": "^1.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "trim-lines": "^3.0.0", + "unist-util-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-markdown": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/mdast-util-to-markdown/-/mdast-util-to-markdown-2.1.2.tgz", + "integrity": "sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "longest-streak": "^3.0.0", + "mdast-util-phrasing": "^4.0.0", + "mdast-util-to-string": "^4.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-decode-string": "^2.0.0", + "unist-util-visit": "^5.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-to-string/-/mdast-util-to-string-4.0.0.tgz", + "integrity": "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/media-typer": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz", + "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/merge-descriptors": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz", + "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/micromark": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz", + "integrity": "sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "@types/debug": "^4.0.0", + "debug": "^4.0.0", + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-combine-extensions": "^2.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-subtokenize": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-core-commonmark": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/micromark-core-commonmark/-/micromark-core-commonmark-2.0.3.tgz", + "integrity": "sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "micromark-factory-destination": "^2.0.0", + "micromark-factory-label": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-factory-title": "^2.0.0", + "micromark-factory-whitespace": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-html-tag-name": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-subtokenize": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-extension-gfm": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm/-/micromark-extension-gfm-3.0.0.tgz", + "integrity": "sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==", + "license": "MIT", + "dependencies": { + "micromark-extension-gfm-autolink-literal": "^2.0.0", + "micromark-extension-gfm-footnote": "^2.0.0", + "micromark-extension-gfm-strikethrough": "^2.0.0", + "micromark-extension-gfm-table": "^2.0.0", + "micromark-extension-gfm-tagfilter": "^2.0.0", + "micromark-extension-gfm-task-list-item": "^2.0.0", + "micromark-util-combine-extensions": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-autolink-literal": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-autolink-literal/-/micromark-extension-gfm-autolink-literal-2.1.0.tgz", + "integrity": "sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==", + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-footnote": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-footnote/-/micromark-extension-gfm-footnote-2.1.0.tgz", + "integrity": "sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-strikethrough": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-strikethrough/-/micromark-extension-gfm-strikethrough-2.1.0.tgz", + "integrity": "sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-table": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-table/-/micromark-extension-gfm-table-2.1.1.tgz", + "integrity": "sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-tagfilter": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-tagfilter/-/micromark-extension-gfm-tagfilter-2.0.0.tgz", + "integrity": "sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==", + "license": "MIT", + "dependencies": { + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-task-list-item": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-task-list-item/-/micromark-extension-gfm-task-list-item-2.1.0.tgz", + "integrity": "sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-factory-destination": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-destination/-/micromark-factory-destination-2.0.1.tgz", + "integrity": "sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-label": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-label/-/micromark-factory-label-2.0.1.tgz", + "integrity": "sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-space": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-space/-/micromark-factory-space-2.0.1.tgz", + "integrity": "sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-title": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-title/-/micromark-factory-title-2.0.1.tgz", + "integrity": "sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-whitespace": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-whitespace/-/micromark-factory-whitespace-2.0.1.tgz", + "integrity": "sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-character": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz", + "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-chunked": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-chunked/-/micromark-util-chunked-2.0.1.tgz", + "integrity": "sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-classify-character": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-classify-character/-/micromark-util-classify-character-2.0.1.tgz", + "integrity": "sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-combine-extensions": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-combine-extensions/-/micromark-util-combine-extensions-2.0.1.tgz", + "integrity": "sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-chunked": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-decode-numeric-character-reference": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-decode-numeric-character-reference/-/micromark-util-decode-numeric-character-reference-2.0.2.tgz", + "integrity": "sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-decode-string": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-decode-string/-/micromark-util-decode-string-2.0.1.tgz", + "integrity": "sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "decode-named-character-reference": "^1.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-encode": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz", + "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-html-tag-name": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-html-tag-name/-/micromark-util-html-tag-name-2.0.1.tgz", + "integrity": "sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-normalize-identifier": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-normalize-identifier/-/micromark-util-normalize-identifier-2.0.1.tgz", + "integrity": "sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-resolve-all": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-resolve-all/-/micromark-util-resolve-all-2.0.1.tgz", + "integrity": "sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-sanitize-uri": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz", + "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-subtokenize": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-util-subtokenize/-/micromark-util-subtokenize-2.1.0.tgz", + "integrity": "sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-symbol": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz", + "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-types": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz", + "integrity": "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/mime-db": { + "version": "1.54.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz", + "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz", + "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "mime-db": "^1.54.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/minimatch": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" } }, "node_modules/motion-dom": { @@ -7879,6 +9019,31 @@ "node": ">=6" } }, + "node_modules/parse-entities": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/parse-entities/-/parse-entities-4.0.2.tgz", + "integrity": "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^2.0.0", + "character-entities-legacy": "^3.0.0", + "character-reference-invalid": "^2.0.0", + "decode-named-character-reference": "^1.0.0", + "is-alphanumerical": "^2.0.0", + "is-decimal": "^2.0.0", + "is-hexadecimal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/parse-entities/node_modules/@types/unist": { + "version": "2.0.11", + "resolved": "https://registry.npmjs.org/@types/unist/-/unist-2.0.11.tgz", + "integrity": "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==", + "license": "MIT" + }, "node_modules/parseurl": { "version": "1.3.3", "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", @@ -8331,6 +9496,16 @@ "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", "license": "ISC" }, + "node_modules/property-information": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/property-information/-/property-information-7.1.0.tgz", + "integrity": "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/proxy-addr": { "version": "2.0.7", "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", @@ -8499,6 +9674,33 @@ "dev": true, "license": "MIT" }, + "node_modules/react-markdown": { + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/react-markdown/-/react-markdown-10.1.0.tgz", + "integrity": "sha512-qKxVopLT/TyA6BX3Ue5NwabOsAzm0Q7kAPwq6L+wWDwisYs7R8vZ0nRXqq6rkueboxpkjvLGU9fWifiX/ZZFxQ==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "hast-util-to-jsx-runtime": "^2.0.0", + "html-url-attributes": "^3.0.0", + "mdast-util-to-hast": "^13.0.0", + "remark-parse": "^11.0.0", + "remark-rehype": "^11.0.0", + "unified": "^11.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + }, + "peerDependencies": { + "@types/react": ">=18", + "react": ">=18" + } + }, "node_modules/readdirp": { "version": "5.0.0", "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.0.0.tgz", @@ -8556,6 +9758,72 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/remark-gfm": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/remark-gfm/-/remark-gfm-4.0.1.tgz", + "integrity": "sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-gfm": "^3.0.0", + "micromark-extension-gfm": "^3.0.0", + "remark-parse": "^11.0.0", + "remark-stringify": "^11.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-parse": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/remark-parse/-/remark-parse-11.0.0.tgz", + "integrity": "sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-from-markdown": "^2.0.0", + "micromark-util-types": "^2.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-rehype": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/remark-rehype/-/remark-rehype-11.1.2.tgz", + "integrity": "sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "mdast-util-to-hast": "^13.0.0", + "unified": "^11.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-stringify": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/remark-stringify/-/remark-stringify-11.0.0.tgz", + "integrity": "sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-to-markdown": "^2.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, "node_modules/remeda": { "version": "2.33.4", "resolved": "https://registry.npmjs.org/remeda/-/remeda-2.33.4.tgz", @@ -9079,6 +10347,16 @@ "node": ">=0.10.0" } }, + "node_modules/space-separated-tokens": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/space-separated-tokens/-/space-separated-tokens-2.0.2.tgz", + "integrity": "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/split2": { "version": "4.2.0", "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz", @@ -9247,6 +10525,20 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/stringify-entities": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/stringify-entities/-/stringify-entities-4.0.4.tgz", + "integrity": "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==", + "license": "MIT", + "dependencies": { + "character-entities-html4": "^2.0.0", + "character-entities-legacy": "^3.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/strip-bom": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", @@ -9270,6 +10562,24 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/style-to-js": { + "version": "1.1.21", + "resolved": "https://registry.npmjs.org/style-to-js/-/style-to-js-1.1.21.tgz", + "integrity": "sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==", + "license": "MIT", + "dependencies": { + "style-to-object": "1.0.14" + } + }, + "node_modules/style-to-object": { + "version": "1.0.14", + "resolved": "https://registry.npmjs.org/style-to-object/-/style-to-object-1.0.14.tgz", + "integrity": "sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==", + "license": "MIT", + "dependencies": { + "inline-style-parser": "0.2.7" + } + }, "node_modules/styled-jsx": { "version": "5.1.6", "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.1.6.tgz", @@ -9411,6 +10721,26 @@ "node": ">=0.6" } }, + "node_modules/trim-lines": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz", + "integrity": "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/trough": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz", + "integrity": "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, "node_modules/ts-api-utils": { "version": "2.5.0", "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz", @@ -9643,6 +10973,93 @@ "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", "license": "MIT" }, + "node_modules/unified": { + "version": "11.0.5", + "resolved": "https://registry.npmjs.org/unified/-/unified-11.0.5.tgz", + "integrity": "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "bail": "^2.0.0", + "devlop": "^1.0.0", + "extend": "^3.0.0", + "is-plain-obj": "^4.0.0", + "trough": "^2.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-is": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.1.tgz", + "integrity": "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-position": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-position/-/unist-util-position-5.0.0.tgz", + "integrity": "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-stringify-position": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz", + "integrity": "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.1.0.tgz", + "integrity": "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit-parents": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz", + "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, "node_modules/universalify": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", @@ -9763,6 +11180,34 @@ "node": ">= 0.8" } }, + "node_modules/vfile": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz", + "integrity": "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile-message": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz", + "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-stringify-position": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, "node_modules/web-streams-polyfill": { "version": "3.3.3", "resolved": "https://registry.npmjs.org/web-streams-polyfill/-/web-streams-polyfill-3.3.3.tgz", @@ -9953,6 +11398,16 @@ "peerDependencies": { "zod": "^3.25.0 || ^4.0.0" } + }, + "node_modules/zwitch": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz", + "integrity": "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } } } } diff --git a/dashboard/package.json b/dashboard/package.json index 8ca5646..868efa3 100644 --- a/dashboard/package.json +++ b/dashboard/package.json @@ -24,6 +24,8 @@ "react": "19.2.4", "react-chartjs-2": "^5.3.1", "react-dom": "19.2.4", + "react-markdown": "^10.1.0", + "remark-gfm": "^4.0.1", "zod": "^4.4.3" }, "devDependencies": { diff --git a/dashboard/prisma/migrations/20260528120000_add_user_setting/migration.sql b/dashboard/prisma/migrations/20260528120000_add_user_setting/migration.sql new file mode 100644 index 0000000..b5d9e62 --- /dev/null +++ b/dashboard/prisma/migrations/20260528120000_add_user_setting/migration.sql @@ -0,0 +1,12 @@ +-- CreateTable +CREATE TABLE "UserSetting" ( + "userId" TEXT NOT NULL, + "groqApiKey" TEXT, + "groqApiKeyLast4" TEXT, + "updatedAt" TIMESTAMP(3) NOT NULL, + + CONSTRAINT "UserSetting_pkey" PRIMARY KEY ("userId") +); + +-- AddForeignKey +ALTER TABLE "UserSetting" ADD CONSTRAINT "UserSetting_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; diff --git a/dashboard/prisma/schema.prisma b/dashboard/prisma/schema.prisma index ab46363..fcaf167 100644 --- a/dashboard/prisma/schema.prisma +++ b/dashboard/prisma/schema.prisma @@ -13,14 +13,23 @@ datasource db { } model User { - id String @id @default(cuid()) - email String @unique - googleId String @unique + id String @id @default(cuid()) + email String @unique + googleId String @unique name String? picture String? - createdAt DateTime @default(now()) - updatedAt DateTime @updatedAt + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt sessions Session[] + settings UserSetting? +} + +model UserSetting { + userId String @id + groqApiKey String? + groqApiKeyLast4 String? + updatedAt DateTime @updatedAt + user User @relation(fields: [userId], references: [id], onDelete: Cascade) } model Session { diff --git a/dashboard/server/cors.ts b/dashboard/server/cors.ts index 8edd9f3..5dc06c8 100644 --- a/dashboard/server/cors.ts +++ b/dashboard/server/cors.ts @@ -6,7 +6,7 @@ function corsHeaders(origin: string | null): Record<string, string> { const allow = origin && ALLOWED_ORIGIN_PATTERN.test(origin) ? origin : "null"; return { "Access-Control-Allow-Origin": allow, - "Access-Control-Allow-Methods": "GET, POST, PATCH, OPTIONS", + "Access-Control-Allow-Methods": "GET, POST, PUT, PATCH, OPTIONS", "Access-Control-Allow-Headers": "Authorization, Content-Type", Vary: "Origin", }; diff --git a/dashboard/server/crypto.ts b/dashboard/server/crypto.ts new file mode 100644 index 0000000..a328c42 --- /dev/null +++ b/dashboard/server/crypto.ts @@ -0,0 +1,45 @@ +import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto"; + +const ALGO = "aes-256-gcm"; +const KEY_LEN = 32; +const IV_LEN = 12; +const TAG_LEN = 16; + +function loadKey(): Buffer { + const raw = process.env.REPORTS_ENCRYPTION_KEY; + if (!raw) throw new Error("REPORTS_ENCRYPTION_KEY is not set"); + const key = Buffer.from(raw, "base64"); + if (key.length !== KEY_LEN) { + throw new Error( + `REPORTS_ENCRYPTION_KEY must be base64-encoded ${KEY_LEN} bytes (got ${key.length})`, + ); + } + return key; +} + +export function encryptSecret(plaintext: string): string { + const key = loadKey(); + const iv = randomBytes(IV_LEN); + const cipher = createCipheriv(ALGO, key, iv); + const ct = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]); + const tag = cipher.getAuthTag(); + return Buffer.concat([iv, tag, ct]).toString("base64"); +} + +export function decryptSecret(encoded: string): string { + const key = loadKey(); + const buf = Buffer.from(encoded, "base64"); + if (buf.length < IV_LEN + TAG_LEN + 1) { + throw new Error("Ciphertext is too short"); + } + const iv = buf.subarray(0, IV_LEN); + const tag = buf.subarray(IV_LEN, IV_LEN + TAG_LEN); + const ct = buf.subarray(IV_LEN + TAG_LEN); + const dec = createDecipheriv(ALGO, key, iv); + dec.setAuthTag(tag); + return Buffer.concat([dec.update(ct), dec.final()]).toString("utf8"); +} + +export function last4(secret: string): string { + return secret.slice(-4); +} diff --git a/dashboard/server/groq.ts b/dashboard/server/groq.ts new file mode 100644 index 0000000..63344bf --- /dev/null +++ b/dashboard/server/groq.ts @@ -0,0 +1,95 @@ +const GROQ_URL = "https://api.groq.com/openai/v1/chat/completions"; +const DEFAULT_MODEL = "llama-3.3-70b-versatile"; +const TIMEOUT_MS = 60_000; + +export class GroqAuthError extends Error { + constructor() { + super("Groq rejected the API key"); + this.name = "GroqAuthError"; + } +} + +export class GroqUpstreamError extends Error { + constructor(message: string) { + super(message); + this.name = "GroqUpstreamError"; + } +} + +export class GroqContextLimitError extends Error { + constructor() { + super("Report context too large for the model. Try a shorter date range."); + this.name = "GroqContextLimitError"; + } +} + +export class GroqTimeoutError extends Error { + constructor() { + super("Groq request timed out"); + this.name = "GroqTimeoutError"; + } +} + +type ChatMessage = { role: "system" | "user"; content: string }; + +export type GroqChatInput = { + apiKey: string; + model?: string; + system: string; + user: string; + temperature?: number; + maxTokens?: number; +}; + +export async function groqChat(input: GroqChatInput): Promise<string> { + const model = input.model ?? getDefaultModel(); + const messages: ChatMessage[] = [ + { role: "system", content: input.system }, + { role: "user", content: input.user }, + ]; + + const ctrl = new AbortController(); + const timer = setTimeout(() => ctrl.abort(), TIMEOUT_MS); + + let res: Response; + try { + res = await fetch(GROQ_URL, { + method: "POST", + headers: { + "Content-Type": "application/json", + "Authorization": `Bearer ${input.apiKey}`, + }, + body: JSON.stringify({ + model, + messages, + temperature: input.temperature ?? 0.4, + max_tokens: input.maxTokens ?? 2000, + }), + signal: ctrl.signal, + }); + } catch (err) { + const name = (err as { name?: string }).name; + if (name === "AbortError") throw new GroqTimeoutError(); + throw new GroqUpstreamError(err instanceof Error ? err.message : "network error"); + } finally { + clearTimeout(timer); + } + + if (res.status === 401 || res.status === 403) throw new GroqAuthError(); + if (res.status === 413) throw new GroqContextLimitError(); + if (!res.ok) { + const body = await res.text(); + console.error("[groq] non-ok response", res.status, body); + throw new GroqUpstreamError(`Groq returned ${res.status}`); + } + + type Resp = { choices?: Array<{ message?: { content?: string } }> }; + const data = (await res.json()) as Resp; + const text = data.choices?.[0]?.message?.content; + if (!text || !text.trim()) throw new GroqUpstreamError("Empty completion"); + return text; +} + +export function getDefaultModel(): string { + return process.env.GROQ_MODEL ?? DEFAULT_MODEL; +} diff --git a/dashboard/server/report-context.ts b/dashboard/server/report-context.ts new file mode 100644 index 0000000..cd63102 --- /dev/null +++ b/dashboard/server/report-context.ts @@ -0,0 +1,394 @@ +import { Prisma } from "@/generated/prisma/client"; +import type { ContextLevel } from "@/types/report"; +import { prisma } from "./db"; + +// Groq free tier: 12,000 tokens/request. Reserve ~500 for system prompt + ~2,000 for response. +const INPUT_TOKEN_BUDGET = 7_500; +const CHARS_PER_TOKEN = 4; +const MAX_HIGHLIGHTS = 20; +const MAX_SESSIONS_SHOWN = 20; +const MAX_TOP_DOMAINS = 10; +const MAX_TOP_TAGS = 15; +const MAX_TOP_TRACKS = 10; +const MAX_TOP_ARTISTS = 10; +const CONTENT_PREVIEW = 300; + +type RawEvent = { + id: string; + sessionId: string; + url: string; + title: string; + content: string | null; + tags: string[]; + timestamp: Date; +}; + +type RawSession = { + id: string; + startedAt: Date; + endedAt: Date | null; +}; + +type RawTrack = { + artist: string; + title: string; + listenedMs: number; + capturedAt: Date; + endedAt: Date | null; +}; + +type MusicProductivity = { + artist: string; + title: string; + minutes: number; + events: number; + perMin: number; +}; + +export type ReportContext = { + markdown: string; + level: ContextLevel; + estimatedTokens: number; + eventCount: number; + sessionCount: number; + trackCount: number; +}; + +export async function buildReportContext( + userId: string, + from: Date, + to: Date, + label: string, +): Promise<ReportContext> { + const [events, sessions, tracks, musicProd] = await Promise.all([ + prisma.event.findMany({ + where: { session: { userId }, timestamp: { gte: from, lte: to } }, + select: { + id: true, sessionId: true, url: true, title: true, + content: true, tags: true, timestamp: true, + }, + orderBy: { timestamp: "asc" }, + }), + prisma.session.findMany({ + where: { userId, startedAt: { gte: from, lte: to } }, + select: { id: true, startedAt: true, endedAt: true }, + orderBy: { startedAt: "asc" }, + }), + prisma.track.findMany({ + where: { session: { userId }, capturedAt: { gte: from, lte: to } }, + select: { artist: true, title: true, listenedMs: true, capturedAt: true, endedAt: true }, + }), + getMusicProductivity(userId, from, to), + ]); + + // Try each level until the rendered context fits within the token budget. + // Level 3 is always fixed-size and acts as the floor. + for (const level of [0, 1, 2, 3] as ContextLevel[]) { + const markdown = renderContext({ + level, label, from, to, + events, sessions, tracks, musicProd, + }); + const tokens = estimateTokens(markdown); + if (tokens <= INPUT_TOKEN_BUDGET || level === 3) { + return { + markdown, + level, + estimatedTokens: tokens, + eventCount: events.length, + sessionCount: sessions.length, + trackCount: tracks.length, + }; + } + } + throw new Error("level 3 must always fit"); +} + +function estimateTokens(text: string): number { + return Math.ceil(text.length / CHARS_PER_TOKEN); +} + +async function getMusicProductivity( + userId: string, + from: Date, + to: Date, +): Promise<MusicProductivity[]> { + return prisma.$queryRaw<MusicProductivity[]>(Prisma.sql` + WITH track_windows AS ( + SELECT + t.artist, + t.title, + t."listenedMs", + t."capturedAt", + COALESCE(t."endedAt", NOW()) AS effective_end + FROM "Track" t + JOIN "Session" s ON s.id = t."sessionId" + WHERE s."userId" = ${userId} + AND t."capturedAt" >= ${from} + AND t."capturedAt" <= ${to} + AND t."listenedMs" >= 60000 + ), + user_events AS ( + SELECT e."timestamp" + FROM "Event" e + JOIN "Session" s ON s.id = e."sessionId" + WHERE s."userId" = ${userId} + AND e."timestamp" >= ${from} + AND e."timestamp" <= ${to} + ) + SELECT + tw.artist, + tw.title, + (tw."listenedMs" / 60000.0)::float AS minutes, + COUNT(ue."timestamp")::int AS events, + (COUNT(ue."timestamp")::float / (tw."listenedMs" / 60000.0))::float AS "perMin" + FROM track_windows tw + LEFT JOIN user_events ue + ON ue."timestamp" >= tw."capturedAt" + AND ue."timestamp" <= tw.effective_end + GROUP BY tw.artist, tw.title, tw."listenedMs" + ORDER BY "perMin" DESC NULLS LAST + LIMIT ${MAX_TOP_TRACKS} + `); +} + +type RenderArgs = { + level: ContextLevel; + label: string; + from: Date; + to: Date; + events: RawEvent[]; + sessions: RawSession[]; + tracks: RawTrack[]; + musicProd: MusicProductivity[]; +}; + +function renderContext(a: RenderArgs): string { + const { level, label, from, to, events, sessions, tracks, musicProd } = a; + const out: string[] = []; + + out.push("# Range"); + out.push(`${fmtDateTime(from)} → ${fmtDateTime(to)} (${label}), timezone UTC`); + out.push(""); + + const totalWorkMs = totalWorkTime(sessions, to); + const activeCount = sessions.filter((s) => !s.endedAt).length; + const endedCount = sessions.length - activeCount; + const distinctHosts = uniqueHosts(events).length; + const distinctTagsN = uniqueTags(events).length; + + out.push("# Summary"); + out.push(`- Sessions: ${sessions.length} (${activeCount} active, ${endedCount} ended)`); + out.push(`- Total session time: ${fmtDuration(totalWorkMs / 1000)}`); + out.push(`- Events captured: ${events.length}`); + out.push(`- Distinct domains: ${distinctHosts}`); + out.push(`- Distinct tags: ${distinctTagsN}`); + out.push(`- Music tracks logged: ${tracks.length}`); + out.push(""); + + if (level === 3) { + if (tracks.length > 0) out.push(...renderMusicSection(tracks, musicProd)); + return out.join("\n").trimEnd(); + } + + // Sessions narrative (top N by recency) + if (sessions.length > 0) { + out.push("# Sessions"); + const shown = sessions.slice(-MAX_SESSIONS_SHOWN); + for (const s of shown) { + const durS = ((s.endedAt ?? to).getTime() - s.startedAt.getTime()) / 1000; + const top = topHostsForSession(events, s.id, 1)[0]; + const tail = top ? `, top host: ${top.host} (${top.count} events)` : ""; + out.push( + `- ${fmtDateTime(s.startedAt)} → ${s.endedAt ? fmtDateTime(s.endedAt) : "active"}` + + ` (${fmtDuration(durS)})${tail}`, + ); + } + if (sessions.length > MAX_SESSIONS_SHOWN) { + out.push(`- … and ${sessions.length - MAX_SESSIONS_SHOWN} earlier sessions in range`); + } + out.push(""); + } + + const tops = topHosts(events, MAX_TOP_DOMAINS); + if (tops.length > 0) { + out.push("# Top domains by event count"); + for (const d of tops) out.push(`- ${d.host} — ${d.count} events`); + out.push(""); + } + + const tagsTop = topTags(events, MAX_TOP_TAGS); + if (tagsTop.length > 0) { + out.push("# Top tags"); + out.push(tagsTop.map((t) => `${t.tag} (${t.count})`).join(", ")); + out.push(""); + } + + if (tracks.length > 0) out.push(...renderMusicSection(tracks, musicProd)); + + if (level >= 2) { + const days = bucketByDay(events); + if (days.length > 0) { + out.push("# Activity by day"); + for (const d of days) { + const hosts = d.topHosts.slice(0, 3).map((h) => `${h.host} (${h.count})`).join(", "); + const tags = d.topTags.slice(0, 3).map((t) => `${t.tag} (${t.count})`).join(", "); + out.push( + `- ${d.date}: ${d.count} events` + + (hosts ? `; hosts: ${hosts}` : "") + + (tags ? `; tags: ${tags}` : ""), + ); + } + out.push(""); + } + const highlights = pickHighlights(events, MAX_HIGHLIGHTS); + if (highlights.length > 0) { + out.push("# Highlights (sample)"); + for (const h of highlights) { + const t = h.tags.length ? ` — tags: ${h.tags.join(", ")}` : ""; + out.push(`- ${fmtDateTime(h.timestamp)} — "${h.title}" — ${hostOf(h.url)}${t}`); + } + out.push(""); + } + return out.join("\n").trimEnd(); + } + + // Level 0 or 1 — full per-event listing + out.push("# Events"); + for (const e of events) { + const t = e.tags.length ? ` — tags: ${e.tags.join(", ")}` : ""; + out.push(`- ${fmtDateTime(e.timestamp)} — "${e.title}" — ${hostOf(e.url)}${t}`); + if (level === 0 && e.content) { + const trimmed = e.content.length > CONTENT_PREVIEW + ? `${e.content.slice(0, CONTENT_PREVIEW)}…` + : e.content; + out.push(` content: "${trimmed.replace(/\s+/g, " ").trim()}"`); + } + } + return out.join("\n").trimEnd(); +} + +function renderMusicSection(tracks: RawTrack[], prod: MusicProductivity[]): string[] { + const out: string[] = []; + out.push("# Music"); + + const byArtist = new Map<string, number>(); + for (const t of tracks) { + byArtist.set(t.artist, (byArtist.get(t.artist) ?? 0) + t.listenedMs); + } + const topArtists = [...byArtist.entries()] + .sort((a, b) => b[1] - a[1]) + .slice(0, MAX_TOP_ARTISTS); + + out.push("Top artists by listening time:"); + for (const [artist, ms] of topArtists) { + out.push(`- ${artist} — ${fmtDuration(ms / 1000)}`); + } + + if (prod.length > 0) { + out.push(""); + out.push("Productivity correlation (events per minute while track was active, tracks with ≥1 min listening):"); + for (const p of prod) { + out.push( + `- "${p.title}" by ${p.artist} — ${p.perMin.toFixed(2)} events/min ` + + `over ${p.minutes.toFixed(1)} min (${p.events} events)`, + ); + } + } + out.push(""); + return out; +} + +function hostOf(url: string): string { + try { return new URL(url).hostname; } catch { return url; } +} + +function fmtDateTime(d: Date): string { + return d.toISOString().slice(0, 16).replace("T", " "); +} + +function fmtDuration(seconds: number): string { + const s = Math.max(0, Math.round(seconds)); + const h = Math.floor(s / 3600); + const m = Math.floor((s % 3600) / 60); + if (h === 0 && m === 0) return `${s}s`; + if (h === 0) return `${m}m`; + return `${h}h ${m}m`; +} + +function uniqueHosts(events: RawEvent[]): string[] { + return [...new Set(events.map((e) => hostOf(e.url)))]; +} + +function uniqueTags(events: RawEvent[]): string[] { + const set = new Set<string>(); + for (const e of events) for (const t of e.tags) set.add(t); + return [...set]; +} + +function topHosts(events: RawEvent[], limit: number) { + const counts = new Map<string, number>(); + for (const e of events) { + const h = hostOf(e.url); + counts.set(h, (counts.get(h) ?? 0) + 1); + } + return [...counts.entries()] + .sort((a, b) => b[1] - a[1]) + .slice(0, limit) + .map(([host, count]) => ({ host, count })); +} + +function topHostsForSession(events: RawEvent[], sessionId: string, limit: number) { + return topHosts(events.filter((e) => e.sessionId === sessionId), limit); +} + +function topTags(events: RawEvent[], limit: number) { + const counts = new Map<string, number>(); + for (const e of events) for (const t of e.tags) { + counts.set(t, (counts.get(t) ?? 0) + 1); + } + return [...counts.entries()] + .sort((a, b) => b[1] - a[1]) + .slice(0, limit) + .map(([tag, count]) => ({ tag, count })); +} + +function bucketByDay(events: RawEvent[]) { + const map = new Map<string, RawEvent[]>(); + for (const e of events) { + const day = e.timestamp.toISOString().slice(0, 10); + if (!map.has(day)) map.set(day, []); + map.get(day)!.push(e); + } + return [...map.entries()] + .sort(([a], [b]) => (a < b ? -1 : 1)) + .map(([date, items]) => ({ + date, + count: items.length, + topHosts: topHosts(items, 5), + topTags: topTags(items, 5), + })); +} + +function pickHighlights(events: RawEvent[], n: number): RawEvent[] { + const withContent = events + .filter((e) => !!e.content?.trim()) + .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime()) + .slice(0, n); + if (withContent.length >= n) return withContent; + + const seen = new Set(withContent.map((e) => e.id)); + const rest = events + .filter((e) => !seen.has(e.id)) + .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime()) + .slice(0, n - withContent.length); + return [...withContent, ...rest]; +} + +function totalWorkTime(sessions: RawSession[], to: Date): number { + let total = 0; + for (const s of sessions) { + const end = s.endedAt ?? to; + total += end.getTime() - s.startedAt.getTime(); + } + return total; +} diff --git a/dashboard/server/reports.ts b/dashboard/server/reports.ts new file mode 100644 index 0000000..cc5f7d3 --- /dev/null +++ b/dashboard/server/reports.ts @@ -0,0 +1,131 @@ +import type { GenerateReportInput } from "./schemas/reports"; +import type { GenerateReportResponse } from "@/types/report"; +import { prisma } from "./db"; +import { buildReportContext } from "./report-context"; +import { getDecryptedGroqApiKey } from "./user-settings"; +import { + groqChat, + getDefaultModel, + GroqAuthError, + GroqContextLimitError, + GroqTimeoutError, + GroqUpstreamError, +} from "./groq"; + +const SYSTEM_PROMPT = `Role: senior productivity coach analyzing a developer's work session log. + +You will receive a structured context about the user's activity: +sessions, events (urls/titles/tags), and music listening with productivity correlation. + +Output a single Markdown report with these sections in order: +1. ## Overview — 2–3 sentence summary of the range. +2. ## Focus areas — bullets: top domains and top tags with brief interpretation. +3. ## Sessions — short narrative across the major sessions (limit to top 5 by duration). +4. ## Music & productivity — IF music data is present: which artists/tracks correlated with higher events/min, vs lower. Avoid clickbait causality — call it "correlation in this range". +5. ## Highlights — 3–5 most interesting events (by content or unusual tags). +6. ## Recommendations — 2–4 concrete suggestions based on visible patterns (e.g. "you spent 2h on Stack Overflow tagged 'prisma' — consider docs bookmark"). Skip if data is too sparse. + +Rules: +- Be specific. Quote concrete numbers and names from the context, never invent. +- If detailLevel >= 2, acknowledge that detail was aggregated and avoid per-event commentary. +- No preamble like "Here is the report"; start directly with "## Overview". +- Keep total length ≤ 600 words.`; + +export class MissingApiKeyError extends Error { + constructor() { + super("No Groq API key configured"); + this.name = "MissingApiKeyError"; + } +} + +export type ResolvedRange = { from: Date; to: Date; label: string }; + +export async function resolveRange( + input: GenerateReportInput, + userId: string, +): Promise<ResolvedRange> { + const now = new Date(); + + switch (input.range) { + case "today": + return { from: startOfDay(now), to: now, label: "today" }; + + case "yesterday": { + const y = shiftDays(now, -1); + return { from: startOfDay(y), to: endOfDay(y), label: "yesterday" }; + } + + case "last_7d": + return { from: shiftDays(now, -7), to: now, label: "last 7 days" }; + + case "last_30d": + return { from: shiftDays(now, -30), to: now, label: "last 30 days" }; + + case "all_time": { + const first = await prisma.session.findFirst({ + where: { userId }, + select: { startedAt: true }, + orderBy: { startedAt: "asc" }, + }); + const from = first?.startedAt ?? shiftDays(now, -1); + return { from, to: now, label: "all time" }; + } + + case "custom": + if (!input.from || !input.to) { + throw new Error("custom range requires both from and to"); + } + return { from: input.from, to: input.to, label: "custom range" }; + } +} + +export async function generateReport( + userId: string, + input: GenerateReportInput, +): Promise<GenerateReportResponse> { + const { from, to, label } = await resolveRange(input, userId); + const ctx = await buildReportContext(userId, from, to, label); + + const userKey = await getDecryptedGroqApiKey(userId); + const apiKey = userKey ?? process.env.GROQ_API_KEY; + if (!apiKey) throw new MissingApiKeyError(); + + const userPrompt = + `detailLevel: ${ctx.level}\n` + + `estimatedContextTokens: ${ctx.estimatedTokens}\n\n` + + ctx.markdown; + + const markdown = await groqChat({ + apiKey, + system: SYSTEM_PROMPT, + user: userPrompt, + }); + + return { + markdown, + range: { from: from.toISOString(), to: to.toISOString(), label }, + contextLevel: ctx.level, + estimatedInputTokens: ctx.estimatedTokens, + model: getDefaultModel(), + }; +} + +function startOfDay(d: Date): Date { + const x = new Date(d); + x.setUTCHours(0, 0, 0, 0); + return x; +} + +function endOfDay(d: Date): Date { + const x = new Date(d); + x.setUTCHours(23, 59, 59, 999); + return x; +} + +function shiftDays(d: Date, delta: number): Date { + const x = new Date(d); + x.setUTCDate(x.getUTCDate() + delta); + return x; +} + +export { GroqAuthError, GroqContextLimitError, GroqTimeoutError, GroqUpstreamError }; diff --git a/dashboard/server/schemas/reports.ts b/dashboard/server/schemas/reports.ts new file mode 100644 index 0000000..796cf86 --- /dev/null +++ b/dashboard/server/schemas/reports.ts @@ -0,0 +1,27 @@ +import { z } from "zod"; + +const RangePreset = z.enum([ + "today", + "yesterday", + "last_7d", + "last_30d", + "all_time", + "custom", +]); + +export const GenerateReportInput = z + .object({ + range: RangePreset, + from: z.coerce.date().optional(), + to: z.coerce.date().optional(), + }) + .refine((d) => d.range !== "custom" || (d.from && d.to), { + message: "custom range requires both from and to", + path: ["from"], + }) + .refine((d) => !d.from || !d.to || d.from <= d.to, { + message: "from must be on or before to", + path: ["from"], + }); + +export type GenerateReportInput = z.infer<typeof GenerateReportInput>; diff --git a/dashboard/server/schemas/user-settings.ts b/dashboard/server/schemas/user-settings.ts new file mode 100644 index 0000000..e32afec --- /dev/null +++ b/dashboard/server/schemas/user-settings.ts @@ -0,0 +1,8 @@ +import { z } from "zod"; + +export const SetApiKeyInput = z.object({ + groqApiKey: z + .union([z.string().min(8, "API key looks too short").max(512), z.null()]), +}); + +export type SetApiKeyInput = z.infer<typeof SetApiKeyInput>; diff --git a/dashboard/server/user-settings.ts b/dashboard/server/user-settings.ts new file mode 100644 index 0000000..936027a --- /dev/null +++ b/dashboard/server/user-settings.ts @@ -0,0 +1,52 @@ +import { prisma } from "./db"; +import { decryptSecret, encryptSecret, last4 } from "./crypto"; + +export type UserSettingsView = { + hasGroqApiKey: boolean; + last4: string | null; +}; + +export async function getUserSettingsView(userId: string): Promise<UserSettingsView> { + const row = await prisma.userSetting.findUnique({ + where: { userId }, + select: { groqApiKey: true, groqApiKeyLast4: true }, + }); + if (!row?.groqApiKey) return { hasGroqApiKey: false, last4: null }; + return { hasGroqApiKey: true, last4: row.groqApiKeyLast4 ?? null }; +} + +export async function getDecryptedGroqApiKey(userId: string): Promise<string | null> { + const row = await prisma.userSetting.findUnique({ + where: { userId }, + select: { groqApiKey: true }, + }); + if (!row?.groqApiKey) return null; + try { + return decryptSecret(row.groqApiKey); + } catch { + return null; + } +} + +export async function setGroqApiKey( + userId: string, + plaintext: string | null, +): Promise<UserSettingsView> { + if (plaintext === null) { + await prisma.userSetting.upsert({ + where: { userId }, + create: { userId, groqApiKey: null, groqApiKeyLast4: null }, + update: { groqApiKey: null, groqApiKeyLast4: null }, + }); + return { hasGroqApiKey: false, last4: null }; + } + + const ciphertext = encryptSecret(plaintext); + const tail = last4(plaintext); + await prisma.userSetting.upsert({ + where: { userId }, + create: { userId, groqApiKey: ciphertext, groqApiKeyLast4: tail }, + update: { groqApiKey: ciphertext, groqApiKeyLast4: tail }, + }); + return { hasGroqApiKey: true, last4: tail }; +} diff --git a/dashboard/types/report.ts b/dashboard/types/report.ts new file mode 100644 index 0000000..4b04c23 --- /dev/null +++ b/dashboard/types/report.ts @@ -0,0 +1,17 @@ +export type RangePreset = + | "today" + | "yesterday" + | "last_7d" + | "last_30d" + | "all_time" + | "custom"; + +export type ContextLevel = 0 | 1 | 2 | 3; + +export type GenerateReportResponse = { + markdown: string; + range: { from: string; to: string; label: string }; + contextLevel: ContextLevel; + estimatedInputTokens: number; + model: string; +}; diff --git a/plans/week3/AC3-ai-session-report.md b/plans/week3/AC3-ai-session-report.md new file mode 100644 index 0000000..1dcb4c5 --- /dev/null +++ b/plans/week3/AC3-ai-session-report.md @@ -0,0 +1,400 @@ +# Plan: Week 3 AC 3 — AI Session Report + +**Branch:** `feature/ai-session-report` +**Closes:** Week 3 AC 3 ([docs/Task.md L89](../../docs/Task.md#L89)) +**Status:** plan, awaiting review + +--- + +## Scope + +Окрема сторінка `/dashboard/reports`, де користувач: + +1. **Обирає діапазон** для якого генерувати звіт: `today` / `yesterday` / `last 7 days` / `last 30 days` / `all time` / `custom from–to`. +2. **(Опційно)** через **modal-портал** вводить свій власний Groq API key. Якщо ключа немає → бекенд бере дефолтний `GROQ_API_KEY` з `.env`. +3. **Натискає "Generate report"** → POST на Route Handler → бекенд: + - Витягує події, треки, метадані сесій по діапазону. + - **Алгоритмічно скейлить контекст** під token budget (підхід нижче у "Design decisions §5"). + - Викликає **Groq** (`llama-3.3-70b-versatile`, 128K context, OpenAI-compatible API). + - Повертає структурований Markdown. +4. Бачить рендер Markdown'у на сторінці (react-markdown). +5. Може **завантажити `.md` файл** (`worktrace-report-<range>-<date>.md`). + +**Музична аналітика** йде в LLM-контекст як окремий блок: топ-артисти по часу прослуховування + кореляція `events/min` під час кожного треку (proxy на "яка музика підвищує продуктивність"). Це **не окремий чарт** — це частина контексту, який LLM аналізує і коментує у фінальному звіті. + +--- + +## Commits (ordered) + +``` +1. docs(plans): add week 3 AC 3 ai session report plan +2. feat(dashboard): add UserSetting model and encrypted groq api key endpoints +3. feat(dashboard): add groq client and report context builder with token-budget sampling +4. feat(ai): add reports/generate route and /dashboard/reports page with markdown render and download +5. feat(dashboard): add api key modal portal on reports page +6. fix(dashboard): address review feedback for week 3 AC 3 ← reserved, only if review requests changes +``` + +> Commit 1 — план. Commit 6 — резерв під правки після код-рев'ю PR. Якщо рев'юер апрувить без зауважень — 6-й комміт не створюється. + +--- + +## Files + +| File | Action | Commit | +|---|---|---| +| `plans/week3/AC3-ai-session-report.md` | **new** — цей план | 1 | +| `dashboard/prisma/schema.prisma` | modify — додати `UserSetting` model | 2 | +| `dashboard/prisma/migrations/<ts>_add_user_setting/migration.sql` | **new** | 2 | +| `dashboard/server/crypto.ts` | **new** — AES-256-GCM encrypt/decrypt API ключів | 2 | +| `dashboard/server/user-settings.ts` | **new** — `getUserSettings(userId)`, `setGroqApiKey(userId, key \| null)` | 2 | +| `dashboard/server/schemas/user-settings.ts` | **new** — Zod для `SetApiKeyInput` | 2 | +| `dashboard/app/api/v1/user/settings/route.ts` | **new** — `GET` (повертає `{ hasGroqApiKey, last4 }` — ніколи сам ключ), `PUT` (set/clear) | 2 | +| `dashboard/.env.example` | modify — `GROQ_API_KEY`, `GROQ_MODEL`, `REPORTS_ENCRYPTION_KEY` | 2 | +| `dashboard/server/groq.ts` | **new** — fetch-обгортка до `api.groq.com/openai/v1/chat/completions` | 3 | +| `dashboard/server/report-context.ts` | **new** — будує LLM-input з DB + token-budget sampling + music-аналітика | 3 | +| `dashboard/server/reports.ts` | **new** — orchestration: resolveRange → buildContext → callGroq → return markdown | 3 | +| `dashboard/server/schemas/reports.ts` | **new** — Zod для `GenerateReportInput` (range / from / to) | 3 | +| `dashboard/types/report.ts` | **new** — `RangePreset`, `GenerateReportResponse`, `ReportContextStats` (внутрішній DTO) | 3 | +| `dashboard/app/api/v1/reports/generate/route.ts` | **new** — `POST` | 4 | +| `dashboard/app/dashboard/reports/page.tsx` | **new** — Server Component (auth check + рендер форми) | 4 | +| `dashboard/app/dashboard/reports/report-form.tsx` | **new** — Client: range picker, generate, мутація, рендер | 4 | +| `dashboard/app/dashboard/reports/markdown-view.tsx` | **new** — wrapper над `react-markdown` + `remark-gfm` зі стилями нашої палітри | 4 | +| `dashboard/app/dashboard/reports/reports-client.ts` | **new** — fetcher'и (`generateReport`, `getApiKeyStatus`, `saveApiKey`) | 4 | +| `dashboard/app/dashboard/app-header.tsx` | modify — додати nav links: `FEED` / `REPORTS` | 4 | +| `dashboard/app/dashboard/reports/api-key-modal.tsx` | **new** — Client, React Portal через `createPortal` у `document.body` | 5 | +| `dashboard/package.json` | modify — `react-markdown`, `remark-gfm` | 4 | + +--- + +## Design decisions + +### 1. Provider: Groq (OpenAI-compatible) + +- Endpoint: `https://api.groq.com/openai/v1/chat/completions` +- Default model: `llama-3.3-70b-versatile` (128K context, ~32K вихідних токенів, безкоштовний tier станом на дату плану) +- Authentication: `Authorization: Bearer <key>` +- Контракт payload'у — OpenAI Chat Completions: `{ model, messages: [{role, content}], temperature, max_tokens }` + +Дефолтний ключ — `process.env.GROQ_API_KEY` (server-only). Якщо у юзера є власний (`UserSetting.groqApiKey` після decrypt) → береться його ключ. Модель не оверайдиться юзером (один `GROQ_MODEL` для всіх). + +**Чому не OpenAI/Gemini:** Task.md прямо рекомендує Groq у free-tier альтернативах ([docs/Task.md L35](../../docs/Task.md#L35)), API сумісне з OpenAI → мінімальна обгортка, 128K контексту достатньо щоб у більшості випадків взагалі не зрізати дані. + +### 2. Storage власного API key — `UserSetting` + AES-256-GCM + +Нова модель: +```prisma +model UserSetting { + userId String @id + groqApiKey String? // ciphertext, base64(iv || authTag || data) + groqApiKeyLast4 String? // зберігаємо open для UI ("sk-…abcd") + updatedAt DateTime @updatedAt + user User @relation(fields: [userId], references: [id], onDelete: Cascade) +} +``` + +- `@id` на `userId` → 1-до-1 з `User`, не плодимо PKs. +- `groqApiKey` — **шифровка**, не plaintext. Майстер-ключ — окрема env-змінна `REPORTS_ENCRYPTION_KEY` (32 байти, base64). Не реюзаємо `JWT_SECRET` — rotation policies різні. +- `crypto.ts` використовує `node:crypto.createCipheriv("aes-256-gcm", key, iv)` — нативний модуль, без нових деп. +- `groqApiKeyLast4` — зручність для UI ("**** **** **** XYZ4"); самостійно нічого не розкриває. +- При `PUT` із порожнім тілом — clearцієм обидва поля → бекенд знов вертатиме дефолтний ключ. + +API: +``` +GET /api/v1/user/settings → { hasGroqApiKey: boolean, last4: string | null } +PUT /api/v1/user/settings → body { groqApiKey: string } → { hasGroqApiKey: true, last4 } +PUT /api/v1/user/settings → body { groqApiKey: null } → { hasGroqApiKey: false, last4: null } +``` + +**Ніколи не повертаємо** plaintext ключ через API. Якщо юзер хоче його змінити — вводить заново. + +### 3. Range presets — централізована резолюція + +`server/reports.ts → resolveRange(input): { from: Date; to: Date; label: string }`: + +| Preset | from | to | Тип діапазону | +|---|---|---|---| +| `today` | `startOfDay(now)` | `now` | вузький | +| `yesterday` | `startOfDay(now - 1d)` | `endOfDay(now - 1d)` | вузький | +| `last_7d` | `now - 7d` | `now` | середній | +| `last_30d` | `now - 30d` | `now` | широкий | +| `all_time` | `min(Session.startedAt)` для userId | `now` | будь-який | +| `custom` | `input.from` (валід Zod) | `input.to` | будь-який | + +Всі обчислення — у UTC server-side. У UI показуємо preset-кнопки + два date-input'и для `custom`. + +### 4. Контекст для LLM — structured JSON-like Markdown, не raw JSON + +LLM працює якісніше з людино-читабельним структурованим input'ом. Будуємо такий шаблон: + +``` +# Range +Mon Apr 21 → Sun Apr 27 (last 7 days), timezone UTC + +# Summary +- Sessions: 12 (3 active, 9 ended) +- Total work time: 14h 22m +- Events captured: 287 +- Distinct domains: 23 +- Distinct tags: 18 + +# Sessions +- 2026-04-21 09:14 → 11:48 (2h 34m), top: github.com (1h 12m) +- ... + +# Top domains by time +1. github.com — 4h 18m, 89 events +2. localhost:3000 — 2h 50m, 54 events +3. ... + +# Top tags +react (47), typescript (39), bug (22), ... + +# Music +Top artists by listening time: +- Tame Impala — 1h 42m +- Bon Iver — 58m +- ... +Productivity proxy (events logged per minute while track was playing): +- "Currents" by Tame Impala — 0.8 events/min over 42m +- "Holocene" by Bon Iver — 0.3 events/min over 18m +- ... + +# Notable events (sample) +- 2026-04-22 14:08 — "Fix prisma adapter migration" — github.com — tags: bug, prisma + content: "Investigating why the adapter-pg ..." +- ... +``` + +**Чому шаблон, а не raw JSON dump:** менше токенів на роздільниках/синтаксисі, легше для моделі. + +### 5. Token-budget sampling — алгоритм + +Constants: +``` +INPUT_TOKEN_BUDGET = 30_000 // 30K — ~24% від 128K контексту; решта на system prompt + response +CHARS_PER_TOKEN = 4 // heuristic для llama-tokenizer (точне рахування — overkill для MVP) +``` + +Алгоритм (у `report-context.ts`): + +``` +1. Завантажуємо з БД ВСЕ що треба для діапазону: + - сесії (id, startedAt, endedAt) + - події (id, sessionId, url, title, content, tags, timestamp) + - треки (artist, title, listenedMs, capturedAt, endedAt, sessionId) + +2. Будуємо стискальні шари (fallback chain): + LEVEL 0 — full: кожна подія з повним content + LEVEL 1 — no_content: content → null, лишається title + url + tags + LEVEL 2 — daily_only: події групуються по днях; для кожного дня — count, top 5 hosts, top 5 tags. Нотатки (events з пустим url або content > 200) лишаються окремо як "highlights" (≤ 20 шт.) + LEVEL 3 — stats_only: тільки summary блок + Music. Подієвий зріз відсутній. + +3. Серіалізуємо контекст у Markdown-шаблон (вище). +4. Estimate = ceil(chars / 4). Якщо ≤ INPUT_TOKEN_BUDGET — повертаємо. +5. Інакше — деградуємо level (0 → 1 → 2 → 3) і повторюємо. +6. На LEVEL 3 завжди влазимо (фіксований розмір). + +Повертаємо: { markdown, level, estimatedTokens, range } +``` + +LLM на верхньому рівні system promp'ту отримує: "Context detail level: 2 (daily aggregate). Individual events were too numerous to include." — щоб модель знала які узагальнення робити. + +**Edge cases:** +- 0 подій у діапазоні → одразу LEVEL 3 + явне "No events in range" → LLM має написати "There is no activity to report for this range." +- 0 треків → музичний блок просто пропускається у шаблоні; LLM не отримує сигнал писати про музику. + +### 6. Music analytics — як рахуємо + +**Топ-артисти по часу:** `SUM(Track.listenedMs) GROUP BY artist ORDER BY DESC LIMIT 10`. Фільтр: `Track.capturedAt` у діапазоні. + +**Events/min під час треку (productivity proxy):** +``` +для кожного треку T (artist, title, capturedAt, endedAt, listenedMs): + N = COUNT(Event) WHERE Event.timestamp BETWEEN T.capturedAt AND COALESCE(T.endedAt, T.capturedAt + T.listenedMs) + AND Event.session.userId = userId + ratio = N / (T.listenedMs / 60000) +повертаємо топ-5 за ratio (тільки де listenedMs > 60_000 — менш ніж 1 хв безкорисно для статистики) +``` + +Реалізуємо одним `$queryRaw` (Postgres підтримує всі ці JOIN/GROUP). Не запихаємо це у `getEventStatsForUser` — він на іншій ціні. Новий `getMusicCorrelationForUser(userId, from, to)` у `report-context.ts` (helper-функція, не публічний `server/` API — використовується тільки звітами). + +### 7. System prompt — фіксований, у `server/reports.ts` + +``` +Role: senior productivity coach analyzing a developer's work session log. + +You will receive a structured context about the user's activity: +sessions, events (urls/titles/tags), and music listening with productivity correlation. + +Output a single Markdown report with these sections in order: +1. ## Overview — 2–3 sentence summary of the range. +2. ## Focus areas — bullets: top domains and top tags with brief interpretation. +3. ## Sessions — short narrative across the major sessions (limit to top 5 by duration). +4. ## Music & productivity — IF music data present: which artists/tracks + correlated with higher events/min, vs lower. Avoid clickbait causality — + call it "correlation in this range". +5. ## Highlights — 3–5 most interesting events (by content or unusual tags). +6. ## Recommendations — 2–4 concrete suggestions based on visible patterns + (e.g. "you spent 2h on Stack Overflow tagged 'prisma' — consider docs + bookmark"). Skip if data is too sparse. + +Rules: +- Be specific. Quote concrete numbers and names from the context, never invent. +- If context.detailLevel >= 2, acknowledge that detail was aggregated and avoid + per-event commentary. +- No preamble like "Here is the report"; start directly with "## Overview". +- ≤ 600 words total. +``` + +User message — Markdown-контекст з §4 + явний service-блок: +``` +detailLevel: 1 +estimatedContextTokens: 18452 +``` + +### 8. Route Handler — `POST /api/v1/reports/generate` + +``` +1. requireUser(req) → userId +2. Zod validate body → { range: "today" | ... | "custom", from?, to? } +3. resolveRange(input, userId) → { from, to, label } +4. buildReportContext(userId, from, to) → { markdown, level, estimatedTokens } +5. apiKey = (await getUserSettings(userId)).groqApiKey ?? process.env.GROQ_API_KEY +6. groqChat({ apiKey, model, system, user: contextMarkdown }) → response text +7. return { markdown: response, range: label, contextLevel: level, estimatedInputTokens, model } +``` + +Помилки: +- 401 — нема auth +- 400 — невалідний range / custom без `from`/`to` / `from > to` +- 402 — Groq повертає 401 (юзерський ключ протух) — кажемо "Invalid API key — clear it in settings or set a new one" +- 502 — Groq повертає 5xx / network failure → "AI provider unavailable, try again" +- 504 — fetch timeout (60s ABORT) → "AI request timed out" + +CORS пар-handler `OPTIONS` додаємо для консистентності з іншими `/api/v1/*`, навіть якщо роут поки що не викликається з extension. + +### 9. UI: `/dashboard/reports` page + +**Layout** успадковується від `/dashboard/layout.tsx` (sticky header вже є з AC2). Додаю у `app-header.tsx` дві nav-кнопки (`FEED` → `/dashboard`, `REPORTS` → `/dashboard/reports`) — стиль той самий монохром-кібер як у решті дашборду. + +**`report-form.tsx`** (Client Component): +- 6 preset-чіпів зверху + collapsible "Custom dates" з двома `<input type="date">` +- Праворуч від presets — маленька кнопка `⚙ API KEY` → відкриває modal +- Кнопка `▶ GENERATE REPORT` (disabled при loading) +- Під формою: + - `loading` state — animated stripe + "Asking the model… this can take 10–30s" + - `error` state — карточка з повідомленням і "Retry" + - `success` state — `MarkdownView` + кнопки `↓ DOWNLOAD .MD` і `🔁 NEW REPORT` + +Стан зберігається у `useState` тільки на сторінці — без TanStack Query (генерація — одноразова дія, не cache-friendly). Тримаємо як `useMutation` з TanStack? — ні, простий `fetch` + `useState({status, data, error})` достатньо; екосистема query-кешу тут не дає виграшу. + +**Завантаження `.md`:** +```ts +const blob = new Blob([markdown], { type: "text/markdown" }); +const url = URL.createObjectURL(blob); +const a = document.createElement("a"); +a.href = url; +a.download = `worktrace-report-${rangeSlug}-${YYYYMMDD}.md`; +a.click(); +URL.revokeObjectURL(url); +``` + +### 10. UI: API Key modal — React Portal + +`api-key-modal.tsx`: +- `createPortal(<dialog>, document.body)` — щоб overlay не клавіш на layout dashboard'у. +- Backdrop + центрована карточка. Закриття: `Esc` / клік по backdrop / кнопка `✕`. +- Поля: + - `<input type="password">` для нового ключа + - кнопка `SAVE` — `PUT /api/v1/user/settings` з `{ groqApiKey }` + - кнопка `CLEAR KEY` (показується тільки якщо `hasGroqApiKey === true`) → `PUT` з `{ groqApiKey: null }` +- Зверху статус: "Currently using your own key (•••• abcd)" або "Currently using the shared default key" +- При успішному save → закриваємо modal, оновлюємо локальний стан. +- Без TanStack Query — самостійний fetch + local state. + +**Чому Portal, а не звичайний абсолют-div:** sticky header має `z-10` і `backdrop-blur` → overlay усередині layout'у трапить підлеглим. Portal у `body` дає чистий top-level rendering без z-index війн. + +### 11. Markdown render — `react-markdown` + `remark-gfm` + +- `react-markdown` рендерить markdown у safe React tree (без `dangerouslySetInnerHTML`). +- `remark-gfm` — GitHub-flavored Markdown (таблиці, todo-checkboxes). +- Кастомні mappings — h1/h2/h3 у нашу палітру (cyan для h2, purple для h3), inline code у `--c-surface` фон. + +**Без подальших ремарків** (без `rehype-highlight` etc.) — звіт це проза, не код. Простір на bundle економимо. + +### 12. Чому не Server Action + +- Server Actions — для form-submit'ів без JSON-API. Наш роут потенційно буде дёргатись з extension у майбутньому (Week 4 ідея) → REST-консистентність з іншими `/api/v1/*` корисніша. +- Прогрес-бар / cancellation / retry — простіше через звичайний fetch. + +### 13. Безпека: ніяк не сипати ключі у логи / response + +- При помилці Groq — у respondі **тільки** generic-повідомлення; точну причину логуємо `console.error("[groq]", err)`. +- `apiKey` ніколи не серіалізується у respondі. +- Validation в `crypto.ts.encrypt()`: якщо `REPORTS_ENCRYPTION_KEY` не виставлено → throw старт-up error (фейл-фаст на dev). + +--- + +## Verification checklist + +### Backend +- [ ] `cd dashboard && npx tsc --noEmit` — без помилок +- [ ] `npm run build` — без помилок +- [ ] `npx prisma migrate dev --name add_user_setting` — міграція проходить, БД має таблицю `UserSetting` +- [ ] `GET /api/v1/user/settings` без cookie → 401 +- [ ] `GET /api/v1/user/settings` з cookie, без ключа → `{ hasGroqApiKey: false, last4: null }` +- [ ] `PUT /api/v1/user/settings` `{ groqApiKey: "test123…" }` → 200, `last4 === "…cdef"` (адекватний хвіст) +- [ ] У БД `UserSetting.groqApiKey` — НЕ plaintext (видно base64-сміття) +- [ ] `PUT /api/v1/user/settings` `{ groqApiKey: null }` → 200, `last4: null`, у БД `null` +- [ ] `POST /api/v1/reports/generate` без cookie → 401 +- [ ] `POST /api/v1/reports/generate` з `{ range: "today" }` → 200, `markdown` починається з `## Overview` +- [ ] `POST /api/v1/reports/generate` з `{ range: "custom", from: <ISO>, to: <ISO> }` де `from > to` → 400 +- [ ] `POST /api/v1/reports/generate` коли подій 0 → 200, markdown містить "no activity"-фразу (тобто LLM правильно зрозумів) +- [ ] `POST /api/v1/reports/generate` з `{ range: "all_time" }` на акаунті з 1000+ подій → 200, у логах видно `level: 2` або `level: 3` (sampling спрацював) +- [ ] Невалідний user-key → 402 з людським повідомленням +- [ ] Mock-fail Groq URL → 502 + +### Token-budget sampling (unit-feel checks) +- [ ] При вузькому діапазоні з малим content'ом — використовується LEVEL 0 (повний) +- [ ] При штучно гігантському діапазоні — деградується щонайменше до LEVEL 2 і `estimatedTokens ≤ INPUT_TOKEN_BUDGET` +- [ ] На LEVEL 3 контекст-маркдаун має фіксовану структуру (тільки `## Summary` + `## Music`) і влазить ~< 2000 токенів + +### UI / стилі +- [ ] `/dashboard/reports` без cookie → 307 → `/login` +- [ ] Header показує nav `FEED | REPORTS`, активний має акцентний колір +- [ ] Preset-кнопки (`TODAY`, `YESTERDAY`, …) — клік перемикає state, активна виділяється +- [ ] `Custom` секція показує два date-input'и тільки після кліку на preset `CUSTOM` +- [ ] `GENERATE` дізейблений під час loading, текст індикатора видно +- [ ] Після генерації markdown рендериться з нашою палітрою (h2 cyan, code у surface) +- [ ] `DOWNLOAD .MD` створює файл з ім'ям `worktrace-report-<range>-YYYYMMDD.md`, контент = згенерований markdown +- [ ] `NEW REPORT` ресетає стан до пустої форми + +### API key modal +- [ ] Кнопка `⚙ API KEY` відкриває overlay поверх header'а (Portal працює) +- [ ] `Esc` і клік по backdrop закривають +- [ ] Введений ключ маскується (`type=password`) +- [ ] Save → закриває modal, бейдж "Using your own key (••••XYZ4)" з'являється на сторінці +- [ ] Clear → бейдж зникає, повертається "Using shared default key" +- [ ] Перезавантаження сторінки → стан зберігається з БД (`GET /api/v1/user/settings` на mount) + +### End-to-end +- [ ] Логін через Google → перейти на `/dashboard/reports` → preset `LAST 7 DAYS` → `GENERATE` → за ~10–30s видно повноцінний звіт із заголовками + Music секція (якщо є треки) +- [ ] Завантажити `.md` → відкрити у VS Code → це валідний Markdown +- [ ] Налаштувати свій ключ → згенерувати знов → у `Network` видно `200` (доводить що бекенд використав інший ключ; перевіримо також на сторінці Groq console) +- [ ] Регресія: `/dashboard` (feed з AC2) і `/login` (AC1) не зламались + +--- + +## Out of scope + +- Збереження історії згенерованих звітів у БД (download'ом достатньо для MVP; колись додамо `Report` model) +- Шаринг звіту по URL / public link +- Стрімінг відповіді з Groq (SSE) — синхронний request/response достатній; UI показує "generating…" splash +- Per-session report (буквальна кнопка на сторінці конкретної сесії) — `/dashboard/sessions/[id]` сторінки не існує; reports працюють по range-у +- Custom system-prompt / template editor для юзера +- Підтримка кількох провайдерів одночасно (OpenAI/Gemini/Groq toggle) — тільки Groq у цьому AC +- Підрахунок токенів через справжній tokenizer (`tiktoken` / `llama-tokenizer-js`) — heuristic chars/4 достатньо для sampling гейту +- Cost tracking / quota — free-tier Groq, ліміти не моніторимо +- Animations переходів між станами loading→success — Week 4 бонус AC 4 +- Rate-limit на `POST /api/v1/reports/generate` per-user — post-MVP, коли побачимо abuse From 8e181d83a74170d5a1e95e9a311bd02ff0c9a49b Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Thu, 28 May 2026 20:51:23 +0300 Subject: [PATCH 17/24] feat(dashboard): Week 3 AC 4 (bonus) - music analytics page with Chart.js (#17) * docs(plans): add week 3 AC4 music analytics plan * refactor(server): extract resolveRange to server/range.ts * feat(music): server module, types, and GET /api/v1/music/stats route * feat(music): /dashboard/music page with Chart.js charts * feat(nav): add MUSIC to header nav * fix(music): aggregate getTopTracks by artist+title to deduplicate rows * fix(music): correct logic in music queries - getTopArtists: COUNT(DISTINCT title) via $queryRaw (was counting rows, not unique tracks) - getMusicProductivity: GROUP BY artist+title + SUM(listenedMs); endedAt null fallback uses capturedAt+listenedMs duration instead of NOW() - getMusicTotals: totalTracks counts distinct (artist,title) pairs via groupBy (was counting all capture rows) --- dashboard/app/api/v1/music/stats/route.ts | 68 ++++++ dashboard/app/dashboard/header-nav.tsx | 1 + dashboard/app/dashboard/mobile-nav.tsx | 1 + .../app/dashboard/music/hourly-chart.tsx | 87 ++++++++ .../app/dashboard/music/music-client.tsx | 158 +++++++++++++ dashboard/app/dashboard/music/page.tsx | 22 ++ .../dashboard/music/productivity-chart.tsx | 90 ++++++++ .../app/dashboard/music/top-artists-chart.tsx | 82 +++++++ dashboard/server/music.ts | 169 ++++++++++++++ dashboard/server/range.ts | 69 ++++++ dashboard/server/report-context.ts | 64 +----- dashboard/server/reports.ts | 61 +----- dashboard/server/schemas/music.ts | 9 + dashboard/types/music-stats.ts | 36 +++ plans/week3/AC4-music-analytics.md | 207 ++++++++++++++++++ 15 files changed, 1008 insertions(+), 116 deletions(-) create mode 100644 dashboard/app/api/v1/music/stats/route.ts create mode 100644 dashboard/app/dashboard/music/hourly-chart.tsx create mode 100644 dashboard/app/dashboard/music/music-client.tsx create mode 100644 dashboard/app/dashboard/music/page.tsx create mode 100644 dashboard/app/dashboard/music/productivity-chart.tsx create mode 100644 dashboard/app/dashboard/music/top-artists-chart.tsx create mode 100644 dashboard/server/music.ts create mode 100644 dashboard/server/range.ts create mode 100644 dashboard/server/schemas/music.ts create mode 100644 dashboard/types/music-stats.ts create mode 100644 plans/week3/AC4-music-analytics.md diff --git a/dashboard/app/api/v1/music/stats/route.ts b/dashboard/app/api/v1/music/stats/route.ts new file mode 100644 index 0000000..cc4131d --- /dev/null +++ b/dashboard/app/api/v1/music/stats/route.ts @@ -0,0 +1,68 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getCurrentUser } from "@/server/current-user"; +import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { withCors, corsPreflight } from "@/server/cors"; +import { MusicStatsQuery } from "@/server/schemas/music"; +import { resolveRange } from "@/server/range"; +import { + getTopArtists, + getTopTracks, + getMusicProductivity, + getHourlyPattern, + getMusicTotals, +} from "@/server/music"; +import type { MusicStats } from "@/types/music-stats"; + +export const GET = withCors(async (req: NextRequest) => { + // Cookie auth (dashboard) — fallback to Bearer (extension) + let userId: string; + try { + const cookie = await getCurrentUser(); + if (cookie) { + userId = cookie.id; + } else { + userId = requireUser(req).id; + } + } catch (err) { + if (err instanceof UnauthorizedError) { + return NextResponse.json({ error: err.message }, { status: 401 }); + } + throw err; + } + + const params = Object.fromEntries(req.nextUrl.searchParams); + const parsed = MusicStatsQuery.safeParse(params); + if (!parsed.success) { + return NextResponse.json({ error: "Invalid query params" }, { status: 400 }); + } + + const { from, to, label } = await resolveRange( + { range: parsed.data.range, from: parsed.data.from, to: parsed.data.to }, + userId, + ); + + const [topArtists, topTracks, productivity, hourlyPattern, totals] = await Promise.all([ + getTopArtists(userId, from, to), + getTopTracks(userId, from, to), + getMusicProductivity(userId, from, to), + getHourlyPattern(userId, from, to), + getMusicTotals(userId, from, to), + ]); + + const body: MusicStats = { + topArtists, + topTracks, + productivity, + hourlyPattern, + totalListenedMs: totals.totalListenedMs, + totalArtists: totals.totalArtists, + totalTracks: totals.totalTracks, + range: { from: from.toISOString(), to: to.toISOString(), label }, + }; + + return NextResponse.json(body); +}); + +export function OPTIONS(req: NextRequest) { + return corsPreflight(req); +} diff --git a/dashboard/app/dashboard/header-nav.tsx b/dashboard/app/dashboard/header-nav.tsx index 2b31d6f..0fb05a0 100644 --- a/dashboard/app/dashboard/header-nav.tsx +++ b/dashboard/app/dashboard/header-nav.tsx @@ -6,6 +6,7 @@ import { usePathname } from "next/navigation"; const ITEMS: { href: string; label: string }[] = [ { href: "/dashboard", label: "FEED" }, { href: "/dashboard/reports", label: "REPORTS" }, + { href: "/dashboard/music", label: "MUSIC" }, ]; export function HeaderNav() { diff --git a/dashboard/app/dashboard/mobile-nav.tsx b/dashboard/app/dashboard/mobile-nav.tsx index a4dcb06..3630f38 100644 --- a/dashboard/app/dashboard/mobile-nav.tsx +++ b/dashboard/app/dashboard/mobile-nav.tsx @@ -7,6 +7,7 @@ import { useState } from "react"; const ITEMS: { href: string; label: string }[] = [ { href: "/dashboard", label: "FEED" }, { href: "/dashboard/reports", label: "REPORTS" }, + { href: "/dashboard/music", label: "MUSIC" }, ]; export function MobileNav() { diff --git a/dashboard/app/dashboard/music/hourly-chart.tsx b/dashboard/app/dashboard/music/hourly-chart.tsx new file mode 100644 index 0000000..f8ebe27 --- /dev/null +++ b/dashboard/app/dashboard/music/hourly-chart.tsx @@ -0,0 +1,87 @@ +"use client"; + +import { Bar } from "react-chartjs-2"; +import { + Chart as ChartJS, + CategoryScale, + LinearScale, + BarElement, + Tooltip, + Legend, +} from "chart.js"; +import type { HourBucket } from "@/types/music-stats"; + +ChartJS.register(CategoryScale, LinearScale, BarElement, Tooltip, Legend); + +const HOUR_LABELS = Array.from({ length: 24 }, (_, h) => + `${String(h).padStart(2, "0")}:00`, +); + +export function HourlyChart({ buckets }: { buckets: HourBucket[] }) { + const sorted = [...buckets].sort((a, b) => a.hour - b.hour); + const hasData = sorted.some((b) => b.listenedMs > 0 || b.eventCount > 0); + + if (!hasData) { + return ( + <div className="flex h-52 items-center justify-center rounded border border-border bg-surface text-[10px] tracking-widest text-muted"> + NO HOURLY DATA IN RANGE + </div> + ); + } + + return ( + <div className="flex flex-col rounded border border-border bg-surface p-4"> + <div className="mb-3 text-[10px] font-bold tracking-widest text-muted"> + HOURLY ACTIVITY PATTERN + </div> + <div className="h-52"> + <Bar + data={{ + labels: HOUR_LABELS, + datasets: [ + { + label: "listening (min)", + data: sorted.map((b) => Math.round(b.listenedMs / 60000)), + backgroundColor: "rgba(0, 229, 176, 0.7)", + borderColor: "#00e5b0", + borderWidth: 1, + borderRadius: 2, + }, + { + label: "events", + data: sorted.map((b) => b.eventCount), + backgroundColor: "rgba(168, 85, 247, 0.7)", + borderColor: "#a855f7", + borderWidth: 1, + borderRadius: 2, + }, + ], + }} + options={{ + responsive: true, + maintainAspectRatio: false, + plugins: { + legend: { + position: "top", + align: "end", + labels: { color: "#c8d0f0", font: { size: 9, family: "Courier New" }, boxWidth: 12 }, + }, + tooltip: { mode: "index", intersect: false }, + }, + scales: { + x: { + ticks: { color: "#3e3e60", font: { size: 8, family: "Courier New" }, maxRotation: 45 }, + grid: { color: "rgba(28, 28, 56, 0.5)" }, + }, + y: { + beginAtZero: true, + ticks: { color: "#3e3e60", font: { size: 9, family: "Courier New" }, precision: 0 }, + grid: { color: "rgba(28, 28, 56, 0.5)" }, + }, + }, + }} + /> + </div> + </div> + ); +} diff --git a/dashboard/app/dashboard/music/music-client.tsx b/dashboard/app/dashboard/music/music-client.tsx new file mode 100644 index 0000000..d65c71f --- /dev/null +++ b/dashboard/app/dashboard/music/music-client.tsx @@ -0,0 +1,158 @@ +"use client"; + +import { useState } from "react"; +import { keepPreviousData, useQuery } from "@tanstack/react-query"; +import type { MusicStats } from "@/types/music-stats"; +import { TopArtistsChart } from "./top-artists-chart"; +import { ProductivityChart } from "./productivity-chart"; +import { HourlyChart } from "./hourly-chart"; + +type Preset = "today" | "yesterday" | "last_7d" | "last_30d" | "all_time"; + +const PRESETS: { value: Preset; label: string }[] = [ + { value: "today", label: "TODAY" }, + { value: "yesterday", label: "YESTERDAY" }, + { value: "last_7d", label: "LAST 7 DAYS" }, + { value: "last_30d", label: "LAST 30 DAYS" }, + { value: "all_time", label: "ALL TIME" }, +]; + +async function fetchMusicStats(range: Preset): Promise<MusicStats> { + const res = await fetch(`/api/v1/music/stats?range=${range}`); + if (!res.ok) { + const body = await res.json().catch(() => ({})) as { error?: string }; + throw new Error(body.error ?? `HTTP ${res.status}`); + } + return res.json() as Promise<MusicStats>; +} + +function fmtListened(ms: number): string { + const h = Math.floor(ms / 3600000); + const m = Math.floor((ms % 3600000) / 60000); + if (h === 0) return `${String(m)}m`; + return `${String(h)}h ${String(m)}m`; +} + +export function MusicClient() { + const [range, setRange] = useState<Preset>("last_7d"); + + const { data, isLoading, isError, error } = useQuery({ + queryKey: ["music-stats", range], + queryFn: () => fetchMusicStats(range), + placeholderData: keepPreviousData, + staleTime: 60_000, + }); + + return ( + <div className="flex flex-col gap-4"> + {/* Range picker */} + <section className="rounded border border-border bg-surface p-4"> + <div className="mb-3 text-[10px] font-bold tracking-widest text-muted">RANGE</div> + <div className="flex flex-wrap gap-2"> + {PRESETS.map((p) => ( + <button + key={p.value} + type="button" + onClick={() => setRange(p.value)} + disabled={isLoading} + className={ + "cursor-pointer rounded border px-3 py-1.5 text-[10px] font-bold tracking-widest transition-colors disabled:opacity-50 " + + (range === p.value + ? "border-cyan bg-cyan/10 text-cyan" + : "border-border text-muted hover:border-purple/60 hover:text-text") + } + > + {p.label} + </button> + ))} + </div> + </section> + + {isLoading && !data ? <SkeletonGrid /> : null} + + {isError ? ( + <div className="rounded border border-pink/40 bg-surface px-4 py-6 text-center text-xs text-pink"> + {error instanceof Error ? error.message : "Failed to load music data"} + </div> + ) : null} + + {data ? ( + <> + {/* Summary row */} + <div className="flex flex-wrap gap-4 text-[10px] tracking-widest text-muted"> + <span> + LISTENED: <span className="text-cyan">{fmtListened(data.totalListenedMs)}</span> + </span> + <span>·</span> + <span> + ARTISTS: <span className="text-cyan">{data.totalArtists}</span> + </span> + <span>·</span> + <span> + TRACKS: <span className="text-cyan">{data.totalTracks}</span> + </span> + </div> + + {data.totalTracks === 0 ? ( + <div className="rounded border border-border bg-surface px-4 py-10 text-center text-[10px] tracking-widest text-muted"> + NO MUSIC DATA FOR THIS RANGE + </div> + ) : ( + <> + {/* Top Artists + Productivity side by side on lg */} + <div className="grid grid-cols-1 gap-4 lg:grid-cols-2"> + <TopArtistsChart artists={data.topArtists} /> + <ProductivityChart rows={data.productivity} /> + </div> + + {/* Hourly pattern full width */} + <HourlyChart buckets={data.hourlyPattern} /> + + {/* Top Tracks text table */} + <section className="rounded border border-border bg-surface p-4"> + <div className="mb-3 text-[10px] font-bold tracking-widest text-muted"> + TOP TRACKS + </div> + <div className="flex flex-col gap-1"> + {data.topTracks.map((t, i) => ( + <div + key={`${t.artist}::${t.title}`} + className="flex items-baseline gap-3 py-1 text-xs" + > + <span className="w-5 shrink-0 text-right text-[10px] text-muted"> + {i + 1} + </span> + <span className="min-w-0 flex-1 truncate text-text"> + {t.title} + </span> + <span className="shrink-0 text-[10px] text-muted"> + {t.artist} + </span> + <span className="shrink-0 text-[10px] text-cyan"> + {fmtListened(t.listenedMs)} + </span> + </div> + ))} + </div> + </section> + </> + )} + </> + ) : null} + </div> + ); +} + +function SkeletonGrid() { + return ( + <div className="flex flex-col gap-4"> + <div className="h-6 w-64 animate-pulse rounded bg-surface" /> + <div className="grid grid-cols-1 gap-4 lg:grid-cols-2"> + <div className="h-64 animate-pulse rounded border border-border bg-surface" /> + <div className="h-64 animate-pulse rounded border border-border bg-surface" /> + </div> + <div className="h-52 animate-pulse rounded border border-border bg-surface" /> + <div className="h-40 animate-pulse rounded border border-border bg-surface" /> + </div> + ); +} diff --git a/dashboard/app/dashboard/music/page.tsx b/dashboard/app/dashboard/music/page.tsx new file mode 100644 index 0000000..dc0ea12 --- /dev/null +++ b/dashboard/app/dashboard/music/page.tsx @@ -0,0 +1,22 @@ +import type { Metadata } from "next"; +import { redirect } from "next/navigation"; +import { getCurrentUser } from "@/server/current-user"; +import { MusicClient } from "./music-client"; + +export const metadata: Metadata = { + title: "Music Analytics", + description: "Correlation between music listening and session activity.", + robots: { index: false, follow: false }, +}; + +export default async function MusicPage() { + const user = await getCurrentUser(); + if (!user) redirect("/login"); + + return ( + <div className="mx-auto flex w-full max-w-6xl flex-col gap-6 px-6 py-8"> + <h1 className="text-base font-bold tracking-widest text-cyan">MUSIC ANALYTICS</h1> + <MusicClient /> + </div> + ); +} diff --git a/dashboard/app/dashboard/music/productivity-chart.tsx b/dashboard/app/dashboard/music/productivity-chart.tsx new file mode 100644 index 0000000..06aa915 --- /dev/null +++ b/dashboard/app/dashboard/music/productivity-chart.tsx @@ -0,0 +1,90 @@ +"use client"; + +import { Bar } from "react-chartjs-2"; +import { + Chart as ChartJS, + CategoryScale, + LinearScale, + BarElement, + Tooltip, +} from "chart.js"; +import type { ProductivityRow } from "@/types/music-stats"; + +ChartJS.register(CategoryScale, LinearScale, BarElement, Tooltip); + +export function ProductivityChart({ rows }: { rows: ProductivityRow[] }) { + const withActivity = rows.filter((r) => r.perMin > 0); + + if (withActivity.length === 0) { + return ( + <div className="flex h-64 items-center justify-center rounded border border-border bg-surface text-[10px] tracking-widest text-muted"> + NO PRODUCTIVITY DATA IN RANGE + </div> + ); + } + + const labels = withActivity.map((r) => `${r.title} / ${r.artist}`); + + return ( + <div className="flex flex-col rounded border border-border bg-surface p-4"> + <div className="mb-1 text-[10px] font-bold tracking-widest text-muted"> + PRODUCTIVITY CORRELATION + </div> + <div className="mb-3 text-[9px] tracking-widest text-muted"> + events / min while track was active + </div> + <div style={{ height: `${Math.max(withActivity.length * 28, 160)}px` }}> + <Bar + data={{ + labels, + datasets: [ + { + data: withActivity.map((r) => Math.round(r.perMin * 100) / 100), + backgroundColor: "#a855f7", + borderColor: "#a855f7", + borderWidth: 0, + borderRadius: 2, + }, + ], + }} + options={{ + indexAxis: "y", + responsive: true, + maintainAspectRatio: false, + plugins: { + legend: { display: false }, + tooltip: { + callbacks: { + label: (ctx) => { + const r = withActivity[ctx.dataIndex]; + return r + ? ` ${r.perMin.toFixed(2)} events/min · ${r.minutes.toFixed(1)} min listened · ${String(r.events)} events` + : ""; + }, + }, + }, + }, + scales: { + x: { + ticks: { color: "#3e3e60", font: { size: 9, family: "Courier New" } }, + grid: { color: "rgba(28, 28, 56, 0.5)" }, + title: { display: true, text: "events / min", color: "#3e3e60", font: { size: 9, family: "Courier New" } }, + }, + y: { + ticks: { + color: "#c8d0f0", + font: { size: 9, family: "Courier New" }, + callback: (_, i) => { + const label = labels[i] ?? ""; + return label.length > 30 ? `${label.slice(0, 28)}…` : label; + }, + }, + grid: { display: false }, + }, + }, + }} + /> + </div> + </div> + ); +} diff --git a/dashboard/app/dashboard/music/top-artists-chart.tsx b/dashboard/app/dashboard/music/top-artists-chart.tsx new file mode 100644 index 0000000..9d8812b --- /dev/null +++ b/dashboard/app/dashboard/music/top-artists-chart.tsx @@ -0,0 +1,82 @@ +"use client"; + +import { Bar } from "react-chartjs-2"; +import { + Chart as ChartJS, + CategoryScale, + LinearScale, + BarElement, + Tooltip, +} from "chart.js"; +import type { TopArtist } from "@/types/music-stats"; + +ChartJS.register(CategoryScale, LinearScale, BarElement, Tooltip); + +function fmtMin(ms: number): string { + const m = Math.floor(ms / 60000); + const s = Math.round((ms % 60000) / 1000); + return s > 0 ? `${String(m)}m ${String(s)}s` : `${String(m)}m`; +} + +export function TopArtistsChart({ artists }: { artists: TopArtist[] }) { + if (artists.length === 0) { + return ( + <div className="flex h-64 items-center justify-center rounded border border-border bg-surface text-[10px] tracking-widest text-muted"> + NO ARTISTS IN RANGE + </div> + ); + } + + const sorted = [...artists].sort((a, b) => b.listenedMs - a.listenedMs).slice(0, 12); + + return ( + <div className="flex flex-col rounded border border-border bg-surface p-4"> + <div className="mb-3 text-[10px] font-bold tracking-widest text-muted"> + TOP ARTISTS BY LISTENING TIME + </div> + <div style={{ height: `${Math.max(sorted.length * 28, 160)}px` }}> + <Bar + data={{ + labels: sorted.map((a) => a.artist), + datasets: [ + { + data: sorted.map((a) => Math.round(a.listenedMs / 60000)), + backgroundColor: "#00e5b0", + borderColor: "#00e5b0", + borderWidth: 0, + borderRadius: 2, + }, + ], + }} + options={{ + indexAxis: "y", + responsive: true, + maintainAspectRatio: false, + plugins: { + legend: { display: false }, + tooltip: { + callbacks: { + label: (ctx) => { + const artist = sorted[ctx.dataIndex]; + return artist ? ` ${fmtMin(artist.listenedMs)} · ${String(artist.trackCount)} track${artist.trackCount !== 1 ? "s" : ""}` : ""; + }, + }, + }, + }, + scales: { + x: { + ticks: { color: "#3e3e60", font: { size: 9, family: "Courier New" } }, + grid: { color: "rgba(28, 28, 56, 0.5)" }, + title: { display: true, text: "minutes", color: "#3e3e60", font: { size: 9, family: "Courier New" } }, + }, + y: { + ticks: { color: "#c8d0f0", font: { size: 9, family: "Courier New" } }, + grid: { display: false }, + }, + }, + }} + /> + </div> + </div> + ); +} diff --git a/dashboard/server/music.ts b/dashboard/server/music.ts new file mode 100644 index 0000000..70876a9 --- /dev/null +++ b/dashboard/server/music.ts @@ -0,0 +1,169 @@ +import { Prisma } from "@/generated/prisma/client"; +import type { TopArtist, TopTrack, ProductivityRow, HourBucket } from "@/types/music-stats"; +import { prisma } from "./db"; + +const MAX_TOP_ARTISTS = 15; +const MAX_TOP_TRACKS = 20; +const MAX_PRODUCTIVITY = 10; + +export async function getTopArtists( + userId: string, + from: Date, + to: Date, +): Promise<TopArtist[]> { + // COUNT(DISTINCT title) requires raw SQL — Prisma groupBy only supports COUNT(field) on all rows + return prisma.$queryRaw<TopArtist[]>(Prisma.sql` + SELECT + t.artist, + SUM(t."listenedMs")::int AS "listenedMs", + COUNT(DISTINCT t.title)::int AS "trackCount" + FROM "Track" t + JOIN "Session" s ON s.id = t."sessionId" + WHERE s."userId" = ${userId} + AND t."capturedAt" >= ${from} + AND t."capturedAt" <= ${to} + GROUP BY t.artist + ORDER BY SUM(t."listenedMs") DESC + LIMIT ${MAX_TOP_ARTISTS} + `); +} + +export async function getTopTracks( + userId: string, + from: Date, + to: Date, +): Promise<TopTrack[]> { + const rows = await prisma.track.groupBy({ + by: ["artist", "title"], + where: { session: { userId }, capturedAt: { gte: from, lte: to } }, + _sum: { listenedMs: true }, + orderBy: { _sum: { listenedMs: "desc" } }, + take: MAX_TOP_TRACKS, + }); + return rows.map((r) => ({ + artist: r.artist, + title: r.title, + listenedMs: r._sum.listenedMs ?? 0, + })); +} + +export async function getMusicProductivity( + userId: string, + from: Date, + to: Date, +): Promise<ProductivityRow[]> { + return prisma.$queryRaw<ProductivityRow[]>(Prisma.sql` + WITH track_windows AS ( + SELECT + t.artist, + t.title, + t."listenedMs", + t."capturedAt", + -- use listenedMs as duration fallback when endedAt was not recorded + COALESCE( + t."endedAt", + t."capturedAt" + make_interval(secs => t."listenedMs" / 1000.0) + ) AS effective_end + FROM "Track" t + JOIN "Session" s ON s.id = t."sessionId" + WHERE s."userId" = ${userId} + AND t."capturedAt" >= ${from} + AND t."capturedAt" <= ${to} + AND t."listenedMs" >= 60000 + ), + user_events AS ( + SELECT e."timestamp" + FROM "Event" e + JOIN "Session" s ON s.id = e."sessionId" + WHERE s."userId" = ${userId} + AND e."timestamp" >= ${from} + AND e."timestamp" <= ${to} + ) + SELECT + tw.artist, + tw.title, + (SUM(tw."listenedMs") / 60000.0)::float AS minutes, + COUNT(ue."timestamp")::int AS events, + (COUNT(ue."timestamp")::float / NULLIF(SUM(tw."listenedMs") / 60000.0, 0))::float AS "perMin" + FROM track_windows tw + LEFT JOIN user_events ue + ON ue."timestamp" >= tw."capturedAt" + AND ue."timestamp" <= tw.effective_end + GROUP BY tw.artist, tw.title + ORDER BY "perMin" DESC NULLS LAST + LIMIT ${MAX_PRODUCTIVITY} + `); +} + +export async function getHourlyPattern( + userId: string, + from: Date, + to: Date, +): Promise<HourBucket[]> { + // Two separate raw queries — tracks per hour + events per hour. + // Results merged in JS to guarantee a full 0–23 grid. + const [trackRows, eventRows] = await Promise.all([ + prisma.$queryRaw<{ hour: number; listenedMs: number }[]>(Prisma.sql` + SELECT + EXTRACT(HOUR FROM t."capturedAt")::int AS hour, + SUM(t."listenedMs")::int AS "listenedMs" + FROM "Track" t + JOIN "Session" s ON s.id = t."sessionId" + WHERE s."userId" = ${userId} + AND t."capturedAt" >= ${from} + AND t."capturedAt" <= ${to} + GROUP BY hour + ORDER BY hour + `), + prisma.$queryRaw<{ hour: number; eventCount: number }[]>(Prisma.sql` + SELECT + EXTRACT(HOUR FROM e."timestamp")::int AS hour, + COUNT(*)::int AS "eventCount" + FROM "Event" e + JOIN "Session" s ON s.id = e."sessionId" + WHERE s."userId" = ${userId} + AND e."timestamp" >= ${from} + AND e."timestamp" <= ${to} + GROUP BY hour + ORDER BY hour + `), + ]); + + const listenMap = new Map(trackRows.map((r) => [r.hour, r.listenedMs])); + const eventMap = new Map(eventRows.map((r) => [r.hour, r.eventCount])); + + return Array.from({ length: 24 }, (_, h) => ({ + hour: h, + listenedMs: listenMap.get(h) ?? 0, + eventCount: eventMap.get(h) ?? 0, + })); +} + +export async function getMusicTotals( + userId: string, + from: Date, + to: Date, +): Promise<{ totalListenedMs: number; totalArtists: number; totalTracks: number }> { + const [agg, uniqueArtists, uniqueTracks] = await Promise.all([ + prisma.track.aggregate({ + where: { session: { userId }, capturedAt: { gte: from, lte: to } }, + _sum: { listenedMs: true }, + }), + // distinct artist count + prisma.track.findMany({ + where: { session: { userId }, capturedAt: { gte: from, lte: to } }, + select: { artist: true }, + distinct: ["artist"], + }), + // distinct (artist, title) pair count = unique songs + prisma.track.groupBy({ + by: ["artist", "title"], + where: { session: { userId }, capturedAt: { gte: from, lte: to } }, + }), + ]); + return { + totalListenedMs: agg._sum.listenedMs ?? 0, + totalArtists: uniqueArtists.length, + totalTracks: uniqueTracks.length, + }; +} diff --git a/dashboard/server/range.ts b/dashboard/server/range.ts new file mode 100644 index 0000000..46e170c --- /dev/null +++ b/dashboard/server/range.ts @@ -0,0 +1,69 @@ +import type { RangePreset } from "@/types/report"; +import { prisma } from "./db"; + +export type { RangePreset }; + +export type RangeInput = { + range: RangePreset; + from?: Date | null; + to?: Date | null; +}; + +export type ResolvedRange = { from: Date; to: Date; label: string }; + +export async function resolveRange( + input: RangeInput, + userId: string, +): Promise<ResolvedRange> { + const now = new Date(); + + switch (input.range) { + case "today": + return { from: startOfDay(now), to: now, label: "today" }; + + case "yesterday": { + const y = shiftDays(now, -1); + return { from: startOfDay(y), to: endOfDay(y), label: "yesterday" }; + } + + case "last_7d": + return { from: shiftDays(now, -7), to: now, label: "last 7 days" }; + + case "last_30d": + return { from: shiftDays(now, -30), to: now, label: "last 30 days" }; + + case "all_time": { + const first = await prisma.session.findFirst({ + where: { userId }, + select: { startedAt: true }, + orderBy: { startedAt: "asc" }, + }); + const from = first?.startedAt ?? shiftDays(now, -1); + return { from, to: now, label: "all time" }; + } + + case "custom": + if (!input.from || !input.to) { + throw new Error("custom range requires both from and to"); + } + return { from: input.from, to: input.to, label: "custom range" }; + } +} + +export function startOfDay(d: Date): Date { + const x = new Date(d); + x.setUTCHours(0, 0, 0, 0); + return x; +} + +export function endOfDay(d: Date): Date { + const x = new Date(d); + x.setUTCHours(23, 59, 59, 999); + return x; +} + +export function shiftDays(d: Date, delta: number): Date { + const x = new Date(d); + x.setUTCDate(x.getUTCDate() + delta); + return x; +} diff --git a/dashboard/server/report-context.ts b/dashboard/server/report-context.ts index cd63102..b8f7296 100644 --- a/dashboard/server/report-context.ts +++ b/dashboard/server/report-context.ts @@ -1,6 +1,6 @@ -import { Prisma } from "@/generated/prisma/client"; import type { ContextLevel } from "@/types/report"; import { prisma } from "./db"; +import { getMusicProductivity } from "./music"; // Groq free tier: 12,000 tokens/request. Reserve ~500 for system prompt + ~2,000 for response. const INPUT_TOKEN_BUDGET = 7_500; @@ -9,8 +9,6 @@ const MAX_HIGHLIGHTS = 20; const MAX_SESSIONS_SHOWN = 20; const MAX_TOP_DOMAINS = 10; const MAX_TOP_TAGS = 15; -const MAX_TOP_TRACKS = 10; -const MAX_TOP_ARTISTS = 10; const CONTENT_PREVIEW = 300; type RawEvent = { @@ -37,14 +35,6 @@ type RawTrack = { endedAt: Date | null; }; -type MusicProductivity = { - artist: string; - title: string; - minutes: number; - events: number; - perMin: number; -}; - export type ReportContext = { markdown: string; level: ContextLevel; @@ -107,49 +97,7 @@ function estimateTokens(text: string): number { return Math.ceil(text.length / CHARS_PER_TOKEN); } -async function getMusicProductivity( - userId: string, - from: Date, - to: Date, -): Promise<MusicProductivity[]> { - return prisma.$queryRaw<MusicProductivity[]>(Prisma.sql` - WITH track_windows AS ( - SELECT - t.artist, - t.title, - t."listenedMs", - t."capturedAt", - COALESCE(t."endedAt", NOW()) AS effective_end - FROM "Track" t - JOIN "Session" s ON s.id = t."sessionId" - WHERE s."userId" = ${userId} - AND t."capturedAt" >= ${from} - AND t."capturedAt" <= ${to} - AND t."listenedMs" >= 60000 - ), - user_events AS ( - SELECT e."timestamp" - FROM "Event" e - JOIN "Session" s ON s.id = e."sessionId" - WHERE s."userId" = ${userId} - AND e."timestamp" >= ${from} - AND e."timestamp" <= ${to} - ) - SELECT - tw.artist, - tw.title, - (tw."listenedMs" / 60000.0)::float AS minutes, - COUNT(ue."timestamp")::int AS events, - (COUNT(ue."timestamp")::float / (tw."listenedMs" / 60000.0))::float AS "perMin" - FROM track_windows tw - LEFT JOIN user_events ue - ON ue."timestamp" >= tw."capturedAt" - AND ue."timestamp" <= tw.effective_end - GROUP BY tw.artist, tw.title, tw."listenedMs" - ORDER BY "perMin" DESC NULLS LAST - LIMIT ${MAX_TOP_TRACKS} - `); -} +import type { ProductivityRow } from "@/types/music-stats"; type RenderArgs = { level: ContextLevel; @@ -159,7 +107,7 @@ type RenderArgs = { events: RawEvent[]; sessions: RawSession[]; tracks: RawTrack[]; - musicProd: MusicProductivity[]; + musicProd: ProductivityRow[]; }; function renderContext(a: RenderArgs): string { @@ -267,7 +215,9 @@ function renderContext(a: RenderArgs): string { return out.join("\n").trimEnd(); } -function renderMusicSection(tracks: RawTrack[], prod: MusicProductivity[]): string[] { +const MAX_TOP_ARTISTS_REPORT = 10; + +function renderMusicSection(tracks: RawTrack[], prod: ProductivityRow[]): string[] { const out: string[] = []; out.push("# Music"); @@ -277,7 +227,7 @@ function renderMusicSection(tracks: RawTrack[], prod: MusicProductivity[]): stri } const topArtists = [...byArtist.entries()] .sort((a, b) => b[1] - a[1]) - .slice(0, MAX_TOP_ARTISTS); + .slice(0, MAX_TOP_ARTISTS_REPORT); out.push("Top artists by listening time:"); for (const [artist, ms] of topArtists) { diff --git a/dashboard/server/reports.ts b/dashboard/server/reports.ts index cc5f7d3..5b5be31 100644 --- a/dashboard/server/reports.ts +++ b/dashboard/server/reports.ts @@ -1,8 +1,8 @@ import type { GenerateReportInput } from "./schemas/reports"; import type { GenerateReportResponse } from "@/types/report"; -import { prisma } from "./db"; import { buildReportContext } from "./report-context"; import { getDecryptedGroqApiKey } from "./user-settings"; +import { resolveRange } from "./range"; import { groqChat, getDefaultModel, @@ -38,46 +38,7 @@ export class MissingApiKeyError extends Error { } } -export type ResolvedRange = { from: Date; to: Date; label: string }; - -export async function resolveRange( - input: GenerateReportInput, - userId: string, -): Promise<ResolvedRange> { - const now = new Date(); - - switch (input.range) { - case "today": - return { from: startOfDay(now), to: now, label: "today" }; - - case "yesterday": { - const y = shiftDays(now, -1); - return { from: startOfDay(y), to: endOfDay(y), label: "yesterday" }; - } - - case "last_7d": - return { from: shiftDays(now, -7), to: now, label: "last 7 days" }; - - case "last_30d": - return { from: shiftDays(now, -30), to: now, label: "last 30 days" }; - - case "all_time": { - const first = await prisma.session.findFirst({ - where: { userId }, - select: { startedAt: true }, - orderBy: { startedAt: "asc" }, - }); - const from = first?.startedAt ?? shiftDays(now, -1); - return { from, to: now, label: "all time" }; - } - - case "custom": - if (!input.from || !input.to) { - throw new Error("custom range requires both from and to"); - } - return { from: input.from, to: input.to, label: "custom range" }; - } -} +export type { ResolvedRange } from "./range"; export async function generateReport( userId: string, @@ -110,22 +71,4 @@ export async function generateReport( }; } -function startOfDay(d: Date): Date { - const x = new Date(d); - x.setUTCHours(0, 0, 0, 0); - return x; -} - -function endOfDay(d: Date): Date { - const x = new Date(d); - x.setUTCHours(23, 59, 59, 999); - return x; -} - -function shiftDays(d: Date, delta: number): Date { - const x = new Date(d); - x.setUTCDate(x.getUTCDate() + delta); - return x; -} - export { GroqAuthError, GroqContextLimitError, GroqTimeoutError, GroqUpstreamError }; diff --git a/dashboard/server/schemas/music.ts b/dashboard/server/schemas/music.ts new file mode 100644 index 0000000..427ddd7 --- /dev/null +++ b/dashboard/server/schemas/music.ts @@ -0,0 +1,9 @@ +import { z } from "zod"; + +export const MusicStatsQuery = z.object({ + range: z.enum(["today", "yesterday", "last_7d", "last_30d", "all_time"]).default("last_7d"), + from: z.coerce.date().optional(), + to: z.coerce.date().optional(), +}); + +export type MusicStatsQuery = z.infer<typeof MusicStatsQuery>; diff --git a/dashboard/types/music-stats.ts b/dashboard/types/music-stats.ts new file mode 100644 index 0000000..cc619a2 --- /dev/null +++ b/dashboard/types/music-stats.ts @@ -0,0 +1,36 @@ +export type TopArtist = { + artist: string; + listenedMs: number; + trackCount: number; +}; + +export type TopTrack = { + artist: string; + title: string; + listenedMs: number; +}; + +export type ProductivityRow = { + artist: string; + title: string; + minutes: number; + events: number; + perMin: number; +}; + +export type HourBucket = { + hour: number; + listenedMs: number; + eventCount: number; +}; + +export type MusicStats = { + topArtists: TopArtist[]; + topTracks: TopTrack[]; + productivity: ProductivityRow[]; + hourlyPattern: HourBucket[]; + totalListenedMs: number; + totalArtists: number; + totalTracks: number; + range: { from: string; to: string; label: string }; +}; diff --git a/plans/week3/AC4-music-analytics.md b/plans/week3/AC4-music-analytics.md new file mode 100644 index 0000000..ac70205 --- /dev/null +++ b/plans/week3/AC4-music-analytics.md @@ -0,0 +1,207 @@ +# AC4 — Music Analytics Page (`/dashboard/music`) + +**Branch:** `feature/music-analytics` +**Spec:** Week 3 AC 4 (бонус) — `/dashboard/music` з кореляцією музики і активності: топ виконавців, активність по годинах. Графіки через **Chart.js** (react-chartjs-2 — вже встановлено, узгоджено з Tech Lead). +**Залежить від:** AC 6 Week 2 (захоплення треків — виконано), AC 3 Week 3 (SQL продуктивності в report-context — переносимо). + +--- + +## Scope + +Сторінка `/dashboard/music` з: +1. Range picker (чіпи: TODAY / LAST 7D / LAST 30D / ALL TIME) +2. Рядок зведеної статистики (загальний час · виконавців · треків) +3. **Chart.js — Top Artists** — горизонтальний бар, виконавці × хвилини +4. **Chart.js — Productivity Correlation** — горизонтальний бар, треки × events/min +5. **Chart.js — Hourly Pattern** — згруповані вертикальні бари, год. 0–23 × слухання + події +6. Таблиця Top Tracks (текстовий список, без графіку) +7. Пункт MUSIC у навігації (desktop + mobile) + +Поза scope: drill-down по треку, streaming, custom date range input. + +--- + +## Data model (нові міграції не потрібні) + +Всі дані — з існуючих таблиць `Track` + `Event` + `Session`. + +**Поля `Track`, що використовуються:** +- `artist`, `title` — ідентифікація +- `listenedMs` — накопичений час прослуховування (PATCH від розширення) +- `capturedAt` — bucket для годинного графіку +- `endedAt` — для JOIN-вікна в productivity; fallback якщо null → `capturedAt + make_interval(secs => listenedMs/1000)` (щоб не захоплювати події до NOW()) +- `sessionId → Session.userId` — фільтр по власнику + +--- + +## Архітектура + +``` +dashboard/ + types/ + music-stats.ts ← форма відповіді (MusicStats) + server/ + music.ts ← всі DB query-функції (без route логіки) + range.ts ← extracted resolveRange + RangePreset (рефактор) + app/ + api/v1/music/stats/ + route.ts ← GET handler, Zod query params + dashboard/ + music/ + page.tsx ← Server Component, auth guard + music-client.tsx ← "use client" — TanStack Query + layout + top-artists-chart.tsx ← Chart.js горизонтальний бар + productivity-chart.tsx ← Chart.js горизонтальний бар + hourly-chart.tsx ← Chart.js згруповані вертикальні бари + header-nav.tsx ← додати MUSIC + mobile-nav.tsx ← додати MUSIC +``` + +Той самий патерн що в AC3: server module → thin route → client з TanStack Query. + +--- + +## API endpoint + +``` +GET /api/v1/music/stats?range=last_7d +GET /api/v1/music/stats?range=custom&from=ISO&to=ISO +``` + +Query params — Zod (той самий `RangePreset` enum що в reports). Auth: cookie-first + Bearer fallback. + +**Тип відповіді (`types/music-stats.ts`):** +```typescript +type TopArtist = { artist: string; listenedMs: number; trackCount: number }; +type TopTrack = { artist: string; title: string; listenedMs: number }; +type ProductivityRow = { artist: string; title: string; minutes: number; events: number; perMin: number }; +type HourBucket = { hour: number; listenedMs: number; eventCount: number }; + +type MusicStats = { + topArtists: TopArtist[]; // ≤15, sorted by listenedMs desc + topTracks: TopTrack[]; // ≤20, sorted by listenedMs desc + productivity: ProductivityRow[]; // ≤10, треки з ≥1 хв слухання + hourlyPattern: HourBucket[]; // завжди 24 рядки (0–23), нулі заповнені + totalListenedMs: number; + totalArtists: number; + totalTracks: number; + range: { from: string; to: string; label: string }; +}; +``` + +--- + +## Server module (`server/music.ts`) + +П'ять функцій, всі `async`, всі фільтрують по `userId`: + +| Функція | SQL-підхід | +|---|---| +| `getTopArtists(userId, from, to)` | `$queryRaw` — `GROUP BY artist`, `SUM(listenedMs)`, **`COUNT(DISTINCT title)`** (Prisma groupBy не підтримує DISTINCT count) | +| `getTopTracks(userId, from, to)` | `groupBy [artist, title]`, `SUM(listenedMs) DESC LIMIT 20` — агрегація по унікальних піснях | +| `getMusicProductivity(userId, from, to)` | `$queryRaw` LEFT JOIN track windows × events; `GROUP BY artist, title` + `SUM(listenedMs)`; fallback для `endedAt = null` → `capturedAt + make_interval(secs => listenedMs/1000)` | +| `getHourlyPattern(userId, from, to)` | Два окремих Prisma-запити (треки per hour + events per hour), merge у JS для заповнення 0–23 | +| `getMusicTotals(userId, from, to)` | `SUM(listenedMs)` + distinct artists (findMany distinct) + **distinct (artist, title) pairs** (groupBy) — всі три окремо | + +`getHourlyPattern` — єдина нетривіальна функція: два `$queryRaw` з `EXTRACT(HOUR FROM ...)`, результати мержаться в JS-масиві 24 елементів. + +--- + +## Рефактор: виокремлення `resolveRange` + +**Проблема:** і `server/reports.ts` і новий music route потребують `resolveRange()`. Зараз вона приватна в reports.ts. + +**Рішення (Commit 2):** Перенести `resolveRange` + `RangePreset` + допоміжні функції дат (`startOfDay`, `endOfDay`, `shiftDays`) у `server/range.ts`. Імпортувати у `reports.ts` (поведінка не змінюється) і в новий route. Це чистий рефактор без зміни API-контракту. + +--- + +## Chart.js компоненти + +Всі три — `"use client"` компоненти з react-chartjs-2. Chart.js вже зареєстрований у `charts.tsx` (фід), тому нові компоненти реєструють тільки потрібні модулі. + +Палітра кольорів з CSS vars проєкту: `#00e5b0` (cyan), `#a855f7` (purple), `#eab308` (yellow). + +### Top Artists chart — `Bar` (горизонтальний, `indexAxis: 'y'`) +- Y: назви виконавців (≤15) +- X: хвилини прослуховування +- Колір: cyan + +### Productivity chart — `Bar` (горизонтальний, `indexAxis: 'y'`) +- Y: "Назва треку / Виконавець" (≤10) +- X: events/min +- Колір: purple +- Empty state якщо `perMin === 0` для всіх + +### Hourly Pattern chart — `Bar` (вертикальний, згрупований) +- X: години 0–23 +- Y: два датасети — listening min (cyan) + event count (purple) +- `datasets[0]` — listening, `datasets[1]` — events + +--- + +## Лейаут сторінки + +``` +h1: MUSIC ANALYTICS + +[range chips: TODAY | LAST 7D | LAST 30D | ALL TIME] + +[summary: Xh Ym listened · Y artists · Z tracks] + +grid 2-col (lg): + [Top Artists — horiz bar] [Productivity — horiz bar] + +full-width: + [Hourly Pattern — grouped bar] + +[Top Tracks — ranked text list: rank · title · artist · Xm Ys] +``` + +Loading: skeleton pulse divs (як на фіді). +Empty state (немає треків у діапазоні): "NO MUSIC DATA FOR THIS RANGE". + +--- + +## Nav update + +Додати `{ href: "/dashboard/music", label: "MUSIC" }` в `ITEMS` у `header-nav.tsx` і `mobile-nav.tsx`. + +--- + +## Commits + +| # | Повідомлення | Що змінюється | +|---|---|---| +| 1 | `docs(plans): add week 3 AC4 music analytics plan` | цей файл | +| 2 | `refactor(server): extract resolveRange to server/range.ts` | новий `server/range.ts`, оновлений імпорт у `server/reports.ts` | +| 3 | `feat(music): server module, types, and GET /api/v1/music/stats route` | `types/music-stats.ts`, `server/music.ts`, `app/api/v1/music/stats/route.ts`, `getMusicProductivity` перенесено | +| 4 | `feat(music): /dashboard/music page with Chart.js charts` | `music/page.tsx`, `music-client.tsx`, три chart-компоненти | +| 5 | `feat(nav): add MUSIC to header nav` | `header-nav.tsx`, `mobile-nav.tsx` | +| 6 | `fix(music): deduplicate top tracks (groupBy)` | `getTopTracks` → `groupBy [artist, title]` + `SUM(listenedMs)` | +| 7 | `fix(music): correct logic in music queries` | `getTopArtists` → `COUNT(DISTINCT title)` via raw SQL; `getMusicProductivity` → `GROUP BY artist, title` + `SUM` + правильний `endedAt` fallback; `getMusicTotals.totalTracks` → унікальні (artist, title) пари | + +--- + +## Ключові рішення + +- **Chart.js замість D3** — погоджено з Tech Lead. Chart.js вже встановлено і використовується на фіді; єдиний інструмент для графіків у проєкті — менше cognitive overhead. +- **Виокремлення `resolveRange`** — дрібний рефактор, що усуває дублювання і потенційний circular import. +- **Hourly chart = два Prisma-запити + JS merge** — уникаємо `generate_series` (PostgreSQL-розширення, що не гарантується) і зберігаємо читабельність коду. +- **`COUNT(DISTINCT title)` через `$queryRaw`** — Prisma `groupBy` підтримує лише `_count: { field }` (all rows), DISTINCT count потребує raw SQL. +- **`getMusicProductivity` GROUP BY по `(artist, title)`, не по `(artist, title, listenedMs)`** — трек `@@unique([sessionId, artist, title])` означає по одному рядку на трек на сесію; без агрегації той самий трек з'являвся б окремим рядком за кожну сесію. +- **`endedAt` null → `capturedAt + make_interval`** — fallback на `NOW()` розтягував JOIN-вікно до поточного моменту і захоплював усі наступні події як "під час цього треку". +- **`getMusicProductivity` → `server/music.ts`** — це бізнес-логіка про музику, не про рендеринг звіту. `report-context.ts` імпортує її звідти. +- **TanStack Query на клієнті** — той самий патерн що й фід: `page.tsx` — Server Component з auth guard, `MusicClient` — "use client" з фільтрами і даними. +- **Без нових Prisma-моделей/міграцій** — вся аналітика виводиться з існуючих даних. + +--- + +## Verification checklist + +- [ ] `npx tsc --noEmit` (dashboard) — clean +- [ ] `npm run lint` (dashboard) — clean +- [ ] Manual: `/dashboard/music` завантажується з коректними даними для LAST 7D +- [ ] Manual: перемикання чіпів range перезапитує і перерендерить всі три графіки +- [ ] Manual: empty state при відсутності треків у діапазоні +- [ ] Manual: пункт MUSIC підсвічується активним на music-сторінці +- [ ] Manual: MUSIC видно у мобільному burger dropdown From 438173c36f648aab51225230e0dd2595e1557e53 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Sun, 31 May 2026 13:18:52 +0300 Subject: [PATCH 18/24] feat(dashboard): Week 3 AC 5 (bonus) - typed API errors, toast notifications, rate limit handling (#18) * docs(plans): AC5 error handling plan * feat(server): add typed API error helper and standardize route handlers * feat(dashboard): add toast notification system * fix(reports): handle 429 rate limit with retry time + tighten token budget --- dashboard/app/api/auth/extension/route.ts | 7 +- dashboard/app/api/auth/google/route.ts | 7 +- dashboard/app/api/v1/events/route.ts | 12 +- dashboard/app/api/v1/events/stats/route.ts | 6 +- dashboard/app/api/v1/music/stats/route.ts | 5 +- .../app/api/v1/reports/generate/route.ts | 34 ++-- dashboard/app/api/v1/sessions/[id]/route.ts | 8 +- dashboard/app/api/v1/sessions/route.ts | 3 +- dashboard/app/api/v1/sessions/top/route.ts | 3 +- dashboard/app/api/v1/tracks/[id]/route.ts | 8 +- dashboard/app/api/v1/tracks/route.ts | 8 +- dashboard/app/api/v1/user/settings/route.ts | 10 +- .../app/dashboard/reports/report-form.tsx | 9 +- dashboard/app/providers.tsx | 24 ++- dashboard/components/toast.tsx | 115 +++++++++++++ dashboard/server/api-error.ts | 20 +++ dashboard/server/groq.ts | 21 +++ dashboard/server/report-context.ts | 24 +-- dashboard/server/reports.ts | 3 +- dashboard/types/api.ts | 1 + plans/week3/AC5-error-handling.md | 152 ++++++++++++++++++ 21 files changed, 407 insertions(+), 73 deletions(-) create mode 100644 dashboard/components/toast.tsx create mode 100644 dashboard/server/api-error.ts create mode 100644 dashboard/types/api.ts create mode 100644 plans/week3/AC5-error-handling.md diff --git a/dashboard/app/api/auth/extension/route.ts b/dashboard/app/api/auth/extension/route.ts index ca0710e..34aafdb 100644 --- a/dashboard/app/api/auth/extension/route.ts +++ b/dashboard/app/api/auth/extension/route.ts @@ -2,18 +2,19 @@ import { NextRequest, NextResponse } from "next/server"; import { withCors, corsPreflight } from "@/server/cors"; import { ExtensionAuthInput } from "@/server/schemas/auth"; import { authenticateGoogleUser } from "@/server/auth"; +import { apiError } from "@/server/api-error"; export const POST = withCors(async (req: NextRequest) => { let body: unknown; try { body = await req.json(); } catch { - return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Invalid JSON body", 400); } const parsed = ExtensionAuthInput.safeParse(body); if (!parsed.success) { - return NextResponse.json({ error: parsed.error.format() }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } try { @@ -21,7 +22,7 @@ export const POST = withCors(async (req: NextRequest) => { return NextResponse.json({ token }, { status: 200 }); } catch (err) { const message = err instanceof Error ? err.message : "Authentication failed"; - return NextResponse.json({ error: message }, { status: 401 }); + return apiError("UNAUTHORIZED", message, 401); } }); diff --git a/dashboard/app/api/auth/google/route.ts b/dashboard/app/api/auth/google/route.ts index 06a81b8..1a54245 100644 --- a/dashboard/app/api/auth/google/route.ts +++ b/dashboard/app/api/auth/google/route.ts @@ -2,18 +2,19 @@ import { NextRequest, NextResponse } from "next/server"; import { WebAuthInput } from "@/server/schemas/auth"; import { authenticateGoogleUser } from "@/server/auth"; import { SESSION_COOKIE, sessionCookieOptions } from "@/server/cookies"; +import { apiError } from "@/server/api-error"; export async function POST(req: NextRequest) { let body: unknown; try { body = await req.json(); } catch { - return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Invalid JSON body", 400); } const parsed = WebAuthInput.safeParse(body); if (!parsed.success) { - return NextResponse.json({ error: parsed.error.format() }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } let token: string; @@ -21,7 +22,7 @@ export async function POST(req: NextRequest) { token = await authenticateGoogleUser(parsed.data.googleToken); } catch (err) { const message = err instanceof Error ? err.message : "Authentication failed"; - return NextResponse.json({ error: message }, { status: 401 }); + return apiError("UNAUTHORIZED", message, 401); } const res = NextResponse.json({ ok: true }, { status: 200 }); diff --git a/dashboard/app/api/v1/events/route.ts b/dashboard/app/api/v1/events/route.ts index ec1fef6..f97719d 100644 --- a/dashboard/app/api/v1/events/route.ts +++ b/dashboard/app/api/v1/events/route.ts @@ -1,5 +1,4 @@ import { NextRequest, NextResponse } from "next/server"; -import { z } from "zod"; import { createEventForUser, listEventsForUser, @@ -8,6 +7,7 @@ import { import { CreateEventInput, EventListFilters } from "@/server/schemas/events"; import { withCors, corsPreflight } from "@/server/cors"; import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { apiError } from "@/server/api-error"; export const GET = withCors(async (req) => { let user; @@ -15,7 +15,7 @@ export const GET = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -23,7 +23,7 @@ export const GET = withCors(async (req) => { const params = Object.fromEntries(req.nextUrl.searchParams); const parsed = EventListFilters.safeParse(params); if (!parsed.success) { - return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } const page = await listEventsForUser(user.id, parsed.data); @@ -36,7 +36,7 @@ export const POST = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -44,7 +44,7 @@ export const POST = withCors(async (req) => { const body = await req.json(); const parsed = CreateEventInput.safeParse(body); if (!parsed.success) { - return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } try { @@ -52,7 +52,7 @@ export const POST = withCors(async (req) => { return NextResponse.json(event, { status: 201 }); } catch (err) { if (err instanceof SessionNotFoundError) { - return NextResponse.json({ error: "Session not found" }, { status: 404 }); + return apiError("NOT_FOUND", "Session not found", 404); } throw err; } diff --git a/dashboard/app/api/v1/events/stats/route.ts b/dashboard/app/api/v1/events/stats/route.ts index 6ad3b89..949b991 100644 --- a/dashboard/app/api/v1/events/stats/route.ts +++ b/dashboard/app/api/v1/events/stats/route.ts @@ -1,9 +1,9 @@ import { NextRequest, NextResponse } from "next/server"; -import { z } from "zod"; import { getEventStatsForUser } from "@/server/events"; import { EventStatsFilters } from "@/server/schemas/events"; import { withCors, corsPreflight } from "@/server/cors"; import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { apiError } from "@/server/api-error"; export const GET = withCors(async (req) => { let user; @@ -11,7 +11,7 @@ export const GET = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -19,7 +19,7 @@ export const GET = withCors(async (req) => { const params = Object.fromEntries(req.nextUrl.searchParams); const parsed = EventStatsFilters.safeParse(params); if (!parsed.success) { - return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } const stats = await getEventStatsForUser(user.id, parsed.data); diff --git a/dashboard/app/api/v1/music/stats/route.ts b/dashboard/app/api/v1/music/stats/route.ts index cc4131d..b36abdc 100644 --- a/dashboard/app/api/v1/music/stats/route.ts +++ b/dashboard/app/api/v1/music/stats/route.ts @@ -12,6 +12,7 @@ import { getMusicTotals, } from "@/server/music"; import type { MusicStats } from "@/types/music-stats"; +import { apiError } from "@/server/api-error"; export const GET = withCors(async (req: NextRequest) => { // Cookie auth (dashboard) — fallback to Bearer (extension) @@ -25,7 +26,7 @@ export const GET = withCors(async (req: NextRequest) => { } } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -33,7 +34,7 @@ export const GET = withCors(async (req: NextRequest) => { const params = Object.fromEntries(req.nextUrl.searchParams); const parsed = MusicStatsQuery.safeParse(params); if (!parsed.success) { - return NextResponse.json({ error: "Invalid query params" }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } const { from, to, label } = await resolveRange( diff --git a/dashboard/app/api/v1/reports/generate/route.ts b/dashboard/app/api/v1/reports/generate/route.ts index 9359baa..46b27e0 100644 --- a/dashboard/app/api/v1/reports/generate/route.ts +++ b/dashboard/app/api/v1/reports/generate/route.ts @@ -1,5 +1,4 @@ import { NextRequest, NextResponse } from "next/server"; -import { z } from "zod"; import { requireUser, UnauthorizedError } from "@/server/jwt"; import { withCors, corsPreflight } from "@/server/cors"; import { GenerateReportInput } from "@/server/schemas/reports"; @@ -8,9 +7,11 @@ import { MissingApiKeyError, GroqAuthError, GroqContextLimitError, + GroqRateLimitError, GroqTimeoutError, GroqUpstreamError, } from "@/server/reports"; +import { apiError } from "@/server/api-error"; export const POST = withCors(async (req) => { let user; @@ -18,7 +19,7 @@ export const POST = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -27,12 +28,12 @@ export const POST = withCors(async (req) => { try { body = await req.json(); } catch { - return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Invalid JSON body", 400); } const parsed = GenerateReportInput.safeParse(body); if (!parsed.success) { - return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } try { @@ -40,32 +41,23 @@ export const POST = withCors(async (req) => { return NextResponse.json(result); } catch (err) { if (err instanceof MissingApiKeyError) { - return NextResponse.json( - { error: "No Groq API key configured. Add your own via the API KEY button." }, - { status: 503 }, - ); + return apiError("SERVER_ERROR", "No Groq API key configured. Add your own via the API KEY button.", 503); } if (err instanceof GroqContextLimitError) { - return NextResponse.json({ error: err.message }, { status: 422 }); + return apiError("SERVER_ERROR", err.message, 422); } if (err instanceof GroqAuthError) { - return NextResponse.json( - { error: "Groq rejected the API key. Clear it in settings or set a valid key." }, - { status: 402 }, - ); + return apiError("SERVER_ERROR", "Groq rejected the API key. Clear it in settings or set a valid key.", 402); + } + if (err instanceof GroqRateLimitError) { + return apiError("SERVER_ERROR", err.message, 429); } if (err instanceof GroqTimeoutError) { - return NextResponse.json( - { error: "AI request timed out. Try again in a moment." }, - { status: 504 }, - ); + return apiError("SERVER_ERROR", "AI request timed out. Try again in a moment.", 504); } if (err instanceof GroqUpstreamError) { console.error("[reports] upstream error", err); - return NextResponse.json( - { error: "AI provider unavailable. Try again later." }, - { status: 502 }, - ); + return apiError("SERVER_ERROR", "AI provider unavailable. Try again later.", 502); } throw err; } diff --git a/dashboard/app/api/v1/sessions/[id]/route.ts b/dashboard/app/api/v1/sessions/[id]/route.ts index 1c90544..fd2afab 100644 --- a/dashboard/app/api/v1/sessions/[id]/route.ts +++ b/dashboard/app/api/v1/sessions/[id]/route.ts @@ -1,9 +1,9 @@ import { NextRequest, NextResponse } from "next/server"; -import { z } from "zod"; import { endSessionForUser, SessionNotFoundError } from "@/server/sessions"; import { SessionIdParam } from "@/server/schemas/sessions"; import { withCors, corsPreflight } from "@/server/cors"; import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { apiError } from "@/server/api-error"; interface RouteContext { params: Promise<{ id: string }>; @@ -16,7 +16,7 @@ export function PATCH(req: NextRequest, ctx: RouteContext): Promise<NextResponse user = requireUser(r); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -24,7 +24,7 @@ export function PATCH(req: NextRequest, ctx: RouteContext): Promise<NextResponse const params = await ctx.params; const parsed = SessionIdParam.safeParse(params); if (!parsed.success) { - return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } try { @@ -32,7 +32,7 @@ export function PATCH(req: NextRequest, ctx: RouteContext): Promise<NextResponse return NextResponse.json(session, { status: 200 }); } catch (err) { if (err instanceof SessionNotFoundError) { - return NextResponse.json({ error: "Session not found" }, { status: 404 }); + return apiError("NOT_FOUND", "Session not found", 404); } throw err; } diff --git a/dashboard/app/api/v1/sessions/route.ts b/dashboard/app/api/v1/sessions/route.ts index b6efa75..002ce97 100644 --- a/dashboard/app/api/v1/sessions/route.ts +++ b/dashboard/app/api/v1/sessions/route.ts @@ -2,6 +2,7 @@ import { NextRequest, NextResponse } from "next/server"; import { createSessionForUser } from "@/server/sessions"; import { withCors, corsPreflight } from "@/server/cors"; import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { apiError } from "@/server/api-error"; export const POST = withCors(async (req) => { let user; @@ -9,7 +10,7 @@ export const POST = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } diff --git a/dashboard/app/api/v1/sessions/top/route.ts b/dashboard/app/api/v1/sessions/top/route.ts index 0c625f3..0b5dc38 100644 --- a/dashboard/app/api/v1/sessions/top/route.ts +++ b/dashboard/app/api/v1/sessions/top/route.ts @@ -2,6 +2,7 @@ import { NextRequest, NextResponse } from "next/server"; import { getTopSessionsForUser } from "@/server/sessions"; import { withCors, corsPreflight } from "@/server/cors"; import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { apiError } from "@/server/api-error"; export const GET = withCors(async (req) => { let user; @@ -9,7 +10,7 @@ export const GET = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } diff --git a/dashboard/app/api/v1/tracks/[id]/route.ts b/dashboard/app/api/v1/tracks/[id]/route.ts index 60d6184..7e6a607 100644 --- a/dashboard/app/api/v1/tracks/[id]/route.ts +++ b/dashboard/app/api/v1/tracks/[id]/route.ts @@ -1,9 +1,9 @@ import { NextRequest, NextResponse } from "next/server"; -import { z } from "zod"; import { endTrackForUser, TrackNotFoundError } from "@/server/tracks"; import { UpdateTrackInput } from "@/server/schemas/tracks"; import { withCors, corsPreflight } from "@/server/cors"; import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { apiError } from "@/server/api-error"; interface RouteContext { params: Promise<{ id: string }>; @@ -16,7 +16,7 @@ export function PATCH(req: NextRequest, ctx: RouteContext): Promise<NextResponse user = requireUser(r); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -26,7 +26,7 @@ export function PATCH(req: NextRequest, ctx: RouteContext): Promise<NextResponse const body = await r.json(); const parsed = UpdateTrackInput.safeParse(body); if (!parsed.success) { - return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } try { @@ -34,7 +34,7 @@ export function PATCH(req: NextRequest, ctx: RouteContext): Promise<NextResponse return NextResponse.json(track, { status: 200 }); } catch (err) { if (err instanceof TrackNotFoundError) { - return NextResponse.json({ error: "Track not found" }, { status: 404 }); + return apiError("NOT_FOUND", "Track not found", 404); } throw err; } diff --git a/dashboard/app/api/v1/tracks/route.ts b/dashboard/app/api/v1/tracks/route.ts index 5f3b8dd..cc8faf6 100644 --- a/dashboard/app/api/v1/tracks/route.ts +++ b/dashboard/app/api/v1/tracks/route.ts @@ -1,9 +1,9 @@ import { NextRequest, NextResponse } from "next/server"; -import { z } from "zod"; import { createTrackForUser, SessionNotFoundError } from "@/server/tracks"; import { CreateTrackInput } from "@/server/schemas/tracks"; import { withCors, corsPreflight } from "@/server/cors"; import { requireUser, UnauthorizedError } from "@/server/jwt"; +import { apiError } from "@/server/api-error"; export const POST = withCors(async (req) => { let user; @@ -11,7 +11,7 @@ export const POST = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -19,7 +19,7 @@ export const POST = withCors(async (req) => { const body = await req.json(); const parsed = CreateTrackInput.safeParse(body); if (!parsed.success) { - return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } try { @@ -27,7 +27,7 @@ export const POST = withCors(async (req) => { return NextResponse.json(track, { status: 201 }); } catch (err) { if (err instanceof SessionNotFoundError) { - return NextResponse.json({ error: "Session not found" }, { status: 404 }); + return apiError("NOT_FOUND", "Session not found", 404); } throw err; } diff --git a/dashboard/app/api/v1/user/settings/route.ts b/dashboard/app/api/v1/user/settings/route.ts index 93d918a..6b36ee9 100644 --- a/dashboard/app/api/v1/user/settings/route.ts +++ b/dashboard/app/api/v1/user/settings/route.ts @@ -1,9 +1,9 @@ import { NextRequest, NextResponse } from "next/server"; -import { z } from "zod"; import { requireUser, UnauthorizedError } from "@/server/jwt"; import { withCors, corsPreflight } from "@/server/cors"; import { SetApiKeyInput } from "@/server/schemas/user-settings"; import { getUserSettingsView, setGroqApiKey } from "@/server/user-settings"; +import { apiError } from "@/server/api-error"; export const GET = withCors(async (req) => { let user; @@ -11,7 +11,7 @@ export const GET = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -25,7 +25,7 @@ export const PUT = withCors(async (req) => { user = requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { - return NextResponse.json({ error: err.message }, { status: 401 }); + return apiError("UNAUTHORIZED", err.message, 401); } throw err; } @@ -34,12 +34,12 @@ export const PUT = withCors(async (req) => { try { body = await req.json(); } catch { - return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Invalid JSON body", 400); } const parsed = SetApiKeyInput.safeParse(body); if (!parsed.success) { - return NextResponse.json({ error: z.treeifyError(parsed.error) }, { status: 400 }); + return apiError("VALIDATION_ERROR", "Validation failed", 400); } const view = await setGroqApiKey(user.id, parsed.data.groqApiKey); diff --git a/dashboard/app/dashboard/reports/report-form.tsx b/dashboard/app/dashboard/reports/report-form.tsx index 7cefedf..81036c9 100644 --- a/dashboard/app/dashboard/reports/report-form.tsx +++ b/dashboard/app/dashboard/reports/report-form.tsx @@ -10,6 +10,7 @@ import { } from "./reports-client"; import { MarkdownView } from "./markdown-view"; import { ApiKeyModal } from "./api-key-modal"; +import { useToast } from "@/components/toast"; const PRESETS: { value: RangePreset; label: string }[] = [ { value: "today", label: "TODAY" }, @@ -47,6 +48,7 @@ function downloadMarkdown(markdown: string, rangeLabel: string): void { } export function ReportForm() { + const toast = useToast(); const [range, setRange] = useState<RangePreset>("last_7d"); const [from, setFrom] = useState<string>(""); const [to, setTo] = useState<string>(todayISO()); @@ -80,10 +82,9 @@ export function ReportForm() { const result = await generateReport(input); setStatus({ kind: "success", result }); } catch (err) { - setStatus({ - kind: "error", - message: err instanceof Error ? err.message : "Failed to generate report", - }); + const message = err instanceof Error ? err.message : "Failed to generate report"; + setStatus({ kind: "error", message }); + toast.error(message); } } diff --git a/dashboard/app/providers.tsx b/dashboard/app/providers.tsx index aeac157..9d965e3 100644 --- a/dashboard/app/providers.tsx +++ b/dashboard/app/providers.tsx @@ -1,9 +1,12 @@ "use client"; -import { useState } from "react"; +import { useEffect, useState } from "react"; import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; +import { ToastProvider, useToast } from "@/components/toast"; + +function QueryProviderInner({ children }: { children: React.ReactNode }) { + const toast = useToast(); -export function Providers({ children }: { children: React.ReactNode }) { const [client] = useState( () => new QueryClient({ @@ -16,5 +19,22 @@ export function Providers({ children }: { children: React.ReactNode }) { }), ); + useEffect(() => { + return client.getQueryCache().subscribe((event) => { + if (event.type === "updated" && event.action.type === "error") { + const { error } = event.action; + toast.error(error instanceof Error ? error.message : "Something went wrong"); + } + }); + }, [client, toast]); + return <QueryClientProvider client={client}>{children}</QueryClientProvider>; } + +export function Providers({ children }: { children: React.ReactNode }) { + return ( + <ToastProvider> + <QueryProviderInner>{children}</QueryProviderInner> + </ToastProvider> + ); +} diff --git a/dashboard/components/toast.tsx b/dashboard/components/toast.tsx new file mode 100644 index 0000000..44dcf6b --- /dev/null +++ b/dashboard/components/toast.tsx @@ -0,0 +1,115 @@ +"use client"; + +import { + createContext, + useCallback, + useContext, + useRef, + useState, +} from "react"; + +// ─── Types ──────────────────────────────────────────────────────────────────── + +type ToastVariant = "error" | "success"; + +interface ToastItem { + id: number; + message: string; + variant: ToastVariant; +} + +interface ToastContextValue { + error: (message: string) => void; + success: (message: string) => void; +} + +// ─── Context ────────────────────────────────────────────────────────────────── + +const ToastContext = createContext<ToastContextValue | null>(null); + +export function useToast(): ToastContextValue { + const ctx = useContext(ToastContext); + if (!ctx) throw new Error("useToast must be used inside ToastProvider"); + return ctx; +} + +// ─── Provider ───────────────────────────────────────────────────────────────── + +const MAX_TOASTS = 3; +const DISMISS_MS = 4000; + +export function ToastProvider({ children }: { children: React.ReactNode }) { + const [toasts, setToasts] = useState<ToastItem[]>([]); + const counter = useRef(0); + + const dismiss = useCallback((id: number) => { + setToasts((prev) => prev.filter((t) => t.id !== id)); + }, []); + + const push = useCallback( + (message: string, variant: ToastVariant) => { + const id = ++counter.current; + setToasts((prev) => { + const next = [...prev, { id, message, variant }]; + return next.length > MAX_TOASTS ? next.slice(next.length - MAX_TOASTS) : next; + }); + setTimeout(() => dismiss(id), DISMISS_MS); + }, + [dismiss], + ); + + const value: ToastContextValue = { + error: (msg) => push(msg, "error"), + success: (msg) => push(msg, "success"), + }; + + return ( + <ToastContext.Provider value={value}> + {children} + <ToastStack toasts={toasts} onDismiss={dismiss} /> + </ToastContext.Provider> + ); +} + +// ─── UI ─────────────────────────────────────────────────────────────────────── + +function ToastStack({ + toasts, + onDismiss, +}: { + toasts: ToastItem[]; + onDismiss: (id: number) => void; +}) { + if (toasts.length === 0) return null; + + return ( + <div + aria-live="polite" + aria-label="Notifications" + className="pointer-events-none fixed bottom-4 right-4 z-50 flex flex-col gap-2" + > + {toasts.map((t) => ( + <div + key={t.id} + role="alert" + className={ + "pointer-events-auto flex items-start gap-3 rounded border px-4 py-3 text-xs shadow-lg " + + (t.variant === "error" + ? "border-pink/40 bg-surface text-pink" + : "border-cyan/40 bg-surface text-cyan") + } + > + <span className="flex-1">{t.message}</span> + <button + type="button" + onClick={() => onDismiss(t.id)} + className="mt-0.5 shrink-0 cursor-pointer opacity-60 hover:opacity-100" + aria-label="Dismiss" + > + ✕ + </button> + </div> + ))} + </div> + ); +} diff --git a/dashboard/server/api-error.ts b/dashboard/server/api-error.ts new file mode 100644 index 0000000..8ef6f61 --- /dev/null +++ b/dashboard/server/api-error.ts @@ -0,0 +1,20 @@ +import { NextResponse } from "next/server"; + +export type ErrorCode = + | "UNAUTHORIZED" + | "VALIDATION_ERROR" + | "NOT_FOUND" + | "SERVER_ERROR"; + +export interface ApiErrorBody { + error: string; + code: ErrorCode; +} + +export function apiError( + code: ErrorCode, + message: string, + status: number, +): NextResponse<ApiErrorBody> { + return NextResponse.json({ error: message, code }, { status }); +} diff --git a/dashboard/server/groq.ts b/dashboard/server/groq.ts index 63344bf..1b51897 100644 --- a/dashboard/server/groq.ts +++ b/dashboard/server/groq.ts @@ -16,6 +16,16 @@ export class GroqUpstreamError extends Error { } } +export class GroqRateLimitError extends Error { + constructor(public readonly retryAfterSec: number | null) { + const wait = retryAfterSec !== null + ? ` Try again in ${String(Math.ceil(retryAfterSec))}s.` + : " Try again in a moment."; + super(`Rate limit reached.${wait}`); + this.name = "GroqRateLimitError"; + } +} + export class GroqContextLimitError extends Error { constructor() { super("Report context too large for the model. Try a shorter date range."); @@ -77,6 +87,17 @@ export async function groqChat(input: GroqChatInput): Promise<string> { if (res.status === 401 || res.status === 403) throw new GroqAuthError(); if (res.status === 413) throw new GroqContextLimitError(); + if (res.status === 429) { + const body = await res.text(); + let retryAfterSec: number | null = null; + try { + type ErrBody = { error?: { message?: string } }; + const parsed = JSON.parse(body) as ErrBody; + const match = /Please try again in (\d+(?:\.\d+)?)s/.exec(parsed.error?.message ?? ""); + if (match?.[1]) retryAfterSec = parseFloat(match[1]); + } catch { /* ignore malformed body */ } + throw new GroqRateLimitError(retryAfterSec); + } if (!res.ok) { const body = await res.text(); console.error("[groq] non-ok response", res.status, body); diff --git a/dashboard/server/report-context.ts b/dashboard/server/report-context.ts index b8f7296..766766d 100644 --- a/dashboard/server/report-context.ts +++ b/dashboard/server/report-context.ts @@ -2,14 +2,16 @@ import type { ContextLevel } from "@/types/report"; import { prisma } from "./db"; import { getMusicProductivity } from "./music"; -// Groq free tier: 12,000 tokens/request. Reserve ~500 for system prompt + ~2,000 for response. -const INPUT_TOKEN_BUDGET = 7_500; -const CHARS_PER_TOKEN = 4; -const MAX_HIGHLIGHTS = 20; -const MAX_SESSIONS_SHOWN = 20; -const MAX_TOP_DOMAINS = 10; -const MAX_TOP_TAGS = 15; -const CONTENT_PREVIEW = 300; +// Groq free tier: ~6,000 TPM effective budget after system prompt (~800) + response (~2,000). +// Use 3 chars/token — more accurate for technical content (URLs, code snippets). +const INPUT_TOKEN_BUDGET = 5_500; +const CHARS_PER_TOKEN = 3; +const MAX_HIGHLIGHTS = 20; +const MAX_SESSIONS_SHOWN = 20; +const MAX_TOP_DOMAINS = 10; +const MAX_TOP_TAGS = 15; +const CONTENT_PREVIEW = 300; +const MAX_MUSIC_PROD_ROWS = 15; type RawEvent = { id: string; @@ -237,12 +239,16 @@ function renderMusicSection(tracks: RawTrack[], prod: ProductivityRow[]): string if (prod.length > 0) { out.push(""); out.push("Productivity correlation (events per minute while track was active, tracks with ≥1 min listening):"); - for (const p of prod) { + const shown = prod.slice(0, MAX_MUSIC_PROD_ROWS); + for (const p of shown) { out.push( `- "${p.title}" by ${p.artist} — ${p.perMin.toFixed(2)} events/min ` + `over ${p.minutes.toFixed(1)} min (${p.events} events)`, ); } + if (prod.length > MAX_MUSIC_PROD_ROWS) { + out.push(`- … and ${prod.length - MAX_MUSIC_PROD_ROWS} more tracks omitted`); + } } out.push(""); return out; diff --git a/dashboard/server/reports.ts b/dashboard/server/reports.ts index 5b5be31..331ef13 100644 --- a/dashboard/server/reports.ts +++ b/dashboard/server/reports.ts @@ -8,6 +8,7 @@ import { getDefaultModel, GroqAuthError, GroqContextLimitError, + GroqRateLimitError, GroqTimeoutError, GroqUpstreamError, } from "./groq"; @@ -71,4 +72,4 @@ export async function generateReport( }; } -export { GroqAuthError, GroqContextLimitError, GroqTimeoutError, GroqUpstreamError }; +export { GroqAuthError, GroqContextLimitError, GroqRateLimitError, GroqTimeoutError, GroqUpstreamError }; diff --git a/dashboard/types/api.ts b/dashboard/types/api.ts new file mode 100644 index 0000000..d8cdd56 --- /dev/null +++ b/dashboard/types/api.ts @@ -0,0 +1 @@ +export type { ApiErrorBody, ErrorCode } from "@/server/api-error"; diff --git a/plans/week3/AC5-error-handling.md b/plans/week3/AC5-error-handling.md new file mode 100644 index 0000000..62645f3 --- /dev/null +++ b/plans/week3/AC5-error-handling.md @@ -0,0 +1,152 @@ +# AC5 — Error Handling (Week 3 Bonus) + +## Критерій + +> Усі Route Handlers повертають типізовані помилки. UI показує toast-нотифікації при +> помилках мережі або валідації. Extension показує статус помилки синхронізації в popup. + +--- + +## Аналіз поточного стану + +### Route Handlers +Всі хендлери вже повертають `{ error: string | ZodTree }` з правильними HTTP-статусами, +але форма **не стандартизована**: +- Auth помилки: `{ error: string }` зі статусом 401 +- Zod помилки: `{ error: z.treeifyError(parsed.error) }` — об'єкт замість рядка +- Domain помилки (SessionNotFoundError): `{ error: "Session not found" }` без коду +- Groq помилки: різні рядки, немає машино-читабельного `code` поля + +Проблема: клієнт не може програмно розрізнити тип помилки без парсингу рядка. + +### Dashboard UI +Вже є інлайн-стани помилок: +- `event-feed.tsx` → `<ErrorState>` (показує "Failed to load events" + Retry) +- `report-form.tsx` → `<ErrorPanel>` (показує повідомлення + Retry) +- Немає **глобального toast-провайдера** для ephemeral-нотифікацій + +### Extension +**Вже виконано:** `popup.ts` показує `syncMeta` з текстом `error: ${res.lastError}` та +CSS-класом `popup__sync-meta--error`. Критерій AC5 для extension **вже задоволений**. + +--- + +## Що робимо + +### 1. Стандартизація API-помилок (server) + +Новий файл `dashboard/server/api-error.ts`: + +```typescript +export type ErrorCode = + | "UNAUTHORIZED" + | "VALIDATION_ERROR" + | "NOT_FOUND" + | "SERVER_ERROR"; + +export interface ApiErrorBody { + error: string; + code: ErrorCode; +} +``` + +Хелпер `apiError(code, message, status)` → `NextResponse<ApiErrorBody>`. + +Всі route handlers оновлюються: +| Ситуація | До | Після | +|---|---|---| +| `UnauthorizedError` | `{ error: msg }` 401 | `{ error: msg, code: "UNAUTHORIZED" }` 401 | +| Zod validation | `{ error: z.treeifyError(...) }` 400 | `{ error: "Validation failed", code: "VALIDATION_ERROR" }` 400 | +| `SessionNotFoundError` | `{ error: "Session not found" }` 404 | `{ error: "Session not found", code: "NOT_FOUND" }` 404 | +| Groq помилки | різні рядки | `{ error: msg, code: "SERVER_ERROR" }` з відповідним статусом | + +Тип `ApiErrorBody` виноситься у `dashboard/types/api.ts` — shared між server і client. + +### 2. Toast-система (dashboard UI) + +**Один файл:** `dashboard/components/toast.tsx` + +Містить: +- `ToastProvider` — context + стейт + рендер stack +- `useToast` — хук `{ error(msg), success(msg) }` +- `Toast` — UI компонент (fixed bottom-right, auto-dismiss 4s, max 3) + +Стилі: +- `error` variant → рамка/текст `pink` +- `success` variant → рамка/текст `cyan` + +**Wire-up у `dashboard/app/providers.tsx`:** +```typescript +// TanStack Query v5 — глобальний onError через QueryCache +const queryClient = new QueryClient({ + queryCache: new QueryCache({ + onError: (error) => toast.error(error.message), + }), +}); +``` + +`ToastProvider` обгортає `QueryClientProvider` (щоб `useToast` був доступний всередині). + +**Wire-up у компонентах:** +- `report-form.tsx` — при `status.kind === "error"` додатково викликати `toast.error(message)` (інлайн `ErrorPanel` залишається) +- `event-feed.tsx` — залишити `<ErrorState>`, тости приходять автоматично через QueryCache + +### 3. Extension sync error (вже готово) + +Стан помилки синхронізації вже відображається в popup: +```typescript +// popup.ts (рядок 178-183) — вже є +if (res.lastError) { + syncMeta.textContent = `error: ${res.lastError}`; + syncMeta.classList.add("popup__sync-meta--error"); +} +``` +Додаткових змін не потрібно. + +--- + +## Файли для зміни / створення + +| Файл | Дія | +|---|---| +| `dashboard/server/api-error.ts` | **create** — ErrorCode, ApiErrorBody, apiError() | +| `dashboard/types/api.ts` | **create** — re-export ApiErrorBody для client-side | +| `dashboard/app/api/auth/extension/route.ts` | update — apiError() | +| `dashboard/app/api/auth/google/route.ts` | update — apiError() | +| `dashboard/app/api/v1/events/route.ts` | update — apiError() | +| `dashboard/app/api/v1/sessions/route.ts` | update — apiError() | +| `dashboard/app/api/v1/tracks/route.ts` | update — apiError() | +| `dashboard/app/api/v1/tracks/[id]/route.ts` | update — apiError() | +| `dashboard/app/api/v1/sessions/[id]/route.ts` | update — apiError() | +| `dashboard/app/api/v1/sessions/top/route.ts` | update — apiError() | +| `dashboard/app/api/v1/events/stats/route.ts` | update — apiError() | +| `dashboard/app/api/v1/music/stats/route.ts` | update — apiError() | +| `dashboard/app/api/v1/user/settings/route.ts` | update — apiError() | +| `dashboard/app/api/v1/reports/generate/route.ts` | update — apiError() | +| `dashboard/components/toast.tsx` | **create** — ToastProvider, useToast, Toast UI | +| `dashboard/app/providers.tsx` | update — ToastProvider + QueryCache.onError | +| `dashboard/app/dashboard/reports/report-form.tsx` | update — toast.error() при помилці | + +--- + +## Commit-план + +``` +feat(server): add typed API error helper and standardize route handlers ← commit 2 +feat(dashboard): add toast notification system ← commit 3 +fix(...): post-review fixes після тестування ← commit 4+ +``` + +> Commit 1 — цей план: `docs(plans): AC5 error handling plan` + +--- + +## Обмеження / рішення + +- **Zod treeifyError** вилучається з відповідей API — клієнт не повинен парсити + вкладену zod-структуру. Замість цього: простий рядок + `code: "VALIDATION_ERROR"`. +- **Toast не замінює інлайн-стани** (ErrorPanel, ErrorState залишаються) — + toast додатковий шар для ephemeral-нотифікацій і фонових помилок. +- **Без зовнішніх бібліотек** (react-hot-toast тощо) — мінімальна реалізація + щоб не збільшувати bundle і лишатись в стилі проєкту. +- **Extension не змінюється** — sync error вже відображається. From 68d4b757edcd8d0242f96bae465122b598f21c08 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Tue, 2 Jun 2026 12:35:08 +0300 Subject: [PATCH 19/24] fix(stale-data): close stale sessions and music timers via cron + pagehide (#19) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(plans): stale data cleanup plan — sessions + music timer Moves backlog item to week4, adds stale music timer problem (680min bug), resolves all open questions, switches to GitHub Actions cron. * feat(server): closeStaleSessions and closeStaleTracksForClosedSessions * feat(dashboard): GET /api/cron/close-stale route, protected by CRON_SECRET * chore(ci): GitHub Actions cron to close stale sessions every 15 min * fix(extension): send TRACK_STOP on pagehide to close stale music timers --- .github/workflows/close-stale.yml | 17 +++ dashboard/.env.example | 6 + dashboard/app/api/cron/close-stale/route.ts | 17 +++ dashboard/server/sessions.ts | 18 +++ dashboard/server/tracks.ts | 11 ++ extension/src/background/index.ts | 5 + extension/src/content/soundcloud.ts | 4 + extension/src/content/ytm.ts | 6 + extension/src/types/music.ts | 3 +- plans/backlog/stale-sessions-cleanup.md | 74 ------------ plans/week4/stale-data-cleanup.md | 120 ++++++++++++++++++++ 11 files changed, 206 insertions(+), 75 deletions(-) create mode 100644 .github/workflows/close-stale.yml create mode 100644 dashboard/app/api/cron/close-stale/route.ts delete mode 100644 plans/backlog/stale-sessions-cleanup.md create mode 100644 plans/week4/stale-data-cleanup.md diff --git a/.github/workflows/close-stale.yml b/.github/workflows/close-stale.yml new file mode 100644 index 0000000..37dfd32 --- /dev/null +++ b/.github/workflows/close-stale.yml @@ -0,0 +1,17 @@ +name: Close stale sessions + +on: + schedule: + - cron: "*/15 * * * *" + workflow_dispatch: + +jobs: + close-stale: + runs-on: ubuntu-latest + steps: + - name: Call cron endpoint + run: | + curl --fail --silent --show-error \ + -X GET \ + -H "Authorization: Bearer ${{ secrets.CRON_SECRET }}" \ + "${{ secrets.VERCEL_APP_URL }}/api/cron/close-stale" diff --git a/dashboard/.env.example b/dashboard/.env.example index 9bc7142..7fa4ac7 100644 --- a/dashboard/.env.example +++ b/dashboard/.env.example @@ -49,5 +49,11 @@ GROQ_MODEL="llama-3.3-70b-versatile" # openssl rand -base64 32 REPORTS_ENCRYPTION_KEY="" +# ─── Cron ────────────────────────────────────────────────────────────────────── +# Secret for the stale-data cleanup cron endpoint. +# GitHub Actions sends this in Authorization: Bearer <secret>. +# Generate: openssl rand -base64 32 +CRON_SECRET="" + # ─── App ─────────────────────────────────────────────────────────────────────── NEXT_PUBLIC_APP_URL="http://localhost:3000" diff --git a/dashboard/app/api/cron/close-stale/route.ts b/dashboard/app/api/cron/close-stale/route.ts new file mode 100644 index 0000000..e546712 --- /dev/null +++ b/dashboard/app/api/cron/close-stale/route.ts @@ -0,0 +1,17 @@ +import { type NextRequest, NextResponse } from "next/server"; +import { closeStaleSessions } from "@/server/sessions"; +import { closeStaleTracksForClosedSessions } from "@/server/tracks"; + +const STALE_THRESHOLD_MINUTES = 30; + +export async function GET(req: NextRequest): Promise<NextResponse> { + const secret = process.env["CRON_SECRET"]; + if (!secret || req.headers.get("authorization") !== `Bearer ${secret}`) { + return NextResponse.json({ error: "Unauthorized" }, { status: 401 }); + } + + const { closed, deleted } = await closeStaleSessions(STALE_THRESHOLD_MINUTES); + const tracksFixed = await closeStaleTracksForClosedSessions(); + + return NextResponse.json({ closed, deleted, tracksFixed }); +} diff --git a/dashboard/server/sessions.ts b/dashboard/server/sessions.ts index af486e1..ac71e3a 100644 --- a/dashboard/server/sessions.ts +++ b/dashboard/server/sessions.ts @@ -2,6 +2,24 @@ import { Prisma } from "@/generated/prisma/client"; import type { TopSession } from "@/types/event"; import { prisma } from "./db"; +export async function closeStaleSessions( + thresholdMinutes: number, +): Promise<{ closed: number; deleted: number }> { + const { count: deleted } = await prisma.session.deleteMany({ + where: { endedAt: null, events: { none: {} } }, + }); + + const closed = await prisma.$executeRaw(Prisma.sql` + UPDATE "Session" s + SET "endedAt" = (SELECT MAX(e."timestamp") FROM "Event" e WHERE e."sessionId" = s.id) + WHERE s."endedAt" IS NULL + AND (SELECT MAX(e."timestamp") FROM "Event" e WHERE e."sessionId" = s.id) + < NOW() - (${thresholdMinutes} || ' minutes')::interval + `); + + return { closed, deleted }; +} + export class SessionNotFoundError extends Error { constructor() { super("Session not found"); diff --git a/dashboard/server/tracks.ts b/dashboard/server/tracks.ts index f5e740f..9088e15 100644 --- a/dashboard/server/tracks.ts +++ b/dashboard/server/tracks.ts @@ -1,6 +1,17 @@ import type { CreateTrackInput, UpdateTrackInput } from "./schemas/tracks"; import { prisma } from "./db"; +export async function closeStaleTracksForClosedSessions(): Promise<number> { + return prisma.$executeRaw` + UPDATE "Track" t + SET "endedAt" = s."endedAt" + FROM "Session" s + WHERE t."sessionId" = s.id + AND t."endedAt" IS NULL + AND s."endedAt" IS NOT NULL + `; +} + export class SessionNotFoundError extends Error { constructor() { super("Session not found"); diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index e734a45..941f714 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -519,6 +519,11 @@ chrome.runtime.onMessage.addListener( return false; } + if (message.type === "TRACK_STOP") { + void endCurrentDbTrack(); + return false; + } + if (message.type === "TRACK_GET_CURRENT") { (async () => { const r = await chrome.storage.local.get("currentTrack"); diff --git a/extension/src/content/soundcloud.ts b/extension/src/content/soundcloud.ts index 0a1115f..5dd0444 100644 --- a/extension/src/content/soundcloud.ts +++ b/extension/src/content/soundcloud.ts @@ -147,3 +147,7 @@ chrome.runtime.onMessage.addListener( sendIfChanged(parseTrack()); observeChanges(); + +window.addEventListener("pagehide", () => { + chrome.runtime.sendMessage({ type: "TRACK_STOP" } satisfies MusicMessage).catch(() => {}); +}); diff --git a/extension/src/content/ytm.ts b/extension/src/content/ytm.ts index 19c79c5..1622d14 100644 --- a/extension/src/content/ytm.ts +++ b/extension/src/content/ytm.ts @@ -152,3 +152,9 @@ chrome.runtime.onMessage.addListener( sendIfChanged(parseTrack()); observeChanges(); + +// Notify background to close the DB track record when the tab is closed/navigated. +// pagehide fires for both tab close and navigation (unlike beforeunload). +window.addEventListener("pagehide", () => { + chrome.runtime.sendMessage({ type: "TRACK_STOP" } satisfies MusicMessage).catch(() => {}); +}); diff --git a/extension/src/types/music.ts b/extension/src/types/music.ts index d29758b..d47b34e 100644 --- a/extension/src/types/music.ts +++ b/extension/src/types/music.ts @@ -10,7 +10,8 @@ export interface TrackInfo { export type MusicMessage = | { type: "TRACK_CAPTURED"; payload: TrackInfo } - | { type: "TRACK_GET_CURRENT" }; + | { type: "TRACK_GET_CURRENT" } + | { type: "TRACK_STOP" }; export type MusicResponse = | { success: true; track: TrackInfo | null } diff --git a/plans/backlog/stale-sessions-cleanup.md b/plans/backlog/stale-sessions-cleanup.md deleted file mode 100644 index 97fee67..0000000 --- a/plans/backlog/stale-sessions-cleanup.md +++ /dev/null @@ -1,74 +0,0 @@ -# Backlog: Stale-session auto-cleanup - -**Пріоритет:** medium, після MVP demo -**Залежить від:** Week 2 AC 3 (session manager), Week 3 AC 2 (top-sessions panel) -**Статус:** не розпочато - ---- - -## Проблема (виявлено під час Week 3 AC 2) - -`Session.endedAt` ставиться **тільки** коли extension явно надсилає `POST /api/v1/sessions/[id]` зі stop-маркером — або з popup'у через кнопку "■ STOP", або з auto-stop-логіки в `background/session.ts`. Якщо service worker заснув, браузер закрився, або юзер просто перестав ним користуватись — запис лишається `endedAt = NULL` назавжди. - -Спостережене на dev-БД (станом 2026-05-27): -- юзер мав 2 одночасні `endedAt = NULL` сесії — одну стартовану сьогодні, другу 2 дні тому -- стара сесія мала 66 events за 1h 10m реальної активності і потрапила у `TOP 3 SESSIONS` як "активна" -- візуально у дашборді це виглядає як неточність, хоча математика правильна (`SUM(event-durations)` — точне) - -**Це не баг алгоритму:** `byDay` / `topTags` / `topHostSeconds` / `totalSeconds` рахуються коректно. Це баг **lifecycle'у сесії**: live-state не синхронізується з БД при втраті екстеншна. - ---- - -## Підходи (від найдешевшого до найповнішого) - -### 1. SQL-filter "recently active" в `getTopSessionsForUser` - -``` -AND (s."endedAt" IS NOT NULL OR <last event timestamp> >= NOW() - INTERVAL '24 hours') -``` - -- **+** zero-cost, не чіпає БД -- **−** маскує проблему; "загублені" сесії все одно сидять у БД і впливають на майбутні агрегації - -### 2. Auto-close при кожному `GET /api/v1/sessions/top` - -`UPDATE "Session" SET "endedAt" = (SELECT MAX(timestamp) FROM "Event" WHERE "sessionId" = id) WHERE "endedAt" IS NULL AND <last event> < NOW() - INTERVAL '1 hour'` - -- **+** очищує БД "by use" -- **−** write на кожному GET читачі = поганий патерн (особливо для cold-cache scenarios), porno-write при високому traffic - -### 3. Cron job (Recommended) - -Окремий джоб, який раз на 15 хв пробігається через відкриті сесії і закриває ті, де `MAX(event.timestamp) < NOW() - INTERVAL '30 minutes'`. Реалізації: - -**3a. Vercel Cron** — `vercel.json` з `crons: [{ path: "/api/cron/close-stale-sessions", schedule: "*/15 * * * *" }]`. Route Handler захищений `Authorization: Bearer ${CRON_SECRET}`. Vercel сам викликає його на schedule (free tier — 2 invocations/day, hobby — необмежено). - -**3b. PostgreSQL `pg_cron`** — суто SQL-job на стороні Neon/Postgres. Не потребує route handler, але vendor-specific (на локальному Postgres треба установлювати extension). - -**3c. Зовнішній GitHub Actions cron** — `.github/workflows/close-stale.yml` з `schedule: cron: "*/15 * * * *"` + step що шле HTTP до Vercel-роуту. Працює для будь-якого хосту, але GH-Actions schedule не гарантує точність (може спізнитись на 10+ хв при високому навантаженні). - -**Рекомендовано:** 3a (Vercel Cron) — найменше movable parts, інфра вже на Vercel. - -### 4. Client-side keepalive + server-side TTL - -Extension шле `PUT /api/v1/sessions/[id]/heartbeat` кожні 5 хв доки активна. Серверний крон закриває сесії без heartbeat'а за останні 15 хв. Близько до 3, але потребує і клієнтських змін. - ---- - -## Декомпозиція (для майбутнього плану) - -``` -1. docs(plans): stale-session cleanup plan -2. feat(server): add closeStaleSessions(thresholdMinutes) in server/sessions.ts -3. feat(dashboard): add /api/cron/close-stale-sessions route + CRON_SECRET env -4. chore: register vercel.json cron schedule */15 * * * * -5. test: write down end-to-end check (insert stale session → run cron → assert closed) -``` - ---- - -## Open questions - -- Який поріг "stale"? 30 хв безактивності — здається безпечним. Менше — ризик закрити активного юзера що зробив паузу -- Що робити з повністю "порожніми" сесіями (`startedAt` є, events = 0)? Видаляти чи закривати з `endedAt = startedAt`? -- Чи показувати у дашборді сесії що були закриті cron'ом інакше (badge "auto-closed")? diff --git a/plans/week4/stale-data-cleanup.md b/plans/week4/stale-data-cleanup.md new file mode 100644 index 0000000..be95035 --- /dev/null +++ b/plans/week4/stale-data-cleanup.md @@ -0,0 +1,120 @@ +# Week 4: Stale data cleanup + +**Пріоритет:** high +**Залежить від:** Week 2 AC 3 (session manager), Week 2 AC 6 (музика), Week 3 AC 2 (top-sessions panel) +**Статус:** не розпочато + +--- + +## Проблема 1 — Stale sessions (виявлено під час Week 3 AC 2) + +`Session.endedAt` ставиться **тільки** коли extension явно надсилає `POST /api/v1/sessions/[id]` зі stop-маркером — або з popup'у через кнопку "■ STOP", або з auto-stop-логіки в `background/session.ts`. Якщо service worker заснув, браузер закрився, або юзер просто перестав ним користуватись — запис лишається `endedAt = NULL` назавжди. + +Спостережене на dev-БД (станом 2026-05-27): +- юзер мав 2 одночасні `endedAt = NULL` сесії — одну стартовану сьогодні, другу 2 дні тому +- стара сесія мала 66 events за 1h 10m реальної активності і потрапила у `TOP 3 SESSIONS` як "активна" +- візуально у дашборді це виглядає як неточність, хоча математика правильна (`SUM(event-durations)` — точне) + +**Це не баг алгоритму:** `byDay` / `topTags` / `topHostSeconds` / `totalSeconds` рахуються коректно. Це баг **lifecycle'у сесії**: live-state не синхронізується з БД при втраті екстеншна. + +--- + +## Проблема 2 — Stale music timer (виявлено 2026-06-02) + +`Track`-запис не отримує `endedAt` (або аналогічний stop-маркер) коли вкладка YouTube Music закривається, браузер завершує роботу, або service worker засинає під час відтворення. + +Спостережене поведінка: +- відкрив extension наступного дня після того як YTM була закрита +- таймер на одній пісні показував **680+ хвилин** — трек "грав" всю ніч і наступний ранок +- MutationObserver в content script перестає отримувати події як тільки вкладка закрита — але останній `Track` вже записаний у `chrome.storage.local` як "поточний" і ніколи не отримав сигнал зупинки +- дашборд `/dashboard/music` рахує тривалість треку від моменту старту до `NOW()` (або до кінця сесії), тому цифри стають абсурдними + +**Це симетрична проблема до Проблеми 1:** те саме відсутнє lifecycle-закриття, тільки для `Track` замість `Session`. + +--- + +## Підходи + +### Проблема 1 — Сесії + +#### 1. SQL-filter "recently active" в `getTopSessionsForUser` + +```sql +AND (s."endedAt" IS NOT NULL OR <last event timestamp> >= NOW() - INTERVAL '24 hours') +``` + +- **+** zero-cost, не чіпає БД +- **−** маскує проблему; "загублені" сесії все одно сидять у БД і впливають на майбутні агрегації + +#### 2. Auto-close при кожному `GET /api/v1/sessions/top` + +```sql +UPDATE "Session" SET "endedAt" = (SELECT MAX(timestamp) FROM "Event" WHERE "sessionId" = id) +WHERE "endedAt" IS NULL AND <last event> < NOW() - INTERVAL '1 hour' +``` + +- **+** очищує БД "by use" +- **−** write на кожному GET = поганий патерн + +#### 3. Cron job (Recommended) + +Окремий джоб, який раз на 15 хв пробігається через відкриті сесії і закриває ті, де `MAX(event.timestamp) < NOW() - INTERVAL '30 minutes'`. + +**3a. Vercel Cron** — `vercel.json` з `crons: [{ path: "/api/cron/close-stale-sessions", schedule: "*/15 * * * *" }]`. Route Handler захищений `Authorization: Bearer ${CRON_SECRET}`. Vercel сам викликає його на schedule (free tier — 2 invocations/day, hobby — необмежено). + +**3b. PostgreSQL `pg_cron`** — суто SQL-job на стороні Neon/Postgres. Не потребує route handler, але vendor-specific. + +**3c. Зовнішній GitHub Actions cron** — `.github/workflows/close-stale.yml` з `schedule: cron: "*/15 * * * *"` + step що шле HTTP до Vercel-роуту. + +**Рекомендовано:** 3c (GitHub Actions cron) — безкоштовно на будь-якому tier, сумісно з Vercel + Neon + Render. GitHub Actions шле HTTP GET на `/api/cron/close-stale-sessions` з `Authorization: Bearer CRON_SECRET`. Vercel route handler запускається, чистить Neon. Cold start ~200-500мс — не критично для cleanup задачі. + +--- + +### Проблема 2 — Музика + +#### 2a. Cap тривалості треку при читанні (найшвидше) + +При отриманні треків з БД: якщо трек не має `endedAt` і `startedAt < NOW() - INTERVAL '2 hours'` — cap тривалість до `MIN(duration, 2*60*60*1000)` або взагалі виключити з агрегації. + +- **+** одна зміна у query, нічого не чіпає extension +- **−** маскує; дані в БД лишаються некоректними + +#### 2b. Extension: зупиняти трек при закритті вкладки (правильно) + +Content script реєструє `window.beforeunload` → надсилає повідомлення до background → background патчить поточний трек-запис і виставляє `endedAt = Date.now()`. + +Проблема: `beforeunload` часто не спрацьовує при crash/kill процесу. + +#### 2c. Cron — закривати stale tracks (симетрично до сесій) + +Той самий cron-роут `close-stale-sessions` додатково закриває `Track`-и де: +- `endedAt IS NULL` +- `startedAt < NOW() - INTERVAL '30 minutes'` +- `sessionId` відповідає вже закритій сесії + +`endedAt` для треку = `MIN(session.endedAt, startedAt + "typical_track_duration")` або просто `session.endedAt`. + +**Рекомендовано:** 2b + 2c разом — extension намагається закрити чисто, cron підбирає решту. + +--- + +## Декомпозиція + +``` +1. docs(plans): move and expand stale-data-cleanup plan +2. feat(server): closeStaleSessions(thresholdMinutes) in server/sessions.ts +3. feat(server): closeStaleTracksForSession() in server/tracks.ts +4. feat(dashboard): GET /api/cron/close-stale — закриває сесії + треки, захищений CRON_SECRET +5. chore(ci): .github/workflows/close-stale.yml — cron schedule "*/15 * * * *", шле HTTP до Vercel +6. fix(extension): beforeunload → stop current track message to background +7. test: insert stale session + track → run cron → assert both closed +``` + +--- + +## Рішення + +- **Поріг "stale" для треків:** 30 хв — симетрично до сесій. Трек і сесія живуть разом, крон закриває обидва одним запитом. +- **Порожні сесії (events = 0):** видаляти. Сесія без подій не несе цінності і забруднює агрегації. +- **Badge "auto-closed":** ні. Юзеру байдуже як закрилась; при потребі дебагу є `updatedAt` в БД. +- **Track schema:** є `endedAt DateTime?` і `listenedMs Int` (підтверджено `prisma/schema.prisma`). `listenedMs` накопичений коректно — чіпати не треба. Cron виставляє `endedAt = session.endedAt` для stale треків без `endedAt`. From d253fce319c9896ffc17b37a6c2aafed602a466f Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Tue, 2 Jun 2026 13:03:57 +0300 Subject: [PATCH 20/24] chore: JWT unification (jose everywhere) + logout cache clear (#20) * docs(plans): move post-week3 tech debt plan to week4 * refactor(server): port issueJWT and requireUser to jose * chore(deps): remove jsonwebtoken and @types/jsonwebtoken * fix(dashboard): clear TanStack cache on logout * chore(plans): drop email-password-auth from backlog, out of scope for Week 4 --- dashboard/app/api/v1/events/route.ts | 4 +- dashboard/app/api/v1/events/stats/route.ts | 2 +- dashboard/app/api/v1/music/stats/route.ts | 2 +- .../app/api/v1/reports/generate/route.ts | 2 +- dashboard/app/api/v1/sessions/[id]/route.ts | 2 +- dashboard/app/api/v1/sessions/route.ts | 2 +- dashboard/app/api/v1/sessions/top/route.ts | 2 +- dashboard/app/api/v1/tracks/[id]/route.ts | 2 +- dashboard/app/api/v1/tracks/route.ts | 2 +- dashboard/app/api/v1/user/settings/route.ts | 4 +- dashboard/app/dashboard/logout-button.tsx | 5 +- dashboard/package-lock.json | 89 ------------ dashboard/package.json | 2 - dashboard/server/auth.ts | 17 +-- dashboard/server/jwt.ts | 27 ++-- plans/backlog/email-password-auth.md | 134 ------------------ plans/backlog/post-week3-tech-debt.md | 75 ---------- .../week4/jwt-unification-and-logout-cache.md | 79 +++++++++++ 18 files changed, 113 insertions(+), 339 deletions(-) delete mode 100644 plans/backlog/email-password-auth.md delete mode 100644 plans/backlog/post-week3-tech-debt.md create mode 100644 plans/week4/jwt-unification-and-logout-cache.md diff --git a/dashboard/app/api/v1/events/route.ts b/dashboard/app/api/v1/events/route.ts index f97719d..bd02f3d 100644 --- a/dashboard/app/api/v1/events/route.ts +++ b/dashboard/app/api/v1/events/route.ts @@ -12,7 +12,7 @@ import { apiError } from "@/server/api-error"; export const GET = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); @@ -33,7 +33,7 @@ export const GET = withCors(async (req) => { export const POST = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/api/v1/events/stats/route.ts b/dashboard/app/api/v1/events/stats/route.ts index 949b991..e8e0671 100644 --- a/dashboard/app/api/v1/events/stats/route.ts +++ b/dashboard/app/api/v1/events/stats/route.ts @@ -8,7 +8,7 @@ import { apiError } from "@/server/api-error"; export const GET = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/api/v1/music/stats/route.ts b/dashboard/app/api/v1/music/stats/route.ts index b36abdc..45f367f 100644 --- a/dashboard/app/api/v1/music/stats/route.ts +++ b/dashboard/app/api/v1/music/stats/route.ts @@ -22,7 +22,7 @@ export const GET = withCors(async (req: NextRequest) => { if (cookie) { userId = cookie.id; } else { - userId = requireUser(req).id; + userId = (await requireUser(req)).id; } } catch (err) { if (err instanceof UnauthorizedError) { diff --git a/dashboard/app/api/v1/reports/generate/route.ts b/dashboard/app/api/v1/reports/generate/route.ts index 46b27e0..ce6803c 100644 --- a/dashboard/app/api/v1/reports/generate/route.ts +++ b/dashboard/app/api/v1/reports/generate/route.ts @@ -16,7 +16,7 @@ import { apiError } from "@/server/api-error"; export const POST = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/api/v1/sessions/[id]/route.ts b/dashboard/app/api/v1/sessions/[id]/route.ts index fd2afab..e797199 100644 --- a/dashboard/app/api/v1/sessions/[id]/route.ts +++ b/dashboard/app/api/v1/sessions/[id]/route.ts @@ -13,7 +13,7 @@ export function PATCH(req: NextRequest, ctx: RouteContext): Promise<NextResponse return withCors(async (r) => { let user; try { - user = requireUser(r); + user = await requireUser(r); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/api/v1/sessions/route.ts b/dashboard/app/api/v1/sessions/route.ts index 002ce97..8f47a45 100644 --- a/dashboard/app/api/v1/sessions/route.ts +++ b/dashboard/app/api/v1/sessions/route.ts @@ -7,7 +7,7 @@ import { apiError } from "@/server/api-error"; export const POST = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/api/v1/sessions/top/route.ts b/dashboard/app/api/v1/sessions/top/route.ts index 0b5dc38..f0e1119 100644 --- a/dashboard/app/api/v1/sessions/top/route.ts +++ b/dashboard/app/api/v1/sessions/top/route.ts @@ -7,7 +7,7 @@ import { apiError } from "@/server/api-error"; export const GET = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/api/v1/tracks/[id]/route.ts b/dashboard/app/api/v1/tracks/[id]/route.ts index 7e6a607..4d9bf39 100644 --- a/dashboard/app/api/v1/tracks/[id]/route.ts +++ b/dashboard/app/api/v1/tracks/[id]/route.ts @@ -13,7 +13,7 @@ export function PATCH(req: NextRequest, ctx: RouteContext): Promise<NextResponse return withCors(async (r) => { let user; try { - user = requireUser(r); + user = await requireUser(r); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/api/v1/tracks/route.ts b/dashboard/app/api/v1/tracks/route.ts index cc8faf6..f25c5a8 100644 --- a/dashboard/app/api/v1/tracks/route.ts +++ b/dashboard/app/api/v1/tracks/route.ts @@ -8,7 +8,7 @@ import { apiError } from "@/server/api-error"; export const POST = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/api/v1/user/settings/route.ts b/dashboard/app/api/v1/user/settings/route.ts index 6b36ee9..8085a48 100644 --- a/dashboard/app/api/v1/user/settings/route.ts +++ b/dashboard/app/api/v1/user/settings/route.ts @@ -8,7 +8,7 @@ import { apiError } from "@/server/api-error"; export const GET = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); @@ -22,7 +22,7 @@ export const GET = withCors(async (req) => { export const PUT = withCors(async (req) => { let user; try { - user = requireUser(req); + user = await requireUser(req); } catch (err) { if (err instanceof UnauthorizedError) { return apiError("UNAUTHORIZED", err.message, 401); diff --git a/dashboard/app/dashboard/logout-button.tsx b/dashboard/app/dashboard/logout-button.tsx index a77a994..0f3854e 100644 --- a/dashboard/app/dashboard/logout-button.tsx +++ b/dashboard/app/dashboard/logout-button.tsx @@ -2,9 +2,11 @@ import { useState } from "react"; import { useRouter } from "next/navigation"; +import { useQueryClient } from "@tanstack/react-query"; export function LogoutButton() { - const router = useRouter(); + const router = useRouter(); + const queryClient = useQueryClient(); const [pending, setPending] = useState(false); return ( @@ -16,6 +18,7 @@ export function LogoutButton() { try { await fetch("/api/auth/logout", { method: "POST" }); } finally { + queryClient.clear(); router.replace("/login"); router.refresh(); } diff --git a/dashboard/package-lock.json b/dashboard/package-lock.json index 1d01aa8..7907e85 100644 --- a/dashboard/package-lock.json +++ b/dashboard/package-lock.json @@ -16,7 +16,6 @@ "framer-motion": "^12.38.0", "google-auth-library": "^10.6.2", "jose": "^6.2.3", - "jsonwebtoken": "^9.0.3", "next": "16.2.6", "pg": "^8.20.0", "prisma": "^7.8.0", @@ -30,7 +29,6 @@ "devDependencies": { "@tailwindcss/postcss": "^4", "@types/d3": "^7.4.3", - "@types/jsonwebtoken": "^9.0.10", "@types/node": "^20", "@types/pg": "^8.20.0", "@types/react": "^19", @@ -2509,17 +2507,6 @@ "dev": true, "license": "MIT" }, - "node_modules/@types/jsonwebtoken": { - "version": "9.0.10", - "resolved": "https://registry.npmjs.org/@types/jsonwebtoken/-/jsonwebtoken-9.0.10.tgz", - "integrity": "sha512-asx5hIG9Qmf/1oStypjanR7iKTv0gXQ1Ov/jfrX6kS/EO0OFni8orbmGCn0672NHR3kXHwpAwR+B368ZGN/2rA==", - "dev": true, - "license": "MIT", - "dependencies": { - "@types/ms": "*", - "@types/node": "*" - } - }, "node_modules/@types/mdast": { "version": "4.0.4", "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz", @@ -7044,40 +7031,6 @@ "graceful-fs": "^4.1.6" } }, - "node_modules/jsonwebtoken": { - "version": "9.0.3", - "resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.3.tgz", - "integrity": "sha512-MT/xP0CrubFRNLNKvxJ2BYfy53Zkm++5bX9dtuPbqAeQpTVe0MQTFhao8+Cp//EmJp244xt6Drw/GVEGCUj40g==", - "license": "MIT", - "dependencies": { - "jws": "^4.0.1", - "lodash.includes": "^4.3.0", - "lodash.isboolean": "^3.0.3", - "lodash.isinteger": "^4.0.4", - "lodash.isnumber": "^3.0.3", - "lodash.isplainobject": "^4.0.6", - "lodash.isstring": "^4.0.1", - "lodash.once": "^4.0.0", - "ms": "^2.1.1", - "semver": "^7.5.4" - }, - "engines": { - "node": ">=12", - "npm": ">=6" - } - }, - "node_modules/jsonwebtoken/node_modules/semver": { - "version": "7.8.0", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.0.tgz", - "integrity": "sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==", - "license": "ISC", - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/jsx-ast-utils": { "version": "3.3.5", "resolved": "https://registry.npmjs.org/jsx-ast-utils/-/jsx-ast-utils-3.3.5.tgz", @@ -7446,42 +7399,6 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/lodash.includes": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz", - "integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==", - "license": "MIT" - }, - "node_modules/lodash.isboolean": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz", - "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==", - "license": "MIT" - }, - "node_modules/lodash.isinteger": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz", - "integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==", - "license": "MIT" - }, - "node_modules/lodash.isnumber": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz", - "integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==", - "license": "MIT" - }, - "node_modules/lodash.isplainobject": { - "version": "4.0.6", - "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", - "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", - "license": "MIT" - }, - "node_modules/lodash.isstring": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz", - "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==", - "license": "MIT" - }, "node_modules/lodash.merge": { "version": "4.6.2", "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", @@ -7489,12 +7406,6 @@ "dev": true, "license": "MIT" }, - "node_modules/lodash.once": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz", - "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==", - "license": "MIT" - }, "node_modules/long": { "version": "5.3.2", "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz", diff --git a/dashboard/package.json b/dashboard/package.json index 868efa3..d9e9b64 100644 --- a/dashboard/package.json +++ b/dashboard/package.json @@ -17,7 +17,6 @@ "framer-motion": "^12.38.0", "google-auth-library": "^10.6.2", "jose": "^6.2.3", - "jsonwebtoken": "^9.0.3", "next": "16.2.6", "pg": "^8.20.0", "prisma": "^7.8.0", @@ -31,7 +30,6 @@ "devDependencies": { "@tailwindcss/postcss": "^4", "@types/d3": "^7.4.3", - "@types/jsonwebtoken": "^9.0.10", "@types/node": "^20", "@types/pg": "^8.20.0", "@types/react": "^19", diff --git a/dashboard/server/auth.ts b/dashboard/server/auth.ts index 2e4e307..67d8e12 100644 --- a/dashboard/server/auth.ts +++ b/dashboard/server/auth.ts @@ -1,5 +1,5 @@ import { OAuth2Client } from "google-auth-library"; -import jwt from "jsonwebtoken"; +import { SignJWT } from "jose"; import { prisma } from "@/server/db"; function requireEnv(name: string): string { @@ -41,13 +41,14 @@ async function upsertUser(data: { }); } -function issueJWT(userId: string, email: string): string { - const expiresIn = (process.env.JWT_EXPIRES_IN ?? "7d") as jwt.SignOptions["expiresIn"]; - return jwt.sign( - { sub: userId, email }, - requireEnv("JWT_SECRET"), - { expiresIn }, - ); +async function issueJWT(userId: string, email: string): Promise<string> { + const secret = requireEnv("JWT_SECRET"); + const expiresIn = process.env["JWT_EXPIRES_IN"] ?? "7d"; + return new SignJWT({ sub: userId, email }) + .setProtectedHeader({ alg: "HS256" }) + .setIssuedAt() + .setExpirationTime(expiresIn) + .sign(new TextEncoder().encode(secret)); } export async function authenticateGoogleUser(googleIdToken: string): Promise<string> { diff --git a/dashboard/server/jwt.ts b/dashboard/server/jwt.ts index 9dbae38..6457e20 100644 --- a/dashboard/server/jwt.ts +++ b/dashboard/server/jwt.ts @@ -1,5 +1,4 @@ import type { NextRequest } from "next/server"; -import jwt from "jsonwebtoken"; import { jwtVerify } from "jose"; import { SESSION_COOKIE } from "@/server/cookies"; @@ -21,13 +20,16 @@ function isPayload(v: unknown): v is JwtPayload { return typeof r["sub"] === "string" && typeof r["email"] === "string"; } -export async function verifyJwt(token: string): Promise<JwtPayload> { - const secret = process.env.JWT_SECRET; +function getSecretKey(): Uint8Array { + const secret = process.env["JWT_SECRET"]; if (!secret) throw new Error("JWT_SECRET is not set"); + return new TextEncoder().encode(secret); +} +export async function verifyJwt(token: string): Promise<JwtPayload> { let payload: unknown; try { - const result = await jwtVerify(token, new TextEncoder().encode(secret)); + const result = await jwtVerify(token, getSecretKey()); payload = result.payload; } catch { throw new UnauthorizedError("Invalid or expired token"); @@ -45,20 +47,9 @@ function extractToken(req: NextRequest): string | null { return req.cookies.get(SESSION_COOKIE)?.value ?? null; } -export function requireUser(req: NextRequest): { id: string; email: string } { +export async function requireUser(req: NextRequest): Promise<{ id: string; email: string }> { const token = extractToken(req); if (!token) throw new UnauthorizedError("Missing authentication credentials"); - - const secret = process.env.JWT_SECRET; - if (!secret) throw new Error("JWT_SECRET is not set"); - - let decoded: unknown; - try { - decoded = jwt.verify(token, secret); - } catch { - throw new UnauthorizedError("Invalid or expired token"); - } - if (!isPayload(decoded)) throw new UnauthorizedError("Invalid token payload"); - - return { id: decoded.sub, email: decoded.email }; + const payload = await verifyJwt(token); + return { id: payload.sub, email: payload.email }; } diff --git a/plans/backlog/email-password-auth.md b/plans/backlog/email-password-auth.md deleted file mode 100644 index 43dd200..0000000 --- a/plans/backlog/email-password-auth.md +++ /dev/null @@ -1,134 +0,0 @@ -# Backlog: Email + Password Auth (альтернатива Google OAuth) - -**Пріоритет:** обов'язково, після Week 2–3 -**Залежить від:** Week 3 AC 1 (middleware + JWT вже є) -**Статус:** не розпочато - ---- - -## Мета - -Дати можливість реєструватись і логінитись через email + пароль без Google акаунту. Один акаунт на один email. Реєстрація підтверджується листом на пошту. - ---- - -## Scope - -### Dashboard (Next.js) - -**Нові Route Handlers:** - -| Endpoint | Що робить | -| -------------------------------- | ---------------------------------------------------------------------------- | -| `POST /api/auth/register` | Реєстрація: email + password → хеш → User у БД → надсилає verification email | -| `POST /api/auth/verify-email` | Приймає токен з листа → позначає email як підтверджений | -| `POST /api/auth/login` | email + password → перевіряє хеш → видає JWT | -| `POST /api/auth/login/extension` | Те саме але для extension (повертає JWT в тілі відповіді) | - -**Зміни в Prisma-схемі:** -```prisma -model User { - // ... існуючі поля - passwordHash String? // null якщо реєстрація через Google - emailVerified Boolean @default(false) - verificationToken String? // одноразовий токен для підтвердження - verificationExp DateTime? // термін дії токену -} -``` -→ потрібна міграція - -**Нові server-модулі:** -- `dashboard/server/password.ts` — `hashPassword`, `verifyPassword` (bcrypt або argon2) -- `dashboard/server/mailer.ts` — SMTP клієнт (nodemailer), `sendVerificationEmail` - -### Extension - -Альтернативний UI в popup: форма email + password замість (або поруч з) "Sign in with Google". - ---- - -## Технічний стек - -| Що | Пакет | -| ----------------- | ------------------------------------------- | -| Хешування паролів | `bcryptjs` (pure JS, без native deps) | -| SMTP | `nodemailer` | -| Email-провайдер | Mailtrap (dev) / Resend або SendGrid (prod) | - ---- - -## SMTP — що треба налаштувати - -**Dev (Mailtrap):** -```env -SMTP_HOST=sandbox.smtp.mailtrap.io -SMTP_PORT=2525 -SMTP_USER=<mailtrap-user> -SMTP_PASS=<mailtrap-pass> -SMTP_FROM=noreply@worktrace.dev -``` -Mailtrap перехоплює всі листи — не відправляє реальним юзерам. Безпечно для розробки. - -**Prod (Resend — безкоштовний tier: 3000 листів/міс):** -```env -SMTP_HOST=smtp.resend.com -SMTP_PORT=465 -SMTP_USER=resend -SMTP_PASS=<resend-api-key> -``` - ---- - -## Сценарій: реєстрація з підтвердженням email - -``` -1. Юзер вводить email + password → POST /api/auth/register -2. Сервер: bcrypt.hash(password) → зберігає User { emailVerified: false, verificationToken: uuid, verificationExp: now+24h } -3. Сервер: nodemailer надсилає лист з посиланням: - https://worktrace.app/api/auth/verify-email?token=<uuid> -4. Юзер клікає посилання → GET /api/auth/verify-email?token=... -5. Сервер: перевіряє token + exp → User.emailVerified = true, видаляє token -6. Юзер логіниться: POST /api/auth/login → email + password → bcrypt.compare → JWT -``` - ---- - -## Сценарій: логін в extension - -``` -1. Popup показує форму: email + password -2. Юзер вводить → popup надсилає NOTE_ADD (або новий тип) до background -3. Background: POST /api/auth/login/extension { email, password } -4. Dashboard: верифікує → повертає { token: JWT } -5. Background: зберігає JWT в chrome.storage.local (той самий формат що і Google OAuth) -``` - ---- - -## Зміни в popup - -Додати вкладки або toggle: -``` -[Google] [Email] -───────────────── -Email: [__________] -Password: [__________] - [Sign In] - [Register] -``` - ---- - -## Out of scope для цього backlog-item - -- Forgot password / reset (окремий backlog) -- 2FA -- OAuth провайдери крім Google -- Rate limiting на auth endpoints (хоча бажано) - ---- - -## Коли робити - -Після Week 3 (коли middleware і JWT flow вже стабільні). Не блокує Week 2–3. -Орієнтовно: між Week 3 і Week 4, або як окремий PR після Week 4. diff --git a/plans/backlog/post-week3-tech-debt.md b/plans/backlog/post-week3-tech-debt.md deleted file mode 100644 index f83df6f..0000000 --- a/plans/backlog/post-week3-tech-debt.md +++ /dev/null @@ -1,75 +0,0 @@ -# Backlog: Tech debt from Week 3 AC 2 review - -**Пріоритет:** low/medium, ергономіка та чистота коду -**Залежить від:** Week 3 AC 2 (merged) -**Статус:** не розпочато - ---- - -## Контекст - -Під час self-review гілки `feature/dashboard-event-feed` виявлено два пункти, які доцільно зробити **поза цією гілкою** — бо вони зачіпають код, що написаний раніше, або міняють контракт відразу в кількох роутах. Свідомо відкладено, щоб PR залишився сфокусованим на AC 2. - ---- - -## 1. JWT-bibліотека уніфікація — `jose` всюди - -### Зараз -- `dashboard/server/jwt.ts` має **дві** функції верифікації: - - `verifyJwt(token)` — на `jose`, async, працює і в edge (middleware), і у Node (Server Components) - - `requireUser(req)` — на `jsonwebtoken`, sync, Node-only, використовується у всіх Route Handler'ах (`/api/v1/events`, `/api/v1/sessions`, `/api/v1/tracks`) -- Один і той самий HS256 секрет валідується двома різними бібліотеками. Це працює (HMAC-SHA256 — стандарт), але: - - `jsonwebtoken` + `@types/jsonwebtoken` — зайва runtime + типова залежність - - дві шляхи верифікації — два місця де треба поправити при зміні алгоритму чи rotation logic - - issue/sign все одно на `jsonwebtoken` (`server/auth.ts:issueJWT`) — половинчасто - -### Бажано -- `requireUser(req)` стає `async`, всередині викликає `verifyJwt(token)` з `jose` -- Усі route handlers додають `await` (вони вже `async`) -- `issueJWT` переписується на `new SignJWT(...)` з `jose` -- `jsonwebtoken` + `@types/jsonwebtoken` видаляються з `package.json` - -### Ризик -- Низький: підпис байт-у-байт сумісний (HS256 над тим самим секретом) -- Існуючий extension з валідним токеном залишається працювати — нічого не ротуємо -- Тестується через існуючий `POST /api/v1/events` з Bearer токеном extension'а - -### Декомпозиція -``` -1. refactor(server): port issueJWT and requireUser to jose -2. chore(deps): remove jsonwebtoken and @types/jsonwebtoken -3. test: regression — Bearer-flow from extension, cookie-flow from dashboard -``` - ---- - -## 2. QueryClient `.clear()` після logout - -### Зараз -- `dashboard/app/dashboard/logout-button.tsx` шле `POST /api/auth/logout` → `router.replace("/login")` + `router.refresh()` -- `QueryClient` живе у `dashboard/app/providers.tsx` через `useState(() => new QueryClient(...))` — це singleton поки tab live -- Якщо user A вийшов, user B зайшов **у тій самій вкладці без перезавантаження** — TanStack кеш не очищується. user B на момент першого пасивного рендеру може побачити кеш від user A (доки `staleTime` не вийшов) - -На практиці `router.refresh()` робить full Server Components re-render → новий prefetch → новий hydrate → старий кеш переписується. Але: -- Перед першим прибуттям свіжих даних може спалахнути stale UI (на 50-200 мс) -- TanStack-кеш для `["top-sessions"]` теж зберігається, бо queryKey не залежить від userId - -### Бажано -- У `LogoutButton.onClick` додати `queryClient.clear()` (через `useQueryClient()`) перед `router.replace` -- Або (стійкіше): мати у QueryClient subscriber на `wt_session` cookie change і автоматично clear - -### Ризик -- Дуже низький — це фронт-only -- Один новий рядок коду - -### Декомпозиція -``` -1. fix(dashboard): clear tanstack cache on logout -``` - ---- - -## Чому не зробили зараз - -- **JWT**: зачіпає 4+ route handlers поза scope AC 2. PR має бути сфокусованим на стрічці подій. Окремий PR `chore: jwt unification` рев'юється легше і не блокує feature merge. -- **QueryClient clear**: код у `logout-button.tsx` фактично не змінений у цій гілці (тільки стиль кнопки). Логіка logout — це AC 1 territory. Краще додати окремою fix-гілкою щоб не розмивати focus AC 2. diff --git a/plans/week4/jwt-unification-and-logout-cache.md b/plans/week4/jwt-unification-and-logout-cache.md new file mode 100644 index 0000000..381ee36 --- /dev/null +++ b/plans/week4/jwt-unification-and-logout-cache.md @@ -0,0 +1,79 @@ +# Week 4: JWT unification + logout cache clear + +**Пріоритет:** medium +**Залежить від:** Week 3 AC 1 (auth middleware + JWT), Week 3 AC 2 (event feed, logout button) +**Статус:** не розпочато +**Гілка:** `chore/jwt-unification` + +--- + +## Контекст + +Під час self-review гілки `feature/dashboard-event-feed` виявлено два пункти, свідомо відкладені щоб PR залишився сфокусованим. Обидва зачіпають код за межами тієї гілки. + +--- + +## 1. JWT уніфікація — `jose` всюди + +### Зараз + +`dashboard/server/jwt.ts` має **дві** функції верифікації: +- `verifyJwt(token)` — на `jose`, async, працює в edge (middleware) і Node +- `requireUser(req)` — на `jsonwebtoken`, sync, Node-only, використовується у всіх Route Handler'ах + +`issueJWT` у `server/auth.ts` теж на `jsonwebtoken`. Результат: один HS256 секрет обслуговується двома різними бібліотеками. + +**Проблеми:** +- `jsonwebtoken` + `@types/jsonwebtoken` — зайві залежності +- два місця де треба правити при зміні алгоритму або rotation logic + +### Після рефактору + +- `issueJWT` → `new SignJWT(...).sign(...)` з `jose` +- `requireUser(req)` → async, викликає існуючий `verifyJwt(token)` з `jose` +- Усі Route Handlers де є `requireUser` — вже `async`, просто додається `await` +- `jsonwebtoken` + `@types/jsonwebtoken` видаляються + +**Ризик:** низький. HS256 підпис байт-у-байт сумісний між бібліотеками. Існуючі токени в extension залишаються валідними — нічого не ротуємо. + +--- + +## 2. `queryClient.clear()` після logout + +### Зараз + +`LogoutButton` → `POST /api/auth/logout` → `router.replace("/login")` + `router.refresh()`. + +`QueryClient` — singleton поки tab жива. Якщо user A вийшов і user B зайшов у тій самій вкладці — TanStack кеш не очищується. До першого рефетчу user B може побачити дані user A (50–200 мс спалах). + +### Після фіксу + +`queryClient.clear()` через `useQueryClient()` перед `router.replace` — один рядок. + +**Ризик:** дуже низький, фронт-only. + +--- + +## Декомпозиція комітів + +``` +1. docs(plans): move post-week3 tech debt plan to week4 +2. refactor(server): port issueJWT and requireUser to jose +3. chore(deps): remove jsonwebtoken and @types/jsonwebtoken +4. fix(dashboard): clear TanStack cache on logout +5. fix: post-manual-test corrections (після ручного тесту від юзера) +``` + +**Коміт 1** — тільки цей план, без коду. +**Коміти 2–4** — реалізація, typecheck і lint чисті перед кожним. +**Коміт 5** — резервний після ручного тесту: Bearer flow з extension, cookie flow з дашборду, logout з двох акаунтів у одній вкладці. + +--- + +## Ручний тест (перед комітом 5) + +1. Extension: відправити `POST /api/v1/events` з Bearer токеном → `201` +2. Dashboard: зайти через Google → відкрити `/dashboard` → дані є +3. Dashboard: натиснути Logout → зайти іншим акаунтом → переконатись що старих даних не видно +4. `npx tsc --noEmit` (dashboard) — чисто +5. `npm run lint` (dashboard) — чисто From f2dfb3a1e5a0aa6f25a1b8b715d558d9eb9f7600 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Tue, 2 Jun 2026 18:21:25 +0300 Subject: [PATCH 21/24] feat(week4): AC 1 CI/CD + AC 2 Deploy - extension zip, auto release, README (#21) * docs(plans): add week4 deploy-polish plan * chore(extension): add zip script via PowerShell Compress-Archive * docs(readme): update tech stack, zip instructions, remove stale Week 1 notes * chore(ci): auto GitHub Release with extension zip on merge to main --- .github/workflows/release-extension.yml | 42 +++++++++++++++++ README.md | 34 +++++++++---- extension/package.json | 3 +- plans/week4/deploy-polish.md | 63 +++++++++++++++++++++++++ 4 files changed, 131 insertions(+), 11 deletions(-) create mode 100644 .github/workflows/release-extension.yml create mode 100644 plans/week4/deploy-polish.md diff --git a/.github/workflows/release-extension.yml b/.github/workflows/release-extension.yml new file mode 100644 index 0000000..fd86a1f --- /dev/null +++ b/.github/workflows/release-extension.yml @@ -0,0 +1,42 @@ +name: Release extension + +on: + push: + branches: [main] + +jobs: + release: + runs-on: ubuntu-latest + permissions: + contents: write + steps: + - uses: actions/checkout@v4 + + - uses: actions/setup-node@v4 + with: + node-version: "20" + cache: "npm" + cache-dependency-path: extension/package-lock.json + + - name: Build extension + working-directory: extension + run: npm ci && npm run build + + - name: Package extension + working-directory: extension + shell: pwsh + run: Compress-Archive -Path dist/* -DestinationPath worktrace-extension.zip -Force + + - name: Create GitHub Release + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + gh release create "extension-build-${{ github.run_number }}" \ + extension/worktrace-extension.zip \ + --title "WorkTrace Extension — build ${{ github.run_number }}" \ + --notes "Автоматичний реліз при мерджі в main. + + Щоб завантажити розширення: + 1. Скачай \`worktrace-extension.zip\` + 2. Розпакуй у будь-яку папку + 3. chrome://extensions → Developer mode → Load unpacked → обери розпаковану папку" diff --git a/README.md b/README.md index e0bd5ec..2eb7313 100644 --- a/README.md +++ b/README.md @@ -26,11 +26,11 @@ The two apps are isolated — `extension/` never imports from `dashboard/` and v ## Tech stack - **Dashboard** — Next.js 16 (App Router, Server Components), React 19, Tailwind CSS v4, TanStack Query v5, Framer Motion, D3.js -- **Backend** — Next.js Route Handlers, Prisma 7 (with `@prisma/adapter-pg`), Zod, `google-auth-library`, `jsonwebtoken` +- **Backend** — Next.js Route Handlers, Prisma 7 (with `@prisma/adapter-pg`), Zod, `google-auth-library`, `jose` - **Extension** — Manifest V3, Vite 7 + `@crxjs/vite-plugin`, TypeScript (strict) - **Database** — PostgreSQL 16 (Docker for local, Neon for production) -- **AI** — LLM provider TBD (Week 3): OpenAI / Groq / Gemini / OpenRouter -- **Deploy** — Vercel (dashboard), `.zip` for local extension install +- **AI** — Groq (`llama-3.3-70b-versatile`), з можливістю вказати власний API ключ у налаштуваннях +- **Deploy** — Vercel (dashboard), `.zip` для локального завантаження extension Versions in `dashboard/package.json` and `extension/package.json` are authoritative. @@ -51,7 +51,7 @@ cp dashboard/.env.example dashboard/.env cp extension/.env.example extension/.env ``` -The dashboard `.env` contains `DATABASE_URL` (already pointing at the docker-compose Postgres) plus `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `JWT_SECRET`. The Google/JWT values are **not required for Week 1** — leave them blank until the auth flow lands in Week 2. +The dashboard `.env` contains `DATABASE_URL` (already pointing at the docker-compose Postgres) plus `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `JWT_SECRET`, `GROQ_API_KEY`, and `CRON_SECRET`. See comments in `.env.example` for how to generate each value. ### 2. Start PostgreSQL @@ -89,19 +89,33 @@ Then in Chrome: The extension card should appear with no errors. For HMR-rebuild during active development use `npm run dev` instead of `npm run build`. +### Load from `.zip` (without source code) + +```bash +cd extension +npm run zip # builds and creates worktrace-extension.zip +``` + +Then in Chrome: + +1. Unzip `worktrace-extension.zip` to any folder +2. Open `chrome://extensions` → **Developer mode** → **Load unpacked** +3. Select the unzipped folder + ## Verifying it works -1. **Dashboard** — `http://localhost:3000` loads (Next.js placeholder page is fine for Week 1). -2. **Extension** — the card on `chrome://extensions` shows no errors; clicking the toolbar icon opens an empty popup; the service worker logs `[worktrace] installed` (visible via the extension's **Inspect** link). -3. **API** — a POST to the events endpoint round-trips through Postgres: +1. **Dashboard** — відкрий `http://localhost:3000`, натисни "Sign in with Google" → має відкритись `/dashboard` з даними. +2. **Extension** — картка на `chrome://extensions` без помилок; іконка в тулбарі відкриває popup; сервіс воркер логує `[worktrace] installed` (видно через **Inspect** посилання розширення). +3. **API** — Bearer токен з extension працює: ```bash curl -X POST http://localhost:3000/api/v1/events \ -H "Content-Type: application/json" \ - -d '{"sessionId":"ctestsess0000000000000001","url":"https://example.com","title":"Hello","tags":["test"],"timestamp":"2026-05-15T12:00:00Z"}' + -H "Authorization: Bearer <jwt-from-extension-storage>" \ + -d '{"sessionId":"<active-session-id>","url":"https://github.com","title":"Test","timestamp":"2026-06-01T10:00:00Z"}' ``` - A 201 response with the created event means the dashboard, Prisma, and Postgres are wired up correctly. (The `sessionId` must reference an existing `Session` row — create one via `npx prisma studio` or seed it manually.) + Відповідь `201` означає що dashboard, Prisma і Postgres з'єднані коректно. ## Project docs @@ -113,4 +127,4 @@ The extension card should appear with no errors. For HMR-rebuild during active d ## Deploy - **Dashboard** — Vercel with **Root Directory: `dashboard`**. The build command `prisma generate && next build` (declared in `dashboard/package.json`) regenerates the Prisma client at build time since `dashboard/generated/` is gitignored. Production database is Neon. -- **Extension** — distributed as a `.zip` of `extension/dist/` for local install. Chrome Web Store packaging is scheduled for Week 4 AC 2. +- **Extension** — `npm run zip` inside `extension/` builds and packages `dist/` into `worktrace-extension.zip`. Load unpacked in Chrome via Developer mode. diff --git a/extension/package.json b/extension/package.json index 4d2ecfc..b29f71e 100644 --- a/extension/package.json +++ b/extension/package.json @@ -7,7 +7,8 @@ "scripts": { "dev": "vite", "build": "vite build", - "typecheck": "tsc --noEmit" + "typecheck": "tsc --noEmit", + "zip": "npm run build && powershell -Command \"Compress-Archive -Path dist/* -DestinationPath worktrace-extension.zip -Force\"" }, "devDependencies": { "@crxjs/vite-plugin": "^2.0.0-beta.36", diff --git a/plans/week4/deploy-polish.md b/plans/week4/deploy-polish.md new file mode 100644 index 0000000..87570a6 --- /dev/null +++ b/plans/week4/deploy-polish.md @@ -0,0 +1,63 @@ +# Week 4 AC 1–2: Deploy polish + +**Пріоритет:** high — фінальний стан репо перед демо +**Залежить від:** всі попередні PR merged до development +**Статус:** в процесі +**Гілка:** `feat/week4-deploy-polish` + +--- + +## Scope + +### AC 1 — CI/CD (залишок) +GitHub Actions `ci.yml` вже є і покриває lint + typecheck. Branch protection rules налаштовані вручну. Автодеплой Vercel підключений через GitHub integration. +→ **Нічого робити в коді.** + +### AC 2 — Deploy (залишок у коді) + +1. **Extension `.zip`** — npm script `zip` в `extension/package.json` ✅ +2. **README оновлення** ✅ +3. **GitHub Actions release** — при мерджі в `main` автоматично білдить zip і публікує GitHub Release з asset +4. **`.env.example` перевірка** — вже актуальний (CRON_SECRET додано в попередньому PR) ✅ + +--- + +## Декомпозиція комітів + +``` +1. docs(plans): add week4 deploy-polish plan ✅ +2. chore(extension): add zip script via PowerShell Compress-Archive ✅ +3. docs(readme): update tech stack, zip instructions ✅ +4. chore(ci): release-extension.yml — auto GitHub Release on merge to main +``` + +--- + +## Деталі реалізації + +### Zip script + +`extension/package.json`: +```json +"zip": "npm run build && powershell -Command \"Compress-Archive -Path dist/* -DestinationPath worktrace-extension.zip -Force\"" +``` + +`powershell` (Windows PowerShell) — доступний локально. У CI використовується `pwsh` (PowerShell Core) — доступний на ubuntu-latest. + +### GitHub Actions release workflow + +`.github/workflows/release-extension.yml`: +- Тригер: `push` до `main` +- Runner: `ubuntu-latest` +- Кроки: checkout → setup-node → `npm ci` → build → zip через `pwsh` → `gh release create` +- Тег: `extension-build-${{ github.run_number }}` +- Asset: `extension/worktrace-extension.zip` +- `GITHUB_TOKEN` — вбудований, не потрібен додатковий secret + +--- + +## Рішення + +- **PowerShell Compress-Archive** — системний інструмент, нуль залежностей; локально `powershell`, у CI `pwsh` +- **Zip не комітимо** — `*.zip` вже в кореневому `.gitignore` +- **GitHub Releases через CI** — `gh release create` вбудованою CLI, тег на основі `run_number`; кожен merge до `main` = новий release з актуальним zip From fb80bbd9ff2b8b9b654369525bf7c522b09ff363 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Tue, 2 Jun 2026 20:09:59 +0300 Subject: [PATCH 22/24] feat(dashboard): Week 4 AC 4 - Framer Motion animations + scroll-reactive background (#22) * docs: add framer-motion animations plan * chore: install framer-motion * feat(anim): scroll-reactive timers bg, prism wave, Lenis smooth scroll, page transitions * feat(anim): AI report loading panel + modal spring entrance * feat(anim): event feed stagger entrance + card hover lift * feat(anim): nav indicator layoutId, mobile-nav spring, progress bars animate * feat(anim): toasts slide-in, music count-up stats, login stagger entrance * fix(anim): style report + music metadata as pill badges for readability * feat(anim): charts fade-in on data load via AnimatePresence --- dashboard/app/dashboard/charts.tsx | 17 +- dashboard/app/dashboard/event-card.tsx | 8 +- dashboard/app/dashboard/event-feed.tsx | 37 ++- dashboard/app/dashboard/header-nav.tsx | 14 +- dashboard/app/dashboard/layout.tsx | 9 +- dashboard/app/dashboard/mobile-nav.tsx | 78 +++-- .../app/dashboard/music/music-client.tsx | 57 +++- .../app/dashboard/reports/api-key-modal.tsx | 182 ++++++----- .../app/dashboard/reports/report-form.tsx | 59 +++- dashboard/app/dashboard/top-sessions.tsx | 7 +- dashboard/app/login/login-entrance.tsx | 34 ++ dashboard/app/login/page.tsx | 31 +- dashboard/app/providers.tsx | 9 +- dashboard/components/glitch-canvas.tsx | 80 +++++ dashboard/components/page-transition.tsx | 44 +++ dashboard/components/parallax-bg.tsx | 39 +++ dashboard/components/smooth-scroll.tsx | 14 + dashboard/components/timer-field.tsx | 152 +++++++++ dashboard/components/toast.tsx | 51 +-- dashboard/package-lock.json | 301 +++++++++++++++++- dashboard/package.json | 6 +- plans/week4/framer-motion-animations.md | 204 ++++++++++++ 22 files changed, 1223 insertions(+), 210 deletions(-) create mode 100644 dashboard/app/login/login-entrance.tsx create mode 100644 dashboard/components/glitch-canvas.tsx create mode 100644 dashboard/components/page-transition.tsx create mode 100644 dashboard/components/parallax-bg.tsx create mode 100644 dashboard/components/smooth-scroll.tsx create mode 100644 dashboard/components/timer-field.tsx create mode 100644 plans/week4/framer-motion-animations.md diff --git a/dashboard/app/dashboard/charts.tsx b/dashboard/app/dashboard/charts.tsx index ff91231..8f26b6e 100644 --- a/dashboard/app/dashboard/charts.tsx +++ b/dashboard/app/dashboard/charts.tsx @@ -19,6 +19,7 @@ import { } from "./feed-shared"; import { EventsByDayChart } from "./events-by-day-chart"; import { TopTagsChart } from "./top-tags-chart"; +import { AnimatePresence, motion } from "framer-motion"; ChartJS.register( CategoryScale, @@ -57,9 +58,17 @@ export function Charts({ filters }: { filters: FeedFilters }) { } return ( - <> - <EventsByDayChart byDay={data.byDay} /> - <TopTagsChart top={data.topTags} /> - </> + <AnimatePresence mode="wait"> + <motion.div + key="charts" + className="contents" + initial={{ opacity: 0 }} + animate={{ opacity: 1 }} + transition={{ duration: 0.35 }} + > + <EventsByDayChart byDay={data.byDay} /> + <TopTagsChart top={data.topTags} /> + </motion.div> + </AnimatePresence> ); } diff --git a/dashboard/app/dashboard/event-card.tsx b/dashboard/app/dashboard/event-card.tsx index 3002d16..d7908f2 100644 --- a/dashboard/app/dashboard/event-card.tsx +++ b/dashboard/app/dashboard/event-card.tsx @@ -2,6 +2,7 @@ import type { EventDTO } from "@/types/event"; import { useClientLocalized } from "./use-client-localized"; +import { motion } from "framer-motion"; function hostnameOf(url: string): string { try { @@ -30,7 +31,10 @@ export function EventCard({ event }: { event: EventDTO }) { const time = useClientLocalized(event.timestamp, utcShort, localShort); return ( - <article className="flex flex-col gap-2 rounded border border-border bg-surface p-3 transition-colors hover:border-purple/60"> + <motion.article + className="flex flex-col gap-2 rounded border border-border bg-surface p-3 transition-colors hover:border-purple/60" + whileHover={{ scale: 1.012, transition: { duration: 0.15 } }} + > <div className="flex items-baseline justify-between gap-3"> <a href={event.url} @@ -70,6 +74,6 @@ export function EventCard({ event }: { event: EventDTO }) { ))} </div> ) : null} - </article> + </motion.article> ); } diff --git a/dashboard/app/dashboard/event-feed.tsx b/dashboard/app/dashboard/event-feed.tsx index bc56865..6d9e576 100644 --- a/dashboard/app/dashboard/event-feed.tsx +++ b/dashboard/app/dashboard/event-feed.tsx @@ -2,6 +2,8 @@ import { useEffect, useMemo, useRef } from "react"; import { keepPreviousData, useInfiniteQuery } from "@tanstack/react-query"; +import { useLenis } from "lenis/react"; +import { motion } from "framer-motion"; import { EventCard } from "./event-card"; import { eventsQueryKey, @@ -39,6 +41,12 @@ export function EventFeed({ filters, onClearFilters }: Props) { ); const sentinelRef = useRef<HTMLDivElement | null>(null); + const lenis = useLenis(); + + // After each new batch loads, tell Lenis the page height changed + useEffect(() => { + lenis?.resize(); + }, [data?.pages.length, lenis]); useEffect(() => { const el = sentinelRef.current; @@ -60,15 +68,34 @@ export function EventFeed({ filters, onClearFilters }: Props) { if (isError) return <ErrorState onRetry={() => refetch()} />; if (events.length === 0) return <EmptyState onClear={onClearFilters} />; + const listVariants = { + visible: { transition: { staggerChildren: 0.05 } }, + }; + const itemVariants = { + hidden: { opacity: 0, y: 16 }, + visible: { opacity: 1, y: 0, transition: { duration: 0.3, ease: [0.25, 0.1, 0.25, 1] as const } }, + }; + return ( <> - <ul className="flex flex-col gap-3" aria-busy={isFetching}> - {events.map((event) => ( - <li key={event.id}> + <motion.ul + className="flex flex-col gap-3" + aria-busy={isFetching} + variants={listVariants} + initial="hidden" + animate="visible" + > + {events.map((event, idx) => ( + <motion.li + key={event.id} + variants={idx < 10 ? itemVariants : undefined} + initial={idx < 10 ? "hidden" : false} + animate="visible" + > <EventCard event={event} /> - </li> + </motion.li> ))} - </ul> + </motion.ul> {hasNextPage ? ( <div diff --git a/dashboard/app/dashboard/header-nav.tsx b/dashboard/app/dashboard/header-nav.tsx index 0fb05a0..aea349c 100644 --- a/dashboard/app/dashboard/header-nav.tsx +++ b/dashboard/app/dashboard/header-nav.tsx @@ -2,6 +2,7 @@ import Link from "next/link"; import { usePathname } from "next/navigation"; +import { motion } from "framer-motion"; const ITEMS: { href: string; label: string }[] = [ { href: "/dashboard", label: "FEED" }, @@ -21,11 +22,18 @@ export function HeaderNav() { key={item.href} href={item.href} className={ - "rounded px-2.5 py-1 transition-colors " + - (active ? "bg-cyan/10 text-cyan" : "text-muted hover:text-text") + "relative rounded px-2.5 py-1 transition-colors " + + (active ? "text-cyan" : "text-muted hover:text-text") } > - {item.label} + {active && ( + <motion.span + layoutId="nav-pill" + className="absolute inset-0 rounded bg-cyan/10" + transition={{ type: "spring", stiffness: 500, damping: 35 }} + /> + )} + <span className="relative z-10">{item.label}</span> </Link> ); })} diff --git a/dashboard/app/dashboard/layout.tsx b/dashboard/app/dashboard/layout.tsx index 9f9b61c..0416274 100644 --- a/dashboard/app/dashboard/layout.tsx +++ b/dashboard/app/dashboard/layout.tsx @@ -1,6 +1,8 @@ import { redirect } from "next/navigation"; import { getCurrentUser } from "@/server/current-user"; import { AppHeader } from "./app-header"; +import { ParallaxBg } from "@/components/parallax-bg"; +import { PageTransition } from "@/components/page-transition"; export default async function DashboardLayout({ children, @@ -9,9 +11,12 @@ export default async function DashboardLayout({ if (!user) redirect("/login"); return ( - <div className="flex min-h-full flex-1 flex-col bg-bg text-text"> + <div className="relative flex min-h-full flex-1 flex-col text-text"> + <ParallaxBg /> <AppHeader email={user.email} name={user.name} picture={user.picture} /> - <main className="flex-1">{children}</main> + <main className="relative z-1 flex-1"> + <PageTransition>{children}</PageTransition> + </main> </div> ); } diff --git a/dashboard/app/dashboard/mobile-nav.tsx b/dashboard/app/dashboard/mobile-nav.tsx index 3630f38..78703ad 100644 --- a/dashboard/app/dashboard/mobile-nav.tsx +++ b/dashboard/app/dashboard/mobile-nav.tsx @@ -3,6 +3,7 @@ import Link from "next/link"; import { usePathname } from "next/navigation"; import { useState } from "react"; +import { AnimatePresence, motion } from "framer-motion"; const ITEMS: { href: string; label: string }[] = [ { href: "/dashboard", label: "FEED" }, @@ -16,7 +17,7 @@ export function MobileNav() { return ( <> - {/* Burger button — mobile only */} + {/* Burger button */} <button type="button" onClick={() => setOpen((v) => !v)} @@ -39,39 +40,52 @@ export function MobileNav() { </button> {/* Backdrop */} - {open && ( - <div - className="fixed inset-0 z-40 sm:hidden" - onClick={() => setOpen(false)} - /> - )} + <AnimatePresence> + {open && ( + <motion.div + key="backdrop" + initial={{ opacity: 0 }} + animate={{ opacity: 1 }} + exit={{ opacity: 0 }} + transition={{ duration: 0.15 }} + className="fixed inset-0 z-40 sm:hidden" + onClick={() => setOpen(false)} + /> + )} + </AnimatePresence> {/* Slide-down panel */} - <div - className={ - "fixed inset-x-0 top-13 z-50 overflow-hidden border-b border-border bg-bg/95 backdrop-blur transition-all duration-200 sm:hidden " + - (open ? "max-h-40 opacity-100" : "max-h-0 opacity-0") - } - > - <nav className="mx-auto flex max-w-6xl flex-col px-6"> - {ITEMS.map((item) => { - const active = pathname === item.href; - return ( - <Link - key={item.href} - href={item.href} - onClick={() => setOpen(false)} - className={ - "border-b border-border/40 py-3.5 text-[10px] font-bold tracking-widest transition-colors last:border-0 " + - (active ? "text-cyan" : "text-muted hover:text-text") - } - > - {item.label} - </Link> - ); - })} - </nav> - </div> + <AnimatePresence> + {open && ( + <motion.div + key="panel" + initial={{ height: 0, opacity: 0 }} + animate={{ height: "auto", opacity: 1 }} + exit={{ height: 0, opacity: 0 }} + transition={{ duration: 0.22, ease: [0.25, 0.1, 0.25, 1] }} + className="fixed inset-x-0 top-13 z-50 overflow-hidden border-b border-border bg-bg/95 backdrop-blur sm:hidden" + > + <nav className="mx-auto flex max-w-6xl flex-col px-6"> + {ITEMS.map((item) => { + const active = pathname === item.href; + return ( + <Link + key={item.href} + href={item.href} + onClick={() => setOpen(false)} + className={ + "border-b border-border/40 py-3.5 text-[10px] font-bold tracking-widest transition-colors last:border-0 " + + (active ? "text-cyan" : "text-muted hover:text-text") + } + > + {item.label} + </Link> + ); + })} + </nav> + </motion.div> + )} + </AnimatePresence> </> ); } diff --git a/dashboard/app/dashboard/music/music-client.tsx b/dashboard/app/dashboard/music/music-client.tsx index d65c71f..292bcc7 100644 --- a/dashboard/app/dashboard/music/music-client.tsx +++ b/dashboard/app/dashboard/music/music-client.tsx @@ -1,6 +1,7 @@ "use client"; -import { useState } from "react"; +import { useEffect, useRef, useState } from "react"; +import { animate } from "framer-motion"; import { keepPreviousData, useQuery } from "@tanstack/react-query"; import type { MusicStats } from "@/types/music-stats"; import { TopArtistsChart } from "./top-artists-chart"; @@ -26,6 +27,22 @@ async function fetchMusicStats(range: Preset): Promise<MusicStats> { return res.json() as Promise<MusicStats>; } +function useCountUp(target: number): number { + const [display, setDisplay] = useState(0); + const prev = useRef(0); + useEffect(() => { + const from = prev.current; + prev.current = target; + const controls = animate(from, target, { + duration: 0.8, + ease: "easeOut", + onUpdate: (v) => setDisplay(Math.round(v)), + }); + return () => controls.stop(); + }, [target]); + return display; +} + function fmtListened(ms: number): string { const h = Math.floor(ms / 3600000); const m = Math.floor((ms % 3600000) / 60000); @@ -78,20 +95,12 @@ export function MusicClient() { {data ? ( <> - {/* Summary row */} - <div className="flex flex-wrap gap-4 text-[10px] tracking-widest text-muted"> - <span> - LISTENED: <span className="text-cyan">{fmtListened(data.totalListenedMs)}</span> - </span> - <span>·</span> - <span> - ARTISTS: <span className="text-cyan">{data.totalArtists}</span> - </span> - <span>·</span> - <span> - TRACKS: <span className="text-cyan">{data.totalTracks}</span> - </span> - </div> + {/* Summary row with count-up */} + <SummaryRow + listenedMs={data.totalListenedMs} + artists={data.totalArtists} + tracks={data.totalTracks} + /> {data.totalTracks === 0 ? ( <div className="rounded border border-border bg-surface px-4 py-10 text-center text-[10px] tracking-widest text-muted"> @@ -143,6 +152,24 @@ export function MusicClient() { ); } +function SummaryRow({ listenedMs, artists, tracks }: { listenedMs: number; artists: number; tracks: number }) { + const animArtists = useCountUp(artists); + const animTracks = useCountUp(tracks); + return ( + <div className="flex flex-wrap gap-2 text-[10px] tracking-widest"> + <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> + LISTENED <span className="ml-1 text-cyan">{fmtListened(listenedMs)}</span> + </span> + <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> + ARTISTS <span className="ml-1 text-cyan">{animArtists}</span> + </span> + <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> + TRACKS <span className="ml-1 text-cyan">{animTracks}</span> + </span> + </div> + ); +} + function SkeletonGrid() { return ( <div className="flex flex-col gap-4"> diff --git a/dashboard/app/dashboard/reports/api-key-modal.tsx b/dashboard/app/dashboard/reports/api-key-modal.tsx index 6527fed..e50be5d 100644 --- a/dashboard/app/dashboard/reports/api-key-modal.tsx +++ b/dashboard/app/dashboard/reports/api-key-modal.tsx @@ -2,16 +2,18 @@ import { useEffect, useState } from "react"; import { createPortal } from "react-dom"; +import { AnimatePresence, motion } from "framer-motion"; import type { UserSettingsView } from "@/server/user-settings"; import { saveApiKey } from "./reports-client"; type Props = { + open: boolean; status: UserSettingsView; onClose: () => void; onSaved: (next: UserSettingsView) => void; }; -export function ApiKeyModal({ status, onClose, onSaved }: Props) { +export function ApiKeyModal({ open, status, onClose, onSaved }: Props) { const [value, setValue] = useState(""); const [busy, setBusy] = useState(false); const [error, setError] = useState<string | null>(null); @@ -37,89 +39,113 @@ export function ApiKeyModal({ status, onClose, onSaved }: Props) { } return createPortal( - <div - role="dialog" - aria-modal="true" - aria-labelledby="api-key-modal-title" - className="fixed inset-0 z-50 flex items-center justify-center bg-bg/80 px-4 backdrop-blur" - onMouseDown={(e) => { if (e.target === e.currentTarget) onClose(); }} - > - <div className="w-full max-w-md rounded border border-border bg-surface p-6 shadow-xl"> - <div className="mb-4 flex items-baseline justify-between"> - <h2 - id="api-key-modal-title" - className="text-sm font-bold tracking-widest text-cyan" - > - GROQ API KEY - </h2> - <button - type="button" - onClick={onClose} - className="cursor-pointer text-muted transition-colors hover:text-pink" - aria-label="Close" + <AnimatePresence> + {open && ( + <> + {/* Backdrop */} + <motion.div + key="backdrop" + initial={{ opacity: 0 }} + animate={{ opacity: 1 }} + exit={{ opacity: 0 }} + transition={{ duration: 0.2 }} + className="fixed inset-0 z-50 bg-bg/80 backdrop-blur" + onMouseDown={onClose} + aria-hidden + /> + + {/* Panel */} + <motion.div + key="panel" + role="dialog" + aria-modal="true" + aria-labelledby="api-key-modal-title" + initial={{ opacity: 0, scale: 0.92, y: 16 }} + animate={{ opacity: 1, scale: 1, y: 0 }} + exit={{ opacity: 0, scale: 0.95, y: 8 }} + transition={{ type: "spring", stiffness: 400, damping: 28, mass: 0.8 }} + className="fixed inset-0 z-50 flex items-center justify-center px-4" + onMouseDown={(e) => e.stopPropagation()} > - ✕ - </button> - </div> + <div className="w-full max-w-md rounded border border-border bg-surface p-6 shadow-xl"> + <div className="mb-4 flex items-baseline justify-between"> + <h2 + id="api-key-modal-title" + className="text-sm font-bold tracking-widest text-cyan" + > + GROQ API KEY + </h2> + <button + type="button" + onClick={onClose} + className="cursor-pointer text-muted transition-colors hover:text-pink" + aria-label="Close" + > + ✕ + </button> + </div> - <p className="mb-4 text-xs text-muted"> - {status.hasGroqApiKey - ? <>Currently using your own key (••••{status.last4 ?? "????"}). To change, enter a new key below.</> - : <>Currently using the shared default key. Paste your own Groq API key to override.</> - } - </p> + <p className="mb-4 text-xs text-muted"> + {status.hasGroqApiKey + ? <>Currently using your own key (••••{status.last4 ?? "????"}). To change, enter a new key below.</> + : <>Currently using the shared default key. Paste your own Groq API key to override.</> + } + </p> - <label className="mb-1 block text-[10px] font-bold tracking-widest text-muted"> - NEW KEY - </label> - <input - type="password" - value={value} - onChange={(e) => setValue(e.target.value)} - placeholder="gsk_…" - disabled={busy} - autoComplete="off" - className="mb-2 w-full rounded border border-border bg-bg px-2 py-1.5 text-xs text-text outline-none transition-colors focus:border-purple disabled:opacity-50" - /> + <label className="mb-1 block text-[10px] font-bold tracking-widest text-muted"> + NEW KEY + </label> + <input + type="password" + value={value} + onChange={(e) => setValue(e.target.value)} + placeholder="gsk_…" + disabled={busy} + autoComplete="off" + className="mb-2 w-full rounded border border-border bg-bg px-2 py-1.5 text-xs text-text outline-none transition-colors focus:border-purple disabled:opacity-50" + /> - {error ? ( - <p className="mb-2 text-[11px] text-pink">{error}</p> - ) : null} + {error ? ( + <p className="mb-2 text-[11px] text-pink">{error}</p> + ) : null} - <p className="mb-4 text-[10px] text-muted"> - Stored encrypted (AES-256-GCM) and never returned to the browser. - </p> + <p className="mb-4 text-[10px] text-muted"> + Stored encrypted (AES-256-GCM) and never returned to the browser. + </p> - <div className="flex flex-wrap items-center justify-end gap-2"> - {status.hasGroqApiKey ? ( - <button - type="button" - onClick={() => commit(null)} - disabled={busy} - className="cursor-pointer rounded border border-pink/60 px-3 py-1.5 text-[10px] font-bold tracking-widest text-pink transition-colors hover:bg-pink/10 disabled:opacity-50" - > - CLEAR KEY - </button> - ) : null} - <button - type="button" - onClick={onClose} - disabled={busy} - className="cursor-pointer rounded border border-muted px-3 py-1.5 text-[10px] font-bold tracking-widest text-muted transition-colors hover:text-text disabled:opacity-50" - > - CANCEL - </button> - <button - type="button" - onClick={() => commit(value)} - disabled={busy || value.trim().length < 8} - className="cursor-pointer rounded border border-cyan bg-cyan/10 px-3 py-1.5 text-[10px] font-bold tracking-widest text-cyan transition-colors hover:bg-cyan/20 disabled:cursor-not-allowed disabled:opacity-50" - > - {busy ? "SAVING…" : "SAVE"} - </button> - </div> - </div> - </div>, + <div className="flex flex-wrap items-center justify-end gap-2"> + {status.hasGroqApiKey ? ( + <button + type="button" + onClick={() => commit(null)} + disabled={busy} + className="cursor-pointer rounded border border-pink/60 px-3 py-1.5 text-[10px] font-bold tracking-widest text-pink transition-colors hover:bg-pink/10 disabled:opacity-50" + > + CLEAR KEY + </button> + ) : null} + <button + type="button" + onClick={onClose} + disabled={busy} + className="cursor-pointer rounded border border-muted px-3 py-1.5 text-[10px] font-bold tracking-widest text-muted transition-colors hover:text-text disabled:opacity-50" + > + CANCEL + </button> + <button + type="button" + onClick={() => commit(value)} + disabled={busy || value.trim().length < 8} + className="cursor-pointer rounded border border-cyan bg-cyan/10 px-3 py-1.5 text-[10px] font-bold tracking-widest text-cyan transition-colors hover:bg-cyan/20 disabled:cursor-not-allowed disabled:opacity-50" + > + {busy ? "SAVING…" : "SAVE"} + </button> + </div> + </div> + </motion.div> + </> + )} + </AnimatePresence>, document.body, ); } diff --git a/dashboard/app/dashboard/reports/report-form.tsx b/dashboard/app/dashboard/reports/report-form.tsx index 81036c9..945f269 100644 --- a/dashboard/app/dashboard/reports/report-form.tsx +++ b/dashboard/app/dashboard/reports/report-form.tsx @@ -1,6 +1,7 @@ "use client"; import { useEffect, useState } from "react"; +import { motion } from "framer-motion"; import type { GenerateReportResponse, RangePreset } from "@/types/report"; import type { UserSettingsView } from "@/server/user-settings"; import { @@ -189,8 +190,9 @@ export function ReportForm() { {status.kind === "error" ? <ErrorPanel message={status.message} onRetry={handleGenerate} /> : null} {status.kind === "success" ? <ResultPanel result={status.result} /> : null} - {modalOpen && apiKey ? ( + {apiKey ? ( <ApiKeyModal + open={modalOpen} status={apiKey} onClose={() => setModalOpen(false)} onSaved={(next) => setApiKey(next)} @@ -216,10 +218,36 @@ function CustomField({ label, children }: { label: string; children: React.React function LoadingPanel() { return ( - <div className="overflow-hidden rounded border border-border bg-surface"> - <div className="h-1 animate-pulse bg-cyan" /> - <div className="p-6 text-center text-xs text-muted"> - Asking the model… this typically takes 10–30 seconds. + <div className="overflow-hidden rounded border border-cyan/20 bg-surface"> + {/* Layer A — scanning bar */} + <div className="relative h-0.5 overflow-hidden bg-border"> + <motion.div + className="absolute inset-y-0 w-1/3 bg-linear-to-r from-transparent via-cyan to-transparent" + animate={{ x: ["-100%", "400%"] }} + transition={{ duration: 1.6, repeat: Infinity, ease: "linear" }} + /> + </div> + + <div className="flex flex-col items-center gap-4 p-8"> + {/* Layer B — dot wave */} + <div className="flex gap-1.5"> + {[0, 1, 2].map((i) => ( + <motion.span + key={i} + className="block h-1.5 w-1.5 rounded-full bg-cyan" + animate={{ opacity: [0.3, 1, 0.3], y: [0, -5, 0] }} + transition={{ duration: 0.9, repeat: Infinity, delay: i * 0.18, ease: "easeInOut" }} + /> + ))} + </div> + + {/* Layer C — text */} + <div className="flex flex-col items-center gap-1 text-center"> + <span className="text-[10px] font-bold tracking-[0.2em] text-cyan/80"> + ASKING THE MODEL + </span> + <span className="text-[10px] text-muted">typically 10–30 seconds</span> + </div> </div> </div> ); @@ -243,14 +271,19 @@ function ErrorPanel({ message, onRetry }: { message: string; onRetry: () => void function ResultPanel({ result }: { result: GenerateReportResponse }) { return ( <div className="flex flex-col gap-3"> - <div className="flex flex-wrap items-center gap-3 text-[10px] tracking-widest text-muted"> - <span>RANGE: <span className="text-cyan">{result.range.label.toUpperCase()}</span></span> - <span>·</span> - <span>DETAIL LEVEL: <span className="text-cyan">{result.contextLevel}</span></span> - <span>·</span> - <span>~{result.estimatedInputTokens.toLocaleString()} INPUT TOKENS</span> - <span>·</span> - <span>MODEL: <span className="text-purple">{result.model}</span></span> + <div className="flex flex-wrap gap-2 text-[10px] tracking-widest"> + <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> + RANGE <span className="ml-1 text-cyan">{result.range.label.toUpperCase()}</span> + </span> + <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> + DETAIL <span className="ml-1 text-cyan">{result.contextLevel}</span> + </span> + <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> + ~{result.estimatedInputTokens.toLocaleString()} TOKENS + </span> + <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> + MODEL <span className="ml-1 text-purple">{result.model}</span> + </span> </div> <MarkdownView markdown={result.markdown} /> </div> diff --git a/dashboard/app/dashboard/top-sessions.tsx b/dashboard/app/dashboard/top-sessions.tsx index bc1f30f..a323400 100644 --- a/dashboard/app/dashboard/top-sessions.tsx +++ b/dashboard/app/dashboard/top-sessions.tsx @@ -1,6 +1,7 @@ "use client"; import { useQuery } from "@tanstack/react-query"; +import { motion } from "framer-motion"; import type { TopSession } from "@/types/event"; import { fetchTopSessions, topSessionsQueryKey } from "./feed-shared"; import { useClientLocalized } from "./use-client-localized"; @@ -104,9 +105,11 @@ function SessionRow({ session }: { session: TopSession }) { </span> </div> <div className="ml-3 h-1 overflow-hidden rounded-sm bg-border"> - <div + <motion.div className="h-full bg-purple" - style={{ width: `${(ratio * 100).toFixed(1)}%` }} + initial={{ width: 0 }} + animate={{ width: `${(ratio * 100).toFixed(1)}%` }} + transition={{ duration: 0.8, delay: 0.2, ease: "easeOut" }} /> </div> </> diff --git a/dashboard/app/login/login-entrance.tsx b/dashboard/app/login/login-entrance.tsx new file mode 100644 index 0000000..42d0cee --- /dev/null +++ b/dashboard/app/login/login-entrance.tsx @@ -0,0 +1,34 @@ +"use client"; + +import { motion } from "framer-motion"; + +const container = { + hidden: {}, + show: { transition: { staggerChildren: 0.12 } }, +}; + +const item = { + hidden: { opacity: 0, y: 20, scale: 0.96 }, + show: { opacity: 1, y: 0, scale: 1, transition: { duration: 0.4, ease: [0.25, 0.1, 0.25, 1] as const } }, +}; + +export function LoginEntrance({ children }: { children: React.ReactNode }) { + return ( + <motion.div + variants={container} + initial="hidden" + animate="show" + className="flex w-full max-w-sm flex-col items-center gap-8 rounded-md border border-border bg-surface p-10" + > + {children} + </motion.div> + ); +} + +export function LoginItem({ children }: { children: React.ReactNode }) { + return ( + <motion.div variants={item} className="flex flex-col items-center gap-3 text-center"> + {children} + </motion.div> + ); +} diff --git a/dashboard/app/login/page.tsx b/dashboard/app/login/page.tsx index 771a88e..cb4173a 100644 --- a/dashboard/app/login/page.tsx +++ b/dashboard/app/login/page.tsx @@ -1,6 +1,7 @@ import type { Metadata } from "next"; import Script from "next/script"; import { GoogleLoginButton } from "./google-button"; +import { LoginEntrance, LoginItem } from "./login-entrance"; export const metadata: Metadata = { title: "Sign in", @@ -13,8 +14,8 @@ export default function LoginPage() { return ( <main className="flex flex-1 items-center justify-center bg-bg"> - <div className="flex w-full max-w-sm flex-col items-center gap-8 rounded-md border border-border bg-surface p-10"> - <div className="flex flex-col items-center gap-3 text-center"> + <LoginEntrance> + <LoginItem> <div className="flex items-center gap-2"> <span className="text-2xl text-cyan" @@ -32,19 +33,21 @@ export default function LoginPage() { <p className="text-xs text-muted"> Sign in with the same Google account you use in the extension. </p> - </div> + </LoginItem> - {clientId ? ( - <> - <Script src="https://accounts.google.com/gsi/client?hl=en" strategy="afterInteractive" /> - <GoogleLoginButton clientId={clientId} /> - </> - ) : ( - <p className="text-xs text-pink"> - NEXT_PUBLIC_GOOGLE_CLIENT_ID is not configured. - </p> - )} - </div> + <LoginItem> + {clientId ? ( + <> + <Script src="https://accounts.google.com/gsi/client?hl=en" strategy="afterInteractive" /> + <GoogleLoginButton clientId={clientId} /> + </> + ) : ( + <p className="text-xs text-pink"> + NEXT_PUBLIC_GOOGLE_CLIENT_ID is not configured. + </p> + )} + </LoginItem> + </LoginEntrance> </main> ); } diff --git a/dashboard/app/providers.tsx b/dashboard/app/providers.tsx index 9d965e3..b2893db 100644 --- a/dashboard/app/providers.tsx +++ b/dashboard/app/providers.tsx @@ -3,6 +3,7 @@ import { useEffect, useState } from "react"; import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; import { ToastProvider, useToast } from "@/components/toast"; +import { SmoothScroll } from "@/components/smooth-scroll"; function QueryProviderInner({ children }: { children: React.ReactNode }) { const toast = useToast(); @@ -33,8 +34,10 @@ function QueryProviderInner({ children }: { children: React.ReactNode }) { export function Providers({ children }: { children: React.ReactNode }) { return ( - <ToastProvider> - <QueryProviderInner>{children}</QueryProviderInner> - </ToastProvider> + <SmoothScroll> + <ToastProvider> + <QueryProviderInner>{children}</QueryProviderInner> + </ToastProvider> + </SmoothScroll> ); } diff --git a/dashboard/components/glitch-canvas.tsx b/dashboard/components/glitch-canvas.tsx new file mode 100644 index 0000000..70a3f1f --- /dev/null +++ b/dashboard/components/glitch-canvas.tsx @@ -0,0 +1,80 @@ +"use client"; + +import { useRef } from "react"; +import { Canvas, useFrame } from "@react-three/fiber"; + +const vert = /* glsl */ ` + varying vec2 vUv; + void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); } +`; + +const frag = /* glsl */ ` + uniform float uTime; + uniform float uWave; + varying vec2 vUv; + + vec3 sampleBg(vec2 uv) { + vec3 bg = vec3(0.004, 0.004, 0.005); + float d1 = length(uv - vec2(0.08, 0.88)); + float d2 = length(uv - vec2(0.92, 0.62)); + float d3 = length(uv - vec2(0.50, 0.02)); + vec3 c = bg + + mix(vec3(0.12), vec3(0.0, 0.898, 0.690), 0.28) * smoothstep(0.55, 0.0, d1) * 0.07 + + mix(vec3(0.10), vec3(0.486, 0.227, 1.0), 0.24) * smoothstep(0.50, 0.0, d2) * 0.06 + + mix(vec3(0.08), vec3(1.0, 0.0, 0.439), 0.20) * smoothstep(0.45, 0.0, d3) * 0.04; + float v = length((uv - 0.5) * 2.0); + return c * (1.0 - smoothstep(0.25, 1.0, v) * 0.78); + } + + void main() { + float w1 = sin(vUv.y * 9.0 + uTime * 1.6) * 0.022; + float w2 = sin(vUv.y * 5.5 - uTime * 1.1) * 0.014; + float w3 = sin(vUv.x * 7.0 + uTime * 2.0) * 0.011; + vec2 wd = vec2(w1 + w2, w3); + float d = uWave * 0.042; + vec3 r = sampleBg(vUv + wd * d); + vec3 g = sampleBg(vUv); + vec3 b = sampleBg(vUv - wd * d); + gl_FragColor = vec4(r.r, g.g, b.b, 1.0); + } +`; + +// Module-level: lives outside React, freely mutable by useFrame each tick. +// The ESLint react-hooks/immutability rule only guards hook-returned values. +const bgUniforms = { uTime: { value: 0 }, uWave: { value: 0 } }; + +function Background({ intensityRef }: { intensityRef: React.MutableRefObject<number> }) { + const timeRef = useRef(0); + const waveRef = useRef(0); + + useFrame((_, delta) => { + const t = intensityRef.current; + waveRef.current += (t - waveRef.current) * (t > waveRef.current ? 0.07 : 0.045); + timeRef.current += delta; + bgUniforms.uTime.value = timeRef.current; + bgUniforms.uWave.value = waveRef.current; + }); + + return ( + <mesh scale={[20, 20, 1]}> + <planeGeometry args={[1, 1]} /> + <shaderMaterial vertexShader={vert} fragmentShader={frag} uniforms={bgUniforms} /> + </mesh> + ); +} + +type Props = { intensityRef: React.MutableRefObject<number> }; + +export default function GlitchCanvas({ intensityRef }: Props) { + return ( + <Canvas + frameloop="always" + dpr={1} + gl={{ antialias: false, alpha: false, depth: false, stencil: false, powerPreference: "low-power" }} + camera={{ position: [0, 0, 3.5], fov: 60 }} + style={{ width: "100%", height: "100%" }} + > + <Background intensityRef={intensityRef} /> + </Canvas> + ); +} diff --git a/dashboard/components/page-transition.tsx b/dashboard/components/page-transition.tsx new file mode 100644 index 0000000..a2cf53a --- /dev/null +++ b/dashboard/components/page-transition.tsx @@ -0,0 +1,44 @@ +"use client"; + +import { AnimatePresence, motion, useReducedMotion } from "framer-motion"; +import { usePathname } from "next/navigation"; +import { useState } from "react"; + +const NAV_ORDER: Record<string, number> = { + "/dashboard": 0, + "/dashboard/reports": 1, + "/dashboard/music": 2, +}; + +export function PageTransition({ children }: { children: React.ReactNode }) { + const pathname = usePathname(); + const reduced = useReducedMotion(); + + // getDerivedStateFromProps pattern: call setState during render (not in an effect). + // React re-runs the render synchronously with updated state, so the entering + // motion.div always mounts with the correct direction in its `initial` prop. + const [nav, setNav] = useState({ prevPath: pathname, dir: 0 }); + + if (nav.prevPath !== pathname) { + const prev = NAV_ORDER[nav.prevPath] ?? 0; + const curr = NAV_ORDER[pathname] ?? 0; + setNav({ prevPath: pathname, dir: curr >= prev ? 1 : -1 }); + } + + const dir = nav.dir; + + return ( + <AnimatePresence mode="wait" initial={false}> + <motion.div + key={pathname} + initial={reduced ? false : { opacity: 0, x: dir * 36, scale: 0.97 }} + animate={{ opacity: 1, x: 0, scale: 1 }} + exit={reduced ? {} : { opacity: 0, x: dir * -36, scale: 0.97 }} + transition={{ duration: 0.28, ease: [0.25, 0.1, 0.25, 1] }} + className="flex-1" + > + {children} + </motion.div> + </AnimatePresence> + ); +} diff --git a/dashboard/components/parallax-bg.tsx b/dashboard/components/parallax-bg.tsx new file mode 100644 index 0000000..930acb7 --- /dev/null +++ b/dashboard/components/parallax-bg.tsx @@ -0,0 +1,39 @@ +"use client"; + +import dynamic from "next/dynamic"; +import { useRef } from "react"; +import { useMotionValueEvent, useReducedMotion, useScroll, useVelocity } from "framer-motion"; +import { TimerField } from "./timer-field"; + +const GlitchCanvas = dynamic(() => import("./glitch-canvas"), { ssr: false }); + +const VELOCITY_THRESHOLD = 80; + +export function ParallaxBg() { + const { scrollY } = useScroll(); + const velocity = useVelocity(scrollY); + const reduced = useReducedMotion(); + const intensityRef = useRef(0); + + useMotionValueEvent(velocity, "change", (v) => { + if (reduced) return; + const speed = Math.abs(v); + intensityRef.current = speed > VELOCITY_THRESHOLD + ? Math.min((speed - VELOCITY_THRESHOLD) / 520, 1) + : 0; + }); + + if (reduced) return null; + + return ( + <> + {/* Three.js: dark base + prism wave on scroll */} + <div className="pointer-events-none fixed inset-0 z-0" aria-hidden> + <GlitchCanvas intensityRef={intensityRef} /> + </div> + + {/* 2D canvas: timer field — green idle, red + downward on scroll */} + <TimerField /> + </> + ); +} diff --git a/dashboard/components/smooth-scroll.tsx b/dashboard/components/smooth-scroll.tsx new file mode 100644 index 0000000..e31a492 --- /dev/null +++ b/dashboard/components/smooth-scroll.tsx @@ -0,0 +1,14 @@ +"use client"; + +import { ReactLenis } from "lenis/react"; +import type { LenisOptions } from "lenis"; + +const OPTIONS: LenisOptions = { + duration: 1.4, // inertia length in seconds + easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)), // expo ease-out + smoothWheel: true, +}; + +export function SmoothScroll({ children }: { children: React.ReactNode }) { + return <ReactLenis root options={OPTIONS}>{children}</ReactLenis>; +} diff --git a/dashboard/components/timer-field.tsx b/dashboard/components/timer-field.tsx new file mode 100644 index 0000000..dffefa4 --- /dev/null +++ b/dashboard/components/timer-field.tsx @@ -0,0 +1,152 @@ +"use client"; + +import { useEffect, useRef } from "react"; +import { useMotionValueEvent, useReducedMotion, useScroll, useVelocity } from "framer-motion"; + +// ─── Config ─────────────────────────────────────────────────────────────────── + +const COUNT = 85; +const BASE_FONT = 11; // px — sizes range 0.6× – 1.5× +const SCROLL_THRESHOLD = 80; // px/s before effects kick in +const REVERSE_SPEED = 45; // ms subtracted per real-ms when scrolling fast + +// ─── Helpers ────────────────────────────────────────────────────────────────── + +function fmt(ms: number): string { + const total = Math.max(0, Math.floor(Math.abs(ms))); + const h = Math.floor(total / 3_600_000); + const m = Math.floor((total % 3_600_000) / 60_000); + const s = Math.floor((total % 60_000) / 1_000); + const cs = Math.floor((total % 1_000) / 10); + return h > 0 + ? `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}` + : `${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}.${String(cs).padStart(2, "0")}`; +} + +interface T { + x: number; // px + y: number; // px (drifts with scroll) + size: number; // font scale 0.6–1.5 + ms: number; // current timer value in ms + driftX: number; // gentle horizontal drift + driftY: number; // gentle vertical drift (natural) +} + +// ─── Component ──────────────────────────────────────────────────────────────── + +export function TimerField() { + const canvasRef = useRef<HTMLCanvasElement>(null); + const timersRef = useRef<T[]>([]); + const velRef = useRef(0); + const rafRef = useRef(0); + const reduced = useReducedMotion(); + + const { scrollY } = useScroll(); + const velocity = useVelocity(scrollY); + + useMotionValueEvent(velocity, "change", (v) => { velRef.current = v; }); + + // Init timers after canvas mounts so we have window dimensions + useEffect(() => { + const W = window.innerWidth; + const H = window.innerHeight; + timersRef.current = Array.from({ length: COUNT }, () => ({ + x: Math.random() * W, + y: Math.random() * H, + size: 0.6 + Math.random() * 0.9, + ms: Math.random() * 5_400_000, // 0–90 min spread + driftX: (Math.random() - 0.5) * 0.05, + driftY: (Math.random() - 0.5) * 0.06, + })); + }, []); + + useEffect(() => { + if (reduced) return; + const canvas = canvasRef.current; + if (!canvas) return; + const ctx = canvas.getContext("2d")!; + let last = performance.now(); + + const c = canvas; // stable reference for closures + + function resize() { + c.width = window.innerWidth; + c.height = window.innerHeight; + } + resize(); + window.addEventListener("resize", resize); + + function draw(now: number) { + const dt = Math.min(now - last, 50); + last = now; + + const speed = Math.abs(velRef.current); + const intensity = Math.max(0, Math.min((speed - SCROLL_THRESHOLD) / 520, 1)); + const scrolling = speed > SCROLL_THRESHOLD; + + ctx.clearRect(0, 0, c.width, c.height); + + for (const t of timersRef.current) { + // ── Time value ────────────────────────────────────────────────────── + if (scrolling) { + t.ms -= dt * (1 + intensity * REVERSE_SPEED); // reverse + accelerate + if (t.ms < 0) t.ms = 5_400_000; + } else { + t.ms += dt; // normal forward tick + if (t.ms > 5_400_000) t.ms = 0; + } + + // ── Position ──────────────────────────────────────────────────────── + t.x += t.driftX; + // natural drift + downward parallax proportional to depth (size) + t.y += t.driftY + intensity * t.size * 2.2; + + // wrap + if (t.x < -80) t.x = c.width + 60; + if (t.x > c.width + 80) t.x = -60; + if (t.y < -20) t.y = c.height + 10; + if (t.y > c.height + 20) t.y = -10; + + // ── Style ─────────────────────────────────────────────────────────── + const fontSize = Math.round(BASE_FONT * t.size); + + if (scrolling) { + // Aggressive red — brighter/stronger with intensity + const g = Math.round((1 - intensity) * 40); + const a = 0.45 + intensity * 0.50; + ctx.fillStyle = `rgba(255, ${g}, 30, ${a})`; + ctx.shadowColor = `rgba(255, 0, 70, ${intensity * 0.9})`; + ctx.shadowBlur = 4 + intensity * 12; + } else { + // Default green — dim, subtle + const a = 0.15 + t.size * 0.10; + ctx.fillStyle = `rgba(0, 229, 176, ${a})`; + ctx.shadowColor = "rgba(0, 229, 176, 0.25)"; + ctx.shadowBlur = 2; + } + + ctx.font = `${fontSize}px "Courier New", monospace`; + ctx.fillText(fmt(t.ms), t.x, t.y); + } + + ctx.shadowBlur = 0; + rafRef.current = requestAnimationFrame(draw); + } + + rafRef.current = requestAnimationFrame(draw); + return () => { + cancelAnimationFrame(rafRef.current); + window.removeEventListener("resize", resize); + }; + }, [reduced]); + + if (reduced) return null; + + return ( + <canvas + ref={canvasRef} + className="pointer-events-none fixed inset-0 z-0" + aria-hidden + /> + ); +} diff --git a/dashboard/components/toast.tsx b/dashboard/components/toast.tsx index 44dcf6b..3874b3d 100644 --- a/dashboard/components/toast.tsx +++ b/dashboard/components/toast.tsx @@ -7,6 +7,7 @@ import { useRef, useState, } from "react"; +import { AnimatePresence, motion } from "framer-motion"; // ─── Types ──────────────────────────────────────────────────────────────────── @@ -80,36 +81,40 @@ function ToastStack({ toasts: ToastItem[]; onDismiss: (id: number) => void; }) { - if (toasts.length === 0) return null; - return ( <div aria-live="polite" aria-label="Notifications" className="pointer-events-none fixed bottom-4 right-4 z-50 flex flex-col gap-2" > - {toasts.map((t) => ( - <div - key={t.id} - role="alert" - className={ - "pointer-events-auto flex items-start gap-3 rounded border px-4 py-3 text-xs shadow-lg " + - (t.variant === "error" - ? "border-pink/40 bg-surface text-pink" - : "border-cyan/40 bg-surface text-cyan") - } - > - <span className="flex-1">{t.message}</span> - <button - type="button" - onClick={() => onDismiss(t.id)} - className="mt-0.5 shrink-0 cursor-pointer opacity-60 hover:opacity-100" - aria-label="Dismiss" + <AnimatePresence mode="popLayout"> + {toasts.map((t) => ( + <motion.div + key={t.id} + role="alert" + initial={{ opacity: 0, x: 120, scale: 0.95 }} + animate={{ opacity: 1, x: 0, scale: 1 }} + exit={{ opacity: 0, x: 120, scale: 0.95 }} + transition={{ type: "spring", stiffness: 400, damping: 30 }} + className={ + "pointer-events-auto flex items-start gap-3 rounded border px-4 py-3 text-xs shadow-lg " + + (t.variant === "error" + ? "border-pink/40 bg-surface text-pink" + : "border-cyan/40 bg-surface text-cyan") + } > - ✕ - </button> - </div> - ))} + <span className="flex-1">{t.message}</span> + <button + type="button" + onClick={() => onDismiss(t.id)} + className="mt-0.5 shrink-0 cursor-pointer opacity-60 hover:opacity-100" + aria-label="Dismiss" + > + ✕ + </button> + </motion.div> + ))} + </AnimatePresence> </div> ); } diff --git a/dashboard/package-lock.json b/dashboard/package-lock.json index 7907e85..99b417a 100644 --- a/dashboard/package-lock.json +++ b/dashboard/package-lock.json @@ -10,12 +10,15 @@ "dependencies": { "@prisma/adapter-pg": "^7.8.0", "@prisma/client": "^7.8.0", + "@react-three/fiber": "^9.6.1", "@tanstack/react-query": "^5.100.10", + "@types/three": "^0.184.1", "chart.js": "^4.5.1", "d3": "^7.9.0", - "framer-motion": "^12.38.0", + "framer-motion": "^12.40.0", "google-auth-library": "^10.6.2", "jose": "^6.2.3", + "lenis": "^1.3.23", "next": "16.2.6", "pg": "^8.20.0", "prisma": "^7.8.0", @@ -24,6 +27,7 @@ "react-dom": "19.2.4", "react-markdown": "^10.1.0", "remark-gfm": "^4.0.1", + "three": "^0.184.0", "zod": "^4.4.3" }, "devDependencies": { @@ -245,6 +249,15 @@ "node": ">=6.0.0" } }, + "node_modules/@babel/runtime": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.7.tgz", + "integrity": "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, "node_modules/@babel/template": { "version": "7.28.6", "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz", @@ -293,6 +306,12 @@ "node": ">=6.9.0" } }, + "node_modules/@dimforge/rapier3d-compat": { + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/@dimforge/rapier3d-compat/-/rapier3d-compat-0.12.0.tgz", + "integrity": "sha512-uekIGetywIgopfD97oDL5PfeezkFpNhwlzlaEYNOA0N6ghdsOvh/HYjSMek5Q2O1PYvRSDFcqFVJl4r4ZBwOow==", + "license": "Apache-2.0" + }, "node_modules/@electric-sql/pglite": { "version": "0.4.1", "resolved": "https://registry.npmjs.org/@electric-sql/pglite/-/pglite-0.4.1.tgz", @@ -1769,6 +1788,54 @@ } } }, + "node_modules/@react-three/fiber": { + "version": "9.6.1", + "resolved": "https://registry.npmjs.org/@react-three/fiber/-/fiber-9.6.1.tgz", + "integrity": "sha512-zF0rsKcVYpcJwbFEnv2HkHX9cvOEgsfQo/X8lwmR2dn13S4qEQJXir9fxf5js2LQFoXqxOY7MDkOkYx2uZ4gSg==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.17.8", + "@types/webxr": "*", + "base64-js": "^1.5.1", + "buffer": "^6.0.3", + "its-fine": "^2.0.0", + "react-use-measure": "^2.1.7", + "scheduler": "^0.27.0", + "suspend-react": "^0.1.3", + "use-sync-external-store": "^1.4.0", + "zustand": "^5.0.3" + }, + "peerDependencies": { + "expo": ">=43.0", + "expo-asset": ">=8.4", + "expo-file-system": ">=11.0", + "expo-gl": ">=11.0", + "react": ">=19 <19.3", + "react-dom": ">=19 <19.3", + "react-native": ">=0.78", + "three": ">=0.156" + }, + "peerDependenciesMeta": { + "expo": { + "optional": true + }, + "expo-asset": { + "optional": true + }, + "expo-file-system": { + "optional": true + }, + "expo-gl": { + "optional": true + }, + "react-dom": { + "optional": true + }, + "react-native": { + "optional": true + } + } + }, "node_modules/@rtsao/scc": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/@rtsao/scc/-/scc-1.1.0.tgz", @@ -2095,6 +2162,12 @@ "react": "^18 || ^19" } }, + "node_modules/@tweenjs/tween.js": { + "version": "23.1.3", + "resolved": "https://registry.npmjs.org/@tweenjs/tween.js/-/tween.js-23.1.3.tgz", + "integrity": "sha512-vJmvvwFxYuGnF2axRtPYocag6Clbb5YS7kLL+SO/TeVFzHqDIWrNKYtcsPMibjDx9O+bu+psAy9NKfWklassUA==", + "license": "MIT" + }, "node_modules/@tybys/wasm-util": { "version": "0.10.2", "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.2.tgz", @@ -2575,6 +2648,15 @@ "@types/react": "^19.2.0" } }, + "node_modules/@types/react-reconciler": { + "version": "0.28.9", + "resolved": "https://registry.npmjs.org/@types/react-reconciler/-/react-reconciler-0.28.9.tgz", + "integrity": "sha512-HHM3nxyUZ3zAylX8ZEyrDNd2XZOnQ0D5XfunJF5FLQnZbHHYq4UWvW1QfelQNXv1ICNkwYhfxjwfnqivYB6bFg==", + "license": "MIT", + "peerDependencies": { + "@types/react": "*" + } + }, "node_modules/@types/send": { "version": "1.2.1", "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.1.tgz", @@ -2596,12 +2678,38 @@ "@types/node": "*" } }, + "node_modules/@types/stats.js": { + "version": "0.17.4", + "resolved": "https://registry.npmjs.org/@types/stats.js/-/stats.js-0.17.4.tgz", + "integrity": "sha512-jIBvWWShCvlBqBNIZt0KAshWpvSjhkwkEu4ZUcASoAvhmrgAUI2t1dXrjSL4xXVLB4FznPrIsX3nKXFl/Dt4vA==", + "license": "MIT" + }, + "node_modules/@types/three": { + "version": "0.184.1", + "resolved": "https://registry.npmjs.org/@types/three/-/three-0.184.1.tgz", + "integrity": "sha512-6q4VdiqVsrTRqmk62/BnlcAvIrnDM0zf2ZDVKI5kZiniWrSaOHaQzmbp+BNzoggc/8tgW412pL//wZIxu2PPTA==", + "license": "MIT", + "dependencies": { + "@dimforge/rapier3d-compat": "~0.12.0", + "@tweenjs/tween.js": "~23.1.3", + "@types/stats.js": "*", + "@types/webxr": ">=0.5.17", + "fflate": "~0.8.2", + "meshoptimizer": "~1.1.1" + } + }, "node_modules/@types/unist": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz", "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==", "license": "MIT" }, + "node_modules/@types/webxr": { + "version": "0.5.24", + "resolved": "https://registry.npmjs.org/@types/webxr/-/webxr-0.5.24.tgz", + "integrity": "sha512-h8fgEd/DpoS9CBrjEQXR+dIDraopAEfu4wYVNY2tEPwk60stPWhvZMf4Foo5FakuQ7HFZoa8WceaWFervK2Ovg==", + "license": "MIT" + }, "node_modules/@typescript-eslint/eslint-plugin": { "version": "8.59.3", "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.59.3.tgz", @@ -3703,6 +3811,30 @@ "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" } }, + "node_modules/buffer": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz", + "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.2.1" + } + }, "node_modules/buffer-equal-constant-time": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz", @@ -5628,6 +5760,12 @@ "node": "^12.20 || >= 14.13" } }, + "node_modules/fflate": { + "version": "0.8.3", + "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.3.tgz", + "integrity": "sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==", + "license": "MIT" + }, "node_modules/file-entry-cache": { "version": "8.0.0", "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", @@ -5769,13 +5907,13 @@ } }, "node_modules/framer-motion": { - "version": "12.38.0", - "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.38.0.tgz", - "integrity": "sha512-rFYkY/pigbcswl1XQSb7q424kSTQ8q6eAC+YUsSKooHQYuLdzdHjrt6uxUC+PRAO++q5IS7+TamgIw1AphxR+g==", + "version": "12.40.0", + "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.40.0.tgz", + "integrity": "sha512-uaBd3qC1v3KQqBEjwTUd183K6PbS+j0yR9w9VmEOLWA/tnUcSn8Xa3uck7t4dgpDoUss8xQTcj8W2L07lrnLFg==", "license": "MIT", "dependencies": { - "motion-dom": "^12.38.0", - "motion-utils": "^12.36.0", + "motion-dom": "^12.40.0", + "motion-utils": "^12.39.0", "tslib": "^2.4.0" }, "peerDependencies": { @@ -6325,6 +6463,26 @@ "node": ">=0.10.0" } }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "BSD-3-Clause" + }, "node_modules/ignore": { "version": "5.3.2", "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", @@ -6924,6 +7082,18 @@ "node": ">= 0.4" } }, + "node_modules/its-fine": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/its-fine/-/its-fine-2.0.0.tgz", + "integrity": "sha512-KLViCmWx94zOvpLwSlsx6yOCeMhZYaxrJV87Po5k/FoZzcPSahvK5qJ7fYhS61sZi5ikmh2S3Hz55A2l3U69ng==", + "license": "MIT", + "dependencies": { + "@types/react-reconciler": "^0.28.9" + }, + "peerDependencies": { + "react": "^19.0.0" + } + }, "node_modules/jiti": { "version": "2.7.0", "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.7.0.tgz", @@ -7108,6 +7278,37 @@ "node": ">=0.10" } }, + "node_modules/lenis": { + "version": "1.3.23", + "resolved": "https://registry.npmjs.org/lenis/-/lenis-1.3.23.tgz", + "integrity": "sha512-YxYq3TJqj9sJNv0V9SkyQHejt14xwyIwgDaaMK89Uf9SxQfIszu+gTQSSphh6BWlLTNVKvvXAGkg+Zf+oFIevg==", + "license": "MIT", + "workspaces": [ + "packages/*", + "playground", + "playground/*" + ], + "funding": { + "type": "github", + "url": "https://github.com/sponsors/darkroomengineering" + }, + "peerDependencies": { + "@nuxt/kit": ">=3.0.0", + "react": ">=17.0.0", + "vue": ">=3.0.0" + }, + "peerDependenciesMeta": { + "@nuxt/kit": { + "optional": true + }, + "react": { + "optional": true + }, + "vue": { + "optional": true + } + } + }, "node_modules/levn": { "version": "0.4.1", "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", @@ -7805,6 +8006,12 @@ "node": ">= 8" } }, + "node_modules/meshoptimizer": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/meshoptimizer/-/meshoptimizer-1.1.1.tgz", + "integrity": "sha512-oRFNWJRDA/WTrVj7NWvqa5HqE1t9MYDj2VaWirQCzCCrAd2GHrqR/sQezCxiWATPNlKTcRaPRHPJwIRoPBAp5g==", + "license": "MIT" + }, "node_modules/micromark": { "version": "4.0.2", "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz", @@ -8433,18 +8640,18 @@ } }, "node_modules/motion-dom": { - "version": "12.38.0", - "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.38.0.tgz", - "integrity": "sha512-pdkHLD8QYRp8VfiNLb8xIBJis1byQ9gPT3Jnh2jqfFtAsWUA3dEepDlsWe/xMpO8McV+VdpKVcp+E+TGJEtOoA==", + "version": "12.40.0", + "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.40.0.tgz", + "integrity": "sha512-HxU3ZaBwNPVQUBQf1xxgq+7JrPNZvjLVxgbpEZL7RrWJnsxOf0/OM+yrHG9ogLQ31Do/r57Oz2gQWPK+6q62mg==", "license": "MIT", "dependencies": { - "motion-utils": "^12.36.0" + "motion-utils": "^12.39.0" } }, "node_modules/motion-utils": { - "version": "12.36.0", - "resolved": "https://registry.npmjs.org/motion-utils/-/motion-utils-12.36.0.tgz", - "integrity": "sha512-eHWisygbiwVvf6PZ1vhaHCLamvkSbPIeAYxWUuL3a2PD/TROgE7FvfHWTIH4vMl798QLfMw15nRqIaRDXTlYRg==", + "version": "12.39.0", + "resolved": "https://registry.npmjs.org/motion-utils/-/motion-utils-12.39.0.tgz", + "integrity": "sha512-8nadJAJjTtqRkmRF36FoJTrywK9nnFmnPwnSMyxaOCU7GDjN9RTMJIxx9De8ErM+vpPhMccr/6fo5WciyQLnMQ==", "license": "MIT" }, "node_modules/ms": { @@ -9612,6 +9819,21 @@ "react": ">=18" } }, + "node_modules/react-use-measure": { + "version": "2.1.7", + "resolved": "https://registry.npmjs.org/react-use-measure/-/react-use-measure-2.1.7.tgz", + "integrity": "sha512-KrvcAo13I/60HpwGO5jpW7E9DfusKyLPLvuHlUyP5zqnmAPhNc6qTRjUQrdTADl0lpPpDVU2/Gg51UlOGHXbdg==", + "license": "MIT", + "peerDependencies": { + "react": ">=16.13", + "react-dom": ">=16.13" + }, + "peerDependenciesMeta": { + "react-dom": { + "optional": true + } + } + }, "node_modules/readdirp": { "version": "5.0.0", "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.0.0.tgz", @@ -10540,6 +10762,15 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/suspend-react": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/suspend-react/-/suspend-react-0.1.3.tgz", + "integrity": "sha512-aqldKgX9aZqpoDp3e8/BZ8Dm7x1pJl+qI3ZKxDN0i/IQTWUwBx/ManmlVJ3wowqbno6c2bmiIfs+Um6LbsjJyQ==", + "license": "MIT", + "peerDependencies": { + "react": ">=17.0" + } + }, "node_modules/tailwindcss": { "version": "4.3.0", "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.3.0.tgz", @@ -10561,6 +10792,12 @@ "url": "https://opencollective.com/webpack" } }, + "node_modules/three": { + "version": "0.184.0", + "resolved": "https://registry.npmjs.org/three/-/three-0.184.0.tgz", + "integrity": "sha512-wtTRjG92pM5eUg/KuUnHsqSAlPM296brTOcLgMRqEeylYTh/CdtvKUvCyyCQTzFuStieWxvZb8mVTMvdPyUpxg==", + "license": "MIT" + }, "node_modules/tinyglobby": { "version": "0.2.16", "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.16.tgz", @@ -11067,6 +11304,15 @@ "punycode": "^2.1.0" } }, + "node_modules/use-sync-external-store": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz", + "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==", + "license": "MIT", + "peerDependencies": { + "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" + } + }, "node_modules/valibot": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/valibot/-/valibot-1.2.0.tgz", @@ -11310,6 +11556,35 @@ "zod": "^3.25.0 || ^4.0.0" } }, + "node_modules/zustand": { + "version": "5.0.14", + "resolved": "https://registry.npmjs.org/zustand/-/zustand-5.0.14.tgz", + "integrity": "sha512-/8tAspM5LMPr28b3fwLYrtdj77ECpfZviaP75CMTnwO8ISyaE4GDIG/9rDDYq/cH9D2Xw2A2RXglLInmVBQB/g==", + "license": "MIT", + "engines": { + "node": ">=12.20.0" + }, + "peerDependencies": { + "@types/react": ">=18.0.0", + "immer": ">=9.0.6", + "react": ">=18.0.0", + "use-sync-external-store": ">=1.2.0" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + }, + "immer": { + "optional": true + }, + "react": { + "optional": true + }, + "use-sync-external-store": { + "optional": true + } + } + }, "node_modules/zwitch": { "version": "2.0.4", "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz", diff --git a/dashboard/package.json b/dashboard/package.json index d9e9b64..1558371 100644 --- a/dashboard/package.json +++ b/dashboard/package.json @@ -11,12 +11,15 @@ "dependencies": { "@prisma/adapter-pg": "^7.8.0", "@prisma/client": "^7.8.0", + "@react-three/fiber": "^9.6.1", "@tanstack/react-query": "^5.100.10", + "@types/three": "^0.184.1", "chart.js": "^4.5.1", "d3": "^7.9.0", - "framer-motion": "^12.38.0", + "framer-motion": "^12.40.0", "google-auth-library": "^10.6.2", "jose": "^6.2.3", + "lenis": "^1.3.23", "next": "16.2.6", "pg": "^8.20.0", "prisma": "^7.8.0", @@ -25,6 +28,7 @@ "react-dom": "19.2.4", "react-markdown": "^10.1.0", "remark-gfm": "^4.0.1", + "three": "^0.184.0", "zod": "^4.4.3" }, "devDependencies": { diff --git a/plans/week4/framer-motion-animations.md b/plans/week4/framer-motion-animations.md new file mode 100644 index 0000000..609b6a8 --- /dev/null +++ b/plans/week4/framer-motion-animations.md @@ -0,0 +1,204 @@ +# AC 4 — Framer Motion Animations + +## Scope + +Add Framer Motion animations across the WorkTrace dashboard. +Five animation groups, ordered by visual impact. + +--- + +## 0. Installation + +```bash +cd dashboard && npm install framer-motion +``` + +--- + +## 1. Scroll-Reactive Background (Layout Layer) + +**File:** `dashboard/app/dashboard/layout.tsx` + +A fixed canvas sitting behind all dashboard content. Three gradient orbs at different z-depths move at different parallax speeds as the user scrolls. The orbs never move enough to be distracting — max 60–80px travel — but give the page a sense of depth. + +**Implementation:** + +Create `dashboard/components/parallax-bg.tsx` — a `"use client"` component: + +- `useScroll({ container: ref })` tracks scroll offset of the main scrollable div in the layout. +- Three `motion.div` orbs with `useTransform(scrollY, [0, 1000], [0, -N])` where N differs per orb (60 / 40 / 25 px), creating depth. +- Orbs: blurred radial gradients (cyan `#00ffff22`, purple `#8b5cf622`, pink `#ec489922`) — same palette as the app. +- `will-change: transform` + `pointer-events-none` — zero layout impact. + +Layout passes the scroll container ref into the component via context or direct prop. + +**Result:** Subtle 3D depth on every dashboard page, scroll down/up triggers smooth orb drift. + +--- + +## 2. Page Transitions (Between FEED / REPORTS / MUSIC) + +**File:** `dashboard/app/dashboard/layout.tsx` wrapping `{children}` + +Navigation order: FEED (0) → REPORTS (1) → MUSIC (2). + +**Implementation:** + +- Wrap `{children}` in `<AnimatePresence mode="wait">`. +- A `<PageTransition>` client component wraps each page — it reads the current pathname to determine direction (left/right). +- Forward navigation (FEED→REPORTS, REPORTS→MUSIC): page slides in from right (`x: 40`), current page exits to left (`x: -40`). +- Backward navigation (MUSIC→REPORTS, REPORTS→FEED): reverse direction. +- Both combined with `opacity: 0 → 1` and a quick scale `0.97 → 1`. +- Duration: `0.3s ease-out` — fast enough not to feel slow, slow enough to register. + +``` +variants = { + enter(dir): { x: dir > 0 ? 40 : -40, opacity: 0, scale: 0.97 } + center: { x: 0, opacity: 1, scale: 1 } + exit(dir): { x: dir > 0 ? -40 : 40, opacity: 0, scale: 0.97 } +} +``` + +**Create:** `dashboard/components/page-transition.tsx` + +--- + +## 3. AI Report Loading Indicator + +**File:** `dashboard/app/dashboard/reports/report-form.tsx` → `LoadingPanel` + +Current: a single `animate-pulse` cyan bar + static text. + +Replace with a **three-layer animation**: + +**Layer A — Scanning bar:** A `motion.div` with a bright cyan gradient sweeps left→right infinitely (`x: "-100%" → "100%"`, `repeat: Infinity`, `duration: 1.4s`, `ease: "linear"`). Container is `overflow-hidden` with a subtle cyan track. + +**Layer B — Pulsing orbs:** Three small dots (`●●●`) each animate `opacity` and `y` with staggered delays (`0 / 0.15 / 0.3s`) — a breathing wave effect. + +**Layer C — Typewriter text:** "ASKING THE MODEL" text with each character using `staggerChildren` on mount. Characters animate `opacity: 0 → 1` and `y: 4 → 0`. + +Total visual: strong, clearly communicates "AI is working", fits the terminal/hacker aesthetic. + +--- + +## 4. Modal Animations (ApiKeyModal) + +**File:** `dashboard/app/dashboard/reports/api-key-modal.tsx` + +Current: instant appear/disappear via `createPortal`. + +**Implementation:** + +- Wrap the portal root in `<AnimatePresence>` (conditional render → animate out before unmount). +- **Backdrop:** `motion.div` fades `opacity: 0 → 0.7`, `duration: 0.2s`. +- **Modal panel:** `motion.div` with spring physics: + ``` + initial: { opacity: 0, scale: 0.92, y: 16 } + animate: { opacity: 1, scale: 1, y: 0 } — spring(stiffness:400, damping:28) + exit: { opacity: 0, scale: 0.95, y: 8 } — duration: 0.15s + ``` +- Enter feels snappy (spring), exit is quick fade-shrink. +- Applies to all future modals (the pattern becomes reusable). + +--- + +## 5. Event Feed Cards (Staggered Entrance) + +**Files:** +- `dashboard/app/dashboard/event-feed.tsx` — list container +- `dashboard/app/dashboard/event-card.tsx` — individual card + +**Implementation:** + +Container (`motion.ul` / `motion.div`) uses `variants` with `staggerChildren: 0.05s`. + +Each card on mount: +``` +initial: { opacity: 0, y: 20 } +animate: { opacity: 1, y: 0 } — duration: 0.3s, ease: [0.25, 0.1, 0.25, 1] +``` + +- Only the first "page" of cards staggers (use `custom` prop to cap stagger at index 10 — beyond that, instant appear to avoid long delays on deep scroll). +- Hover: `whileHover={{ scale: 1.015, transition: { duration: 0.15 } }}` — subtle lift. +- The existing `border-purple` hover CSS stays; scale adds depth. + +--- + +## 6. Additional Targeted Animations + +| Location | Animation | +|---|---| +| `toast.tsx` | `AnimatePresence` + slide-in from right (`x: 120 → 0`), fade-out on dismiss | +| `mobile-nav.tsx` | Replace CSS `max-h` trick with `motion.div` height `0 → auto` via `layout` prop, spring easing | +| `header-nav.tsx` | Shared `layoutId="nav-indicator"` pill that slides between active links | +| `top-sessions.tsx` | Progress bars animate width `0 → actual%` on mount via `motion.div` | +| `music-client.tsx` | Summary stat numbers count up from 0 using custom `useCountUp` + `useInView` | +| `charts.tsx` | Fade-in container when data replaces skeleton (`AnimatePresence` swap) | +| `login/page.tsx` | Logo entrance: `scale: 0.8, opacity: 0 → 1`, staggered with button | + +--- + +## File Inventory + +### New files +``` +dashboard/components/parallax-bg.tsx — scroll-reactive background orbs +dashboard/components/page-transition.tsx — directional page slide wrapper +``` + +### Modified files +``` +dashboard/app/dashboard/layout.tsx — integrate ParallaxBg + PageTransition + AnimatePresence +dashboard/app/dashboard/event-feed.tsx — stagger container +dashboard/app/dashboard/event-card.tsx — card entrance + whileHover +dashboard/app/dashboard/reports/report-form.tsx — LoadingPanel overhaul +dashboard/app/dashboard/reports/api-key-modal.tsx — spring modal + AnimatePresence +dashboard/app/dashboard/header-nav.tsx — layoutId nav indicator +dashboard/app/dashboard/mobile-nav.tsx — motion height animation +dashboard/app/dashboard/top-sessions.tsx — progress bar animate +dashboard/app/dashboard/music/music-client.tsx — count-up stats +dashboard/components/toast.tsx — slide-in/out with AnimatePresence +dashboard/app/login/page.tsx — entrance stagger +``` + +--- + +## Technical Notes + +- **SSR safety:** All Framer Motion components that use `useScroll`/`useMotionValue` must be `"use client"`. Already the case for every file in scope. +- **`AnimatePresence mode="wait"`** on page transitions prevents overlap flash. +- **`layout` prop** on progress bars / nav indicator uses Framer's FLIP algorithm — no manual width math. +- **Reduced-motion:** Wrap all animation variants behind `useReducedMotion()` fallback — respect OS accessibility setting. +- **Bundle size:** `framer-motion` is ~45 kB gzipped. Acceptable for a dashboard app. Use tree-shaking (named imports only). + +--- + +## Commit Plan + +| # | Commit message | Що входить | +|---|---|---| +| 1 | `docs: add framer-motion animations plan` | цей файл `/plans/week4/framer-motion-animations.md` | +| 2 | `chore: install framer-motion` | `npm install framer-motion`, оновлений `package.json` / `package-lock.json` | +| 3 | `feat(anim): parallax background orbs on scroll` | `parallax-bg.tsx` + інтеграція в `dashboard/layout.tsx` | +| 4 | `feat(anim): directional page transitions` | `page-transition.tsx` + `AnimatePresence` у `dashboard/layout.tsx` | +| 5 | `feat(anim): AI report loading panel` | `reports/report-form.tsx` — `LoadingPanel` overhaul | +| 6 | `feat(anim): modal spring entrance + AnimatePresence` | `reports/api-key-modal.tsx` | +| 7 | `feat(anim): event feed stagger + card hover` | `event-feed.tsx`, `event-card.tsx` | +| 8 | `feat(anim): nav indicator, mobile-nav, progress bars` | `header-nav.tsx`, `mobile-nav.tsx`, `top-sessions.tsx` | +| 9 | `feat(anim): toasts slide, music count-up, login entrance` | `toast.tsx`, `music-client.tsx`, `login/page.tsx` | +| 10 | *(резервний)* `fix(anim): post-review fixes` | Залишається порожнім — для виправлень після твого огляду | + +--- + +## Acceptance Criteria (AC 4) + +- [ ] Framer Motion installed, no TS errors, existing tests green. +- [ ] Background orbs visible on all three dashboard pages; move on scroll. +- [ ] Page transition fires on FEED ↔ REPORTS ↔ MUSIC nav clicks (directional). +- [ ] AI report loading panel shows scanning bar + dot wave + typewriter text. +- [ ] ApiKeyModal scales in with spring; backdrop fades; both animate out on close. +- [ ] Event feed cards stagger in on first load; hover lifts cards. +- [ ] Toast slides in from right; slides out on dismiss. +- [ ] Nav active indicator slides between links (no jump). +- [ ] Top sessions progress bars animate from 0 on mount. +- [ ] `prefers-reduced-motion` respected — animations disabled when OS requests it. From f490844d28689e1ce34659b5713892dc2f2c7cee Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Tue, 2 Jun 2026 20:38:32 +0300 Subject: [PATCH 23/24] fix(dashboard): report localStorage cache + delete account flow (#23) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * feat(reports): localStorage cache per range, auto-load on switch, createdAt badge * feat(account): delete account flow — animated 2-step modal + DELETE /api/auth/delete-account * fix(reports): scope cache key by normalized user email to prevent cross-account bleed * fix(account): escape key, error display, localStorage cleanup on logout/delete, hydration fix * fix(account): SSR-safe portal via typeof document check, remove dead logout-button.tsx --- .../app/api/auth/delete-account/route.ts | 16 ++ dashboard/app/dashboard/account-menu.tsx | 207 ++++++++++++++++++ dashboard/app/dashboard/app-header.tsx | 4 +- dashboard/app/dashboard/logout-button.tsx | 33 --- dashboard/app/dashboard/reports/page.tsx | 2 +- .../app/dashboard/reports/report-form.tsx | 110 +++++++--- 6 files changed, 311 insertions(+), 61 deletions(-) create mode 100644 dashboard/app/api/auth/delete-account/route.ts create mode 100644 dashboard/app/dashboard/account-menu.tsx delete mode 100644 dashboard/app/dashboard/logout-button.tsx diff --git a/dashboard/app/api/auth/delete-account/route.ts b/dashboard/app/api/auth/delete-account/route.ts new file mode 100644 index 0000000..855c102 --- /dev/null +++ b/dashboard/app/api/auth/delete-account/route.ts @@ -0,0 +1,16 @@ +import { NextResponse } from "next/server"; +import { getCurrentUser } from "@/server/current-user"; +import { prisma } from "@/server/db"; +import { SESSION_COOKIE, clearedCookieOptions } from "@/server/cookies"; + +export async function DELETE() { + const user = await getCurrentUser(); + if (!user) return NextResponse.json({ error: "Unauthorized" }, { status: 401 }); + + // Cascade in schema handles Sessions → Events/Tracks, and UserSetting + await prisma.user.delete({ where: { id: user.id } }); + + const res = NextResponse.json({ ok: true }); + res.cookies.set(SESSION_COOKIE, "", clearedCookieOptions()); + return res; +} diff --git a/dashboard/app/dashboard/account-menu.tsx b/dashboard/app/dashboard/account-menu.tsx new file mode 100644 index 0000000..183a24a --- /dev/null +++ b/dashboard/app/dashboard/account-menu.tsx @@ -0,0 +1,207 @@ +"use client"; + +import { useEffect, useState } from "react"; +import { createPortal } from "react-dom"; +import { AnimatePresence, motion } from "framer-motion"; +import { useRouter } from "next/navigation"; +import { useQueryClient } from "@tanstack/react-query"; + +type Menu = null | "account" | "delete-confirm"; + +const backdrop = { + initial: { opacity: 0 }, + animate: { opacity: 1 }, + exit: { opacity: 0 }, + transition: { duration: 0.2 }, +}; + +const panel = { + initial: { opacity: 0, scale: 0.92, y: 16 }, + animate: { opacity: 1, scale: 1, y: 0 }, + exit: { opacity: 0, scale: 0.95, y: 8 }, + transition: { type: "spring" as const, stiffness: 400, damping: 28, mass: 0.8 }, +}; + +// Remove all cached report keys for a given email (or all wt:report:* keys) +function clearReportCache(email: string) { + try { + const prefix = `wt:report:${email.toLowerCase().trim()}:`; + Object.keys(localStorage) + .filter((k) => k.startsWith(prefix)) + .forEach((k) => localStorage.removeItem(k)); + } catch { /* localStorage unavailable */ } +} + +export function AccountMenu({ userEmail }: { userEmail: string }) { + const router = useRouter(); + const queryClient = useQueryClient(); + const [menu, setMenu] = useState<Menu>(null); + const [pending, setPending] = useState(false); + const [deleteErr, setDeleteErr] = useState<string | null>(null); + + // Escape key closes the active modal + useEffect(() => { + const onKey = (e: KeyboardEvent) => { + if (e.key !== "Escape") return; + if (menu === "delete-confirm") setMenu("account"); + else if (menu === "account") setMenu(null); + }; + window.addEventListener("keydown", onKey); + return () => window.removeEventListener("keydown", onKey); + }, [menu]); + + async function handleLogout() { + setPending(true); + try { + await fetch("/api/auth/logout", { method: "POST" }); + clearReportCache(userEmail); + } finally { + queryClient.clear(); + router.replace("/login"); + router.refresh(); + } + } + + async function handleDelete() { + setPending(true); + setDeleteErr(null); + try { + const res = await fetch("/api/auth/delete-account", { method: "DELETE" }); + if (!res.ok) { + const body = await res.json().catch(() => ({})) as { error?: string }; + throw new Error(body.error ?? `HTTP ${res.status}`); + } + clearReportCache(userEmail); + queryClient.clear(); + router.replace("/login"); + router.refresh(); + } catch (err) { + setDeleteErr(err instanceof Error ? err.message : "Failed to delete account"); + setPending(false); + } + } + + return ( + <> + <button + type="button" + onClick={() => setMenu("account")} + title="Account" + aria-label="Account menu" + className="flex h-7 w-7 cursor-pointer items-center justify-center rounded border border-border bg-surface text-base text-muted transition-all hover:border-pink hover:bg-pink/10 hover:text-pink hover:shadow-[0_0_8px_color-mix(in_srgb,var(--c-pink)_30%,transparent)]" + > + ⎋ + </button> + + {typeof document !== "undefined" && createPortal( + <AnimatePresence mode="wait"> + + {/* ── Modal 1: account options ── */} + {menu === "account" && ( + <> + <motion.div key="bd-a" {...backdrop} + className="fixed inset-0 z-50 bg-bg/80 backdrop-blur" + onMouseDown={() => setMenu(null)} + aria-hidden + /> + <motion.div key="p-a" {...panel} + role="dialog" aria-modal="true" aria-labelledby="account-modal-title" + className="fixed inset-0 z-50 flex items-center justify-center px-4" + onMouseDown={(e) => e.stopPropagation()} + > + <div className="w-full max-w-sm rounded border border-border bg-surface p-6 shadow-xl"> + <div className="mb-4 flex items-baseline justify-between"> + <h2 id="account-modal-title" className="text-sm font-bold tracking-widest text-cyan"> + ACCOUNT + </h2> + <button type="button" onClick={() => setMenu(null)} + className="cursor-pointer text-muted transition-colors hover:text-pink" aria-label="Close"> + ✕ + </button> + </div> + + <div className="flex flex-col gap-2"> + <button + type="button" + onClick={handleLogout} + disabled={pending} + className="w-full cursor-pointer rounded border border-border px-4 py-2.5 text-[10px] font-bold tracking-widest text-muted transition-colors hover:border-purple/60 hover:text-text disabled:opacity-50" + > + SIGN OUT + </button> + <button + type="button" + onClick={() => { setDeleteErr(null); setMenu("delete-confirm"); }} + disabled={pending} + className="w-full cursor-pointer rounded border border-pink/40 px-4 py-2.5 text-[10px] font-bold tracking-widest text-pink transition-colors hover:bg-pink/10 disabled:opacity-50" + > + DELETE ACCOUNT + </button> + </div> + </div> + </motion.div> + </> + )} + + {/* ── Modal 2: delete confirmation ── */} + {menu === "delete-confirm" && ( + <> + <motion.div key="bd-d" {...backdrop} + className="fixed inset-0 z-50 bg-bg/80 backdrop-blur" + onMouseDown={() => setMenu("account")} + aria-hidden + /> + <motion.div key="p-d" {...panel} + role="dialog" aria-modal="true" aria-labelledby="delete-modal-title" + className="fixed inset-0 z-50 flex items-center justify-center px-4" + onMouseDown={(e) => e.stopPropagation()} + > + <div className="w-full max-w-sm rounded border border-pink/40 bg-surface p-6 shadow-xl"> + <div className="mb-4 flex items-baseline justify-between"> + <h2 id="delete-modal-title" className="text-sm font-bold tracking-widest text-pink"> + DELETE ACCOUNT + </h2> + <button type="button" onClick={() => setMenu("account")} + className="cursor-pointer text-muted transition-colors hover:text-pink" aria-label="Back"> + ✕ + </button> + </div> + + <p className="mb-5 text-xs leading-relaxed text-muted"> + This will <span className="text-pink">permanently delete</span> all your events, + sessions, music data, and settings. This action cannot be undone. + </p> + + {deleteErr ? ( + <p className="mb-3 text-[11px] text-pink">{deleteErr}</p> + ) : null} + + <div className="flex flex-wrap items-center justify-end gap-2"> + <button + type="button" + onClick={() => setMenu("account")} + disabled={pending} + className="cursor-pointer rounded border border-border px-3 py-1.5 text-[10px] font-bold tracking-widest text-muted transition-colors hover:text-text disabled:opacity-50" + > + CANCEL + </button> + <button + type="button" + onClick={handleDelete} + disabled={pending} + className="cursor-pointer rounded border border-pink bg-pink/10 px-4 py-1.5 text-[10px] font-bold tracking-widest text-pink transition-colors hover:bg-pink/20 disabled:cursor-not-allowed disabled:opacity-50" + > + {pending ? "DELETING…" : "DELETE EVERYTHING"} + </button> + </div> + </div> + </motion.div> + </> + )} + + </AnimatePresence>, + document.body, + )} + </> + ); +} diff --git a/dashboard/app/dashboard/app-header.tsx b/dashboard/app/dashboard/app-header.tsx index c2af845..0623675 100644 --- a/dashboard/app/dashboard/app-header.tsx +++ b/dashboard/app/dashboard/app-header.tsx @@ -1,4 +1,4 @@ -import { LogoutButton } from "./logout-button"; +import { AccountMenu } from "./account-menu"; import { HeaderNav } from "./header-nav"; import { MobileNav } from "./mobile-nav"; @@ -52,7 +52,7 @@ export function AppHeader({ email, name, picture }: Props) { > {displayName} </span> - <LogoutButton /> + <AccountMenu userEmail={email} /> <MobileNav /> </div> </header> diff --git a/dashboard/app/dashboard/logout-button.tsx b/dashboard/app/dashboard/logout-button.tsx deleted file mode 100644 index 0f3854e..0000000 --- a/dashboard/app/dashboard/logout-button.tsx +++ /dev/null @@ -1,33 +0,0 @@ -"use client"; - -import { useState } from "react"; -import { useRouter } from "next/navigation"; -import { useQueryClient } from "@tanstack/react-query"; - -export function LogoutButton() { - const router = useRouter(); - const queryClient = useQueryClient(); - const [pending, setPending] = useState(false); - - return ( - <button - type="button" - disabled={pending} - onClick={async () => { - setPending(true); - try { - await fetch("/api/auth/logout", { method: "POST" }); - } finally { - queryClient.clear(); - router.replace("/login"); - router.refresh(); - } - }} - title="Sign out" - aria-label="Sign out" - className="flex h-7 w-7 cursor-pointer items-center justify-center rounded border border-border bg-surface text-base text-muted transition-all hover:border-pink hover:bg-pink/10 hover:text-pink hover:shadow-[0_0_8px_color-mix(in_srgb,var(--c-pink)_30%,transparent)] disabled:cursor-not-allowed disabled:opacity-30" - > - {pending ? "…" : "⎋"} - </button> - ); -} diff --git a/dashboard/app/dashboard/reports/page.tsx b/dashboard/app/dashboard/reports/page.tsx index 1f55bf5..f813ba7 100644 --- a/dashboard/app/dashboard/reports/page.tsx +++ b/dashboard/app/dashboard/reports/page.tsx @@ -18,7 +18,7 @@ export default async function ReportsPage() { <div className="flex items-baseline justify-between"> <h1 className="text-base font-bold tracking-widest text-cyan">AI SESSION REPORT</h1> </div> - <ReportForm /> + <ReportForm userEmail={user.email} /> </div> ); } diff --git a/dashboard/app/dashboard/reports/report-form.tsx b/dashboard/app/dashboard/reports/report-form.tsx index 945f269..7641167 100644 --- a/dashboard/app/dashboard/reports/report-form.tsx +++ b/dashboard/app/dashboard/reports/report-form.tsx @@ -26,7 +26,35 @@ type Status = | { kind: "idle" } | { kind: "loading" } | { kind: "error"; message: string } - | { kind: "success"; result: GenerateReportResponse }; + | { kind: "success"; result: GenerateReportResponse; createdAt: string }; + +// ─── localStorage cache ─────────────────────────────────────────────────────── + +type CachedReport = { result: GenerateReportResponse; createdAt: string }; + +function reportCacheKey(email: string, range: RangePreset, from: string, to: string): string { + const u = email.toLowerCase().trim(); + return range === "custom" + ? `wt:report:${u}:custom:${from}:${to}` + : `wt:report:${u}:${range}`; +} + +function loadCache(key: string): CachedReport | null { + try { + const raw = localStorage.getItem(key); + return raw ? (JSON.parse(raw) as CachedReport) : null; + } catch { return null; } +} + +function saveCache(key: string, data: CachedReport): void { + try { localStorage.setItem(key, JSON.stringify(data)); } catch { /* quota */ } +} + +function fmtCreatedAt(iso: string): string { + return new Date(iso).toLocaleString(undefined, { + month: "short", day: "numeric", hour: "2-digit", minute: "2-digit", + }); +} function todayISO(): string { const d = new Date(); @@ -48,12 +76,19 @@ function downloadMarkdown(markdown: string, rangeLabel: string): void { URL.revokeObjectURL(url); } -export function ReportForm() { +export function ReportForm({ userEmail }: { userEmail: string }) { const toast = useToast(); const [range, setRange] = useState<RangePreset>("last_7d"); const [from, setFrom] = useState<string>(""); const [to, setTo] = useState<string>(todayISO()); - const [status, setStatus] = useState<Status>({ kind: "idle" }); + // Lazy init: read localStorage for the default range before first render + const [status, setStatus] = useState<Status>(() => { + try { + const cached = loadCache(reportCacheKey(userEmail, "last_7d", "", "")); + if (cached) return { kind: "success", result: cached.result, createdAt: cached.createdAt }; + } catch { /* localStorage unavailable (SSR guard) */ } + return { kind: "idle" }; + }); const [apiKey, setApiKey] = useState<UserSettingsView | null>(null); const [modalOpen, setModalOpen] = useState(false); @@ -65,6 +100,35 @@ export function ReportForm() { return () => { cancelled = true; }; }, []); + // Range button click — load cache in the event handler (not in an effect) + function handleRangeChange(newRange: RangePreset) { + setRange(newRange); + if (newRange === "custom") return; + const cached = loadCache(reportCacheKey(userEmail, newRange, "", "")); + setStatus(cached + ? { kind: "success", result: cached.result, createdAt: cached.createdAt } + : { kind: "idle" }); + } + + // Custom date changes — check cache when both dates are present + function handleFromChange(newFrom: string) { + setFrom(newFrom); + if (!newFrom || !to) { setStatus({ kind: "idle" }); return; } + const cached = loadCache(reportCacheKey(userEmail, "custom", newFrom, to)); + setStatus(cached + ? { kind: "success", result: cached.result, createdAt: cached.createdAt } + : { kind: "idle" }); + } + + function handleToChange(newTo: string) { + setTo(newTo); + if (!from || !newTo) { setStatus({ kind: "idle" }); return; } + const cached = loadCache(reportCacheKey(userEmail, "custom", from, newTo)); + setStatus(cached + ? { kind: "success", result: cached.result, createdAt: cached.createdAt } + : { kind: "idle" }); + } + const isCustom = range === "custom"; const isBusy = status.kind === "loading"; @@ -81,7 +145,9 @@ export function ReportForm() { } try { const result = await generateReport(input); - setStatus({ kind: "success", result }); + const createdAt = new Date().toISOString(); + saveCache(reportCacheKey(userEmail, range, from, to), { result, createdAt }); + setStatus({ kind: "success", result, createdAt }); } catch (err) { const message = err instanceof Error ? err.message : "Failed to generate report"; setStatus({ kind: "error", message }); @@ -116,7 +182,7 @@ export function ReportForm() { <button key={p.value} type="button" - onClick={() => setRange(p.value)} + onClick={() => handleRangeChange(p.value)} disabled={isBusy} className={ "cursor-pointer rounded border px-3 py-1.5 text-[10px] font-bold tracking-widest transition-colors disabled:cursor-not-allowed disabled:opacity-50 " + @@ -131,22 +197,13 @@ export function ReportForm() { <div className="ml-auto flex flex-wrap items-center gap-2"> {status.kind === "success" ? ( - <> - <button - type="button" - onClick={() => setStatus({ kind: "idle" })} - className="cursor-pointer rounded border border-muted px-3 py-1.5 text-[10px] font-bold tracking-widest text-muted transition-colors hover:border-pink hover:text-pink" - > - NEW REPORT - </button> - <button - type="button" - onClick={() => downloadMarkdown(status.result.markdown, status.result.range.label)} - className="cursor-pointer rounded border border-cyan px-3 py-1.5 text-[10px] font-bold tracking-widest text-cyan transition-colors hover:bg-cyan/10" - > - DOWNLOAD .MD - </button> - </> + <button + type="button" + onClick={() => downloadMarkdown(status.result.markdown, status.result.range.label)} + className="cursor-pointer rounded border border-cyan px-3 py-1.5 text-[10px] font-bold tracking-widest text-cyan transition-colors hover:bg-cyan/10" + > + DOWNLOAD .MD + </button> ) : null} <button type="button" @@ -166,7 +223,7 @@ export function ReportForm() { type="date" value={from} max={to || todayISO()} - onChange={(e) => setFrom(e.target.value)} + onChange={(e) => handleFromChange(e.target.value)} disabled={isBusy} className={INPUT_CLASS} /> @@ -177,7 +234,7 @@ export function ReportForm() { value={to} min={from || undefined} max={todayISO()} - onChange={(e) => setTo(e.target.value)} + onChange={(e) => handleToChange(e.target.value)} disabled={isBusy} className={INPUT_CLASS} /> @@ -188,7 +245,7 @@ export function ReportForm() { {status.kind === "loading" ? <LoadingPanel /> : null} {status.kind === "error" ? <ErrorPanel message={status.message} onRetry={handleGenerate} /> : null} - {status.kind === "success" ? <ResultPanel result={status.result} /> : null} + {status.kind === "success" ? <ResultPanel result={status.result} createdAt={status.createdAt} /> : null} {apiKey ? ( <ApiKeyModal @@ -268,7 +325,7 @@ function ErrorPanel({ message, onRetry }: { message: string; onRetry: () => void ); } -function ResultPanel({ result }: { result: GenerateReportResponse }) { +function ResultPanel({ result, createdAt }: { result: GenerateReportResponse; createdAt: string }) { return ( <div className="flex flex-col gap-3"> <div className="flex flex-wrap gap-2 text-[10px] tracking-widest"> @@ -284,6 +341,9 @@ function ResultPanel({ result }: { result: GenerateReportResponse }) { <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> MODEL <span className="ml-1 text-purple">{result.model}</span> </span> + <span className="rounded border border-border bg-surface px-2.5 py-1 text-muted"> + GENERATED <span className="ml-1 text-muted/70">{fmtCreatedAt(createdAt)}</span> + </span> </div> <MarkdownView markdown={result.markdown} /> </div> From a5c0c4935249b819bed932ac555144577f2e0396 Mon Sep 17 00:00:00 2001 From: BOHDAN MATULA <99603423+BODMAT@users.noreply.github.com> Date: Tue, 2 Jun 2026 21:08:15 +0300 Subject: [PATCH 24/24] fix: code review follow-ups - flush() race + extension/dashboard hardening (#24) * fix(extension): unify JWT decode into single decodeJwtPayload helper * fix(extension): log ensureDbSession failure instead of silent void * fix(extension): extract isTrackBlocked helper, remove blocklist check duplication * fix(extension): exhaustiveness guard on message type dispatcher * feat(extension): make WORKTRACE title a link to the dashboard * fix(dashboard): surface localStorage QuotaExceededError as toast in report cache * fix(dashboard): validate Groq key gsk_ prefix before save * feat(dashboard): add footer with GitHub releases link * fix(extension): guard flush() against concurrent runs to prevent duplicate events --- dashboard/app/dashboard/layout.tsx | 10 ++ .../app/dashboard/reports/api-key-modal.tsx | 9 +- .../app/dashboard/reports/report-form.tsx | 15 +- extension/src/background/index.ts | 47 +++--- extension/src/background/sync.ts | 136 ++++++++++-------- extension/src/popup/index.html | 2 +- extension/src/popup/popup.css | 1 + 7 files changed, 139 insertions(+), 81 deletions(-) diff --git a/dashboard/app/dashboard/layout.tsx b/dashboard/app/dashboard/layout.tsx index 0416274..d8c4bc7 100644 --- a/dashboard/app/dashboard/layout.tsx +++ b/dashboard/app/dashboard/layout.tsx @@ -17,6 +17,16 @@ export default async function DashboardLayout({ <main className="relative z-1 flex-1"> <PageTransition>{children}</PageTransition> </main> + <footer className="relative z-10 flex items-center justify-center border-t border-border bg-bg/95 px-6 py-3 backdrop-blur"> + <a + href="https://github.com/BODMAT/worktrace" + target="_blank" + rel="noopener noreferrer" + className="text-[10px] font-bold tracking-widest text-muted transition-colors hover:text-cyan" + > + GITHUB · RELEASES + </a> + </footer> </div> ); } diff --git a/dashboard/app/dashboard/reports/api-key-modal.tsx b/dashboard/app/dashboard/reports/api-key-modal.tsx index e50be5d..9025204 100644 --- a/dashboard/app/dashboard/reports/api-key-modal.tsx +++ b/dashboard/app/dashboard/reports/api-key-modal.tsx @@ -18,6 +18,9 @@ export function ApiKeyModal({ open, status, onClose, onSaved }: Props) { const [busy, setBusy] = useState(false); const [error, setError] = useState<string | null>(null); + const trimmed = value.trim(); + const keyFormatOk = trimmed.startsWith("gsk_") && trimmed.length >= 20; + useEffect(() => { const onKey = (e: KeyboardEvent) => { if (e.key === "Escape") onClose(); }; window.addEventListener("keydown", onKey); @@ -105,7 +108,9 @@ export function ApiKeyModal({ open, status, onClose, onSaved }: Props) { className="mb-2 w-full rounded border border-border bg-bg px-2 py-1.5 text-xs text-text outline-none transition-colors focus:border-purple disabled:opacity-50" /> - {error ? ( + {trimmed.length > 0 && !trimmed.startsWith("gsk_") ? ( + <p className="mb-2 text-[11px] text-pink">Key must start with gsk_</p> + ) : error ? ( <p className="mb-2 text-[11px] text-pink">{error}</p> ) : null} @@ -135,7 +140,7 @@ export function ApiKeyModal({ open, status, onClose, onSaved }: Props) { <button type="button" onClick={() => commit(value)} - disabled={busy || value.trim().length < 8} + disabled={busy || !keyFormatOk} className="cursor-pointer rounded border border-cyan bg-cyan/10 px-3 py-1.5 text-[10px] font-bold tracking-widest text-cyan transition-colors hover:bg-cyan/20 disabled:cursor-not-allowed disabled:opacity-50" > {busy ? "SAVING…" : "SAVE"} diff --git a/dashboard/app/dashboard/reports/report-form.tsx b/dashboard/app/dashboard/reports/report-form.tsx index 7641167..2c0deee 100644 --- a/dashboard/app/dashboard/reports/report-form.tsx +++ b/dashboard/app/dashboard/reports/report-form.tsx @@ -47,7 +47,14 @@ function loadCache(key: string): CachedReport | null { } function saveCache(key: string, data: CachedReport): void { - try { localStorage.setItem(key, JSON.stringify(data)); } catch { /* quota */ } + try { + localStorage.setItem(key, JSON.stringify(data)); + } catch (err) { + if (err instanceof DOMException && (err.name === "QuotaExceededError" || err.name === "NS_ERROR_DOM_QUOTA_REACHED")) { + throw err; // let caller notify the user + } + // other DOMExceptions are unexpected — swallow silently + } } function fmtCreatedAt(iso: string): string { @@ -146,7 +153,11 @@ export function ReportForm({ userEmail }: { userEmail: string }) { try { const result = await generateReport(input); const createdAt = new Date().toISOString(); - saveCache(reportCacheKey(userEmail, range, from, to), { result, createdAt }); + try { + saveCache(reportCacheKey(userEmail, range, from, to), { result, createdAt }); + } catch { + toast.error("Report generated but couldn't be cached — browser storage is full."); + } setStatus({ kind: "success", result, createdAt }); } catch (err) { const message = err instanceof Error ? err.message : "Failed to generate report"; diff --git a/extension/src/background/index.ts b/extension/src/background/index.ts index 941f714..5c20838 100644 --- a/extension/src/background/index.ts +++ b/extension/src/background/index.ts @@ -48,17 +48,20 @@ function isExpired(expiresAt: number): boolean { return Date.now() >= expiresAt - EXPIRY_BUFFER_MS; } -function decodeEmail(jwt: string): string | null { +function decodeJwtPayload(jwt: string): { email?: string; exp?: number } | null { try { const payloadB64 = jwt.split(".")[1]; if (!payloadB64) return null; - const payload = JSON.parse(atob(payloadB64)) as { email?: string }; - return payload.email ?? null; + return JSON.parse(atob(payloadB64)) as { email?: string; exp?: number }; } catch { return null; } } +function decodeEmail(jwt: string): string | null { + return decodeJwtPayload(jwt)?.email ?? null; +} + // ─── Google OAuth ────────────────────────────────────────────────────────────── async function launchGoogleOAuth(): Promise<string> { @@ -101,9 +104,9 @@ async function exchangeForJWT(googleIdToken: string): Promise<StoredAuth> { } const { token } = await res.json() as { token: string }; - const payloadB64 = token.split(".")[1] ?? ""; - const { exp } = JSON.parse(atob(payloadB64)) as { exp: number }; - return { jwt: token, jwtExpiresAt: exp * 1000 }; + const payload = decodeJwtPayload(token); + if (!payload?.exp) throw new Error("JWT missing exp claim"); + return { jwt: token, jwtExpiresAt: payload.exp * 1000 }; } // ─── Core ────────────────────────────────────────────────────────────────────── @@ -163,6 +166,17 @@ async function tryEndDbSession(dbSessionId: string): Promise<void> { } } +// ─── Music helpers ──────────────────────────────────────────────────────────── + +const TRACK_SOURCE_DOMAINS: Record<TrackInfo["source"], string> = { + "youtube-music": "music.youtube.com", + "soundcloud": "soundcloud.com", +}; + +async function isTrackBlocked(track: TrackInfo): Promise<boolean> { + return isDomainBlocked(`https://${TRACK_SOURCE_DOMAINS[track.source]}`); +} + // ─── Music: pull track from active tab ──────────────────────────────────────── // Returns current playbackTime from the music tab without any side effects. @@ -204,10 +218,7 @@ async function queryActiveTabForTrack(): Promise<TrackInfo | null> { const track = await chrome.tabs.sendMessage(tab.id, { type: "TRACK_REQUEST" }) as TrackInfo | null; if (track) { // Blocklist check before storing or persisting to DB - const sourceUrl = `https://${ - track.source === "youtube-music" ? "music.youtube.com" : "soundcloud.com" - }`; - const blocked = await isDomainBlocked(sourceUrl); + const blocked = await isTrackBlocked(track); if (blocked) return null; await chrome.storage.local.set({ currentTrack: track }); @@ -355,7 +366,11 @@ chrome.runtime.onMessage.addListener( session: { ...session, elapsedMs: getElapsedMs(session) }, }); // Fire-and-forget DB session creation — retried by sync alarm if it fails - if (!session.dbSessionId) void ensureDbSession(); + if (!session.dbSessionId) { + ensureDbSession().catch((err) => + console.warn("[worktrace] ensureDbSession failed:", err), + ); + } }) .catch((err: unknown) => sendResponse({ @@ -494,13 +509,8 @@ chrome.runtime.onMessage.addListener( const track = message.payload; // Background-level blocklist check: second line of defence after content script - // Derive the domain from the known source → hostname mapping - const trackSourceDomain: Record<TrackInfo["source"], string> = { - "youtube-music": "music.youtube.com", - "soundcloud": "soundcloud.com", - }; void (async () => { - const blocked = await isDomainBlocked(`https://${trackSourceDomain[track.source]}`); + const blocked = await isTrackBlocked(track); if (blocked) return; void chrome.storage.local.set({ currentTrack: track }); @@ -620,6 +630,9 @@ chrome.runtime.onMessage.addListener( return true; } + // Exhaustiveness guard — TypeScript compile error if a new message type is added without a handler + const _exhaustive: never = message; + void _exhaustive; return false; }, ); diff --git a/extension/src/background/sync.ts b/extension/src/background/sync.ts index 467def8..e44c319 100644 --- a/extension/src/background/sync.ts +++ b/extension/src/background/sync.ts @@ -21,6 +21,13 @@ let apiFetchFn: ApiFetch | null = null; let ensureDbSessionFn: EnsureDbSession | null = null; let checkAuthFn: CheckAuth | null = null; +// Re-entry guard: the 30s alarm and the inline SESSION_STOP flush can overlap. +// Without this, two concurrent flushes read the same queue, POST the same +// events (event.create has no idempotency key → permanent duplicates), and +// race on writing `remaining` back. The SW is single-threaded, so a synchronous +// check before the first await is sufficient to serialise. +let flushing = false; + export function initSync(deps: { apiFetch: ApiFetch; ensureDbSession: EnsureDbSession; @@ -56,70 +63,81 @@ async function setStatus(patch: Partial<SyncStatus>): Promise<void> { export async function flush(): Promise<void> { if (!apiFetchFn || !ensureDbSessionFn || !checkAuthFn) return; - // Skip flush entirely if the user is not authenticated — avoids ERR_CONNECTION_REFUSED spam - const isAuth = await checkAuthFn(); - if (!isAuth) return; - - const session = await getSession(); - if (!session) return; - - const dbSessionId = session.dbSessionId ?? (await ensureDbSessionFn()); - if (!dbSessionId) { - await setStatus({ lastError: "DB session not available" }); - return; - } - - const r = await chrome.storage.local.get(PENDING_KEY); - const queue = (r[PENDING_KEY] as PendingEvent[] | undefined) ?? []; - if (queue.length === 0) return; - - const batch = queue.slice(0, BATCH_SIZE); - let sentCount = 0; - let lastError: string | null = null; - - for (let i = 0; i < batch.length; i++) { - const event = batch[i]!; - let res: Response; - try { - res = await apiFetchFn("/api/v1/events", { - method: "POST", - body: JSON.stringify({ ...event, sessionId: dbSessionId }), - }); - } catch (err) { - // Network error — keep this event and everything after it for the next flush - lastError = err instanceof Error ? err.message : "Network error"; - break; - } - - if (res.ok) { - sentCount++; - continue; + // Bail synchronously if another flush is already in flight (see `flushing` above). + if (flushing) return; + flushing = true; + try { + // Skip flush entirely if the user is not authenticated — avoids ERR_CONNECTION_REFUSED spam + const isAuth = await checkAuthFn(); + if (!isAuth) return; + + const session = await getSession(); + if (!session) return; + + const dbSessionId = session.dbSessionId ?? (await ensureDbSessionFn()); + if (!dbSessionId) { + await setStatus({ lastError: "DB session not available" }); + return; } - if (res.status === 401) { - // Token rotated/expired — stop, queue waits for next login - lastError = "Unauthorized — please sign in again"; + const r = await chrome.storage.local.get(PENDING_KEY); + const queue = (r[PENDING_KEY] as PendingEvent[] | undefined) ?? []; + if (queue.length === 0) return; + + const batch = queue.slice(0, BATCH_SIZE); + let sentCount = 0; + let lastError: string | null = null; + + for (let i = 0; i < batch.length; i++) { + const event = batch[i]!; + let res: Response; + try { + res = await apiFetchFn("/api/v1/events", { + method: "POST", + body: JSON.stringify({ ...event, sessionId: dbSessionId }), + }); + } catch (err) { + // Network error — keep this event and everything after it for the next flush + lastError = err instanceof Error ? err.message : "Network error"; + break; + } + + if (res.ok) { + sentCount++; + continue; + } + + if (res.status === 401) { + // Token rotated/expired — stop, queue waits for next login + lastError = "Unauthorized — please sign in again"; + break; + } + + if (res.status >= 400 && res.status < 500) { + // Poisonous payload — drop it, keep going so it can't block the queue + sentCount++; + lastError = `Dropped invalid event (HTTP ${String(res.status)})`; + continue; + } + + // 5xx — retry next alarm + lastError = `Server error (HTTP ${String(res.status)})`; break; } - if (res.status >= 400 && res.status < 500) { - // Poisonous payload — drop it, keep going so it can't block the queue - sentCount++; - lastError = `Dropped invalid event (HTTP ${String(res.status)})`; - continue; + if (sentCount > 0) { + // Re-read the queue: events may have been appended by content scripts + // while we were awaiting the network. Only drop what we actually sent. + const fresh = await chrome.storage.local.get(PENDING_KEY); + const current = (fresh[PENDING_KEY] as PendingEvent[] | undefined) ?? []; + const remaining = current.slice(sentCount); + await chrome.storage.local.set({ [PENDING_KEY]: remaining }); } - - // 5xx — retry next alarm - lastError = `Server error (HTTP ${String(res.status)})`; - break; + await setStatus({ + lastSyncedAt: sentCount > 0 ? Date.now() : (await getStatus()).lastSyncedAt, + lastError, + }); + } finally { + flushing = false; } - - if (sentCount > 0) { - const remaining = queue.slice(sentCount); - await chrome.storage.local.set({ [PENDING_KEY]: remaining }); - } - await setStatus({ - lastSyncedAt: sentCount > 0 ? Date.now() : (await getStatus()).lastSyncedAt, - lastError, - }); } diff --git a/extension/src/popup/index.html b/extension/src/popup/index.html index 9477633..28db512 100644 --- a/extension/src/popup/index.html +++ b/extension/src/popup/index.html @@ -14,7 +14,7 @@ <div class="popup__logo"> <span class="popup__logo-icon">⬡</span> <div class="popup__logo-stack"> - <span class="popup__logo-text">WORKTRACE</span> + <a href="https://worktrace-ecru.vercel.app" class="popup__logo-text" target="_blank" rel="noopener noreferrer">WORKTRACE</a> <span class="popup__user-email" id="user-email" hidden></span> </div> </div> diff --git a/extension/src/popup/popup.css b/extension/src/popup/popup.css index 8b438c5..16591e4 100644 --- a/extension/src/popup/popup.css +++ b/extension/src/popup/popup.css @@ -67,6 +67,7 @@ body { font-weight: 700; color: var(--c-cyan); text-shadow: 0 0 6px color-mix(in srgb, var(--c-cyan) 60%, transparent); + text-decoration: none; } .popup__user-email {