© SciActive Inc. All rights reserved. Design by: + HTML5 UP.
`,ee,M,q,te,Y,re,Fr,Dt,ae,Yr="SciActive",Nt,Ee,V,rt,ye,Pt,jt,le,ne,Jr="User Guide",qt,A,at,be,Ut,Qt,lt,Ie,Rt,zt,nt,Ae,Ht,Ot,st,Le,Gt,Vt,ot,$e,Bt,Kt,it,Ce,Wt,Ft,ct,Se,Yt,Jt,ft,ke,Xt,Zt,ut,Te,er,tr,se,oe,Xr="Packages",rr,c,dt,we,ar,lr,ht,Me,nr,sr,pt,xe,or,ir,mt,De,cr,fr,vt,Ne,ur,dr,gt,Pe,hr,pr,_t,je,mr,vr,Et,qe,gr,_r,yt,Ue,Er,yr,bt,Qe,br,Ir,It,Re,Ar,Lr,At,ze,$r,Cr,Lt,He,Sr,kr,$t,Oe,Tr,wr,Ct,Ge,Mr,xr,B,ie,Zr="limit:numberoffset:numbersort:stringreverse:true, reverse:false,
+ reverse:1, or reverse:0name=string or name!=string",kl,oe,eo=`name="string value" or name!="string value" [name] or [!name]name~/pattern/ or name!~/pattern/name~/pattern/i or name!~/pattern/iname~pattern or name!~patternname~"pattern" or name!~"pattern" name~"pattern"i or name!~"pattern"inow or
+ yesterday.)"two days from now",
+ "last thursday", "+4 weeks", or
+ "5 minutes ago".)now or
+ yesterday.)"two days from now",
+ "last thursday", "+4 weeks", or
+ "5 minutes ago".)now or
+ yesterday.)`,ma,B,Xt,pr='name<"relative time value"',xa,Ea,We,_r=`"two days from now",
+ "last thursday", "+4 weeks", or
+ "5 minutes ago".)now or
+ yesterday.)"two days from now",
+ "last thursday", "+4 weeks", or
+ "5 minutes ago".)"|" type in an ilike clause surrounded by "%"
+ characters for each field passed in to the defaultFields argument.`,Sa,G,Dr="bareHandler that
+ will handle bare query parts instead of the "Default Fields" behavior
+ described above. It will receive three arguments, the query parts, the
+ entity class, and the default fields entry for that class. It should return
+ a partial selector that will replace or extend the "|" selector.`,ll;return k=new gi({props:{language:Ui,code:"npm install --save @nymphjs/query-parser"}}),O=new gi({props:{language:Ii,code:`import queryParser from '@nymphjs/query-parser';
+
+import BlogPost from './BlogPost';
+import Category from './Category';
+
+async function doQuery() {
+ const [options, ...selectors] = queryParser({
+ query:
+ 'limit:4 sort:mdate foobar (| [archived] mdate<"2 weeks ago") category<{cat Tech}>',
+ entityClass: BlogPost,
+ defaultFields: ['title', 'body'],
+ qrefMap: {
+ cat: {
+ class: Category,
+ defaultFields: ['name'],
+ },
+ },
+ });
+ /*
+ Options will be
+ {
+ class: BlogPost,
+ limit: 4,
+ sort: 'mdate'
+ }
+
+ And selectors will be (equivalent to)
+ [
+ {
+ type: "|",
+ truthy: [
+ "archived"
+ ],
+ lt: [
+ ["mdate", null, "2 weeks ago"]
+ ]
+ },
+ {
+ type: "&",
+ qref: [
+ "category",
+ [
+ {
+ class: Category
+ },
+ {
+ type: "|",
+ ilike: ["name", "%Tech%"]
+ }
+ ]
+ ]
+ },
+ {
+ type: "|",
+ ilike: [
+ ["title", "%foobar%"],
+ ["body", "%foobar%"]
+ ]
+ }
+ ]
+ */
+ const entities = await nymph.getEntities(options, ...selectors);
+}`}}),{c(){q=new qi(!1),pt=pi(),tl=o(),t=l("section"),b=l("header"),b.innerHTML=Na,Cl=o(),K=l("p"),K.textContent=$a,pl=o(),w=l("header"),w.innerHTML=za,_l=o(),mi(k.$$.fragment),ml=o(),D=l("header"),D.innerHTML=Ja,xl=o(),V=l("p"),V.innerHTML=Ba,El=o(),mi(O.$$.fragment),Ll=o(),P=l("header"),P.innerHTML=Fa,yl=o(),W=l("p"),W.textContent=Qa,Hl=o(),Z=l("ul"),Z.innerHTML=Ya,gl=o(),ee=l("p"),ee.textContent=Xa,Tl=o(),U=l("header"),U.innerHTML=Ga,Ml=o(),te=l("p"),te.textContent=Ka,ql=o(),le=l("header"),le.innerHTML=Va,bl=o(),ne=l("p"),ne.textContent=Wa,wl=o(),_=l("ul"),ae=l("li"),ae.innerHTML=Za,kl=o(),oe=l("li"),oe.innerHTML=eo,Dl=o(),m=l("li"),re=l("code"),re.textContent=to,Ol=c(" or "),ie=l("code"),ie.textContent=lo,Pl=o(),_t=l("ul"),h=l("li"),Ul=c("(Match a JSON encoded value (like "),se=l("code"),se.textContent=no,Il=c(", "),de=l("code"),de.textContent=ao,Al=c(`,
+ `),ce=l("code"),ce.textContent=oo,Rl=c(", or "),mt=l("code"),Sl=c(ro),jl=c(").)"),Nl=o(),ue=l("header"),ue.innerHTML=io,$l=o(),he=l("p"),he.textContent=so,zl=o(),xt=l("ul"),I=l("li"),Et=l("code"),Jl=c(co),Bl=c(" or "),Lt=l("code"),Fl=c(uo),Ql=o(),ve=l("header"),ve.innerHTML=ho,Yl=o(),fe=l("p"),fe.textContent=vo,Xl=o(),yt=l("ul"),A=l("li"),Ht=l("code"),Gl=c(fo),Kl=c(" or "),gt=l("code"),Vl=c(Co),Wl=o(),Ce=l("header"),Ce.innerHTML=po,Zl=o(),pe=l("p"),pe.textContent=_o,en=o(),_e=l("ul"),_e.innerHTML=mo,tn=o(),me=l("header"),me.innerHTML=xo,ln=o(),xe=l("p"),xe.textContent=Eo,nn=o(),Tt=l("ul"),R=l("li"),Mt=l("code"),an=c(Lo),on=c(" or "),qt=l("code"),rn=c(yo),sn=o(),Ee=l("header"),Ee.innerHTML=Ho,dn=o(),Le=l("p"),Le.textContent=go,cn=o(),bt=l("ul"),x=l("li"),wt=l("code"),un=c(To),hn=c(` or
+ `),kt=l("code"),vn=c(Mo),fn=o(),ye=l("ul"),ye.innerHTML=qo,Cn=o(),He=l("header"),He.innerHTML=bo,pn=o(),ge=l("p"),ge.textContent=wo,_n=o(),S=l("ul"),E=l("li"),Dt=l("code"),mn=c(ko),xn=c(` or
+ `),Ot=l("code"),En=c(Do),Ln=o(),Te=l("ul"),Te.innerHTML=Oo,yn=o(),L=l("li"),Pt=l("code"),Hn=c(Po),gn=c(` or
+ `),Ut=l("code"),Tn=c(Uo),Mn=o(),It=l("ul"),v=l("li"),qn=c("(Search for a JSON encoded value (like "),Me=l("code"),Me.textContent=Io,bn=c(`,
+ `),qe=l("code"),qe.textContent=Ao,wn=c(`,
+ `),be=l("code"),be.textContent=Ro,kn=c(", or "),At=l("code"),Dn=c(So),On=c(").)"),Pn=o(),we=l("header"),we.innerHTML=jo,Un=o(),ke=l("p"),ke.textContent=No,In=o(),De=l("ul"),De.innerHTML=$o,An=o(),Oe=l("header"),Oe.innerHTML=zo,Rn=o(),Pe=l("p"),Pe.textContent=Jo,Sn=o(),Ue=l("ul"),Ue.innerHTML=Bo,jn=o(),Ie=l("header"),Ie.innerHTML=Fo,Nn=o(),Ae=l("p"),Ae.textContent=Qo,$n=o(),Re=l("ul"),Re.innerHTML=Yo,zn=o(),Se=l("header"),Se.innerHTML=Xo,Jn=o(),je=l("p"),je.textContent=Go,Bn=o(),Ne=l("ul"),Ne.innerHTML=Ko,Fn=o(),$e=l("header"),$e.innerHTML=Vo,Qn=o(),ze=l("p"),ze.textContent=Wo,Yn=o(),y=l("ul"),Rt=l("li"),St=l("code"),Xn=c(Zo),Gn=o(),j=l("li"),jt=l("code"),Kn=c(er),Vn=o(),Je=l("ul"),Je.innerHTML=tr,Wn=o(),N=l("li"),Nt=l("code"),Zn=c(lr),ea=o(),Be=l("ul"),Be.innerHTML=nr,ta=o(),Fe=l("header"),Fe.innerHTML=ar,la=o(),Qe=l("p"),Qe.textContent=or,na=o(),H=l("ul"),$t=l("li"),zt=l("code"),aa=c(rr),oa=o(),$=l("li"),Jt=l("code"),ra=c(ir),ia=o(),Ye=l("ul"),Ye.innerHTML=sr,sa=o(),z=l("li"),Bt=l("code"),da=c(dr),ca=o(),Xe=l("ul"),Xe.innerHTML=cr,ua=o(),Ge=l("header"),Ge.innerHTML=ur,ha=o(),Ke=l("p"),Ke.textContent=hr,va=o(),g=l("ul"),Ft=l("li"),Qt=l("code"),fa=c(vr),Ca=o(),J=l("li"),Yt=l("code"),pa=c(fr),_a=o(),Ve=l("ul"),Ve.innerHTML=Cr,ma=o(),B=l("li"),Xt=l("code"),xa=c(pr),Ea=o(),We=l("ul"),We.innerHTML=_r,La=o(),Ze=l("header"),Ze.innerHTML=mr,ya=o(),et=l("p"),et.textContent=xr,Ha=o(),T=l("ul"),Gt=l("li"),Kt=l("code"),ga=c(Er),Ta=o(),F=l("li"),Vt=l("code"),Ma=c(Lr),qa=o(),tt=l("ul"),tt.innerHTML=yr,ba=o(),Q=l("li"),Wt=l("code"),wa=c(Hr),ka=o(),lt=l("ul"),lt.innerHTML=gr,Da=o(),Y=l("header"),Y.innerHTML=Tr,Oa=o(),nt=l("p"),nt.textContent=Mr,Pa=o(),at=l("p"),at.textContent=qr,Ua=o(),Zt=l("pre"),Ia=c(br),Aa=o(),X=l("header"),X.innerHTML=wr,Ra=o(),ot=l("p"),ot.innerHTML=kr,Sa=o(),G=l("header"),G.innerHTML=Dr,ja=o(),rt=l("p"),rt.innerHTML=Or,this.h()},l(f){const el=bi("svelte-18iv594",document.head);q=wi(el,!1),pt=pi(),el.forEach(s),tl=r(f),t=n(f,"SECTION",{});var a=d(t);b=n(a,"HEADER",{class:!0,"data-svelte-h":!0}),i(b)!=="svelte-ilghid"&&(b.innerHTML=Na),Cl=r(a),K=n(a,"P",{"data-svelte-h":!0}),i(K)!=="svelte-1u54ey9"&&(K.textContent=$a),pl=r(a),w=n(a,"HEADER",{class:!0,"data-svelte-h":!0}),i(w)!=="svelte-1hx9pnb"&&(w.innerHTML=za),_l=r(a),xi(k.$$.fragment,a),ml=r(a),D=n(a,"HEADER",{class:!0,"data-svelte-h":!0}),i(D)!=="svelte-n87w0o"&&(D.innerHTML=Ja),xl=r(a),V=n(a,"P",{"data-svelte-h":!0}),i(V)!=="svelte-d576tz"&&(V.innerHTML=Ba),El=r(a),xi(O.$$.fragment,a),Ll=r(a),P=n(a,"HEADER",{class:!0,"data-svelte-h":!0}),i(P)!=="svelte-1v13hnh"&&(P.innerHTML=Fa),yl=r(a),W=n(a,"P",{"data-svelte-h":!0}),i(W)!=="svelte-k61ukp"&&(W.textContent=Qa),Hl=r(a),Z=n(a,"UL",{"data-svelte-h":!0}),i(Z)!=="svelte-w3ncnj"&&(Z.innerHTML=Ya),gl=r(a),ee=n(a,"P",{"data-svelte-h":!0}),i(ee)!=="svelte-1vvt3ch"&&(ee.textContent=Xa),Tl=r(a),U=n(a,"HEADER",{class:!0,"data-svelte-h":!0}),i(U)!=="svelte-zyiri5"&&(U.innerHTML=Ga),Ml=r(a),te=n(a,"P",{"data-svelte-h":!0}),i(te)!=="svelte-1bkl19t"&&(te.textContent=Ka),ql=r(a),le=n(a,"HEADER",{"data-svelte-h":!0}),i(le)!=="svelte-1wpx9it"&&(le.innerHTML=Va),bl=r(a),ne=n(a,"P",{"data-svelte-h":!0}),i(ne)!=="svelte-1j94u4c"&&(ne.textContent=Wa),wl=r(a),_=n(a,"UL",{});var it=d(_);ae=n(it,"LI",{"data-svelte-h":!0}),i(ae)!=="svelte-1vnagpw"&&(ae.innerHTML=Za),kl=r(it),oe=n(it,"LI",{"data-svelte-h":!0}),i(oe)!=="svelte-1dirgw6"&&(oe.innerHTML=eo),Dl=r(it),m=n(it,"LI",{});var st=d(m);re=n(st,"CODE",{"data-svelte-h":!0}),i(re)!=="svelte-19pdxk6"&&(re.textContent=to),Ol=u(st," or "),ie=n(st,"CODE",{"data-svelte-h":!0}),i(ie)!=="svelte-3pupn"&&(ie.textContent=lo),Pl=r(st),_t=n(st,"UL",{});var Pr=d(_t);h=n(Pr,"LI",{});var C=d(h);Ul=u(C,"(Match a JSON encoded value (like "),se=n(C,"CODE",{"data-svelte-h":!0}),i(se)!=="svelte-1b4w2dk"&&(se.textContent=no),Il=u(C,", "),de=n(C,"CODE",{"data-svelte-h":!0}),i(de)!=="svelte-1rarbq3"&&(de.textContent=ao),Al=u(C,`,
+ `),ce=n(C,"CODE",{"data-svelte-h":!0}),i(ce)!=="svelte-ntdzrg"&&(ce.textContent=oo),Rl=u(C,", or "),mt=n(C,"CODE",{});var Ur=d(mt);Sl=u(Ur,ro),Ur.forEach(s),jl=u(C,").)"),C.forEach(s),Pr.forEach(s),st.forEach(s),it.forEach(s),Nl=r(a),ue=n(a,"HEADER",{"data-svelte-h":!0}),i(ue)!=="svelte-1v1minp"&&(ue.innerHTML=io),$l=r(a),he=n(a,"P",{"data-svelte-h":!0}),i(he)!=="svelte-1du67hd"&&(he.textContent=so),zl=r(a),xt=n(a,"UL",{});var Ir=d(xt);I=n(Ir,"LI",{});var nl=d(I);Et=n(nl,"CODE",{});var Ar=d(Et);Jl=u(Ar,co),Ar.forEach(s),Bl=u(nl," or "),Lt=n(nl,"CODE",{});var Rr=d(Lt);Fl=u(Rr,uo),Rr.forEach(s),nl.forEach(s),Ir.forEach(s),Ql=r(a),ve=n(a,"HEADER",{"data-svelte-h":!0}),i(ve)!=="svelte-1y925f9"&&(ve.innerHTML=ho),Yl=r(a),fe=n(a,"P",{"data-svelte-h":!0}),i(fe)!=="svelte-681s5m"&&(fe.textContent=vo),Xl=r(a),yt=n(a,"UL",{});var Sr=d(yt);A=n(Sr,"LI",{});var al=d(A);Ht=n(al,"CODE",{});var jr=d(Ht);Gl=u(jr,fo),jr.forEach(s),Kl=u(al," or "),gt=n(al,"CODE",{});var Nr=d(gt);Vl=u(Nr,Co),Nr.forEach(s),al.forEach(s),Sr.forEach(s),Wl=r(a),Ce=n(a,"HEADER",{"data-svelte-h":!0}),i(Ce)!=="svelte-1vzgm5l"&&(Ce.innerHTML=po),Zl=r(a),pe=n(a,"P",{"data-svelte-h":!0}),i(pe)!=="svelte-p4ruy4"&&(pe.textContent=_o),en=r(a),_e=n(a,"UL",{"data-svelte-h":!0}),i(_e)!=="svelte-1dq8v2h"&&(_e.innerHTML=mo),tn=r(a),me=n(a,"HEADER",{"data-svelte-h":!0}),i(me)!=="svelte-181n01z"&&(me.innerHTML=xo),ln=r(a),xe=n(a,"P",{"data-svelte-h":!0}),i(xe)!=="svelte-1m7ce6y"&&(xe.textContent=Eo),nn=r(a),Tt=n(a,"UL",{});var $r=d(Tt);R=n($r,"LI",{});var ol=d(R);Mt=n(ol,"CODE",{});var zr=d(Mt);an=u(zr,Lo),zr.forEach(s),on=u(ol," or "),qt=n(ol,"CODE",{});var Jr=d(qt);rn=u(Jr,yo),Jr.forEach(s),ol.forEach(s),$r.forEach(s),sn=r(a),Ee=n(a,"HEADER",{"data-svelte-h":!0}),i(Ee)!=="svelte-yp3f1"&&(Ee.innerHTML=Ho),dn=r(a),Le=n(a,"P",{"data-svelte-h":!0}),i(Le)!=="svelte-gnya5t"&&(Le.textContent=go),cn=r(a),bt=n(a,"UL",{});var Br=d(bt);x=n(Br,"LI",{});var dt=d(x);wt=n(dt,"CODE",{});var Fr=d(wt);un=u(Fr,To),Fr.forEach(s),hn=u(dt,` or
+ `),kt=n(dt,"CODE",{});var Qr=d(kt);vn=u(Qr,Mo),Qr.forEach(s),fn=r(dt),ye=n(dt,"UL",{"data-svelte-h":!0}),i(ye)!=="svelte-1rnvygs"&&(ye.innerHTML=qo),dt.forEach(s),Br.forEach(s),Cn=r(a),He=n(a,"HEADER",{"data-svelte-h":!0}),i(He)!=="svelte-zaqzad"&&(He.innerHTML=bo),pn=r(a),ge=n(a,"P",{"data-svelte-h":!0}),i(ge)!=="svelte-j3asv6"&&(ge.textContent=wo),_n=r(a),S=n(a,"UL",{});var rl=d(S);E=n(rl,"LI",{});var ct=d(E);Dt=n(ct,"CODE",{});var Yr=d(Dt);mn=u(Yr,ko),Yr.forEach(s),xn=u(ct,` or
+ `),Ot=n(ct,"CODE",{});var Xr=d(Ot);En=u(Xr,Do),Xr.forEach(s),Ln=r(ct),Te=n(ct,"UL",{"data-svelte-h":!0}),i(Te)!=="svelte-2dutyq"&&(Te.innerHTML=Oo),ct.forEach(s),yn=r(rl),L=n(rl,"LI",{});var ut=d(L);Pt=n(ut,"CODE",{});var Gr=d(Pt);Hn=u(Gr,Po),Gr.forEach(s),gn=u(ut,` or
+ `),Ut=n(ut,"CODE",{});var Kr=d(Ut);Tn=u(Kr,Uo),Kr.forEach(s),Mn=r(ut),It=n(ut,"UL",{});var Vr=d(It);v=n(Vr,"LI",{});var p=d(v);qn=u(p,"(Search for a JSON encoded value (like "),Me=n(p,"CODE",{"data-svelte-h":!0}),i(Me)!=="svelte-1b4w2dk"&&(Me.textContent=Io),bn=u(p,`,
+ `),qe=n(p,"CODE",{"data-svelte-h":!0}),i(qe)!=="svelte-1rarbq3"&&(qe.textContent=Ao),wn=u(p,`,
+ `),be=n(p,"CODE",{"data-svelte-h":!0}),i(be)!=="svelte-ntdzrg"&&(be.textContent=Ro),kn=u(p,", or "),At=n(p,"CODE",{});var Wr=d(At);Dn=u(Wr,So),Wr.forEach(s),On=u(p,").)"),p.forEach(s),Vr.forEach(s),ut.forEach(s),rl.forEach(s),Pn=r(a),we=n(a,"HEADER",{"data-svelte-h":!0}),i(we)!=="svelte-bua55r"&&(we.innerHTML=jo),Un=r(a),ke=n(a,"P",{"data-svelte-h":!0}),i(ke)!=="svelte-uwu0uk"&&(ke.textContent=No),In=r(a),De=n(a,"UL",{"data-svelte-h":!0}),i(De)!=="svelte-1ndwe67"&&(De.innerHTML=$o),An=r(a),Oe=n(a,"HEADER",{"data-svelte-h":!0}),i(Oe)!=="svelte-1rhkq09"&&(Oe.innerHTML=zo),Rn=r(a),Pe=n(a,"P",{"data-svelte-h":!0}),i(Pe)!=="svelte-7b6wj1"&&(Pe.textContent=Jo),Sn=r(a),Ue=n(a,"UL",{"data-svelte-h":!0}),i(Ue)!=="svelte-11m7ek5"&&(Ue.innerHTML=Bo),jn=r(a),Ie=n(a,"HEADER",{"data-svelte-h":!0}),i(Ie)!=="svelte-1rqgjcl"&&(Ie.innerHTML=Fo),Nn=r(a),Ae=n(a,"P",{"data-svelte-h":!0}),i(Ae)!=="svelte-1ue8bv6"&&(Ae.textContent=Qo),$n=r(a),Re=n(a,"UL",{"data-svelte-h":!0}),i(Re)!=="svelte-1tly68z"&&(Re.innerHTML=Yo),zn=r(a),Se=n(a,"HEADER",{"data-svelte-h":!0}),i(Se)!=="svelte-btuyo5"&&(Se.innerHTML=Xo),Jn=r(a),je=n(a,"P",{"data-svelte-h":!0}),i(je)!=="svelte-1m62xd1"&&(je.textContent=Go),Bn=r(a),Ne=n(a,"UL",{"data-svelte-h":!0}),i(Ne)!=="svelte-3tcf7p"&&(Ne.innerHTML=Ko),Fn=r(a),$e=n(a,"HEADER",{"data-svelte-h":!0}),i($e)!=="svelte-1565k96"&&($e.innerHTML=Vo),Qn=r(a),ze=n(a,"P",{"data-svelte-h":!0}),i(ze)!=="svelte-1st2fkl"&&(ze.textContent=Wo),Yn=r(a),y=n(a,"UL",{});var ht=d(y);Rt=n(ht,"LI",{});var Zr=d(Rt);St=n(Zr,"CODE",{});var ei=d(St);Xn=u(ei,Zo),ei.forEach(s),Zr.forEach(s),Gn=r(ht),j=n(ht,"LI",{});var il=d(j);jt=n(il,"CODE",{});var ti=d(jt);Kn=u(ti,er),ti.forEach(s),Vn=r(il),Je=n(il,"UL",{"data-svelte-h":!0}),i(Je)!=="svelte-1svbsw1"&&(Je.innerHTML=tr),il.forEach(s),Wn=r(ht),N=n(ht,"LI",{});var sl=d(N);Nt=n(sl,"CODE",{});var li=d(Nt);Zn=u(li,lr),li.forEach(s),ea=r(sl),Be=n(sl,"UL",{"data-svelte-h":!0}),i(Be)!=="svelte-1bn8y3i"&&(Be.innerHTML=nr),sl.forEach(s),ht.forEach(s),ta=r(a),Fe=n(a,"HEADER",{"data-svelte-h":!0}),i(Fe)!=="svelte-ijyrzj"&&(Fe.innerHTML=ar),la=r(a),Qe=n(a,"P",{"data-svelte-h":!0}),i(Qe)!=="svelte-1mrui9r"&&(Qe.textContent=or),na=r(a),H=n(a,"UL",{});var vt=d(H);$t=n(vt,"LI",{});var ni=d($t);zt=n(ni,"CODE",{});var ai=d(zt);aa=u(ai,rr),ai.forEach(s),ni.forEach(s),oa=r(vt),$=n(vt,"LI",{});var dl=d($);Jt=n(dl,"CODE",{});var oi=d(Jt);ra=u(oi,ir),oi.forEach(s),ia=r(dl),Ye=n(dl,"UL",{"data-svelte-h":!0}),i(Ye)!=="svelte-1svbsw1"&&(Ye.innerHTML=sr),dl.forEach(s),sa=r(vt),z=n(vt,"LI",{});var cl=d(z);Bt=n(cl,"CODE",{});var ri=d(Bt);da=u(ri,dr),ri.forEach(s),ca=r(cl),Xe=n(cl,"UL",{"data-svelte-h":!0}),i(Xe)!=="svelte-1bn8y3i"&&(Xe.innerHTML=cr),cl.forEach(s),vt.forEach(s),ua=r(a),Ge=n(a,"HEADER",{"data-svelte-h":!0}),i(Ge)!=="svelte-1qzfhtr"&&(Ge.innerHTML=ur),ha=r(a),Ke=n(a,"P",{"data-svelte-h":!0}),i(Ke)!=="svelte-1oswxdc"&&(Ke.textContent=hr),va=r(a),g=n(a,"UL",{});var ft=d(g);Ft=n(ft,"LI",{});var ii=d(Ft);Qt=n(ii,"CODE",{});var si=d(Qt);fa=u(si,vr),si.forEach(s),ii.forEach(s),Ca=r(ft),J=n(ft,"LI",{});var ul=d(J);Yt=n(ul,"CODE",{});var di=d(Yt);pa=u(di,fr),di.forEach(s),_a=r(ul),Ve=n(ul,"UL",{"data-svelte-h":!0}),i(Ve)!=="svelte-1svbsw1"&&(Ve.innerHTML=Cr),ul.forEach(s),ma=r(ft),B=n(ft,"LI",{});var hl=d(B);Xt=n(hl,"CODE",{});var ci=d(Xt);xa=u(ci,pr),ci.forEach(s),Ea=r(hl),We=n(hl,"UL",{"data-svelte-h":!0}),i(We)!=="svelte-1bn8y3i"&&(We.innerHTML=_r),hl.forEach(s),ft.forEach(s),La=r(a),Ze=n(a,"HEADER",{"data-svelte-h":!0}),i(Ze)!=="svelte-1o8n18a"&&(Ze.innerHTML=mr),ya=r(a),et=n(a,"P",{"data-svelte-h":!0}),i(et)!=="svelte-p4b7pu"&&(et.textContent=xr),Ha=r(a),T=n(a,"UL",{});var Ct=d(T);Gt=n(Ct,"LI",{});var ui=d(Gt);Kt=n(ui,"CODE",{});var hi=d(Kt);ga=u(hi,Er),hi.forEach(s),ui.forEach(s),Ta=r(Ct),F=n(Ct,"LI",{});var vl=d(F);Vt=n(vl,"CODE",{});var vi=d(Vt);Ma=u(vi,Lr),vi.forEach(s),qa=r(vl),tt=n(vl,"UL",{"data-svelte-h":!0}),i(tt)!=="svelte-1svbsw1"&&(tt.innerHTML=yr),vl.forEach(s),ba=r(Ct),Q=n(Ct,"LI",{});var fl=d(Q);Wt=n(fl,"CODE",{});var fi=d(Wt);wa=u(fi,Hr),fi.forEach(s),ka=r(fl),lt=n(fl,"UL",{"data-svelte-h":!0}),i(lt)!=="svelte-1bn8y3i"&&(lt.innerHTML=gr),fl.forEach(s),Ct.forEach(s),Da=r(a),Y=n(a,"HEADER",{class:!0,"data-svelte-h":!0}),i(Y)!=="svelte-o2bzkl"&&(Y.innerHTML=Tr),Oa=r(a),nt=n(a,"P",{"data-svelte-h":!0}),i(nt)!=="svelte-1ego8n1"&&(nt.textContent=Mr),Pa=r(a),at=n(a,"P",{"data-svelte-h":!0}),i(at)!=="svelte-jrvukd"&&(at.textContent=qr),Ua=r(a),Zt=n(a,"PRE",{});var Ci=d(Zt);Ia=u(Ci,br),Ci.forEach(s),Aa=r(a),X=n(a,"HEADER",{class:!0,"data-svelte-h":!0}),i(X)!=="svelte-1o84pgh"&&(X.innerHTML=wr),Ra=r(a),ot=n(a,"P",{"data-svelte-h":!0}),i(ot)!=="svelte-6nx9nn"&&(ot.innerHTML=kr),Sa=r(a),G=n(a,"HEADER",{class:!0,"data-svelte-h":!0}),i(G)!=="svelte-g58mlz"&&(G.innerHTML=Dr),ja=r(a),rt=n(a,"P",{"data-svelte-h":!0}),i(rt)!=="svelte-15xz686"&&(rt.innerHTML=Or),a.forEach(s),this.h()},h(){document.title="Query Parser - Packages - Nymph.js",q.a=pt,M(b,"class","major"),M(w,"class","major"),M(D,"class","major"),M(P,"class","major"),M(U,"class","major"),M(Y,"class","major"),M(X,"class","major"),M(G,"class","major")},m(f,el){q.m(Pi,document.head),e(document.head,pt),_i(f,tl,el),_i(f,t,el),e(t,b),e(t,Cl),e(t,K),e(t,pl),e(t,w),e(t,_l),Ei(k,t,null),e(t,ml),e(t,D),e(t,xl),e(t,V),e(t,El),Ei(O,t,null),e(t,Ll),e(t,P),e(t,yl),e(t,W),e(t,Hl),e(t,Z),e(t,gl),e(t,ee),e(t,Tl),e(t,U),e(t,Ml),e(t,te),e(t,ql),e(t,le),e(t,bl),e(t,ne),e(t,wl),e(t,_),e(_,ae),e(_,kl),e(_,oe),e(_,Dl),e(_,m),e(m,re),e(m,Ol),e(m,ie),e(m,Pl),e(m,_t),e(_t,h),e(h,Ul),e(h,se),e(h,Il),e(h,de),e(h,Al),e(h,ce),e(h,Rl),e(h,mt),e(mt,Sl),e(h,jl),e(t,Nl),e(t,ue),e(t,$l),e(t,he),e(t,zl),e(t,xt),e(xt,I),e(I,Et),e(Et,Jl),e(I,Bl),e(I,Lt),e(Lt,Fl),e(t,Ql),e(t,ve),e(t,Yl),e(t,fe),e(t,Xl),e(t,yt),e(yt,A),e(A,Ht),e(Ht,Gl),e(A,Kl),e(A,gt),e(gt,Vl),e(t,Wl),e(t,Ce),e(t,Zl),e(t,pe),e(t,en),e(t,_e),e(t,tn),e(t,me),e(t,ln),e(t,xe),e(t,nn),e(t,Tt),e(Tt,R),e(R,Mt),e(Mt,an),e(R,on),e(R,qt),e(qt,rn),e(t,sn),e(t,Ee),e(t,dn),e(t,Le),e(t,cn),e(t,bt),e(bt,x),e(x,wt),e(wt,un),e(x,hn),e(x,kt),e(kt,vn),e(x,fn),e(x,ye),e(t,Cn),e(t,He),e(t,pn),e(t,ge),e(t,_n),e(t,S),e(S,E),e(E,Dt),e(Dt,mn),e(E,xn),e(E,Ot),e(Ot,En),e(E,Ln),e(E,Te),e(S,yn),e(S,L),e(L,Pt),e(Pt,Hn),e(L,gn),e(L,Ut),e(Ut,Tn),e(L,Mn),e(L,It),e(It,v),e(v,qn),e(v,Me),e(v,bn),e(v,qe),e(v,wn),e(v,be),e(v,kn),e(v,At),e(At,Dn),e(v,On),e(t,Pn),e(t,we),e(t,Un),e(t,ke),e(t,In),e(t,De),e(t,An),e(t,Oe),e(t,Rn),e(t,Pe),e(t,Sn),e(t,Ue),e(t,jn),e(t,Ie),e(t,Nn),e(t,Ae),e(t,$n),e(t,Re),e(t,zn),e(t,Se),e(t,Jn),e(t,je),e(t,Bn),e(t,Ne),e(t,Fn),e(t,$e),e(t,Qn),e(t,ze),e(t,Yn),e(t,y),e(y,Rt),e(Rt,St),e(St,Xn),e(y,Gn),e(y,j),e(j,jt),e(jt,Kn),e(j,Vn),e(j,Je),e(y,Wn),e(y,N),e(N,Nt),e(Nt,Zn),e(N,ea),e(N,Be),e(t,ta),e(t,Fe),e(t,la),e(t,Qe),e(t,na),e(t,H),e(H,$t),e($t,zt),e(zt,aa),e(H,oa),e(H,$),e($,Jt),e(Jt,ra),e($,ia),e($,Ye),e(H,sa),e(H,z),e(z,Bt),e(Bt,da),e(z,ca),e(z,Xe),e(t,ua),e(t,Ge),e(t,ha),e(t,Ke),e(t,va),e(t,g),e(g,Ft),e(Ft,Qt),e(Qt,fa),e(g,Ca),e(g,J),e(J,Yt),e(Yt,pa),e(J,_a),e(J,Ve),e(g,ma),e(g,B),e(B,Xt),e(Xt,xa),e(B,Ea),e(B,We),e(t,La),e(t,Ze),e(t,ya),e(t,et),e(t,Ha),e(t,T),e(T,Gt),e(Gt,Kt),e(Kt,ga),e(T,Ta),e(T,F),e(F,Vt),e(Vt,Ma),e(F,qa),e(F,tt),e(T,ba),e(T,Q),e(Q,Wt),e(Wt,wa),e(Q,ka),e(Q,lt),e(t,Da),e(t,Y),e(t,Oa),e(t,nt),e(t,Pa),e(t,at),e(t,Ua),e(t,Zt),e(Zt,Ia),e(t,Aa),e(t,X),e(t,Ra),e(t,ot),e(t,Sa),e(t,G),e(t,ja),e(t,rt),ll=!0},p:ki,i(f){ll||(Li(k.$$.fragment,f),Li(O.$$.fragment,f),ll=!0)},o(f){yi(k.$$.fragment,f),yi(O.$$.fragment,f),ll=!1},d(f){f&&(q.d(),s(tl),s(t)),s(pt),Hi(k),Hi(O)}}}class zi extends Di{constructor(q){super(),Oi(this,q,null,Ai,Mi,{})}}export{zi as component};
diff --git a/docs/_app/immutable/nodes/12.5662eea9.js b/docs/_app/immutable/nodes/12.5662eea9.js
deleted file mode 100644
index a66250d..0000000
--- a/docs/_app/immutable/nodes/12.5662eea9.js
+++ /dev/null
@@ -1,120 +0,0 @@
-import{S as be,i as Re,s as je,R as Me,e as xe,a as l,k as a,q as p,y as k,F as De,T as He,h as n,c as h,l as o,m as i,r as m,z as I,p as Ae,n as ue,C as e,b as Ce,A as U,D as Pe,g as q,d as L,B as Q}from"../chunks/index.d7cc8d8b.js";import{H as F,g as ke}from"../chunks/github.df9008b1.js";import{b as Ie}from"../chunks/bash.2b754df6.js";import{t as ye}from"../chunks/typescript.7dd1ec19.js";function Ue(Ne){let u,$,D,t,E,w,O,Y,T,z,X,_,x,B,G,y,J,S,C,K,V,N,W,Z,d,ee,b,te,re,c,se,R,ne,ae,oe,f,ie,v,le,j,pe,he,me,g,H;return y=new F({props:{language:Ie,code:"npm install --save @nymphjs/server"}}),d=new F({props:{language:ye,code:`import express from 'express';
-import { Nymph } from '@nymphjs/nymph';
-import SQLite3Driver from '@nymphjs/driver-sqlite3';
-import createServer from '@nymphjs/server';
-
-// Import all the entities you will be using on the server.
-import MyEntityClass from './entities/MyEntity';
-
-// Configure Nymph.
-const nymph = new Nymph(
- {},
- new SQLite3Driver({
- filename: ':memory:',
- }),
-);
-const MyEntity = nymph.addEntityClass(MyEntityClass);
-
-// Create your Express app.
-const app = express();
-
-// Create and use the REST server (with an optional path).
-app.use('/rest', createServer(nymph));
-
-// Do anything else you need to do...
-
-// Start your server.
-app.listen(80);`}}),f=new F({props:{language:ye,code:`import { Nymph } from '@nymphjs/client';
-
-import MyEntityClass from './entities/MyEntityClient';
-
-const nymph = new Nymph({
- // You should configure your Express server to
- // use HTTPS, but you don't have to.
- restUrl: 'https://mydomain.tld/rest',
-});
-const MyEntity = nymph.addEntityClass(MyEntityClass);`}}),g=new F({props:{language:ye,code:`import express from 'express';
-import { Nymph } from '@nymphjs/nymph';
-import SQLite3Driver from '@nymphjs/driver-sqlite3';
-import { Tilmeld } from '@nymphjs/tilmeld';
-import createServer from '@nymphjs/server';
-import setup from '@nymphjs/tilmeld-setup';
-
-// Import all the entities you will be using on the server.
-import MyEntityClass from './entities/MyEntity';
-
-// Consfigure Tilmeld.
-const tilmeld = new Tilmeld({
- appName: 'My Awesome App',
- appUrl: 'https://mydomain.tld',
- setupPath: '/user',
-});
-
-// Configure Nymph.
-const nymph = new Nymph(
- {},
- new SQLite3Driver({
- filename: ':memory:',
- }),
- tilmeld,
-);
-const MyEntity = nymph.addEntityClass(MyEntityClass);
-
-// Create your Express app.
-const app = express();
-
-// Authenticate the user manually.
-app.use('/rest', async (request, response, next) => {
- const { User } = tilmeld;
-
- try {
- // Somehow authenticate the user...
- const user = await User.factoryUsername(username);
-
- if (user.guid != null && user.enabled) {
- response.locals.user = user;
- }
-
- next();
- } catch (e: any) {
- response.status(500);
- response.send('Internal server error.');
- }
-});
-
-// Create and use the REST server (with an optional path).
-app.use('/rest', createServer(nymph));
-
-// Create Tilmeld setup app.
-app.user(
- '/user',
- setup(
- {
- restUrl: 'https://mydomain.tld/rest',
- },
- nymph,
- ),
-);
-
-// Do anything else you need to do...
-
-// Start your server.
-app.listen(80);`}}),{c(){u=new Me(!1),$=xe(),D=l(),t=a("section"),E=a("header"),w=a("h1"),O=p("REST Server"),Y=l(),T=a("p"),z=p(`The REST server lets you configure an endpoint for the Nymph client to query
- and push data to. The server provides this endpoint as an Express
- middleware, which can be used in a new or existing Express (or compatible)
- server.`),X=l(),_=a("header"),x=a("h2"),B=p("Installation"),G=l(),k(y.$$.fragment),J=l(),S=a("header"),C=a("h2"),K=p("Usage"),V=l(),N=a("p"),W=p(`You need to install Express, Nymph, and a Nymph driver, then you can use the
- REST server with an optional path. For this example, I'll use the SQLite3
- driver with an in-memory database.`),Z=l(),k(d.$$.fragment),ee=l(),b=a("p"),te=p(`You will need to import any entities you use on the server, so they are
- available to Nymph.`),re=l(),c=a("p"),se=p("Now you can configure your "),R=a("strong"),ne=p("client"),ae=p(`, using your server's
- address (and the optional path, if set).`),oe=l(),k(f.$$.fragment),ie=l(),v=a("p"),le=p(`The REST server will authenticate for you using the Tilmeld auth cookie and
- XSRF token, but if you need to, you can authenticate in some other way (like
- OAuth2), and place the user in `),j=a("code"),pe=p("response.locals.user"),he=p("."),me=l(),k(g.$$.fragment),this.h()},l(s){const M=De("svelte-vfb9fs",document.head);u=He(M,!1),$=xe(),M.forEach(n),D=h(s),t=o(s,"SECTION",{});var r=i(t);E=o(r,"HEADER",{class:!0});var de=i(E);w=o(de,"H1",{style:!0});var ce=i(w);O=m(ce,"REST Server"),ce.forEach(n),de.forEach(n),Y=h(r),T=o(r,"P",{});var fe=i(T);z=m(fe,`The REST server lets you configure an endpoint for the Nymph client to query
- and push data to. The server provides this endpoint as an Express
- middleware, which can be used in a new or existing Express (or compatible)
- server.`),fe.forEach(n),X=h(r),_=o(r,"HEADER",{class:!0});var ve=i(_);x=o(ve,"H2",{});var ge=i(x);B=m(ge,"Installation"),ge.forEach(n),ve.forEach(n),G=h(r),I(y.$$.fragment,r),J=h(r),S=o(r,"HEADER",{class:!0});var Ee=i(S);C=o(Ee,"H2",{});var we=i(C);K=m(we,"Usage"),we.forEach(n),Ee.forEach(n),V=h(r),N=o(r,"P",{});var _e=i(N);W=m(_e,`You need to install Express, Nymph, and a Nymph driver, then you can use the
- REST server with an optional path. For this example, I'll use the SQLite3
- driver with an in-memory database.`),_e.forEach(n),Z=h(r),I(d.$$.fragment,r),ee=h(r),b=o(r,"P",{});var Se=i(b);te=m(Se,`You will need to import any entities you use on the server, so they are
- available to Nymph.`),Se.forEach(n),re=h(r),c=o(r,"P",{});var A=i(c);se=m(A,"Now you can configure your "),R=o(A,"STRONG",{});var $e=i(R);ne=m($e,"client"),$e.forEach(n),ae=m(A,`, using your server's
- address (and the optional path, if set).`),A.forEach(n),oe=h(r),I(f.$$.fragment,r),ie=h(r),v=o(r,"P",{});var P=i(v);le=m(P,`The REST server will authenticate for you using the Tilmeld auth cookie and
- XSRF token, but if you need to, you can authenticate in some other way (like
- OAuth2), and place the user in `),j=o(P,"CODE",{});var Te=i(j);pe=m(Te,"response.locals.user"),Te.forEach(n),he=m(P,"."),P.forEach(n),me=h(r),I(g.$$.fragment,r),r.forEach(n),this.h()},h(){document.title="REST Server - Packages - Nymph.js",u.a=$,Ae(w,"font-size","3em"),ue(E,"class","major"),ue(_,"class","major"),ue(S,"class","major")},m(s,M){u.m(ke,document.head),e(document.head,$),Ce(s,D,M),Ce(s,t,M),e(t,E),e(E,w),e(w,O),e(t,Y),e(t,T),e(T,z),e(t,X),e(t,_),e(_,x),e(x,B),e(t,G),U(y,t,null),e(t,J),e(t,S),e(S,C),e(C,K),e(t,V),e(t,N),e(N,W),e(t,Z),U(d,t,null),e(t,ee),e(t,b),e(b,te),e(t,re),e(t,c),e(c,se),e(c,R),e(R,ne),e(c,ae),e(t,oe),U(f,t,null),e(t,ie),e(t,v),e(v,le),e(v,j),e(j,pe),e(v,he),e(t,me),U(g,t,null),H=!0},p:Pe,i(s){H||(q(y.$$.fragment,s),q(d.$$.fragment,s),q(f.$$.fragment,s),q(g.$$.fragment,s),H=!0)},o(s){L(y.$$.fragment,s),L(d.$$.fragment,s),L(f.$$.fragment,s),L(g.$$.fragment,s),H=!1},d(s){n($),s&&u.d(),s&&n(D),s&&n(t),Q(y),Q(d),Q(f),Q(g)}}}class Oe extends be{constructor(u){super(),Re(this,u,null,Ue,je,{})}}export{Oe as component};
diff --git a/docs/_app/immutable/nodes/12.b900fcff.js b/docs/_app/immutable/nodes/12.b900fcff.js
new file mode 100644
index 0000000..5e34b02
--- /dev/null
+++ b/docs/_app/immutable/nodes/12.b900fcff.js
@@ -0,0 +1,111 @@
+import{s as re,I as ae,e as te,a as r,f as o,x as oe,J as ie,d as T,c as a,g as i,h as le,r as l,j as O,u as n,i as ne,v as pe}from"../chunks/scheduler.d7e45cc8.js";import{S as me,i as he,b as M,d as H,m as b,a as N,t as j,e as L}from"../chunks/index.77720afb.js";import{H as R,g as ue}from"../chunks/github.64534d2c.js";import{b as ye}from"../chunks/bash.7e4226ac.js";import{t as J}from"../chunks/typescript.09c48802.js";function de(se){let p,$,_,e,m,X='response.locals.user.`,F,f,S;return u=new R({props:{language:ye,code:"npm install --save @nymphjs/server"}}),d=new R({props:{language:J,code:`import express from 'express';
+import { Nymph } from '@nymphjs/nymph';
+import SQLite3Driver from '@nymphjs/driver-sqlite3';
+import createServer from '@nymphjs/server';
+
+// Import all the entities you will be using on the server.
+import MyEntityClass from './entities/MyEntity';
+
+// Configure Nymph.
+const nymph = new Nymph(
+ {},
+ new SQLite3Driver({
+ filename: ':memory:',
+ }),
+);
+const MyEntity = nymph.addEntityClass(MyEntityClass);
+
+// Create your Express app.
+const app = express();
+
+// Create and use the REST server (with an optional path).
+app.use('/rest', createServer(nymph));
+
+// Do anything else you need to do...
+
+// Start your server.
+app.listen(80);`}}),c=new R({props:{language:J,code:`import { Nymph } from '@nymphjs/client';
+
+import MyEntityClass from './entities/MyEntityClient';
+
+const nymph = new Nymph({
+ // You should configure your Express server to
+ // use HTTPS, but you don't have to.
+ restUrl: 'https://mydomain.tld/rest',
+});
+const MyEntity = nymph.addEntityClass(MyEntityClass);`}}),f=new R({props:{language:J,code:`import express from 'express';
+import { Nymph } from '@nymphjs/nymph';
+import SQLite3Driver from '@nymphjs/driver-sqlite3';
+import { Tilmeld } from '@nymphjs/tilmeld';
+import createServer from '@nymphjs/server';
+import setup from '@nymphjs/tilmeld-setup';
+
+// Import all the entities you will be using on the server.
+import MyEntityClass from './entities/MyEntity';
+
+// Consfigure Tilmeld.
+const tilmeld = new Tilmeld({
+ appName: 'My Awesome App',
+ appUrl: 'https://mydomain.tld',
+ setupPath: '/user',
+});
+
+// Configure Nymph.
+const nymph = new Nymph(
+ {},
+ new SQLite3Driver({
+ filename: ':memory:',
+ }),
+ tilmeld,
+);
+const MyEntity = nymph.addEntityClass(MyEntityClass);
+
+// Create your Express app.
+const app = express();
+
+// Authenticate the user manually.
+app.use('/rest', async (request, response, next) => {
+ const { User } = tilmeld;
+
+ try {
+ // Somehow authenticate the user...
+ const user = await User.factoryUsername(username);
+
+ if (user.guid != null && user.enabled) {
+ response.locals.user = user;
+ }
+
+ next();
+ } catch (e: any) {
+ response.status(500);
+ response.send('Internal server error.');
+ }
+});
+
+// Create and use the REST server (with an optional path).
+app.use('/rest', createServer(nymph));
+
+// Create Tilmeld setup app.
+app.user(
+ '/user',
+ setup(
+ {
+ restUrl: 'https://mydomain.tld/rest',
+ },
+ nymph,
+ ),
+);
+
+// Do anything else you need to do...
+
+// Start your server.
+app.listen(80);`}}),{c(){p=new ae(!1),$=te(),_=r(),e=o("section"),m=o("header"),m.innerHTML=X,D=r(),g=o("p"),g.textContent=B,P=r(),h=o("header"),h.innerHTML=G,A=r(),M(u.$$.fragment),I=r(),y=o("header"),y.innerHTML=K,U=r(),v=o("p"),v.textContent=V,q=r(),M(d.$$.fragment),Q=r(),E=o("p"),E.textContent=W,k=r(),x=o("p"),x.innerHTML=Z,Y=r(),M(c.$$.fragment),z=r(),C=o("p"),C.innerHTML=ee,F=r(),M(f.$$.fragment),this.h()},l(s){const w=oe("svelte-vfb9fs",document.head);p=ie(w,!1),$=te(),w.forEach(T),_=a(s),e=i(s,"SECTION",{});var t=le(e);m=i(t,"HEADER",{class:!0,"data-svelte-h":!0}),l(m)!=="svelte-n2t05f"&&(m.innerHTML=X),D=a(t),g=i(t,"P",{"data-svelte-h":!0}),l(g)!=="svelte-1t43z4b"&&(g.textContent=B),P=a(t),h=i(t,"HEADER",{class:!0,"data-svelte-h":!0}),l(h)!=="svelte-1hx9pnb"&&(h.innerHTML=G),A=a(t),H(u.$$.fragment,t),I=a(t),y=i(t,"HEADER",{class:!0,"data-svelte-h":!0}),l(y)!=="svelte-n87w0o"&&(y.innerHTML=K),U=a(t),v=i(t,"P",{"data-svelte-h":!0}),l(v)!=="svelte-5fapv"&&(v.textContent=V),q=a(t),H(d.$$.fragment,t),Q=a(t),E=i(t,"P",{"data-svelte-h":!0}),l(E)!=="svelte-ihx1p9"&&(E.textContent=W),k=a(t),x=i(t,"P",{"data-svelte-h":!0}),l(x)!=="svelte-5wdfo3"&&(x.innerHTML=Z),Y=a(t),H(c.$$.fragment,t),z=a(t),C=i(t,"P",{"data-svelte-h":!0}),l(C)!=="svelte-1f1uhip"&&(C.innerHTML=ee),F=a(t),H(f.$$.fragment,t),t.forEach(T),this.h()},h(){document.title="REST Server - Packages - Nymph.js",p.a=$,O(m,"class","major"),O(h,"class","major"),O(y,"class","major")},m(s,w){p.m(ue,document.head),n(document.head,$),ne(s,_,w),ne(s,e,w),n(e,m),n(e,D),n(e,g),n(e,P),n(e,h),n(e,A),b(u,e,null),n(e,I),n(e,y),n(e,U),n(e,v),n(e,q),b(d,e,null),n(e,Q),n(e,E),n(e,k),n(e,x),n(e,Y),b(c,e,null),n(e,z),n(e,C),n(e,F),b(f,e,null),S=!0},p:pe,i(s){S||(N(u.$$.fragment,s),N(d.$$.fragment,s),N(c.$$.fragment,s),N(f.$$.fragment,s),S=!0)},o(s){j(u.$$.fragment,s),j(d.$$.fragment,s),j(c.$$.fragment,s),j(f.$$.fragment,s),S=!1},d(s){s&&(p.d(),T(_),T(e)),T($),L(u),L(d),L(c),L(f)}}}class xe extends me{constructor(p){super(),he(this,p,null,de,re,{})}}export{xe as component};
diff --git a/docs/_app/immutable/nodes/13.f8c5ad83.js b/docs/_app/immutable/nodes/13.f8c5ad83.js
new file mode 100644
index 0000000..5c1ceb0
--- /dev/null
+++ b/docs/_app/immutable/nodes/13.f8c5ad83.js
@@ -0,0 +1,72 @@
+import{s as J,I as Y,e as O,a as m,f as d,x as B,J as G,d as _,c as p,g as y,h as K,r as b,j as S,u as s,i as A,v as Q}from"../chunks/scheduler.d7e45cc8.js";import{S as V,i as W,b as D,d as F,m as I,a as R,t as U,e as k}from"../chunks/index.77720afb.js";import{H as q,g as X}from"../chunks/github.64534d2c.js";import{b as Z}from"../chunks/bash.7e4226ac.js";import{t as ee}from"../chunks/typescript.09c48802.js";function te(z){let r,u,w,e,n,T='system/admin - A user with this ability has
+ all abilities.tilmeld/admin - Allow the user to manage and edit other user's
+ account and group information and grant/revoke abilities.tilmeld/switch - Allow the user to switch to other users (log
+ in as them without their password).uid/get/[name] - Allow the user to read the named UID.uid/new/[name] - Allow the user to read, create, and increment
+ the named UID.uid/set/[name] - Allow the user to read, create, increment, set,
+ and delete the named UID.dist, or TS source in src.",b,p,S="User and
+ Group
+ entities. It also contains helpers, login,
+ register, and checkUsername.`,w,_,A=`Once you've initialized Nymph Client, set the User and Group classes on it.
+ Then initialize the new User class with the Nymph instance. (This allows the
+ class to set up authentication listeners.)`,N,u,P,v,R=`If you're running more than one instance of Nymph client, be sure to use the
+ classes returned by addEntityClass, so as not to accidentally
+ submit entities from one instances to another instance.`,$;return d=new W({props:{language:ie,code:"npm install --save @nymphjs/tilmeld-client"}}),u=new W({props:{language:ce,code:`import { Nymph } from '@nymphjs/client';
+import {
+ User as UserClass,
+ Group as GroupClass,
+} from '@nymphjs/tilmeld-client';
+
+const nymph = new Nymph({
+ restUrl: 'https://yournymphrestserver/path/to/your/endpoint',
+});
+const User = nymph.addEntityClass(UserClass);
+const Group = nymph.addEntityClass(GroupClass);
+User.init(nymph);`}}),{c(){c=new ee(!1),C=O(),x=a(),e=o("section"),h=o("header"),h.innerHTML=I,M=a(),f=o("p"),f.textContent=q,E=a(),m=o("header"),m.innerHTML=z,L=a(),Y(d.$$.fragment),U=a(),g=o("p"),g.innerHTML=D,b=a(),p=o("header"),p.innerHTML=S,j=a(),y=o("p"),y.innerHTML=k,w=a(),_=o("p"),_.textContent=A,N=a(),Y(u.$$.fragment),P=a(),v=o("p"),v.innerHTML=R,this.h()},l(s){const T=te("svelte-1baconj",document.head);c=ne(T,!1),C=O(),T.forEach(H),x=l(s),e=r(s,"SECTION",{});var t=se(e);h=r(t,"HEADER",{class:!0,"data-svelte-h":!0}),i(h)!=="svelte-isekeu"&&(h.innerHTML=I),M=l(t),f=r(t,"P",{"data-svelte-h":!0}),i(f)!=="svelte-13mrlh4"&&(f.textContent=q),E=l(t),m=r(t,"HEADER",{class:!0,"data-svelte-h":!0}),i(m)!=="svelte-1hx9pnb"&&(m.innerHTML=z),L=l(t),B(d.$$.fragment,t),U=l(t),g=r(t,"P",{"data-svelte-h":!0}),i(g)!=="svelte-h28vnv"&&(g.innerHTML=D),b=l(t),p=r(t,"HEADER",{class:!0,"data-svelte-h":!0}),i(p)!=="svelte-n87w0o"&&(p.innerHTML=S),j=l(t),y=r(t,"P",{"data-svelte-h":!0}),i(y)!=="svelte-g39yzf"&&(y.innerHTML=k),w=l(t),_=r(t,"P",{"data-svelte-h":!0}),i(_)!=="svelte-1f69b11"&&(_.textContent=A),N=l(t),B(u.$$.fragment,t),P=l(t),v=r(t,"P",{"data-svelte-h":!0}),i(v)!=="svelte-qtqrq3"&&(v.innerHTML=R),t.forEach(H),this.h()},h(){document.title="Tilmeld Client - Packages - Nymph.js",c.a=C,G(h,"class","major"),G(m,"class","major"),G(p,"class","major")},m(s,T){c.m(re,document.head),n(document.head,C),J(s,x,T),J(s,e,T),n(e,h),n(e,M),n(e,f),n(e,E),n(e,m),n(e,L),F(d,e,null),n(e,U),n(e,g),n(e,b),n(e,p),n(e,j),n(e,y),n(e,w),n(e,_),n(e,N),F(u,e,null),n(e,P),n(e,v),$=!0},p:ae,i(s){$||(K(d.$$.fragment,s),K(u.$$.fragment,s),$=!0)},o(s){Q(d.$$.fragment,s),Q(u.$$.fragment,s),$=!1},d(s){s&&(c.d(),H(x),H(e)),H(C),V(d),V(u)}}}class ge extends le{constructor(c){super(),oe(this,c,null,he,Z,{})}}export{ge as component};
diff --git a/docs/_app/immutable/nodes/16.d3ee0c7c.js b/docs/_app/immutable/nodes/16.d3ee0c7c.js
deleted file mode 100644
index ba7b680..0000000
--- a/docs/_app/immutable/nodes/16.d3ee0c7c.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import{S as ae,i as ne,s as oe,R as se,e as Z,a as S,k as s,q as d,y as re,F as le,T as he,h as a,c as T,l as r,m as l,r as c,z as de,p as ce,n as f,C as e,b as ee,A as ie,D as me,g as pe,d as ue,B as fe}from"../chunks/index.d7cc8d8b.js";import{H as _e,g as ge}from"../chunks/github.df9008b1.js";import{b as ve}from"../chunks/bash.2b754df6.js";function ye(te){let i,H,j,t,_,g,w,A,h,U,m,x,D,p,M,P,R,v,I,q,z,u,N,y,b,Y,B,C,F,k;return u=new _e({props:{language:ve,code:"npm install --save @nymphjs/tilmeld-components"}}),{c(){i=new se(!1),H=Z(),j=S(),t=s("section"),_=s("header"),g=s("h1"),w=d("Tilmeld Components"),A=S(),h=s("p"),U=d(`The Tilmeld Components are front end registration/login, account recovery,
- account details, and password change components built with `),m=s("a"),x=d("Svelte"),D=d(`
- and `),p=s("a"),M=d("SMUI"),P=d("."),R=S(),v=s("header"),I=s("h2"),q=d("Installation"),z=S(),re(u.$$.fragment),N=S(),y=s("header"),b=s("h2"),Y=d("Usage"),B=S(),C=s("p"),F=d(`You need to have an SMUI theme compiled and installed on your front end app.
- If you're using Svelte, you need to have TypeScript support and you should
- use the 'svelte' mainfield from package.json.`),this.h()},l(n){const $=le("svelte-n3h9ha",document.head);i=he($,!1),H=Z(),$.forEach(a),j=T(n),t=r(n,"SECTION",{});var o=l(t);_=r(o,"HEADER",{class:!0});var O=l(_);g=r(O,"H1",{style:!0});var G=l(g);w=c(G,"Tilmeld Components"),G.forEach(a),O.forEach(a),A=T(o),h=r(o,"P",{});var E=l(h);U=c(E,`The Tilmeld Components are front end registration/login, account recovery,
- account details, and password change components built with `),m=r(E,"A",{href:!0,target:!0});var J=l(m);x=c(J,"Svelte"),J.forEach(a),D=c(E,`
- and `),p=r(E,"A",{href:!0,target:!0});var K=l(p);M=c(K,"SMUI"),K.forEach(a),P=c(E,"."),E.forEach(a),R=T(o),v=r(o,"HEADER",{class:!0});var L=l(v);I=r(L,"H2",{});var Q=l(I);q=c(Q,"Installation"),Q.forEach(a),L.forEach(a),z=T(o),de(u.$$.fragment,o),N=T(o),y=r(o,"HEADER",{class:!0});var V=l(y);b=r(V,"H2",{});var W=l(b);Y=c(W,"Usage"),W.forEach(a),V.forEach(a),B=T(o),C=r(o,"P",{});var X=l(C);F=c(X,`You need to have an SMUI theme compiled and installed on your front end app.
- If you're using Svelte, you need to have TypeScript support and you should
- use the 'svelte' mainfield from package.json.`),X.forEach(a),o.forEach(a),this.h()},h(){document.title="Tilmeld Components - Packages - Nymph.js",i.a=H,ce(g,"font-size","3em"),f(_,"class","major"),f(m,"href","https://svelte.dev/"),f(m,"target","_blank"),f(p,"href","https://sveltematerialui.com/"),f(p,"target","_blank"),f(v,"class","major"),f(y,"class","major")},m(n,$){i.m(ge,document.head),e(document.head,H),ee(n,j,$),ee(n,t,$),e(t,_),e(_,g),e(g,w),e(t,A),e(t,h),e(h,U),e(h,m),e(m,x),e(h,D),e(h,p),e(p,M),e(h,P),e(t,R),e(t,v),e(v,I),e(I,q),e(t,z),ie(u,t,null),e(t,N),e(t,y),e(y,b),e(b,Y),e(t,B),e(t,C),e(C,F),k=!0},p:me,i(n){k||(pe(u.$$.fragment,n),k=!0)},o(n){ue(u.$$.fragment,n),k=!1},d(n){a(H),n&&i.d(),n&&a(j),n&&a(t),fe(u)}}}class He extends ae{constructor(i){super(),ne(this,i,null,ye,oe,{})}}export{He as component};
diff --git a/docs/_app/immutable/nodes/16.de906698.js b/docs/_app/immutable/nodes/16.de906698.js
new file mode 100644
index 0000000..7eeaf07
--- /dev/null
+++ b/docs/_app/immutable/nodes/16.de906698.js
@@ -0,0 +1,5 @@
+import{s as A,I as D,e as w,a as d,f as c,x as R,J as U,d as g,c as p,g as u,h as N,r as v,j as E,u as n,i as I,v as q}from"../chunks/scheduler.d7e45cc8.js";import{S as z,i as J,b as O,d as Y,m as B,a as F,t as G,e as K}from"../chunks/index.77720afb.js";import{H as Q,g as V}from"../chunks/github.64534d2c.js";import{b as W}from"../chunks/bash.7e4226ac.js";function X(P){let s,f,H,e,l,L='factory
+ static method of an entity's class and pass in an optional GUID. You can also
+ use the factorySync method if you need to create a new entity
+ synchronously. The benefit of using the factory methods is that they can
+ return the correct type in TypeScript. To check that an entity hasn't been
+ saved yet, check that the GUID is null (entity.guid == null).`,Q,g,F,C,ct=`Much like entries in many blogging systems, entities can be organized using
+ tags. The tags provide a fast way to query entities.`,J,f,K,T,dt=`Be cautious when saving an entity in another entity's property. If the
+ referenced entity is newly created and does not have a GUID, Nymph will not
+ be able to retrieve it later. Always save the referenced entity first.`,X,y,m,ht="Saving a Referenced Entity the Right Way",Z,p,tt,v,$,ut="Saving a Referenced Entity the Wrong Way",et,w,nt,P,gt=`Caution: Since the referenced entity's class name is stored in the reference
+ on the parent entity, if you change the class name in an update, you need to
+ reassign all referenced entities of that class and resave.`,at,I,ft=`When an entity is loaded, it does not request its referenced entities from
+ Nymph. Instead, it creates instances without data called "sleeping
+ references". You can use \`$wake\` on the entity or \`$wakeAll\` on the parent
+ entity to get the entity's data from the DB. The $wakeAll
+ method will awaken all sleeping references in the entity's data. You can call
+ $clearCache
+ in Node.js or $refresh in the client to turn all the entities back
+ into sleeping references.`,S,c,_,st,it,x,ot,D;return g=new V({props:{language:W,code:`// BlogPost extends the Entity class.
+let blogPost = await BlogPost.factory();
+
+// Check that the entity is new.
+if (someBlogPost.guid == null) {
+ alert("This blog post hasn't been saved yet!");
+}`}}),f=new V({props:{language:W,code:`blogPost.$addTag('super-post');
+await blogPost.$save();
+
+let superPosts = await nymph.getEntities(
+ { class: BlogPost },
+ { type: '&', tag: 'super-post' }
+);
+
+blogPost.$inArray(superPosts); // true`}}),p=new V({props:{language:W,code:`let entity = await Entity.factory();
+entity.foo = await Entity.factory();
+
+entity.foo.bar = 'It works!';
+await entity.foo.$save(); // Saving the referenced entity first! :)
+await entity.$save(); // now foo has been saved.
+
+const guid = entity.guid;
+entity = await Entity.factory(guid);
+
+entity.foo.guid == null; // False
+console.log(entity.foo.bar); // Outputs 'It works!'.`}}),w=new V({props:{language:W,code:`let entity = await Entity.factory();
+entity.foo = await Entity.factory();
+
+await entity.$save(); // foo hasn't been saved yet!
+
+entity.foo.bar = 'It works!';
+await entity.foo.$save();
+
+const guid = entity.guid;
+entity = await Entity.factory(guid);
+
+entity.foo.guid == null; // True
+console.log(entity.foo.bar); // Outputs undefined.`}}),{c(){h=new Et(!1),M=pt(),L=s(),e=i("section"),u=i("header"),u.innerHTML=rt,Y=s(),E=i("p"),E.innerHTML=lt,Q=s(),B(g.$$.fragment),F=s(),C=i("p"),C.textContent=ct,J=s(),B(f.$$.fragment),K=s(),T=i("p"),T.textContent=dt,X=s(),y=i("div"),m=i("div"),m.innerHTML=ht,Z=s(),B(p.$$.fragment),tt=s(),v=i("div"),$=i("div"),$.innerHTML=ut,et=s(),B(w.$$.fragment),nt=s(),P=i("p"),P.textContent=gt,at=s(),I=i("p"),I.innerHTML=ft,S=s(),c=i("section"),_=i("a"),st=vt("Previous: Introduction"),it=s(),x=i("a"),ot=vt("Next: Entity Querying"),this.h()},l(n){const b=Ct("svelte-1eabkgd",document.head);h=Tt(b,!1),M=pt(),b.forEach(l),L=o(n),e=r(n,"SECTION",{});var a=k(e);u=r(a,"HEADER",{class:!0,"data-svelte-h":!0}),d(u)!=="svelte-1r4zxlg"&&(u.innerHTML=rt),Y=o(a),E=r(a,"P",{"data-svelte-h":!0}),d(E)!=="svelte-1jwh69x"&&(E.innerHTML=lt),Q=o(a),z(g.$$.fragment,a),F=o(a),C=r(a,"P",{"data-svelte-h":!0}),d(C)!=="svelte-go5m5m"&&(C.textContent=ct),J=o(a),z(f.$$.fragment,a),K=o(a),T=r(a,"P",{"data-svelte-h":!0}),d(T)!=="svelte-k2lz97"&&(T.textContent=dt),X=o(a),y=r(a,"DIV",{});var N=k(y);m=r(N,"DIV",{style:!0,"data-svelte-h":!0}),d(m)!=="svelte-1jxvgmh"&&(m.innerHTML=ht),Z=o(N),z(p.$$.fragment,N),N.forEach(l),tt=o(a),v=r(a,"DIV",{});var A=k(v);$=r(A,"DIV",{style:!0,"data-svelte-h":!0}),d($)!=="svelte-1s82s64"&&($.innerHTML=ut),et=o(A),z(w.$$.fragment,A),A.forEach(l),nt=o(a),P=r(a,"P",{"data-svelte-h":!0}),d(P)!=="svelte-v88prl"&&(P.textContent=gt),at=o(a),I=r(a,"P",{"data-svelte-h":!0}),d(I)!=="svelte-1v43csb"&&(I.innerHTML=ft),a.forEach(l),S=o(n),c=r(n,"SECTION",{class:!0});var j=k(c);_=r(j,"A",{href:!0,class:!0});var yt=k(_);st=$t(yt,"Previous: Introduction"),yt.forEach(l),it=o(j),x=r(j,"A",{href:!0,class:!0});var mt=k(x);ot=$t(mt,"Next: Entity Querying"),mt.forEach(l),j.forEach(l),this.h()},h(){document.title="Creating Entities - User Guide - Nymph.js",h.a=M,H(u,"class","major"),wt(m,"text-align","end"),wt($,"text-align","end"),H(_,"href",_t+"/user-guide/introduction"),H(_,"class","button"),H(x,"href",_t+"/user-guide/entity-querying"),H(x,"class","button"),H(c,"class","page-steps")},m(n,b){h.m(Ht,document.head),t(document.head,M),q(n,L,b),q(n,e,b),t(e,u),t(e,Y),t(e,E),t(e,Q),G(g,e,null),t(e,F),t(e,C),t(e,J),G(f,e,null),t(e,K),t(e,T),t(e,X),t(e,y),t(y,m),t(y,Z),G(p,y,null),t(e,tt),t(e,v),t(v,$),t(v,et),G(w,v,null),t(e,nt),t(e,P),t(e,at),t(e,I),q(n,S,b),q(n,c,b),t(c,_),t(_,st),t(c,it),t(c,x),t(x,ot),D=!0},p:Pt,i(n){D||(O(g.$$.fragment,n),O(f.$$.fragment,n),O(p.$$.fragment,n),O(w.$$.fragment,n),D=!0)},o(n){R(g.$$.fragment,n),R(f.$$.fragment,n),R(p.$$.fragment,n),R(w.$$.fragment,n),D=!1},d(n){n&&(h.d(),l(L),l(e),l(S),l(c)),l(M),U(g),U(f),U(p),U(w)}}}class jt extends It{constructor(h){super(),kt(this,h,null,Mt,bt,{})}}export{jt as component};
diff --git a/docs/_app/immutable/nodes/19.bdc12e86.js b/docs/_app/immutable/nodes/19.bdc12e86.js
new file mode 100644
index 0000000..2d11984
--- /dev/null
+++ b/docs/_app/immutable/nodes/19.bdc12e86.js
@@ -0,0 +1,140 @@
+import{s as He,I as Me,e as ye,a as i,f as n,l as fe,x as je,J as Ie,d as l,c as r,g as o,h as j,r as d,m as ge,j as I,k as z,u as e,i as S,v as Le}from"../chunks/scheduler.d7e45cc8.js";import{S as De,i as Pe,b as ve,d as Te,m as $e,a as we,t as Ee,e as xe}from"../chunks/index.77720afb.js";import{H as _e,g as qe}from"../chunks/github.64534d2c.js";import{t as Ce}from"../chunks/typescript.09c48802.js";import{b as be}from"../chunks/paths.d4a6803e.js";function ke(Ne){let p,L,D,t,u,ae='Entity class. This is equivalent to creating a new table in a relational database.
+ If you are going to use the class on the client side, you also need to create
+ a corresponding client class. Below are two examples, one for Node.js, and one
+ for the client. A more in depth explanation follows the examples.`,A,y,f,ne="Extending Entity in Node.js",O,g,Y,v,T,oe="Extending Entity in the Client",B,$,G,x,ie=`In both cases, defaults are set in the constructor (the done
+ property is set to false and the name property is set to an
+ empty string). You can see that from within the methods of an entity, the
+ entity's data (other than guid, cdate, mdate, and tags) are accessed from
+ this.$data. The
+ $data part is not necessary outside of the entity's own methods.`,R,_,re=`You'll also notice that when using Nymph from within an entity's methods,
+ there is an instance of Nymph available in this.$nymph (or
+ this.nymph in static methods). In Node.js, these instances will
+ know which user is logged in and add appropriate permission checks, and will
+ maintain a persistent DB connection during a transaction. On the client,
+ these instances will know how to communicate with the configured REST
+ server. Basically, you have to use these instances. You can also use
+ this.$nymph.getEntityClass
+ and this.nymph.getEntityClass to get the right class for Nymph queries.`,W,C,le=`In Node.js, the etype is set to "todo". The etype of an entity
+ determines which table(s) the entity will be placed in. When you search for
+ an entity, you give Nymph a class. Nymph will use that class' etype to
+ determine where to search for entities. If you don't provide a class, the
+ Entity class and the "entity" etype will be used.`,F,b,de=`The $clientEnabledMethods property and the
+ clientEnabledStaticMethods
+ static property in Node.js determine which methods and static methods can be
+ called from the client using $serverCall and
+ serverCallStatic. In the client class, the
+ return await this.$serverCall('$archive', []); statement takes advantage
+ of this feature.`,K,N,he=`On both the Node.js class and the client class, the class name is set in the class static property. This class name should match on each side. It is how Nymph
+ maps the client class to the Node.js class and vice versa.`,Q,H,ce=`Nymph provides a mechanism to ensure uniqueness among entities. Any strings
+ returned by the $getUniques method will have a uniqueness
+ constraint enforced by the database across this entity's etype. The
+ Todo class returns a string containing both the user's GUID and
+ the todo name. This ensures that the user can't have two todos with the same
+ name. The $save method checks for a thrown
+ EntityUniqueConstraintError
+ when calling the super class' $save.`,X,M,me=`Finally, in Node.js, the Todo class validates all of its data
+ in the $save method using
+ Joi. Without
+ this validation, a malicious user could send invalid data types or even
+ megabytes worth of data in an entity. Any validation library should support
+ validation in Nymph using the $getValidatable method. The
+ $allowlistData property will ensure no extra properties are set.`,P,h,c,Z,ee,m,te,q;return g=new _e({props:{language:Ce,code:`import {
+ Entity,
+ EntityUniqueConstraintError,
+ nymphJoiProps,
+} from '@nymphjs/nymph';
+import { tilmeldJoiProps } from '@nymphjs/tilmeld';
+import Joi from 'joi';
+
+export type TodoData = {
+ name?: string;
+ done?: boolean;
+};
+
+export class Todo extends EntityJavaScript data objects for Node.js and the browser.
Nymph is an object relational mapper for collaborative web apps. Nymph + runs in Node.js and provides a REST server with clients built for Node.js + and the browser. It allows rapid prototyping and production ready speed + and features.
Nymph can use SQLite3, MySQL, or PostgreSQL as its database backend. You + can use SQLite in development, and MySQL or Postgres in production. You + can even use Nymph with SQLite in an Electron app.
Nymph is lean and fast. Not just in processing, but Nymph can be used + for rapid prototyping.
`,se,_,A,w,re,N,me=`Nymph is licensed under the Apache-2 license. It provides all you need + to build a backend for your app and the frontend tools you'll need as + well.
`,oe,S,P,$,ie,L,fe=`Nymph's publish/subscribe server makes it easy to build collaborative apps. You can subscribe to complex queries from the client and be notified + when the queries' results have changed.
`,le,T,q,E,ce,I,ve=`Nymph provides an optional user and group manager called Tilmeld that + secures your app based on granular permission controls.
`,D,x,ye=`Nymph is very easy to integrate into React, Svelte, Angular, Ember, and + more.
Nymph's easy querying on the server and client makes it perfect for building + complex apps with any frontend framework. Because you don't have to write + SQL, almost all of your logic can be on the client side, if you prefer. You + can also use backend logic in the client as if it were written on the + front-end with automatic asynchronous server calls.
Nymph's REST server package makes it easy to integrate anywhere in your app. + It provides an Express middleware that you can place on any arbitrary + endpoint.
Nymph's PubSub server package makes synchronizing your client with pushed + changes from the server super easy. With a reactive framework on the + frontend, your UI will update in near real time to changes to any entities + that match your subscribed queries.
`,O,C,ge='If you want to really dive deep into Nymph, you can also browse the API docs, which covers every part of Nymph's API.
',Y,H,be='In 2021, Nymph was migrated from PHP to Node.js. You can also visit the site for the legacy version.
',V;return g=new ee({props:{path:Ce}}),w=new ee({props:{path:He}}),$=new ee({props:{path:Me}}),E=new ee({props:{path:je}}),{c(){M=r(),m=n("section"),m.innerHTML=pe,Q=r(),p=n("section"),v=n("header"),v.innerHTML=he,te=r(),j=n("p"),j.textContent=de,ae=r(),i=n("div"),y=n("article"),k=n("span"),G(g.$$.fragment),ne=r(),b=n("div"),b.innerHTML=ue,se=r(),_=n("article"),A=n("span"),G(w.$$.fragment),re=r(),N=n("div"),N.innerHTML=me,oe=r(),S=n("article"),P=n("span"),G($.$$.fragment),ie=r(),L=n("div"),L.innerHTML=fe,le=r(),T=n("article"),q=n("span"),G(E.$$.fragment),ce=r(),I=n("div"),I.innerHTML=ve,D=r(),x=n("section"),x.innerHTML=ye,O=r(),C=n("section"),C.innerHTML=ge,Y=r(),H=n("section"),H.innerHTML=be,this.h()},l(e){Te("svelte-o16nng",document.head).forEach(a),M=o(e),m=s(e,"SECTION",{id:!0,"data-svelte-h":!0}),h(m)!=="svelte-sq7jw"&&(m.innerHTML=pe),Q=o(e),p=s(e,"SECTION",{});var R=d(p);v=s(R,"HEADER",{class:!0,"data-svelte-h":!0}),h(v)!=="svelte-1mw113u"&&(v.innerHTML=he),te=o(R),j=s(R,"P",{"data-svelte-h":!0}),h(j)!=="svelte-1twg9ow"&&(j.textContent=de),ae=o(R),i=s(R,"DIV",{class:!0});var f=d(i);y=s(f,"ARTICLE",{});var F=d(y);k=s(F,"SPAN",{class:!0});var _e=d(k);U(g.$$.fragment,_e),_e.forEach(a),ne=o(F),b=s(F,"DIV",{class:!0,"data-svelte-h":!0}),h(b)!=="svelte-gv6mah"&&(b.innerHTML=ue),F.forEach(a),se=o(f),_=s(f,"ARTICLE",{});var J=d(_);A=s(J,"SPAN",{class:!0});var we=d(A);U(w.$$.fragment,we),we.forEach(a),re=o(J),N=s(J,"DIV",{class:!0,"data-svelte-h":!0}),h(N)!=="svelte-1f7ku42"&&(N.innerHTML=me),J.forEach(a),oe=o(f),S=s(f,"ARTICLE",{});var z=d(S);P=s(z,"SPAN",{class:!0});var Ne=d(P);U($.$$.fragment,Ne),Ne.forEach(a),ie=o(z),L=s(z,"DIV",{class:!0,"data-svelte-h":!0}),h(L)!=="svelte-1qg7qmr"&&(L.innerHTML=fe),z.forEach(a),le=o(f),T=s(f,"ARTICLE",{});var B=d(T);q=s(B,"SPAN",{class:!0});var Se=d(q);U(E.$$.fragment,Se),Se.forEach(a),ce=o(B),I=s(B,"DIV",{class:!0,"data-svelte-h":!0}),h(I)!=="svelte-342cl6"&&(I.innerHTML=ve),B.forEach(a),f.forEach(a),R.forEach(a),D=o(e),x=s(e,"SECTION",{"data-svelte-h":!0}),h(x)!=="svelte-g5k3xt"&&(x.innerHTML=ye),O=o(e),C=s(e,"SECTION",{"data-svelte-h":!0}),h(C)!=="svelte-x9jtur"&&(C.innerHTML=ge),Y=o(e),H=s(e,"SECTION",{"data-svelte-h":!0}),h(H)!=="svelte-6rylbe"&&(H.innerHTML=be),this.h()},h(){document.title="Nymph.js - JavaScript Data Objects",c(m,"id","banner"),c(v,"class","major"),c(k,"class","icon"),c(b,"class","content"),c(A,"class","icon"),c(N,"class","content"),c(P,"class","icon"),c(L,"class","content"),c(q,"class","icon"),c(I,"class","content"),c(i,"class","features")},m(e,l){u(e,M,l),u(e,m,l),u(e,Q,l),u(e,p,l),t(p,v),t(p,te),t(p,j),t(p,ae),t(p,i),t(i,y),t(y,k),W(g,k,null),t(y,ne),t(y,b),t(i,se),t(i,_),t(_,A),W(w,A,null),t(_,re),t(_,N),t(i,oe),t(i,S),t(S,P),W($,P,null),t(S,ie),t(S,L),t(i,le),t(i,T),t(T,q),W(E,q,null),t(T,ce),t(T,I),u(e,D,l),u(e,x,l),u(e,O,l),u(e,C,l),u(e,Y,l),u(e,H,l),V=!0},p:Ee,i(e){V||(K(g.$$.fragment,e),K(w.$$.fragment,e),K($.$$.fragment,e),K(E.$$.fragment,e),V=!0)},o(e){X(g.$$.fragment,e),X(w.$$.fragment,e),X($.$$.fragment,e),X(E.$$.fragment,e),V=!1},d(e){e&&(a(M),a(m),a(Q),a(p),a(D),a(x),a(O),a(C),a(Y),a(H)),Z(g),Z(w),Z($),Z(E)}}}class Re extends Ie{constructor(M){super(),xe(this,M,null,ke,Le,{})}}export{Re as component}; diff --git a/docs/_app/immutable/nodes/20.5b87b0c3.js b/docs/_app/immutable/nodes/20.5b87b0c3.js deleted file mode 100644 index f5764a0..0000000 --- a/docs/_app/immutable/nodes/20.5b87b0c3.js +++ /dev/null @@ -1,224 +0,0 @@ -import{S as ds,i as us,s as fs,R as ys,e as ls,a as h,k as o,q as t,y as le,F as ms,T as ps,h as n,c,l as s,m as r,r as a,z as he,p as so,n as ce,C as e,b as bt,A as de,D as Es,g as ue,d as fe,B as ye}from"../chunks/index.d7cc8d8b.js";import{H as me,g as vs}from"../chunks/github.df9008b1.js";import{t as pe}from"../chunks/typescript.7dd1ec19.js";import{b as hs}from"../chunks/paths.d307dac8.js";function gs(cs){let S,Ee,mt,i,J,K,Ct,Dt,ve,Ot,Tt,w,kt,ge,It,qt,$e,Nt,Ut,jt,E,Pt,we,At,St,_e,Gt,Lt,be,xt,Mt,Ft,G,zt,_,Ht,Ce,Yt,Bt,De,Qt,Rt,Jt,b,Kt,Oe,Vt,Wt,Te,Xt,Zt,ea,L,ta,x,aa,ke,na,oa,sa,M,ra,u,ia,Ie,la,ha,qe,ca,da,Ne,ua,fa,Ue,ya,ma,je,pa,Ea,Pe,va,ga,Ae,$a,wa,_a,F,ba,z,Ca,Se,Da,Oa,Ta,v,H,Ge,ka,Ia,C,Le,qa,Na,xe,Ua,ja,Me,Pa,Aa,D,Fe,Sa,Ga,ze,La,xa,O,He,Ma,Fa,Ye,za,Ha,Be,Ya,Ba,p,Qe,Qa,Ra,Re,Ja,Ka,Je,Va,Wa,Ke,Xa,Za,Ve,en,tn,an,f,We,nn,on,Xe,sn,rn,Ze,ln,hn,et,cn,dn,tt,un,fn,at,yn,mn,nt,pn,En,vn,Y,gn,T,$n,ot,wn,_n,st,bn,Cn,Dn,k,V,rt,On,Tn,kn,W,it,In,qn,Nn,X,lt,Un,jn,Pn,I,An,ht,Sn,Gn,ct,Ln,xn,Mn,B,Fn,dt,zn,Hn,Yn,g,Bn,ut,Qn,Rn,ft,Jn,Kn,yt,Vn,Wn,Xn,Q,pt,q,N,Zn,eo,U,to,Et;return G=new me({props:{language:pe,code:`const entity = await MyEntity.factory(); - -entity.$addTag('foo', 'bar'); -entity.$hasTag('foo'); // True - -entity.$removeTag('foo', 'bar'); -entity.$hasTag('foo'); // False`}}),L=new me({props:{language:pe,code:`// Create some entities. -let entity = await MyEntity.factory(); -entity.foo = await MyEntity.factory(); -entity.foo.bar = 'Old value.'; -await entity.foo.$save(); -await entity.$save(); - -// Get a copy of the referenced entity. -let instOfFoo = await nymph.getEntity( - { class: MyEntity }, - { type: '&', guid: entity.foo.guid } -); -// And change a value on it. -instOfFoo.bar = 'New value.'; -await instOfFoo.$save(); - -console.log(entity.foo.bar); // Outputs 'Old value.' -// If on Node.js -entity.$clearCache(); -await entity.foo.$wake(); -// Else if on the client -await entity.$refresh(); -await entity.foo.$wake(); -// End if -console.log(entity.foo.bar); // Outputs 'New value.'`}}),M=new me({props:{language:pe,code:`// Create an entity. -const entity = await MyEntity.factory(); -entity.foo = 'Old value.'; -await entity.$save(); - -// Get a copy of the entity. -const instOfEnt = await nymph.getEntity( - { class: MyEntity }, - { type: '&', guid: entity.guid } -); -// And change a value on it. -instOfEnt.foo = 'New value.'; -await instOfEnt.$save(); - -console.log(entity.foo); // Outputs 'Old value.' -await entity.$refresh(); -console.log(entity.foo); // Outputs 'New value.'`}}),F=new me({props:{language:pe,code:`const entity = await MyEntity.factory(); - -// Save the entity. -await entity.$save(); -// or -await nymph.saveEntity(entity); -// or -await nymph.saveEntities([entity]); - -// (Client only.) Save only the data that has changed. -await entity.$patch(); -// or -await nymph.patchEntity(entity); -// or -await nymph.patchEntities([entity]); - -// Delete the entity. -await entity.$delete(); -// or -await nymph.deleteEntity(entity); -// or -await nymph.deleteEntities([entity]);`}}),Y=new me({props:{language:pe,code:`// Assuming the entity with GUID 'a4c1591d6ea91c8450d2d360' exists. -let entity = await MyEntity.factory('a4c1591d6ea91c8450d2d360'); -let entity2 = await MyEntity.factory('a4c1591d6ea91c8450d2d360'); - -entity.$is(entity2); // True -entity.$equals(entity2); // True - -entity2.someProp = 'some new value'; -entity.$is(entity2); // True -entity.$equals(entity2); // False - -const arr = [null, null, entity2]; -entity.$arraySearch(arr); // 2 -entity.$inArray(arr); // True -entity.$arraySearch(arr, true); // -1 -entity.$inArray(arr, true); // false`}}),Q=new me({props:{language:pe,code:`// You can use $serverCall and serverCallStatic directly. -try { - const success: boolean = await todo.$serverCall('$archive', []); - if (!success) { - alert("Couldn't archive " + todo.name); - } -} catch (e) { - alert('Error: ' + e.textStatus + " -Couldn't archive " + todo.name); -} - -// Or you can define methods like this in your client class. -class Todo extends Entity$patch will push just the changed
+ properties up to the server, whereas $save would push all properties.`,ee,_,_e=`Entities can be organized using tags. To add, remove, and check tags, the
+ methods $addTag, $removeTag, and
+ $hasTag are used, respectively. Each takes any number of tags as
+ arguments.`,te,m,ae,M,Me=`Entities that have been saved inside another entity's property are loaded as
+ "sleeping references". This means their data is not actually pulled from the
+ database/server. It will "wake up" when you use $wake on it or
+ $wakeAll on the entity that contains it.`,ne,C,Ce=`To clear the cache of referenced entities, so that the next time one is
+ awoken, it will be pulled from the database, use the $clearCache
+ method in Node.js or the $refresh method in the client.`,ie,p,oe,x,xe=`Much like clearing the entity cache, you may need to refresh the entity's
+ own data in Node.js. Use the $refresh method, just like in the client,
+ for this.`,se,g,re,k,ke=`To save an entity, use the $save method. Likewise, to delete
+ the entity, use the $delete method. You can also call the
+ saveEntity,
+ deleteEntity, and deleteEntityByID methods of
+ Nymph. The Entity class uses these methods.`,le,v,ce,H,He=`Entities can't be checked using the == operator. Instead, you can
+ use the following entity methods.`,de,L,Le=`$is - Perform a less strict comparison of two entities
+ (basically a GUID check). To return true, the entities must meet the
+ following criteria.
+ $equals - Perform a more strict comparison of two entities
+ (basically a GUID + data + tags check). To return true, the entities must
+ meet the following criteria. Unlike $is, this method can't be
+ used on sleeping references.
+ $inArray - Check whether the entity is in an array. Takes two
+ arguments, the array and a boolean strict. If
+ strict
+ is false or undefined, the function uses $is to compare, and
+ if it's true, the function uses $equals.$arraySearch - Search an array for the entity and return its
+ index, or -1 if it's not found. Takes two arguments, the
+ array and a boolean
+ strict. If strict is false or undefined, the
+ function uses
+ $is
+ to compare, and if it's true, the function uses $equals. This
+ method may return 0, which evaluates to false, so you should use
+ $inArray if you are only checking whether the entity is in the
+ array.$serverCall method to
+ call methods on a server side instance of the entity.
+ $serverCall expects three parameters.`,ye,q,qe=`method - the name of the method to call on the server side object.params - an array of the parameters to pass to the method.stateless - if set to true, the method won't update the entity
+ with the returned server side representation.$readyAll again. If you know that the server side method
+ will not change any of the data on the entity, you can set
+ stateless to true.`,me,P,Pe="You can also call static methods on the server with serverCallStatic.",pe,O,Oe=`In order to be called from the client side, the method must be listed in the
+ $clientEnabledMethods or
+ clientEnabledStaticMethods property in the Node.js class. This
+ guards against a user submitting tailored requests to perform potentially
+ dangerous tasks on the server side. If the method is not listed, the request
+ will fail with a 403 Forbidden status.`,ge,w,J,d,h,ve,$e,u,we,R;return m=new z({props:{language:Y,code:`const entity = await MyEntity.factory();
+
+entity.$addTag('foo', 'bar');
+entity.$hasTag('foo'); // True
+
+entity.$removeTag('foo', 'bar');
+entity.$hasTag('foo'); // False`}}),p=new z({props:{language:Y,code:`// Create some entities.
+let entity = await MyEntity.factory();
+entity.foo = await MyEntity.factory();
+entity.foo.bar = 'Old value.';
+await entity.foo.$save();
+await entity.$save();
+
+// Get a copy of the referenced entity.
+let instOfFoo = await nymph.getEntity(
+ { class: MyEntity },
+ { type: '&', guid: entity.foo.guid }
+);
+// And change a value on it.
+instOfFoo.bar = 'New value.';
+await instOfFoo.$save();
+
+console.log(entity.foo.bar); // Outputs 'Old value.'
+// If on Node.js
+entity.$clearCache();
+await entity.foo.$wake();
+// Else if on the client
+await entity.$refresh();
+await entity.foo.$wake();
+// End if
+console.log(entity.foo.bar); // Outputs 'New value.'`}}),g=new z({props:{language:Y,code:`// Create an entity.
+const entity = await MyEntity.factory();
+entity.foo = 'Old value.';
+await entity.$save();
+
+// Get a copy of the entity.
+const instOfEnt = await nymph.getEntity(
+ { class: MyEntity },
+ { type: '&', guid: entity.guid }
+);
+// And change a value on it.
+instOfEnt.foo = 'New value.';
+await instOfEnt.$save();
+
+console.log(entity.foo); // Outputs 'Old value.'
+await entity.$refresh();
+console.log(entity.foo); // Outputs 'New value.'`}}),v=new z({props:{language:Y,code:`const entity = await MyEntity.factory();
+
+// Save the entity.
+await entity.$save();
+// or
+await nymph.saveEntity(entity);
+// or
+await nymph.saveEntities([entity]);
+
+// (Client only.) Save only the data that has changed.
+await entity.$patch();
+// or
+await nymph.patchEntity(entity);
+// or
+await nymph.patchEntities([entity]);
+
+// Delete the entity.
+await entity.$delete();
+// or
+await nymph.deleteEntity(entity);
+// or
+await nymph.deleteEntities([entity]);`}}),$=new z({props:{language:Y,code:`// Assuming the entity with GUID 'a4c1591d6ea91c8450d2d360' exists.
+let entity = await MyEntity.factory('a4c1591d6ea91c8450d2d360');
+let entity2 = await MyEntity.factory('a4c1591d6ea91c8450d2d360');
+
+entity.$is(entity2); // True
+entity.$equals(entity2); // True
+
+entity2.someProp = 'some new value';
+entity.$is(entity2); // True
+entity.$equals(entity2); // False
+
+const arr = [null, null, entity2];
+entity.$arraySearch(arr); // 2
+entity.$inArray(arr); // True
+entity.$arraySearch(arr, true); // -1
+entity.$inArray(arr, true); // false`}}),w=new z({props:{language:Y,code:`// You can use $serverCall and serverCallStatic directly.
+try {
+ const success: boolean = await todo.$serverCall('$archive', []);
+ if (!success) {
+ alert("Couldn't archive " + todo.name);
+ }
+} catch (e) {
+ alert('Error: ' + e.textStatus + "
+Couldn't archive " + todo.name);
+}
+
+// Or you can define methods like this in your client class.
+class Todo extends EntityEntity class' factory method can take a GUID as an
+ argument. You can provide other factory functions that can take things as
+ well. For example, the User class in Tilmeld has a
+ factoryUsername method that takes a username. The method will return
+ a new entity if the queried entity is not found. You can determine if it was
+ found by checking that its GUID is not null.`,ln,ht,rn,ct,Vl="getEntities
+ and getEntity methods. The first argument is an Options object.`,sn,ft,Yl=`| Option | Type | Default | Description |
|---|---|---|---|
| class | typeof Entity | Entity | The Entity class to query. |
| limit | number | undefined | The limit of entities to be returned. Not needed when using getEntity, as it always returns only one. |
| offset | number | 0 | The offset from the first matching entity, in order, to start + retrieving. |
| reverse | boolean | false | If true, entities will be retrieved from newest to oldest/largest
+ to smallest (with regard to sort). |
| sort | 'cdate' | 'mdate' | string | 'cdate' | How to sort the entities. Should be "cdate", "mdate", or the name + of a property. |
| return | 'entity' | 'guid' | 'count' | 'entity' | What to return, the entities with their data, just the GUIDs, or + just a count. |
| source | string | undefined | Will be 'client' if the query came from a REST request or the + PubSub server. (Mainly used in Tilmeld for access control.) |
| skipCache | boolean | false | If true, Nymph will skip the cache and retrieve the entity from the + DB. |
| skipAc | boolean | false | If true, Tilmeld will not filter returned entities according to + access controls. (If Tilmeld is installed.) (This is always set to + false by the REST endpoint and PubSub server.) |
type property.`,cn,ut,Zl="| Type | Name | Description |
|---|---|---|
| & | And | All clauses in the selector must match. |
| | | Or | At least one clause in the selector must match. |
| !& | Not And | All clauses in the selector must not match. |
| !| | Not Or | At least one clause in the selector must not match. |
name: value, or
+ name: [value1, value2, ...]. They can be negated by prepending
+ a bang (!) to the name, like '!name': value. A clause that has
+ multiple values is considered as multiple clauses in terms of matching for
+ "or" selectors.`,un,Ft,vt,Bt,tr="export - Export entities to a file.exportPrint - Export entities to the console.import - Import entities from a file.Nymph is an ORM for Node.js and the browser, written in TypeScript. Nymph + data objects, called entities, are accessed just like plain objects. Nymph + includes a REST server and a Publish/Subscribe server.
Data in Nymph is stored and manipulated in objects called entities. Entities can hold most types of data available in JavaScript, including
+ other entities. Entities are not strictly structured, so data of any type
+ can be added and saved just by assigning a property on the entity and
+ calling $save. This makes data manipulation and rapid
+ prototyping in Nymph very easy. Then when you're ready to launch to
+ production, you would use a validation library to enforce a schema for your
+ entities.
+ Joi
+ is a good one. You can do this in the
+ $save
+ method on your entities before calling
+ return await super.$save();. This means that during
+ development, you don't need to worry about managing schemas at all, but you
+ still get the benefit of strict checks in production.
All entities are given a globally unique identifier (GUID), which is a + random, cryptographically secure, 12 byte integer, encoded in a 24 + character, lowercase HEX string. Since these are random and quite large, + there should never be any two entities in any Nymph installation with the + same GUIDs (unless that's done on purpose). Nymph also provides UIDs, which + are sequential and can be used to number entities (or anything else).
Using Nymph, nearly all of an app's business logic can be written on either + the client side or the server side, since you interact with data the same + way in each. Anything that relies on access control can be handled on the + server side where Tilmeld, Nymph's optional user/group manager, provides + access control.
If an entity is referenced in another entity's property, the class name is + saved along with the GUID. When this referenced entity is awoken, Nymph will + retrieve it using the saved class.
When an entity containing a referenced entity is pulled from the database,
+ the referenced entity will exist in the data as a "sleeping reference".
+ Sleeping references have the right class and know their GUID, but other data
+ is not accessible until its pulled from the database. This happens when you
+ use the $wake method on it, or the $wakeAll method
+ on its parent.
When querying entities with Nymph, the ETYPE constant on the class + determines which database table(s) Nymph will look in.
Caution: When changing an entity's class name, any entities referencing it + must be resaved after setting the reference again using the new class name.
If you want to really dive deep into Nymph, you can also browse the API docs, which covers every part of Nymph's API.
`,o,t,h,y,a,m;return{c(){i=g(),s=c("section"),s.innerHTML=N,o=g(),t=c("section"),h=c("span"),y=g(),a=c("a"),m=j("Next: Creating Entities"),this.h()},l(e){x("svelte-6cxoo7",document.head).forEach(n),i=f(e),s=d(e,"SECTION",{"data-svelte-h":!0}),T(s)!=="svelte-gi5e61"&&(s.innerHTML=N),o=f(e),t=d(e,"SECTION",{class:!0});var l=b(t);h=d(l,"SPAN",{}),b(h).forEach(n),y=f(l),a=d(l,"A",{href:!0,class:!0,style:!0});var _=b(a);m=S(_,"Next: Creating Entities"),_.forEach(n),l.forEach(n),this.h()},h(){document.title="Introduction - User Guide - Nymph.js",v(a,"href",q+"/user-guide/creating-entities"),v(a,"class","button"),k(a,"margin",".5em"),v(t,"class","page-steps")},m(e,r){p(e,i,r),p(e,s,r),p(e,o,r),p(e,t,r),u(t,h),u(t,y),u(t,a),u(a,m)},p:w,i:w,o:w,d(e){e&&(n(i),n(s),n(o),n(t))}}}class $ extends A{constructor(i){super(),U(this,i,null,C,I,{})}}export{$ as component}; diff --git a/docs/_app/immutable/nodes/24.82606410.js b/docs/_app/immutable/nodes/24.82606410.js new file mode 100644 index 0000000..46aeae4 --- /dev/null +++ b/docs/_app/immutable/nodes/24.82606410.js @@ -0,0 +1,98 @@ +import{s as Pe,I as Ce,e as xe,a as n,f as i,l as H,x as ke,J as qe,d as u,c as r,g as o,h as q,r as m,m as M,j as _,k as Ee,u as e,i as I,v as je}from"../chunks/scheduler.d7e45cc8.js";import{S as He,i as Me,b as z,d as Q,m as W,a as Y,t as B,e as O}from"../chunks/index.77720afb.js";import{H as G,g as Ue}from"../chunks/github.64534d2c.js";import{t as J}from"../chunks/typescript.09c48802.js";import{b as me}from"../chunks/paths.d4a6803e.js";function Ae(Te){let b,j,U,t,p,be='subscribeEntities method on PubSub to subscribe
+ to a query. It will return a function you can call to subscribe to the
+ query. That function accepts a resolve and reject callback, similar to a
+ promise. The resolve function will receive an update, which will at first be
+ an array of entities, then will be an update object with instructions that
+ updateArray uses to update the original array.`,ee,g,te,E,ge=`You can also receive a count of how many subscribers there are to that
+ query. The count is given to a third callback.`,ae,f,se,T,fe=`To unsubscribe from the query, use the unsubscribe method on
+ the
+ PubSubSubscription object returned by the function.`,ne,y,re,P,ye=`You can subscribe to changes to an entity with the subscribeWith
+ method. This method accepts the callbacks directly and returns a
+ PubSubSubscription
+ object.`,ie,v,oe,C,ve=`Warning: Subscriptions can lead to resource leaks if left open. Take care to
+ unsubscribe to every query you are no longer watching.`,ue,k,we=`Warning: The PubSub server is smart about removing entities that no longer
+ match when a new entity matches, but there are some queries that can have
+ changes in their matching entities without any change to the server (like
+ relative time queries). These queries won't necessarily be updated correctly
+ in due time by the PubSub server.`,A,l,c,le,ce,h,he,L;return g=new G({props:{language:J,code:`let smiths: (User & UserData)[] = [];
+pubsub.subscribeEntities(
+ {
+ class: User
+ },
+ {
+ type: '&',
+ like: ['name', '% Smith']
+ }
+)(
+ (update) => {
+ // This function will be called once initially with an array of
+ // entities, then again every time there's a change with an
+ // update object.
+ // The updateArray function will add any newly matching entities,
+ // update any existing entities that have changed, and remove any
+ // entities that no longer match (including deleted entities).
+ pubsub.updateArray(smiths, update);
+ },
+ (e) => {
+ alert('Error: ' + e.textStatus);
+ }
+);`}}),f=new G({props:{language:J,code:`let smiths: (User & UserData)[] = [];
+pubsub.subscribeEntities(
+ {
+ class: User
+ },
+ {
+ type: '&',
+ like: ['name', '% Smith']
+ }
+)(
+ (update) => {
+ pubsub.updateArray(smiths, update);
+ },
+ (e) => {
+ alert('Error: ' + e.textStatus);
+ },
+ (count) => {
+ // This function will be called each time the count of
+ // subscribers to this query changes.
+ console.log(\`There are now \${count} users watching the Smiths.\`);
+ }
+);`}}),y=new G({props:{language:J,code:`let smiths: (User & UserData)[] = [];
+let subscription = pubsub.subscribeEntities(
+ {
+ class: User
+ },
+ {
+ type: '&',
+ like: ['name', '% Smith']
+ }
+)((update) => {
+ pubsub.updateArray(smiths, update);
+});
+
+onDestroy(() => {
+ subscription.unsubscribe();
+});`}}),v=new G({props:{language:J,code:`let subscription = pubsub.subscribeWith(
+ smithEntity,
+ () => {
+ if (smithEntity.guid == null) {
+ if (confirm('Someone deleted Mr. Smith! Do you want to restore him?')) {
+ smithEntity.$save();
+ }
+ } else {
+ alert("Mr. Smith's entity has changed!");
+ }
+ },
+ (e) => {
+ alert('Error: ' + e.textStatus);
+ },
+ (count) => {
+ console.log(\`There are now \${count} users watching Mr. Smith.\`);
+ }
+);
+
+onDestroy(() => {
+ subscription.unsubscribe();
+});`}}),{c(){b=new Ce(!1),j=xe(),U=n(),t=i("section"),p=i("header"),p.innerHTML=be,R=n(),$=i("p"),$.textContent=pe,F=n(),d=i("p"),K=H("Before we get started, you can follow the "),S=i("a"),V=H("PubSub Server Package"),X=H(" page to set up a Nymph PubSub server."),Z=n(),x=i("p"),x.innerHTML=de,ee=n(),z(g.$$.fragment),te=n(),E=i("p"),E.textContent=ge,ae=n(),z(f.$$.fragment),se=n(),T=i("p"),T.innerHTML=fe,ne=n(),z(y.$$.fragment),re=n(),P=i("p"),P.innerHTML=ye,ie=n(),z(v.$$.fragment),oe=n(),C=i("p"),C.textContent=ve,ue=n(),k=i("p"),k.textContent=we,A=n(),l=i("section"),c=i("a"),le=H("Previous: Entity Querying"),ce=n(),h=i("a"),he=H("Next: Entity Class"),this.h()},l(s){const w=ke("svelte-4wlam7",document.head);b=qe(w,!1),j=xe(),w.forEach(u),U=r(s),t=o(s,"SECTION",{});var a=q(t);p=o(a,"HEADER",{class:!0,"data-svelte-h":!0}),m(p)!=="svelte-1wxvjwc"&&(p.innerHTML=be),R=r(a),$=o(a,"P",{"data-svelte-h":!0}),m($)!=="svelte-zptfod"&&($.textContent=pe),F=r(a),d=o(a,"P",{});var D=q(d);K=M(D,"Before we get started, you can follow the "),S=o(D,"A",{href:!0});var _e=q(S);V=M(_e,"PubSub Server Package"),_e.forEach(u),X=M(D," page to set up a Nymph PubSub server."),D.forEach(u),Z=r(a),x=o(a,"P",{"data-svelte-h":!0}),m(x)!=="svelte-1nwoqjz"&&(x.innerHTML=de),ee=r(a),Q(g.$$.fragment,a),te=r(a),E=o(a,"P",{"data-svelte-h":!0}),m(E)!=="svelte-sbbhjn"&&(E.textContent=ge),ae=r(a),Q(f.$$.fragment,a),se=r(a),T=o(a,"P",{"data-svelte-h":!0}),m(T)!=="svelte-107lklx"&&(T.innerHTML=fe),ne=r(a),Q(y.$$.fragment,a),re=r(a),P=o(a,"P",{"data-svelte-h":!0}),m(P)!=="svelte-1hyvonj"&&(P.innerHTML=ye),ie=r(a),Q(v.$$.fragment,a),oe=r(a),C=o(a,"P",{"data-svelte-h":!0}),m(C)!=="svelte-1uz9efr"&&(C.textContent=ve),ue=r(a),k=o(a,"P",{"data-svelte-h":!0}),m(k)!=="svelte-1p6g7on"&&(k.textContent=we),a.forEach(u),A=r(s),l=o(s,"SECTION",{class:!0});var N=q(l);c=o(N,"A",{href:!0,class:!0,style:!0});var $e=q(c);le=M($e,"Previous: Entity Querying"),$e.forEach(u),ce=r(N),h=o(N,"A",{href:!0,class:!0,style:!0});var Se=q(h);he=M(Se,"Next: Entity Class"),Se.forEach(u),N.forEach(u),this.h()},h(){document.title="Subscribing to Queries - User Guide - Nymph.js",b.a=j,_(p,"class","major"),_(S,"href",me+"/packages/pubsub/"),_(c,"href",me+"/user-guide/entity-querying"),_(c,"class","button"),Ee(c,"margin",".5em"),_(h,"href",me+"/user-guide/entity-class"),_(h,"class","button"),Ee(h,"margin",".5em"),_(l,"class","page-steps")},m(s,w){b.m(Ue,document.head),e(document.head,j),I(s,U,w),I(s,t,w),e(t,p),e(t,R),e(t,$),e(t,F),e(t,d),e(d,K),e(d,S),e(S,V),e(d,X),e(t,Z),e(t,x),e(t,ee),W(g,t,null),e(t,te),e(t,E),e(t,ae),W(f,t,null),e(t,se),e(t,T),e(t,ne),W(y,t,null),e(t,re),e(t,P),e(t,ie),W(v,t,null),e(t,oe),e(t,C),e(t,ue),e(t,k),I(s,A,w),I(s,l,w),e(l,c),e(c,le),e(l,ce),e(l,h),e(h,he),L=!0},p:je,i(s){L||(Y(g.$$.fragment,s),Y(f.$$.fragment,s),Y(y.$$.fragment,s),Y(v.$$.fragment,s),L=!0)},o(s){B(g.$$.fragment,s),B(f.$$.fragment,s),B(y.$$.fragment,s),B(v.$$.fragment,s),L=!1},d(s){s&&(b.d(),u(U),u(t),u(A),u(l)),u(j),O(g),O(f),O(y),O(v)}}}class Qe extends He{constructor(b){super(),Me(this,b,null,Ae,Pe,{})}}export{Qe as component};
diff --git a/docs/_app/immutable/nodes/24.c4d2b8e8.js b/docs/_app/immutable/nodes/24.c4d2b8e8.js
deleted file mode 100644
index c34b47e..0000000
--- a/docs/_app/immutable/nodes/24.c4d2b8e8.js
+++ /dev/null
@@ -1,116 +0,0 @@
-import{S as it,i as ot,s as ut,R as ct,e as rt,a as l,k as o,q as n,y as J,F as lt,T as ht,h as a,c as h,l as u,m as c,r as i,z as K,p as Qe,n as P,C as e,b as L,A as V,D as bt,g as X,d as Z,B as ee}from"../chunks/index.d7cc8d8b.js";import{H as te,g as dt}from"../chunks/github.df9008b1.js";import{t as ae}from"../chunks/typescript.7dd1ec19.js";import{b as Be}from"../chunks/paths.d307dac8.js";function pt(nt){let g,x,M,t,T,q,se,re,A,ne,ie,v,oe,k,ue,ce,le,b,he,U,be,de,O,pe,me,ye,w,fe,N,ge,ve,E,we,d,Ee,W,Se,_e,H,$e,Pe,Te,S,qe,p,ke,I,De,je,Y,Ce,xe,Ae,_,Ue,Q,Oe,Ne,B,We,z,m,y,He,Ie,f,Ye,R;return w=new te({props:{language:ae,code:`let smiths: (User & UserData)[] = [];
-pubsub.subscribeEntities(
- {
- class: User
- },
- {
- type: '&',
- like: ['name', '% Smith']
- }
-)(
- (update) => {
- // This function will be called once initially with an array of
- // entities, then again every time there's a change with an
- // update object.
- // The updateArray function will add any newly matching entities,
- // update any existing entities that have changed, and remove any
- // entities that no longer match (including deleted entities).
- pubsub.updateArray(smiths, update);
- },
- (e) => {
- alert('Error: ' + e.textStatus);
- }
-);`}}),E=new te({props:{language:ae,code:`let smiths: (User & UserData)[] = [];
-pubsub.subscribeEntities(
- {
- class: User
- },
- {
- type: '&',
- like: ['name', '% Smith']
- }
-)(
- (update) => {
- pubsub.updateArray(smiths, update);
- },
- (e) => {
- alert('Error: ' + e.textStatus);
- },
- (count) => {
- // This function will be called each time the count of
- // subscribers to this query changes.
- console.log(\`There are now \${count} users watching the Smiths.\`);
- }
-);`}}),S=new te({props:{language:ae,code:`let smiths: (User & UserData)[] = [];
-let subscription = pubsub.subscribeEntities(
- {
- class: User
- },
- {
- type: '&',
- like: ['name', '% Smith']
- }
-)((update) => {
- pubsub.updateArray(smiths, update);
-});
-
-onDestroy(() => {
- subscription.unsubscribe();
-});`}}),_=new te({props:{language:ae,code:`let subscription = pubsub.subscribeWith(
- smithEntity,
- () => {
- if (smithEntity.guid == null) {
- if (confirm('Someone deleted Mr. Smith! Do you want to restore him?')) {
- smithEntity.$save();
- }
- } else {
- alert("Mr. Smith's entity has changed!");
- }
- },
- (e) => {
- alert('Error: ' + e.textStatus);
- },
- (count) => {
- console.log(\`There are now \${count} users watching Mr. Smith.\`);
- }
-);
-
-onDestroy(() => {
- subscription.unsubscribe();
-});`}}),{c(){g=new ct(!1),x=rt(),M=l(),t=o("section"),T=o("header"),q=o("h1"),se=n("Subscribing to Queries"),re=l(),A=o("p"),ne=n(`Subscribing to a query lets you receive updates to that query. This is a
- powerful tool for collaborative apps. It's also just as easy as making a
- regular entity query.`),ie=l(),v=o("p"),oe=n("Before we get started, you can follow the "),k=o("a"),ue=n("PubSub Server Package"),ce=n(" page to set up a Nymph PubSub server."),le=l(),b=o("p"),he=n("You can use the "),U=o("code"),be=n("subscribeEntities"),de=n(` method on PubSub to subscribe
- to a query. It will return a function you can call to subscribe to the
- query. That function accepts a resolve and reject callback, similar to a
- promise. The resolve function will receive an update, which will at first be
- an array of entities, then will be an update object with instructions that
- `),O=o("code"),pe=n("updateArray"),me=n(" uses to update the original array."),ye=l(),J(w.$$.fragment),fe=l(),N=o("p"),ge=n(`You can also receive a count of how many subscribers there are to that
- query. The count is given to a third callback.`),ve=l(),J(E.$$.fragment),we=l(),d=o("p"),Ee=n("To unsubscribe from the query, use the "),W=o("code"),Se=n("unsubscribe"),_e=n(` method on
- the
- `),H=o("code"),$e=n("PubSubSubscription"),Pe=n(" object returned by the function."),Te=l(),J(S.$$.fragment),qe=l(),p=o("p"),ke=n("You can subscribe to changes to an entity with the "),I=o("code"),De=n("subscribeWith"),je=n(`
- method. This method accepts the callbacks directly and returns a
- `),Y=o("code"),Ce=n("PubSubSubscription"),xe=n(`
- object.`),Ae=l(),J(_.$$.fragment),Ue=l(),Q=o("p"),Oe=n(`Warning: Subscriptions can lead to resource leaks if left open. Take care to
- unsubscribe to every query you are no longer watching.`),Ne=l(),B=o("p"),We=n(`Warning: The PubSub server is smart about removing entities that no longer
- match when a new entity matches, but there are some queries that can have
- changes in their matching entities without any change to the server (like
- relative time queries). These queries won't necessarily be updated correctly
- in due time by the PubSub server.`),z=l(),m=o("section"),y=o("a"),He=n("Previous: Entity Querying"),Ie=l(),f=o("a"),Ye=n("Next: Entity Class"),this.h()},l(r){const $=lt("svelte-4wlam7",document.head);g=ht($,!1),x=rt(),$.forEach(a),M=h(r),t=u(r,"SECTION",{});var s=c(t);T=u(s,"HEADER",{class:!0});var Me=c(T);q=u(Me,"H1",{style:!0});var ze=c(q);se=i(ze,"Subscribing to Queries"),ze.forEach(a),Me.forEach(a),re=h(s),A=u(s,"P",{});var Re=c(A);ne=i(Re,`Subscribing to a query lets you receive updates to that query. This is a
- powerful tool for collaborative apps. It's also just as easy as making a
- regular entity query.`),Re.forEach(a),ie=h(s),v=u(s,"P",{});var F=c(v);oe=i(F,"Before we get started, you can follow the "),k=u(F,"A",{href:!0});var Fe=c(k);ue=i(Fe,"PubSub Server Package"),Fe.forEach(a),ce=i(F," page to set up a Nymph PubSub server."),F.forEach(a),le=h(s),b=u(s,"P",{});var D=c(b);he=i(D,"You can use the "),U=u(D,"CODE",{});var Ge=c(U);be=i(Ge,"subscribeEntities"),Ge.forEach(a),de=i(D,` method on PubSub to subscribe
- to a query. It will return a function you can call to subscribe to the
- query. That function accepts a resolve and reject callback, similar to a
- promise. The resolve function will receive an update, which will at first be
- an array of entities, then will be an update object with instructions that
- `),O=u(D,"CODE",{});var Je=c(O);pe=i(Je,"updateArray"),Je.forEach(a),me=i(D," uses to update the original array."),D.forEach(a),ye=h(s),K(w.$$.fragment,s),fe=h(s),N=u(s,"P",{});var Ke=c(N);ge=i(Ke,`You can also receive a count of how many subscribers there are to that
- query. The count is given to a third callback.`),Ke.forEach(a),ve=h(s),K(E.$$.fragment,s),we=h(s),d=u(s,"P",{});var j=c(d);Ee=i(j,"To unsubscribe from the query, use the "),W=u(j,"CODE",{});var Le=c(W);Se=i(Le,"unsubscribe"),Le.forEach(a),_e=i(j,` method on
- the
- `),H=u(j,"CODE",{});var Ve=c(H);$e=i(Ve,"PubSubSubscription"),Ve.forEach(a),Pe=i(j," object returned by the function."),j.forEach(a),Te=h(s),K(S.$$.fragment,s),qe=h(s),p=u(s,"P",{});var C=c(p);ke=i(C,"You can subscribe to changes to an entity with the "),I=u(C,"CODE",{});var Xe=c(I);De=i(Xe,"subscribeWith"),Xe.forEach(a),je=i(C,`
- method. This method accepts the callbacks directly and returns a
- `),Y=u(C,"CODE",{});var Ze=c(Y);Ce=i(Ze,"PubSubSubscription"),Ze.forEach(a),xe=i(C,`
- object.`),C.forEach(a),Ae=h(s),K(_.$$.fragment,s),Ue=h(s),Q=u(s,"P",{});var et=c(Q);Oe=i(et,`Warning: Subscriptions can lead to resource leaks if left open. Take care to
- unsubscribe to every query you are no longer watching.`),et.forEach(a),Ne=h(s),B=u(s,"P",{});var tt=c(B);We=i(tt,`Warning: The PubSub server is smart about removing entities that no longer
- match when a new entity matches, but there are some queries that can have
- changes in their matching entities without any change to the server (like
- relative time queries). These queries won't necessarily be updated correctly
- in due time by the PubSub server.`),tt.forEach(a),s.forEach(a),z=h(r),m=u(r,"SECTION",{class:!0});var G=c(m);y=u(G,"A",{href:!0,class:!0,style:!0});var at=c(y);He=i(at,"Previous: Entity Querying"),at.forEach(a),Ie=h(G),f=u(G,"A",{href:!0,class:!0,style:!0});var st=c(f);Ye=i(st,"Next: Entity Class"),st.forEach(a),G.forEach(a),this.h()},h(){document.title="Subscribing to Queries - User Guide - Nymph.js",g.a=x,Qe(q,"font-size","3em"),P(T,"class","major"),P(k,"href",Be+"/packages/pubsub/"),P(y,"href",Be+"/user-guide/entity-querying"),P(y,"class","button"),Qe(y,"margin",".5em"),P(f,"href",Be+"/user-guide/entity-class"),P(f,"class","button"),Qe(f,"margin",".5em"),P(m,"class","page-steps")},m(r,$){g.m(dt,document.head),e(document.head,x),L(r,M,$),L(r,t,$),e(t,T),e(T,q),e(q,se),e(t,re),e(t,A),e(A,ne),e(t,ie),e(t,v),e(v,oe),e(v,k),e(k,ue),e(v,ce),e(t,le),e(t,b),e(b,he),e(b,U),e(U,be),e(b,de),e(b,O),e(O,pe),e(b,me),e(t,ye),V(w,t,null),e(t,fe),e(t,N),e(N,ge),e(t,ve),V(E,t,null),e(t,we),e(t,d),e(d,Ee),e(d,W),e(W,Se),e(d,_e),e(d,H),e(H,$e),e(d,Pe),e(t,Te),V(S,t,null),e(t,qe),e(t,p),e(p,ke),e(p,I),e(I,De),e(p,je),e(p,Y),e(Y,Ce),e(p,xe),e(t,Ae),V(_,t,null),e(t,Ue),e(t,Q),e(Q,Oe),e(t,Ne),e(t,B),e(B,We),L(r,z,$),L(r,m,$),e(m,y),e(y,He),e(m,Ie),e(m,f),e(f,Ye),R=!0},p:bt,i(r){R||(X(w.$$.fragment,r),X(E.$$.fragment,r),X(S.$$.fragment,r),X(_.$$.fragment,r),R=!0)},o(r){Z(w.$$.fragment,r),Z(E.$$.fragment,r),Z(S.$$.fragment,r),Z(_.$$.fragment,r),R=!1},d(r){a(x),r&&g.d(),r&&a(M),r&&a(t),ee(w),ee(E),ee(S),ee(_),r&&a(z),r&&a(m)}}}class vt extends it{constructor(g){super(),ot(this,g,null,pt,ut,{})}}export{vt as component};
diff --git a/docs/_app/immutable/nodes/25.0a00f3be.js b/docs/_app/immutable/nodes/25.0a00f3be.js
new file mode 100644
index 0000000..6314b46
--- /dev/null
+++ b/docs/_app/immutable/nodes/25.0a00f3be.js
@@ -0,0 +1,151 @@
+import{s as ut,I as yt,e as lt,a as i,f as s,l as ct,x as ft,J as gt,d as c,c as r,g as o,h as j,r as l,m as ht,j as E,k as dt,u as e,i as I,v as vt}from"../chunks/scheduler.d7e45cc8.js";import{S as wt,i as $t,b as Tt,d as bt,m as xt,a as _t,t as Ct,e as Nt}from"../chunks/index.77720afb.js";import{H as Et,g as Ht}from"../chunks/github.64534d2c.js";import{t as Mt}from"../chunks/typescript.09c48802.js";import{b as mt}from"../chunks/paths.d4a6803e.js";function Pt(pt){let p,H,M,t,u,Q='Nymph has the following methods for managing transactions.",q,$,Z="startTransaction - Start a named transaction.commit - Commit a named transaction.rollback - Rollback a named transaction.inTransaction - Check if Nymph is currently running within a transaction.startTransaction will return a new instance of Nymph. For the rest
+ of the transaction, until it is committed or rolled back, you should use this
+ instance. It will be tied to a specific connection to the database.`,A,b,et=`The transaction instance of Nymph has its own set of classes. You can use
+ its getEntityClass method to get the proper classes for that instance
+ of Nymph.`,U,x,nt=`When you start a new transaction, entities retrieved from that transaction's
+ Nymph instance will have that instance within their static nymph
+ property and instance $nymph property. As long as the entity code
+ always uses these instances, every query and change should occur within that
+ transaction.`,Y,_,at=`Not all databases that Nymph supports (specifically, MySQL with an engine
+ that doesn't support transactions, like the MyISAM engine) can use
+ transactions. To ensure data consistency, it's highly recommended to use a
+ configuration that supports transactions.`,O,C,st=`Here is an example of a class that uses a transaction to delete all of its
+ children when it is deleted. If any of its children cannot be deleted, then
+ the transaction is rolled back, meaning none of its children get deleted.`,W,y,R,N,ot=`The $setNymph method is used to make sure the entity and all
+ referenced entities use the transactional Nymph instance. The
+ tnymph Nymph instance is used during the transaction, and the
+ children are retrieved using the proper class with
+ tnymph.getEntityClass(Todo).`,P,h,d,V,F,m,G,k;return y=new Et({props:{language:Mt,code:`import { EntityUniqueConstraintError, type Nymph } from '@nymphjs/nymph';
+import { Entity, nymphJoiProps } from '@nymphjs/nymph';
+import type { AccessControlData } from '@nymphjs/tilmeld';
+import { enforceTilmeld, tilmeldJoiProps } from '@nymphjs/tilmeld';
+import Joi from 'joi';
+
+export type TodoData = {
+ name: string;
+ done: boolean;
+ parent?: Todo & TodoData;
+} & AccessControlData;
+
+export class Todo extends EntitydeleteUID - Delete a unique ID from the system.getUID - Get the current value of a unique ID.newUID - Increment or create a unique ID and return the new value.renameUID - Rename a unique ID.setUID - Set the value of a unique ID.checkClientUIDPermissions method on Tilmeld.`,L,D,z=`Caution: If a UID is incremented, and the entity you're using it on can't be
+ saved, there is no safe way to decrement the UID back to its previous value.
+ It's much better to just throw away that UID.`,w,l,c,N,S,d,M,x;return f=new he({props:{language:fe,code:`let entity = await Post.factory();
+
+entity.id = await nymph.newUID('Blog/Post');
+await entity.$save();`}}),{c(){h=new ee(!1),q=F(),b=r(),e=s("section"),m=s("header"),m.innerHTML=A,H=r(),g=s("p"),g.textContent=G,P=r(),I=s("p"),I.textContent=O,$=r(),v=s("ul"),v.innerHTML=R,j=r(),oe(f.$$.fragment),k=r(),y=s("p"),y.innerHTML=Y,L=r(),D=s("p"),D.textContent=z,w=r(),l=s("section"),c=s("a"),N=K("Previous: Defining Entities"),S=r(),d=s("a"),M=K("Next: Transactions"),this.h()},l(n){const p=te("svelte-qnlra6",document.head);h=ne(p,!1),q=F(),p.forEach(i),b=u(n),e=o(n,"SECTION",{});var a=T(e);m=o(a,"HEADER",{class:!0,"data-svelte-h":!0}),_(m)!=="svelte-1qo2qmx"&&(m.innerHTML=A),H=u(a),g=o(a,"P",{"data-svelte-h":!0}),_(g)!=="svelte-4vobrc"&&(g.textContent=G),P=u(a),I=o(a,"P",{"data-svelte-h":!0}),_(I)!=="svelte-dtbas7"&&(I.textContent=O),$=u(a),v=o(a,"UL",{"data-svelte-h":!0}),_(v)!=="svelte-ltuvp2"&&(v.innerHTML=R),j=u(a),le(f.$$.fragment,a),k=u(a),y=o(a,"P",{"data-svelte-h":!0}),_(y)!=="svelte-1o1nq16"&&(y.innerHTML=Y),L=u(a),D=o(a,"P",{"data-svelte-h":!0}),_(D)!=="svelte-unb6h4"&&(D.textContent=z),a.forEach(i),w=u(n),l=o(n,"SECTION",{class:!0});var C=T(l);c=o(C,"A",{href:!0,class:!0,style:!0});var B=T(c);N=Q(B,"Previous: Defining Entities"),B.forEach(i),S=u(C),d=o(C,"A",{href:!0,class:!0,style:!0});var J=T(d);M=Q(J,"Next: Transactions"),J.forEach(i),C.forEach(i),this.h()},h(){document.title="UIDs - User Guide - Nymph.js",h.a=q,U(m,"class","major"),U(c,"href",W+"/user-guide/defining-entities"),U(c,"class","button"),V(c,"margin",".5em"),U(d,"href",W+"/user-guide/transactions"),U(d,"class","button"),V(d,"margin",".5em"),U(l,"class","page-steps")},m(n,p){h.m(me,document.head),t(document.head,q),E(n,b,p),E(n,e,p),t(e,m),t(e,H),t(e,g),t(e,P),t(e,I),t(e,$),t(e,v),t(e,j),re(f,e,null),t(e,k),t(e,y),t(e,L),t(e,D),E(n,w,p),E(n,l,p),t(l,c),t(c,N),t(l,S),t(l,d),t(d,M),x=!0},p:ae,i(n){x||(ue(f.$$.fragment,n),x=!0)},o(n){ce(f.$$.fragment,n),x=!1},d(n){n&&(h.d(),i(b),i(e),i(w),i(l)),i(q),de(f)}}}class _e extends se{constructor(h){super(),ie(this,h,null,pe,Z,{})}}export{_e as component};
diff --git a/docs/_app/immutable/nodes/3.1d509ff4.js b/docs/_app/immutable/nodes/3.1d509ff4.js
new file mode 100644
index 0000000..822f76e
--- /dev/null
+++ b/docs/_app/immutable/nodes/3.1d509ff4.js
@@ -0,0 +1,71 @@
+import{s as he,I as de,e as Z,a as l,f as a,l as $,x as ue,J as ce,d as h,c as d,g as r,h as j,r as y,m as H,j as k,u as e,i as ee,v as me}from"../chunks/scheduler.d7e45cc8.js";import{S as pe,i as be,b as te,d as se,m as ne,a as oe,t as ae,e as re}from"../chunks/index.77720afb.js";import{H as ie,g as fe}from"../chunks/github.64534d2c.js";import{b as ye}from"../chunks/bash.7e4226ac.js";import{t as ge}from"../chunks/typescript.09c48802.js";import{b as ve}from"../chunks/paths.d4a6803e.js";function Te(le){let u,C,N,t,c,G='@nymphjs/client:",B,v,F,N,pe="Then set up Nymph and PubSub like normal:",K,y,P;return f=new ne({props:{language:He,code:"npm install --save @nymphjs/client-node"}}),v=new ne({props:{language:ge,code:"const { Nymph, PubSub } = require('@nymphjs/client-node');"}}),y=new ne({props:{language:ge,code:`const nymphOptions = {
+ restUrl: 'https://yournymphrestserver/path/to/your/endpoint',
+ pubsubUrl: 'wss://yournymphpubsubserver',
+};
+const nymph = new Nymph(nymphOptions);
+const pubsub = new PubSub(nymphOptions, nymph);`}}),{c(){c=new _e(!1),H=ue(),w=l(),t=s("section"),d=s("header"),d.innerHTML=ae,O=l(),_=s("p"),_.textContent=se,q=l(),u=s("header"),u.innerHTML=oe,D=l(),Q(f.$$.fragment),A=l(),r=s("p"),J=S("This package is the Nymph client for Node.js. You can find CJS in "),x=s("code"),x.textContent=re,R=S(", or TS source in "),C=s("code"),C.textContent=le,I=S(`. There is also a
+ `),E=s("strong"),b=s("a"),U=S("browser client"),z=S("."),Y=l(),$=s("p"),$.textContent=ie,G=l(),g=s("header"),g.innerHTML=he,W=l(),T=s("p"),T.innerHTML=me,B=l(),Q(v.$$.fragment),F=l(),N=s("p"),N.textContent=pe,K=l(),Q(y.$$.fragment),this.h()},l(a){const j=xe("svelte-1vkc5se",document.head);c=Ce(j,!1),H=ue(),j.forEach(p),w=i(a),t=o(a,"SECTION",{});var n=L(t);d=o(n,"HEADER",{class:!0,"data-svelte-h":!0}),h(d)!=="svelte-kq687x"&&(d.innerHTML=ae),O=i(n),_=o(n,"P",{"data-svelte-h":!0}),h(_)!=="svelte-3yk1jg"&&(_.textContent=se),q=i(n),u=o(n,"HEADER",{class:!0,"data-svelte-h":!0}),h(u)!=="svelte-1hx9pnb"&&(u.innerHTML=oe),D=i(n),V(f.$$.fragment,n),A=i(n),r=o(n,"P",{});var m=L(r);J=k(m,"This package is the Nymph client for Node.js. You can find CJS in "),x=o(m,"CODE",{"data-svelte-h":!0}),h(x)!=="svelte-14vfyz8"&&(x.textContent=re),R=k(m,", or TS source in "),C=o(m,"CODE",{"data-svelte-h":!0}),h(C)!=="svelte-1fkgjes"&&(C.textContent=le),I=k(m,`. There is also a
+ `),E=o(m,"STRONG",{});var ce=L(E);b=o(ce,"A",{href:!0});var de=L(b);U=k(de,"browser client"),de.forEach(p),ce.forEach(p),z=k(m,"."),m.forEach(p),Y=i(n),$=o(n,"P",{"data-svelte-h":!0}),h($)!=="svelte-1qaxaoa"&&($.textContent=ie),G=i(n),g=o(n,"HEADER",{class:!0,"data-svelte-h":!0}),h(g)!=="svelte-n87w0o"&&(g.innerHTML=he),W=i(n),T=o(n,"P",{"data-svelte-h":!0}),h(T)!=="svelte-vwsf9r"&&(T.innerHTML=me),B=i(n),V(v.$$.fragment,n),F=i(n),N=o(n,"P",{"data-svelte-h":!0}),h(N)!=="svelte-1xojua4"&&(N.textContent=pe),K=i(n),V(y.$$.fragment,n),n.forEach(p),this.h()},h(){document.title="Node Client - Packages - Nymph.js",c.a=H,M(d,"class","major"),M(u,"class","major"),M(b,"href",Ee+"/packages/client"),M(g,"class","major")},m(a,j){c.m(Ne,document.head),e(document.head,H),fe(a,w,j),fe(a,t,j),e(t,d),e(t,O),e(t,_),e(t,q),e(t,u),e(t,D),X(f,t,null),e(t,A),e(t,r),e(r,J),e(r,x),e(r,R),e(r,C),e(r,I),e(r,E),e(E,b),e(b,U),e(r,z),e(t,Y),e(t,$),e(t,G),e(t,g),e(t,W),e(t,T),e(t,B),X(v,t,null),e(t,F),e(t,N),e(t,K),X(y,t,null),P=!0},p:be,i(a){P||(Z(f.$$.fragment,a),Z(v.$$.fragment,a),Z(y.$$.fragment,a),P=!0)},o(a){ee(f.$$.fragment,a),ee(v.$$.fragment,a),ee(y.$$.fragment,a),P=!1},d(a){a&&(c.d(),p(w),p(t)),p(H),te(f),te(v),te(y)}}}class Oe extends $e{constructor(c){super(),Te(this,c,null,je,ye,{})}}export{Oe as component};
diff --git a/docs/_app/immutable/nodes/4.a6408b4a.js b/docs/_app/immutable/nodes/4.a6408b4a.js
deleted file mode 100644
index c6884e0..0000000
--- a/docs/_app/immutable/nodes/4.a6408b4a.js
+++ /dev/null
@@ -1,12 +0,0 @@
-import{S as Ae,i as Re,s as Je,R as Ue,e as Oe,a as d,k as o,q as h,y as de,F as Ie,T as ze,h as s,c as p,l as r,m as l,r as i,z as pe,p as We,n as J,C as e,b as De,A as me,D as Ye,g as fe,d as ue,B as ge}from"../chunks/index.d7cc8d8b.js";import{H as ye,g as Be}from"../chunks/github.df9008b1.js";import{b as Fe}from"../chunks/bash.2b754df6.js";import{t as qe}from"../chunks/typescript.7dd1ec19.js";import{b as Ge}from"../chunks/paths.d307dac8.js";function Ke(xe){let f,T,x,t,b,E,U,I,S,z,W,v,C,Y,B,u,F,c,G,k,K,L,w,M,Q,P,N,V,X,Z,j,ee,te,$,H,ae,se,g,ne,O,oe,re,le,y,he,D,ie,ce,_,A;return u=new ye({props:{language:Fe,code:"npm install --save @nymphjs/client-node"}}),y=new ye({props:{language:qe,code:"const { Nymph, PubSub } = require('@nymphjs/client-node');"}}),_=new ye({props:{language:qe,code:`const nymphOptions = {
- restUrl: 'https://yournymphrestserver/path/to/your/endpoint',
- pubsubUrl: 'wss://yournymphpubsubserver',
-};
-const nymph = new Nymph(nymphOptions);
-const pubsub = new PubSub(nymphOptions, nymph);`}}),{c(){f=new Ue(!1),T=Oe(),x=d(),t=o("section"),b=o("header"),E=o("h1"),U=h("Node Client"),I=d(),S=o("p"),z=h(`The Nymph Node Client lets you do everything the Nymph Client does, but from
- Node.JS instead of the browser.`),W=d(),v=o("header"),C=o("h2"),Y=h("Installation"),B=d(),de(u.$$.fragment),F=d(),c=o("p"),G=h("This package is the Nymph client for Node.js. You can find CJS in "),k=o("code"),K=h("dist"),L=h(", or TS source in "),w=o("code"),M=h("src"),Q=h(`. There is also a
- `),P=o("strong"),N=o("a"),V=h("browser client"),X=h("."),Z=d(),j=o("p"),ee=h(`This package provides fetch and WebSocket ponyfills to Nymph and handles
- Tilmeld auth tokens.`),te=d(),$=o("header"),H=o("h2"),ae=h("Usage"),se=d(),g=o("p"),ne=h("To use, require it instead of "),O=o("code"),oe=h("@nymphjs/client"),re=h(":"),le=d(),de(y.$$.fragment),he=d(),D=o("p"),ie=h("Then set up Nymph and PubSub like normal:"),ce=d(),de(_.$$.fragment),this.h()},l(n){const q=Ie("svelte-1vkc5se",document.head);f=ze(q,!1),T=Oe(),q.forEach(s),x=p(n),t=r(n,"SECTION",{});var a=l(t);b=r(a,"HEADER",{class:!0});var _e=l(b);E=r(_e,"H1",{style:!0});var be=l(E);U=i(be,"Node Client"),be.forEach(s),_e.forEach(s),I=p(a),S=r(a,"P",{});var Ee=l(S);z=i(Ee,`The Nymph Node Client lets you do everything the Nymph Client does, but from
- Node.JS instead of the browser.`),Ee.forEach(s),W=p(a),v=r(a,"HEADER",{class:!0});var ve=l(v);C=r(ve,"H2",{});var Ne=l(C);Y=i(Ne,"Installation"),Ne.forEach(s),ve.forEach(s),B=p(a),pe(u.$$.fragment,a),F=p(a),c=r(a,"P",{});var m=l(c);G=i(m,"This package is the Nymph client for Node.js. You can find CJS in "),k=r(m,"CODE",{});var $e=l(k);K=i($e,"dist"),$e.forEach(s),L=i(m,", or TS source in "),w=r(m,"CODE",{});var Te=l(w);M=i(Te,"src"),Te.forEach(s),Q=i(m,`. There is also a
- `),P=r(m,"STRONG",{});var Se=l(P);N=r(Se,"A",{href:!0});var Ce=l(N);V=i(Ce,"browser client"),Ce.forEach(s),Se.forEach(s),X=i(m,"."),m.forEach(s),Z=p(a),j=r(a,"P",{});var ke=l(j);ee=i(ke,`This package provides fetch and WebSocket ponyfills to Nymph and handles
- Tilmeld auth tokens.`),ke.forEach(s),te=p(a),$=r(a,"HEADER",{class:!0});var we=l($);H=r(we,"H2",{});var Pe=l(H);ae=i(Pe,"Usage"),Pe.forEach(s),we.forEach(s),se=p(a),g=r(a,"P",{});var R=l(g);ne=i(R,"To use, require it instead of "),O=r(R,"CODE",{});var je=l(O);oe=i(je,"@nymphjs/client"),je.forEach(s),re=i(R,":"),R.forEach(s),le=p(a),pe(y.$$.fragment,a),he=p(a),D=r(a,"P",{});var He=l(D);ie=i(He,"Then set up Nymph and PubSub like normal:"),He.forEach(s),ce=p(a),pe(_.$$.fragment,a),a.forEach(s),this.h()},h(){document.title="Node Client - Packages - Nymph.js",f.a=T,We(E,"font-size","3em"),J(b,"class","major"),J(v,"class","major"),J(N,"href",Ge+"/packages/client"),J($,"class","major")},m(n,q){f.m(Be,document.head),e(document.head,T),De(n,x,q),De(n,t,q),e(t,b),e(b,E),e(E,U),e(t,I),e(t,S),e(S,z),e(t,W),e(t,v),e(v,C),e(C,Y),e(t,B),me(u,t,null),e(t,F),e(t,c),e(c,G),e(c,k),e(k,K),e(c,L),e(c,w),e(w,M),e(c,Q),e(c,P),e(P,N),e(N,V),e(c,X),e(t,Z),e(t,j),e(j,ee),e(t,te),e(t,$),e($,H),e(H,ae),e(t,se),e(t,g),e(g,ne),e(g,O),e(O,oe),e(g,re),e(t,le),me(y,t,null),e(t,he),e(t,D),e(D,ie),e(t,ce),me(_,t,null),A=!0},p:Ye,i(n){A||(fe(u.$$.fragment,n),fe(y.$$.fragment,n),fe(_.$$.fragment,n),A=!0)},o(n){ue(u.$$.fragment,n),ue(y.$$.fragment,n),ue(_.$$.fragment,n),A=!1},d(n){s(T),n&&f.d(),n&&s(x),n&&s(t),ge(u),ge(y),ge(_)}}}class Ze extends Ae{constructor(f){super(),Re(this,f,null,Ke,Je,{})}}export{Ze as component};
diff --git a/docs/_app/immutable/nodes/5.0b26b696.js b/docs/_app/immutable/nodes/5.0b26b696.js
new file mode 100644
index 0000000..cb29641
--- /dev/null
+++ b/docs/_app/immutable/nodes/5.0b26b696.js
@@ -0,0 +1,15 @@
+import{s as W,I as X,e as I,a as s,f as o,x as Y,J as Z,d as H,c as r,g as l,h as ee,r as f,j as $,u as a,i as z,v as te}from"../chunks/scheduler.d7e45cc8.js";import{S as ae,i as ne,b as O,d as J,m as U,a as B,t as F,e as G}from"../chunks/index.77720afb.js";import{H as K,g as se}from"../chunks/github.64534d2c.js";import{b as re}from"../chunks/bash.7e4226ac.js";import{t as oe}from"../chunks/typescript.09c48802.js";function le(V){let i,_,L,e,h,q='Optional stackStatic Optional prepareStatic stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureEntity interface.
+Initialize an entity.
+Rest ..._rest: any[]Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Protected $dirtyA map of props to whether they're dirty (for patch).
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Protected $originalArray of the entity's original tags (for patch).
+Protected $sleepingThe reference to use to wake.
+Protected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a high precision Unix timestamp.
+The entity's Globally Unique ID.
+The modified date of the entity as a high precision Unix timestamp.
+Array of the entity's tags.
+Static classThe lookup name for this entity.
+This is used for reference arrays (and sleeping references) and server +requests.
+Static nymphThe instance of Nymph to use for queries.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Whether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Protected $checkGet a patch of this entity's dirty data to be applied on the server.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Whether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Initialize this entity from a JSON representation.
+The entity JSON.
+Protected $referenceRefresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Call an instance method on the server version of this entity.
+The entity's data will be sent up to the server as well, so the server's +state can match the client's state. It won't be propagated into the DB, +though.
+The name of the method.
+The parameters to call the method with.
+Whether the server should return, and the client update, the data in the entity after the method has run.
+The value that the method on the server returned.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Ready this entity's data, and the data of entity's within this one's.
+Optional level: numberThe number of levels deep to wake. If undefined, it will keep going until there are no more entities. (Careful of infinite loops.)
+The entity.
+Static factoryCreate or retrieve a new entity instance.
+Note that this will always return an entity, even if the GUID is not found.
+Static factoryCreate a new sleeping reference instance.
+Sleeping references won't retrieve their data from the server until they
+are readied with $wake() or a parent's $wakeAll().
The Nymph Entity Reference to use to wake.
+The new instance.
+Static factoryCreate a new entity instance.
+Static serverStatic serverCall a static iterator method on the server version of this entity.
+The name of the method.
+The parameters to call the method with.
+An iterator that iterates over values that the method on the server yields.
+Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureThe entity class for this instance of Nymph.
+The entity cache.
+Private entityA simple map of names to Entity classes.
+Headers that will be sent with every request.
+These are used by Tilmeld for authentication.
+And optional PubSub client instance.
+Private requestPrivate responsePrivate restPrivate weakAdd your class to this instance.
+This will create a class that extends your class within this instance of +Nymph and return it. You can then use this class's constructor and methods, +which will use this instance of Nymph.
+Because this creates a subclass, don't use the class
+returned from getEntityClass to check with instanceof.
Private requestPrivate WebOptional protocols: string | string[]Readonly CLOSED: 3Readonly CLOSING: 2Readonly CONNECTING: 0Readonly OPEN: 1Private authPrivate connectPrivate connectionPrivate disconnectPrivate errorPrivate noPrivate nymphPrivate pubsubPrivate subscriptionsPrivate switchPrivate waitPrivate _attemptPrivate _isPrivate _isPrivate _onclosePrivate _onmessagePrivate _onopenPrivate _sendPrivate _sendPrivate _sendUIDPrivate _sendPrivate _sendPrivate _subscribePrivate _subscribeUIDPrivate _unsubscribePrivate _unsubscribeUIDPrivate _waitOptional resolve: PubSubResolveCallback<number>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackOptional resolve: PubSubResolveCallback<T>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureThe entity class for this instance of Nymph.
+The entity cache.
+Headers that will be sent with every request.
+These are used by Tilmeld for authentication.
+And optional PubSub client instance.
+Add your class to this instance.
+This will create a class that extends your class within this instance of +Nymph and return it. You can then use this class's constructor and methods, +which will use this instance of Nymph.
+Because this creates a subclass, don't use the class
+returned from getEntityClass to check with instanceof.
Optional _plural: booleanOptional stateless: booleanOptional resolve: PubSubResolveCallback<number>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackOptional resolve: PubSubResolveCallback<T>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackThe MySQL Nymph database driver.
+Optional link: PoolOptional transaction: MySQLDriverTransactionProtected connectedProtected entityA cache to make entity retrieval faster.
+Protected entityA counter for the entity cache to determine the most accessed entities.
+Protected linkPrivate mysqlProtected nymphProtected prefixProtected transactionOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
+A clone of this instance.
+Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
+Any value to search.
+An entity, GUID, or array of either to search for.
+True if the reference is found, false otherwise.
+Protected findPrivate getProtected getInitialize the Nymph driver.
+This is meant to be called internally by Nymph. Don't call this directly.
+The Nymph instance.
+Protected internalProtected iteratePrivate makeGenerate the MySQL query.
+The options array.
+The formatted selector array.
+Used to track internal params.
+Used to store internal params.
+Whether only a subquery should be returned.
+The SQL query.
+Protected performProtected posixProtected pullPull an entity from the cache.
+The entity's GUID.
+The entity's class.
+Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
+The entity or null if it's not cached.
+Protected pushPush an entity onto the cache.
+The entity's GUID.
+The entity's cdate.
+The entity's mdate.
+The entity's tags.
+The entity's data.
+The entity's sdata.
+Private queryPrivate queryPrivate queryPrivate queryProtected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Private translateStatic escapeStatic escapeThe PostgreSQL Nymph database driver.
+Optional link: PoolOptional transaction: PostgreSQLDriverTransactionProtected connectedProtected entityA cache to make entity retrieval faster.
+Protected entityA counter for the entity cache to determine the most accessed entities.
+Protected linkProtected nymphPrivate postgresqlProtected prefixProtected transactionOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
+A clone of this instance.
+Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
+Any value to search.
+An entity, GUID, or array of either to search for.
+True if the reference is found, false otherwise.
+Protected findPrivate getProtected getInitialize the Nymph driver.
+This is meant to be called internally by Nymph. Don't call this directly.
+The Nymph instance.
+Protected internalProtected iteratePrivate makeGenerate the PostgreSQL query.
+The options array.
+The formatted selector array.
+Used to track internal params.
+Used to store internal params.
+Whether only a subquery should be returned.
+The SQL query.
+Protected performProtected posixProtected pullPull an entity from the cache.
+The entity's GUID.
+The entity's class.
+Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
+The entity or null if it's not cached.
+Protected pushPush an entity onto the cache.
+The entity's GUID.
+The entity's cdate.
+The entity's mdate.
+The entity's tags.
+The entity's data.
+The entity's sdata.
+Private queryPrivate queryPrivate queryPrivate queryOptional connection?: PostgreSQLDriverConnectionOptional etypes?: string[]Optional params?: { Protected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Private translateStatic escapeStatic escapeStatic escapeStatic escapeStatic unescapeStatic unescapeThe SQLite3 Nymph database driver.
+Optional store: InternalStoreProtected entityA cache to make entity retrieval faster.
+Protected entityA counter for the entity cache to determine the most accessed entities.
+Protected nymphProtected prefixProtected storePrivate _connectOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
+A clone of this instance.
+Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
+Any value to search.
+An entity, GUID, or array of either to search for.
+True if the reference is found, false otherwise.
+Protected findProtected getInitialize the Nymph driver.
+This is meant to be called internally by Nymph. Don't call this directly.
+The Nymph instance.
+Protected iteratePrivate makeGenerate the SQLite3 query.
+The options array.
+The formatted selector array.
+Used to track internal params.
+Used to store internal params.
+Whether only a subquery should be returned.
+The SQL query.
+Protected performProtected posixProtected pullPull an entity from the cache.
+The entity's GUID.
+The entity's class.
+Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
+The entity or null if it's not cached.
+Protected pushPush an entity onto the cache.
+The entity's GUID.
+The entity's cdate.
+The entity's mdate.
+The entity's tags.
+The entity's data.
+The entity's sdata.
+Private queryPrivate queryPrivate queryPrivate queryProtected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Static escapeOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureDatabase abstraction object.
+Provides a way to access, manipulate, and store data in Nymph.
+The GUID is not set until the entity is saved. GUIDs must be unique forever, +even after deletion. It's the job of the Nymph DB driver to make sure no two +entities ever have the same GUID. This is generally done by using a large +randomly generated ID.
+Each entity class has an etype that determines which table(s) in the database +it belongs to. If two entity classes have the same etype, their data will be +stored in the same table(s). This isn't a good idea, however, because +references to an entity store a class name, not an etype.
+Tags are used to classify entities. Where an etype is used to separate data +by tables, tags can be used to separate entities within a table. You can +define specific tags to be protected, meaning they cannot be added/removed +from the client. It can be useful to allow user defined tags, such as for +blog posts.
+Simply calling $delete() will not unset the entity. It will still take up +memory. Likewise, simply calling unset will not delete the entity from the +DB.
+Some notes about $equals() and $is(), the replacements for "==":
+The == operator will likely not give you the result you want, since two +instances of the same entity will fail that check, even though they represent +the same data in the database.
+$equals() performs a more strict comparison of the entity to another. Use +$equals() instead of the == operator when you want to check both the entities +they represent, and the data inside them. In order to return true for +$equals(), the entity and object must meet the following criteria:
+$is() performs a less strict comparison of the entity to another. Use $is() +instead of the == operator when the entity's data may have been changed, but +you only care if they represent the same entity. In order to return true, the +entity and object must meet the following criteria:
+Some notes about saving entities in other entity's properties:
+Entities use references in the DB to store an entity in their properties. The +reference is stored as an array with the values:
+Since the referenced entity's class name (meaning the class static
+property, not the name of the class itself) is stored in the reference on the
+parent entity, if you change the class name in an update, you need to
+reassign all referenced entities of that class and resave.
When an entity is loaded, it does not request its referenced entities from +Nymph. Instead, it creates instances without data called sleeping references. +When you first access an entity's data, if it is a sleeping reference, it +will fill its data from the DB. You can call clearCache() to turn all the +entities back into sleeping references.
+Initialize an entity.
+Rest ..._rest: any[]Protected Optional $allowlistIf this is defined, then it lists the only properties that will be +accepted from incoming JSON. Any other properties will be ignored.
+If you use an allowlist, you don't need to use protectedData, since you +can simply leave those entries out of allowlistData.
+Protected Optional $allowlistIf this is defined, then it lists the only tags that will be accepted from +incoming JSON. Any other tags will be ignored.
+Protected $clientThe names of methods allowed to be called by the frontend with serverCall.
+Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Private $originalThe AC properties' values when the entity was loaded.
+Protected $privateProperties that will not be serialized into JSON with toJSON(). This +can be considered a denylist, because these properties will not be set +with incoming JSON.
+Clients CAN still determine what is in these properties, unless they are +also listed in searchRestrictedData.
+Protected $protectedProperties that can only be modified by server side code. They will still +be visible on the frontend, unlike $privateData, but any changes to them +that come from the frontend will be ignored.
+In addition to what's listed here, all of the access control properties +will be included when Tilmeld is being used. These are:
+You should modify these through client enabled methods or the $save method +instead, for safety.
+Protected $protectedTags that can only be added/removed by server side code. They will still be +visible on the frontend, but any changes to them that come from the +frontend will be ignored.
+Protected $sdataThe actual sdata store.
+Private $skipWhether to use "skipAc" when accessing entity references.
+Protected $sleepingThe reference to use to wake.
+Protected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a Unix timestamp in milliseconds.
+The entity's Globally Unique ID.
+This is a 12 byte number represented as a lower case HEX string (24 +characters).
+The modified date of the entity as a Unix timestamp in milliseconds.
+Array of the entity's tags.
+Static ETYPEA unique name for this type of entity used to separate its data from other +types of entities in the database.
+Static classThe lookup name for this entity.
+This is used for reference arrays (and sleeping references) and client +requests.
+Static clientThe names of static methods allowed to be called by the frontend with +serverCallStatic.
+Static nymphThe instance of Nymph to use for queries.
+Static pubWhether this entity should publish changes to PubSub servers.
+Static restWhether this entity should be accessible on the frontend through the REST +server.
+If this is false, any request from the client that attempts to use this +entity will fail.
+Static searchProperties that will not be searchable from the frontend. If the frontend +includes any of these properties in any of their clauses, they will be +filtered out before the search is executed.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Whether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Protected $checkGet the current values of the AC properties.
+An object of AC properties.
+Get the original values of the AC properties.
+An object of AC properties.
+Used to retrieve the serialized data object.
+This should only be used by Nymph to save the data object into storage.
+This method is used by Nymph to avoid unserializing data that hasn't been +requested yet.
+It should always be called after getData().
+The entity's serialized data object.
+Get an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this method returns an empty array, meaning +there are no uniqueness constraints applied to its etype.
+Resolves to an array of entity's unique constraint strings.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Whether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Accept JSON data from the client.
+This function uses the security protection lists:
+The input data. Please note, this will be modified (destroyed).
+Allow to accept data that is older than the current data.
+Accept JSON patch from the client.
+This function uses the security protection lists:
+The patch data. Please note, this will be modified (destroyed).
+Allow to accept data that is older than the current data.
+Used to set the data.
+This should only be used by Nymph to push the data from storage.
+sdata is used by Nymph to avoid unserializing data that hasn't been
+requested yet.
The data object.
+Optional sdata: SerializedEntityDataThe serialized data object.
+Protected $referenceSet up a sleeping reference.
+Refresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Static Optional alterStatic factoryCreate or retrieve a new entity instance.
+Note that this will always return an entity, even if the GUID is not found.
+Static factoryCreate a new sleeping reference instance.
+Sleeping references won't retrieve their data from the database until they
+are readied with $wake() or a parent's $wakeAll().
The Nymph Entity Reference to use to wake.
+The new instance.
+Static factoryCreate a new entity instance.
+Static getGet an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this static method instantiates the entity,
+assigns all of the given data, then calls $getUniques and returns its
+output. This can have a performance impact if a lot of extra processing
+happens during any of these steps. You can override this method to
+calculate the unique strings faster, but you must return the same strings
+that would be returned by $getUniques.
Optional cdate?: numberOptional guid?: stringOptional mdate?: numberOptional sdata?: SerializedEntityDataResolves to an array of entity's unique constraint strings.
+Optional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureEntityInvalidDataError.
+This exception is meant to be thrown when an attempt to save an entity is +made, and validation on the data of that entity fails.
+Optional causePrivate fieldsOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureAn object relational mapper for Node.js.
+Written by Hunter Perrin for SciActive.
+Initialize Nymph.
+The Nymph configuration.
+The Nymph database driver.
+Optional tilmeld: TilmeldInterfaceThe Tilmeld user/group manager instance, if you want to use it.
+Optional parent: NymphUsed internally by Nymph. Don't set this.
+The entity class for this instance of Nymph.
+Private afterPrivate afterPrivate afterPrivate afterPrivate afterPrivate afterPrivate afterPrivate afterPrivate afterPrivate afterPrivate beforePrivate beforePrivate beforePrivate beforePrivate beforePrivate beforePrivate beforePrivate beforePrivate beforePrivate beforePrivate beforePrivate beforeThe Nymph config.
+Private connectPrivate disconnectThe Nymph database driver.
+Private entityA simple map of names to Entity classes.
+Private failedPrivate failedPrivate failedPrivate failedPrivate failedPrivate failedPrivate failedThe Nymph instance that this one was cloned from, or null if it's not a +clone.
+Private queryOptional tilmeldAn optional Tilmeld user/group manager instance.
+Add your class to this instance.
+This will create a class that extends your class within this instance of +Nymph and return it. You can then use this class's constructor and methods, +which will use this instance of Nymph.
+Because this creates a subclass, don't use the class
+returned from getEntityClass to check with instanceof.
Delete an entity from the database.
+The entity.
+True on success, false on failure.
+Export entities to a local file.
+This is the file format:
+#nex2
# The above line must be the first thing in the file.
# Comments begin with #
# And can have white space before them.
# This defines a UID.
<name/of/uid>[5]
<another uid>[8000]
# For UIDs, the name is in angle brackets (<>) and the value follows
# in square brackets ([]).
# This starts a new entity.
{1234abcd}<etype>[tag,list,with,commas]
# For entities, the GUID is in curly brackets ({}), then the etype in
# angle brackets, then the comma separated tag list follows in square
# brackets ([]).
# Properties are stored like this:
# propname=JSON.stringify(value)
abilities=["system/admin"]
groups=[]
inheritAbilities=false
name="admin"
# White space before/after "=" and at beginning/end of line is ignored.
username = "admin"
{2}<etype>[tag,list]
another="This is another entity."
newline="\n"
+The file to export to.
+True on success, false on failure.
+Get an array of entities.
+options is an object, which contains any of the following settings:
If a class is specified, it must have a factory() static method that +returns a new instance.
+Selectors are objects. Any amount of selectors can be provided. Empty
+selectors will be ignored. The type property of a selector is required
+and can be one of the following strings:
The rest of the properties in the selectors are called selector clauses, +which can be any of the following (in the form selector.name = value, or +selector.name = [value1, value2,...]):
+These clauses can all be negated, by prefixing them with an exclamation +point, such as "!truthy" to mean falsy (or undefined).
+Any clause that accepts an array of name and value can also accept a third +element. If value is null and the third element is a string, the third +element will be used with Locutus' strtotime function to set value to a +relative timestamp. For example, the following selector will look for all +entities that were created in the last day:
+{
type: '&',
gte: ['cdate', null, '-1 day']
}
+Locutus' implementation: https://locutus.io/php/datetime/strtotime/ +PHP's documentation: https://www.php.net/manual/en/function.strtotime.php
+This example will retrieve the last two entities where:
+const entities = Nymph.getEntities(
{ class: Entity, reverse: true, limit: 2 },
{
type: '&', // all must be true
tag: 'person',
defined: 'spouse',
equal: [
['gender', 'male'],
['lname', 'Smith']
],
'!equal': ['warnings', 0]
},
{
type: '|', // at least one of the selectors in this must match
selector: [
{
type: '&',
tag: ['level1', 'level2']
},
{
type: '&',
tag: ['access1', 'access2']
}
]
},
{
type: '|', // at least one must be true
tag: ['employee', 'manager']
},
{
type: '|',
equal: [
['name', 'Clark'],
['name', 'James']
],
match: [
['name', 'Chris(topher)?'],
['name', 'Ja(ke|cob)']
]
},
{
type: '!|', // at least one must be false
gte: ['age', 22],
gt: ['pay', 8]
}
);
+An array of entities or guids, or a count.
+Use an asterisk to specify any variable.
+Get the first entity to match all options/selectors.
+options and selectors are the same as in getEntities().
+This function is equivalent to setting options.limit to 1 for +getEntities(), except that it will return null if no entity is found. +getEntities() would return an empty array.
+An entity or guid, or null on failure or nothing found, or a number.
+Get the class that uses the specified class name.
+Get the class that uses the specified etype.
+Note that it is fine, though unusual, for two classes to use the same +etype. However, this can lead to very hard to diagnose bugs, so is +generally discouraged.
+Increment or create a unique ID and return the new value.
+Unique IDs, or UIDs are similar to GUIDs, but numeric and sequential.
+A UID can be used to identify an object when the GUID doesn't suffice. On +a system where a new entity is created many times per second, referring +to something by its GUID may be unintuitive. However, the component +designer is responsible for assigning UIDs to the component's entities. +Beware that if a UID is incremented for an entity, and the entity cannot +be saved, there is no safe, and therefore, no recommended way to +decrement the UID back to its previous value.
+If newUID() is passed the name of a UID which does not exist yet, one +will be created with that name, and assigned the value 1. If the UID +already exists, its value will be incremented. The new value will be +returned.
+The UID's name.
+The UID's new value, or null on failure.
+Run all the query callbacks on a query.
+Save an entity to the database.
+If the entity has never been saved (has no GUID), a variable "cdate" +is set on it with the current Unix timestamp.
+The variable "mdate" is set to the current Unix timestamp.
+The entity.
+True on success, false on failure.
+Start an atomic transaction and returns a new instance of Nymph.
+All proceeding changes using this new instance will wait to be written to +the database's permanent storage until commit() is called. You can also +undo all the changes since this function ran with rollback().
+Transactions will nest as long as every name is unique. Internally, Nymph +uses names prefixed with "nymph-".
+A new instance of Nymph that should be used for the transaction.
+Abstract A Nymph database driver.
+Protected entityA cache to make entity retrieval faster.
+Protected entityA counter for the entity cache to determine the most accessed entities.
+Protected nymphPrivate putProtect against infinite loops.
+Protected cleanAbstract cloneThis is used internally by Nymph. Don't call it yourself.
+A clone of this instance.
+Abstract commitAbstract connectAbstract deleteOptional className: stringAbstract deleteUIDAbstract disconnectProtected entitySearch through a value for an entity reference.
+Any value to search.
+An entity, GUID, or array of either to search for.
+True if the reference is found, false otherwise.
+Abstract exportProtected findAbstract getProtected getAbstract getUIDAbstract importAbstract importUIDAbstract inInitialize the Nymph driver.
+This is meant to be called internally by Nymph. Don't call this directly.
+The Nymph instance.
+Protected Abstract internalAbstract isProtected iterateAbstract needsAbstract newUIDProtected posixProtected pullPull an entity from the cache.
+The entity's GUID.
+The entity's class.
+Whether to tell the entity to use skip_ac.
+The entity or null if it's not cached.
+Protected pushPush an entity onto the cache.
+The entity's GUID.
+The entity's cdate.
+The entity's mdate.
+The entity's tags.
+The entity's data.
+The entity's sdata.
+Abstract renameUIDAbstract rollbackAbstract saveProtected saveAbstract setUIDAbstract startOptional query: stringOptional causePrivate Optional queryOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureA publish/subscribe server for Nymph.
+Written by Hunter Perrin for SciActive.
+The PubSub config.
+The Nymph instance.
+Protected queryThe WebSocket server.
+Private sessionsOptional switchProtected uidProtected Static transactionPrivate findQRefRest ...selectors: Selector[]Private handleHandle an authentication from a client.
+Private handleHandle a publish from a client.
+Private handleHandle an entity publish from a client.
+Private handleHandle a UID publish from a client.
+Private handleHandle a subscribe or unsubscribe from a client.
+Private handleHandle a subscribe or unsubscribe for a query from a client.
+Optional qrefParent: { Private handleHandle a subscribe or unsubscribe for a UID from a client.
+Private relayPrivate translateQRefPrivate updateStatic initPrivate Static isPrivate Static publishPrivate Static publishPrivate Static removeOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackOptional statusOptional statusStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureEntity Array Sorter
+Sorting functions sort the array in place and also return the sorted array.
+Private collatorPrivate comparatorPrivate sortPrivate sortPrivate _arraySort an array of entities hierarchically by a specified property's value.
+Entities will be placed immediately after their parents. The
+parentProperty property, if present, should hold either null, undefined,
+or the entity's parent.
The name of the property to sort entities by.
+The name of the property which holds the parent of the entity.
+Sort an array of entities by parent and a specified property's value.
+Entities' will be sorted by their parents' properties, then the entities' +properties.
+The name of the property to sort entities by.
+The name of the property which holds the parent of the entity.
+Sort an array of entities by a specified property's value.
+The name of the property to sort entities by.
+Abstract AbleObject abstract class.
+Used in entities which support abilities, such as users and groups.
+Initialize an entity.
+Rest ..._rest: any[]Protected Optional $allowlistIf this is defined, then it lists the only properties that will be +accepted from incoming JSON. Any other properties will be ignored.
+If you use an allowlist, you don't need to use protectedData, since you +can simply leave those entries out of allowlistData.
+Protected Optional $allowlistIf this is defined, then it lists the only tags that will be accepted from +incoming JSON. Any other tags will be ignored.
+Protected $clientThe names of methods allowed to be called by the frontend with serverCall.
+Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Protected $privateProperties that will not be serialized into JSON with toJSON(). This +can be considered a denylist, because these properties will not be set +with incoming JSON.
+Clients CAN still determine what is in these properties, unless they are +also listed in searchRestrictedData.
+Protected $protectedProperties that can only be modified by server side code. They will still +be visible on the frontend, unlike $privateData, but any changes to them +that come from the frontend will be ignored.
+In addition to what's listed here, all of the access control properties +will be included when Tilmeld is being used. These are:
+You should modify these through client enabled methods or the $save method +instead, for safety.
+Protected $protectedTags that can only be added/removed by server side code. They will still be +visible on the frontend, but any changes to them that come from the +frontend will be ignored.
+Protected $sdataThe actual sdata store.
+Protected $sleepingThe reference to use to wake.
+Protected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a Unix timestamp in milliseconds.
+The entity's Globally Unique ID.
+This is a 12 byte number represented as a lower case HEX string (24 +characters).
+The modified date of the entity as a Unix timestamp in milliseconds.
+Array of the entity's tags.
+Static ETYPEA unique name for this type of entity used to separate its data from other +types of entities in the database.
+Static classThe lookup name for this entity.
+This is used for reference arrays (and sleeping references) and client +requests.
+Static clientThe names of static methods allowed to be called by the frontend with +serverCallStatic.
+Static nymphThe instance of Nymph to use for queries.
+Static pubWhether this entity should publish changes to PubSub servers.
+Static restWhether this entity should be accessible on the frontend through the REST +server.
+If this is false, any request from the client that attempts to use this +entity will fail.
+Static searchProperties that will not be searchable from the frontend. If the frontend +includes any of these properties in any of their clauses, they will be +filtered out before the search is executed.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Protected $checkGet the current values of the AC properties.
+An object of AC properties.
+Get the original values of the AC properties.
+An object of AC properties.
+Used to retrieve the serialized data object.
+This should only be used by Nymph to save the data object into storage.
+This method is used by Nymph to avoid unserializing data that hasn't been +requested yet.
+It should always be called after getData().
+The entity's serialized data object.
+Get an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this method returns an empty array, meaning +there are no uniqueness constraints applied to its etype.
+Resolves to an array of entity's unique constraint strings.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Accept JSON data from the client.
+This function uses the security protection lists:
+The input data. Please note, this will be modified (destroyed).
+Optional allowConflict: booleanAllow to accept data that is older than the current data.
+Accept JSON patch from the client.
+This function uses the security protection lists:
+The patch data. Please note, this will be modified (destroyed).
+Optional allowConflict: booleanAllow to accept data that is older than the current data.
+Used to set the data.
+This should only be used by Nymph to push the data from storage.
+sdata is used by Nymph to avoid unserializing data that hasn't been
+requested yet.
The data object.
+Optional sdata: SerializedEntityDataThe serialized data object.
+Protected $referenceSet up a sleeping reference.
+Refresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Static Optional alterStatic factoryCreate or retrieve a new entity instance.
+Note that this will always return an entity, even if the GUID is not found.
+Static factoryCreate a new sleeping reference instance.
+Sleeping references won't retrieve their data from the database until they
+are readied with $wake() or a parent's $wakeAll().
The Nymph Entity Reference to use to wake.
+The new instance.
+Static factoryCreate a new entity instance.
+Static getGet an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this static method instantiates the entity,
+assigns all of the given data, then calls $getUniques and returns its
+output. This can have a performance impact if a lot of extra processing
+happens during any of these steps. You can override this method to
+calculate the unique strings faster, but you must return the same strings
+that would be returned by $getUniques.
Optional cdate?: numberOptional guid?: stringOptional mdate?: numberOptional sdata?: SerializedEntityDataResolves to an array of entity's unique constraint strings.
+Optional causeOptional stackOptional statusOptional statusStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackOptional statusOptional statusStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackOptional statusOptional statusStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackOptional statusOptional statusStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureA user group data model.
+Written by Hunter Perrin for SciActive.
+Protected Optional $allowlistIf this is defined, then it lists the only properties that will be +accepted from incoming JSON. Any other properties will be ignored.
+If you use an allowlist, you don't need to use protectedData, since you +can simply leave those entries out of allowlistData.
+Protected Optional $allowlistIf this is defined, then it lists the only tags that will be accepted from +incoming JSON. Any other tags will be ignored.
+Protected $clientThe names of methods allowed to be called by the frontend with serverCall.
+Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Protected $privateProperties that will not be serialized into JSON with toJSON(). This +can be considered a denylist, because these properties will not be set +with incoming JSON.
+Clients CAN still determine what is in these properties, unless they are +also listed in searchRestrictedData.
+Protected $protectedProperties that can only be modified by server side code. They will still +be visible on the frontend, unlike $privateData, but any changes to them +that come from the frontend will be ignored.
+In addition to what's listed here, all of the access control properties +will be included when Tilmeld is being used. These are:
+You should modify these through client enabled methods or the $save method +instead, for safety.
+Protected $protectedTags that can only be added/removed by server side code. They will still be +visible on the frontend, but any changes to them that come from the +frontend will be ignored.
+Protected $sdataThe actual sdata store.
+Private $skipThis should only be used by the backend.
+Private $skipThis should only be used by the backend.
+Protected $sleepingThe reference to use to wake.
+Protected $tagsProtected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a Unix timestamp in milliseconds.
+The entity's Globally Unique ID.
+This is a 12 byte number represented as a lower case HEX string (24 +characters).
+The modified date of the entity as a Unix timestamp in milliseconds.
+Array of the entity's tags.
+Private Static DEFAULT_Private Static DEFAULT_Static ETYPEThe instance of Tilmeld to use for queries.
+Static classThe lookup name for this entity.
+This is used for reference arrays (and sleeping references) and client +requests.
+Static clientThe names of static methods allowed to be called by the frontend with +serverCallStatic.
+Static nymphThe instance of Nymph to use for queries.
+Static pubWhether this entity should publish changes to PubSub servers.
+Static restWhether this entity should be accessible on the frontend through the REST +server.
+If this is false, any request from the client that attempts to use this +entity will fail.
+Static searchProperties that will not be searchable from the frontend. If the frontend +includes any of these properties in any of their clauses, they will be +filtered out before the search is executed.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Protected $checkGet the current values of the AC properties.
+An object of AC properties.
+Get the number of parents the group has.
+If the group is a top level group, this will return 0. If it is a child of +a top level group, this will return 1. If it is a grandchild of a top level +group, this will return 2, and so on.
+Levels will max out at 1024 to avoid recursive loops.
+The level of the group.
+Get the original values of the AC properties.
+An object of AC properties.
+Used to retrieve the serialized data object.
+This should only be used by Nymph to save the data object into storage.
+This method is used by Nymph to avoid unserializing data that hasn't been +requested yet.
+It should always be called after getData().
+The entity's serialized data object.
+Get an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this method returns an empty array, meaning +there are no uniqueness constraints applied to its etype.
+Resolves to an array of entity's unique constraint strings.
+Gets an array of users in the group.
+Include users in all descendant groups too.
+Optional limit: numberThe limit for the query.
+Optional offset: numberThe offset for the query.
+An array of users.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Accept JSON data from the client.
+This function uses the security protection lists:
+The input data. Please note, this will be modified (destroyed).
+Allow to accept data that is older than the current data.
+Accept JSON patch from the client.
+This function uses the security protection lists:
+The patch data. Please note, this will be modified (destroyed).
+Allow to accept data that is older than the current data.
+Used to set the data.
+This should only be used by Nymph to push the data from storage.
+sdata is used by Nymph to avoid unserializing data that hasn't been
+requested yet.
The data object.
+Optional sdata: SerializedEntityDataThe serialized data object.
+Protected $referenceSet up a sleeping reference.
+Refresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Static Optional alterStatic factoryCreate or retrieve a new entity instance.
+Note that this will always return an entity, even if the GUID is not found.
+Static factoryStatic factoryCreate a new sleeping reference instance.
+Sleeping references won't retrieve their data from the database until they
+are readied with $wake() or a parent's $wakeAll().
The Nymph Entity Reference to use to wake.
+The new instance.
+Static factoryCreate a new entity instance.
+Private Static getStatic getStatic getStatic getGet an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this static method instantiates the entity,
+assigns all of the given data, then calls $getUniques and returns its
+output. This can have a performance impact if a lot of extra processing
+happens during any of these steps. You can override this method to
+calculate the unique strings faster, but you must return the same strings
+that would be returned by $getUniques.
Optional cdate?: numberOptional guid?: stringOptional mdate?: numberOptional sdata?: SerializedEntityDataResolves to an array of entity's unique constraint strings.
+A user and group system for Nymph.js.
+Written by Hunter Perrin for SciActive.
+The group class for this instance of Tilmeld.
+The user class for this instance of Tilmeld.
+Private alreadyUsed to avoid infinite loop.
+The Tilmeld config.
+The currently logged in user.
+Private gatekeeperGatekeeper ability cache.
+Gatekeeper will cache the user's abilities that it calculates, so it can +check faster if that user has been checked before.
+The Nymph instance.
+If you will be performing authentication functions (logging in/out), you +should set these so Tilmeld can read and write cookies and headers.
+If you want the user to be authenticated with the cookie and/or header they +provide, you should set at least the request. It's better to set both, so +the JWT can be updated if needed.
+After you set these, call authenticate() to read user authentication data
+from them and fill the user's session.
If you want to support cookie based authentication (which still requires an +XSRF token for security), you should enable the cookie parser middleware.
+Add selectors to a list of options and selectors which will limit results +to only entities the current user has access to.
+Check for TILMELDAUTH and TILMELDSWITCH tokens, and, if set, authenticate +from it/them.
+You can also call this function after setting response.locals.user to the
+user you want to authenticate. You should check for user.enabled before
+setting this variable, unless you explicitly want to log in as a disabled
+user. (The user must be an instance of the User class for this Tilmeld
+instance.)
This function will set response.locals.user to the logged in user on
+successful authentication.
Skip the XSRF token check.
+Skip the token renewal step, even if the token is close to expiration.
+True if a user was authenticated, false on any failure.
+Check a UID's permissions for a user.
+UID functions on the Node.js side are not checked automatically. This +function is only run automatically for UID functions run from the client. +You should call this function manually if you're running a UID function on +the Node.js side and you want it gated.
+This will check the Tilmeld config and the user's abilities.
+The UID to check.
+The lowest level of permission to consider a pass.
+Optional user: false | User & UserDataThe user to check permissions for. If null, uses the current user. If false, checks for public access.
+Whether the current user has at least type permission for the UID.
Check an entity's permissions for a user.
+This will check the AC (Access Control) properties of the entity. These +include the following properties:
+"acUser" refers to the entity's owner, "acGroup" refers to all users in the +entity's group and all ancestor groups, and "acOther" refers to any user +who doesn't fit these descriptions.
+Each of these properties should be either NO_ACCESS, READ_ACCESS, +WRITE_ACCESS, or FULL_ACCESS.
+These properties default to:
+"acRead", "acWrite", and "acFull" are arrays of users and/or groups that +also have those permissions.
+Only users with FULL_ACCESS have the ability to change any of the ac*, +user, and group properties.
+The following conditions will result in different checks, which determine +whether the check passes:
+The entity to check.
+The lowest level of permission to consider a pass.
+Optional user: false | User & UserDataThe user to check permissions for. If null, uses the current user. If false, checks for public access.
+Optional acProperties: ACPropertiesThe acProperties to use instead of getting them from the entity.
+Whether the current user has at least type permission for the entity.
Initialize Tilmeld.
+This is meant to be called internally by Nymph. Don't call this directly.
+The Nymph instance.
+Private initA user data model.
+Written by Hunter Perrin for SciActive.
+Protected Optional $allowlistIf this is defined, then it lists the only properties that will be +accepted from incoming JSON. Any other properties will be ignored.
+If you use an allowlist, you don't need to use protectedData, since you +can simply leave those entries out of allowlistData.
+Protected Optional $allowlistIf this is defined, then it lists the only tags that will be accepted from +incoming JSON. Any other tags will be ignored.
+Protected $clientThe names of methods allowed to be called by the frontend with serverCall.
+Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Private Optional $descendantThe user's group descendants.
+Private Optional $gatekeeperGatekeeper ability cache.
+Gatekeeper will cache the user's abilities that it calculates, so it can +check faster if that user has been checked before.
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Optional $originalUsed to save the current email address to send verification if it changes +from the frontend.
+If you are changing a user's email address and want to bypass email +verification, don't set this.
+Protected $privateProperties that will not be serialized into JSON with toJSON(). This +can be considered a denylist, because these properties will not be set +with incoming JSON.
+Clients CAN still determine what is in these properties, unless they are +also listed in searchRestrictedData.
+Protected $protectedProperties that can only be modified by server side code. They will still +be visible on the frontend, unlike $privateData, but any changes to them +that come from the frontend will be ignored.
+In addition to what's listed here, all of the access control properties +will be included when Tilmeld is being used. These are:
+You should modify these through client enabled methods or the $save method +instead, for safety.
+Protected $protectedTags that can only be added/removed by server side code. They will still be +visible on the frontend, but any changes to them that come from the +frontend will be ignored.
+Protected $sdataThe actual sdata store.
+Private $skipThis should only be used by the backend.
+Private $skipThis should only be used by the backend.
+Protected $sleepingThe reference to use to wake.
+Protected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a Unix timestamp in milliseconds.
+The entity's Globally Unique ID.
+This is a 12 byte number represented as a lower case HEX string (24 +characters).
+The modified date of the entity as a Unix timestamp in milliseconds.
+Array of the entity's tags.
+Private Static DEFAULT_Private Static DEFAULT_Private Static DEFAULT_Static ETYPEThe instance of Tilmeld to use for queries.
+Private Static afterPrivate Static afterPrivate Static afterPrivate Static beforePrivate Static beforePrivate Static beforePrivate Static checkStatic classThe lookup name for this entity.
+This is used for reference arrays (and sleeping references) and client +requests.
+Static clientThe names of static methods allowed to be called by the frontend with +serverCallStatic.
+Static nymphThe instance of Nymph to use for queries.
+Static pubWhether this entity should publish changes to PubSub servers.
+Static restWhether this entity should be accessible on the frontend through the REST +server.
+If this is false, any request from the client that attempts to use this +entity will fail.
+Static searchProperties that will not be searchable from the frontend. If the frontend +includes any of these properties in any of their clauses, they will be +filtered out before the search is executed.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+A frontend accessible method to change the user's password.
+The input data from the client.
+Optional revokeAn object with a boolean 'result' entry and a 'message' entry.
+Protected $checkCheck to see if a user has an ability.
+This function will check both user and group abilities, if the user is +marked to inherit the abilities of its group.
+If ability is undefined, it will check to see if the user is currently
+logged in.
If the user has the "system/admin" ability, this function will return true.
+Optional ability: stringThe ability.
+True or false.
+Get the current values of the AC properties.
+An object of AC properties.
+Get the original values of the AC properties.
+An object of AC properties.
+Used to retrieve the serialized data object.
+This should only be used by Nymph to save the data object into storage.
+This method is used by Nymph to avoid unserializing data that hasn't been +requested yet.
+It should always be called after getData().
+The entity's serialized data object.
+Get an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this method returns an empty array, meaning +there are no uniqueness constraints applied to its etype.
+Resolves to an array of entity's unique constraint strings.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Accept JSON data from the client.
+This function uses the security protection lists:
+The input data. Please note, this will be modified (destroyed).
+Allow to accept data that is older than the current data.
+Accept JSON patch from the client.
+This function uses the security protection lists:
+The patch data. Please note, this will be modified (destroyed).
+Allow to accept data that is older than the current data.
+Optional additionalOptional code?: stringUsed to set the data.
+This should only be used by Nymph to push the data from storage.
+sdata is used by Nymph to avoid unserializing data that hasn't been
+requested yet.
The data object.
+Optional sdata: SerializedEntityDataThe serialized data object.
+Protected $referenceSet up a sleeping reference.
+Refresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Optional additionalA frontend accessible method to remove the TOTP secret from the user's +account.
+Optional data: { The input data from the client.
+An object with a boolean 'result' entry and a 'message' entry.
+A frontend accessible method to revoke all currently issued tokens.
+The input data from the client.
+An object with a boolean 'result' entry and a 'message' entry.
+A frontend accessible method to save a TOTP secret into the user's account.
+The input data from the client.
+An object with a boolean 'result' entry and a 'message' entry.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Static Optional alterStatic currentStatic factoryCreate or retrieve a new entity instance.
+Note that this will always return an entity, even if the GUID is not found.
+Static factoryCreate a new sleeping reference instance.
+Sleeping references won't retrieve their data from the database until they
+are readied with $wake() or a parent's $wakeAll().
The Nymph Entity Reference to use to wake.
+The new instance.
+Static factoryCreate a new entity instance.
+Static factoryStatic getStatic getGet an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this static method instantiates the entity,
+assigns all of the given data, then calls $getUniques and returns its
+output. This can have a performance impact if a lot of extra processing
+happens during any of these steps. You can override this method to
+calculate the unique strings faster, but you must return the same strings
+that would be returned by $getUniques.
Optional cdate?: numberOptional guid?: stringOptional mdate?: numberOptional sdata?: SerializedEntityDataResolves to an array of entity's unique constraint strings.
+Static loginOptional additionalOptional code?: stringStatic offStatic onStatic recoverRecover account details.
+The input data from the client.
+An object with a boolean 'result' entry and a 'message' entry.
+Static sendSend an account recovery link.
+The input data from the client.
+An object with a boolean 'result' entry and a 'message' entry.
+Entity interface.
+Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Protected $dirtyA map of props to whether they're dirty (for patch).
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Protected $originalArray of the entity's original tags (for patch).
+Protected $sleepingThe reference to use to wake.
+Protected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a high precision Unix timestamp.
+The entity's Globally Unique ID.
+The modified date of the entity as a high precision Unix timestamp.
+Array of the entity's tags.
+Static classThe lookup name for this entity.
+This is used for reference arrays (and sleeping references) and server +requests.
+Static nymphThe instance of Nymph to use for queries.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Protected $checkGet a patch of this entity's dirty data to be applied on the server.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Initialize this entity from a JSON representation.
+The entity JSON.
+Protected $referenceRefresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Call an instance method on the server version of this entity.
+The entity's data will be sent up to the server as well, so the server's +state can match the client's state. It won't be propagated into the DB, +though.
+The name of the method.
+The parameters to call the method with.
+Optional stateless: booleanWhether the server should return, and the client update, the data in the entity after the method has run.
+The value that the method on the server returned.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Ready this entity's data, and the data of entity's within this one's.
+Optional level: numberThe number of levels deep to wake. If undefined, it will keep going until there are no more entities. (Careful of infinite loops.)
+The entity.
+Static factoryCreate or retrieve a new entity instance.
+Note that this will always return an entity, even if the GUID is not found.
+Static factoryStatic factoryCreate a new sleeping reference instance.
+Sleeping references won't retrieve their data from the server until they
+are readied with $wake() or a parent's $wakeAll().
The Nymph Entity Reference to use to wake.
+The new instance.
+Static factoryCreate a new entity instance.
+Static getStatic getStatic serverStatic serverCall a static iterator method on the server version of this entity.
+The name of the method.
+The parameters to call the method with.
+An iterator that iterates over values that the method on the server yields.
+Optional message: stringOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureEntity interface.
+Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Protected $dirtyA map of props to whether they're dirty (for patch).
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Protected $originalArray of the entity's original tags (for patch).
+Protected $sleepingThe reference to use to wake.
+Protected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a high precision Unix timestamp.
+The entity's Globally Unique ID.
+The modified date of the entity as a high precision Unix timestamp.
+Array of the entity's tags.
+Static classThe lookup name for this entity.
+This is used for reference arrays (and sleeping references) and server +requests.
+Static nymphThe instance of Nymph to use for queries.
+Protected Static storesSearch the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Protected $checkGet a patch of this entity's dirty data to be applied on the server.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Initialize this entity from a JSON representation.
+The entity JSON.
+Protected $referenceRefresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Optional additionalCall an instance method on the server version of this entity.
+The entity's data will be sent up to the server as well, so the server's +state can match the client's state. It won't be propagated into the DB, +though.
+The name of the method.
+The parameters to call the method with.
+Optional stateless: booleanWhether the server should return, and the client update, the data in the entity after the method has run.
+The value that the method on the server returned.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Ready this entity's data, and the data of entity's within this one's.
+Optional level: numberThe number of levels deep to wake. If undefined, it will keep going until there are no more entities. (Careful of infinite loops.)
+The entity.
+Static currentOptional returnObjectIfNotExist: falseStatic factoryCreate or retrieve a new entity instance.
+Note that this will always return an entity, even if the GUID is not found.
+Static factoryCreate a new sleeping reference instance.
+Sleeping references won't retrieve their data from the server until they
+are readied with $wake() or a parent's $wakeAll().
The Nymph Entity Reference to use to wake.
+The new instance.
+Static factoryCreate a new entity instance.
+Static factoryStatic getPrivate Static handleStatic initStatic loginOptional additionalOptional code?: stringStatic offStatic onStatic recoverStatic sendStatic serverStatic serverCall a static iterator method on the server version of this entity.
+The name of the method.
+The parameters to call the method with.
+An iterator that iterates over values that the method on the server yields.
+Base class for Svelte components with some minor dev-enhancements. Used when dev=true.
+Can be used to create strongly typed Svelte components.
+You have component library on npm called component-library, from which
+you export a component called MyComponent. For Svelte+TypeScript users,
+you want to provide typings. Therefore you create a index.d.ts:
import { SvelteComponent } from "svelte";
export class MyComponent extends SvelteComponent<{foo: string}> {}
+Typing this makes it possible for IDEs like VS Code with the Svelte extension +to provide intellisense and to use the component like this in a Svelte file +with TypeScript:
+<script lang="ts">
import { MyComponent } from "component-library";
</script>
<MyComponent foo={'bar'} />
+Generate secure unique ID with custom alphabet.
+Alphabet must contain 256 symbols or less. Otherwise, the generator +will not be secure.
+Alphabet used to generate the ID.
+Optional defaultSize: numberSize of the ID. The default size is 21.
+A random string generator.
+const { customAlphabet } = require('nanoid')
const nanoid = customAlphabet('0123456789абвгдеё', 5)
nanoid() //=> "8ё56а"
+Optional size: numberGenerate secure URL-friendly unique ID.
+By default, the ID will have 21 symbols to have a collision probability +similar to UUID v4.
+import { nanoid } from 'nanoid'
model.id = nanoid() //=> "Uakgb_J5m9g-0JDMbcJqL"
+Optional size: numberSize of the ID. The default size is 21.
+A random string.
+Optional bareOptional defaultOptional qrefA REST server middleware creator for Nymph.
+Written by Hunter Perrin for SciActive.
+Optional jsonOptional clientConfig: ClientConfigOptional code: stringOptional additionalData: { Optional clientConfig: ClientConfigOptional allowPowerful object data storage and querying.
+All you need to start using Nymph is the @nymphjs/nymph package and one of the drivers, @nymphjs/driver-mysql, @nymphjs/driver-postgresql, or @nymphjs/driver-sqlite3. Check out the readme for the Nymph package.
You can also set up a REST server to use Nymph remotely, a PubSub server to receive updates for queries, and a user and group management system to provide registration and access control.
+Check out the user guide for information about how to use Nymph once you have it set up.
+The Nymph core provides the base level classes and utilities to query the database, save data to it, and define different data types.
+The MySQL driver lets you configure Nymph to query and save data to a MySQL database.
+The PostgreSQL driver lets you configure Nymph to query and save data to a Postgres database.
+The SQLite3 driver lets you configure Nymph to query and save data to a SQLite3 database. This includes an in memory SQLite3 database.
+The REST server lets you configure an endpoint for the Nymph client to query and push data to. The server provides this endpoint as an Express middleware, which can be used in a new or existing Express (or compatible) server.
+The PubSub server provides a WebSocket server that allows Nymph to publish changes and the Nymph Client to subscribe to those changes. You can subscribe to individual entities, entity queries, or UIDs.
+The Nymph Client allows you to query and push data to a Nymph REST server from the browser. You can also subscribe to entities and queries on a Nymph PubSub server and be notified of changes.
+The Nymph Node Client let's you do everything the Nymph Client does, but from Node.JS instead of the browser.
+Tilmeld (the d is silent) is a user and group management system for Nymph. It provides strict access controls to protect entities from unauthorized access/modification. It allows for granting and revoking ad hoc abilities to users and groups, then checking for those abilities. It provides authentication services and features protection against XSRF attacks.
+The Tilmeld Client lets you register, login, and perform user account related functions remotely on a Nymph server.
+The Tilmeld Components are front end registration/login, account recovery, account details, and password change components build with Svelte and SMUI.
+The Tilmeld Setup App allows administrators to create, modify, and delete users and groups and configure how Tilmeld works. It also acts as the endpoint for email address verification.
+The Nymph Entity Sorter lets you sort entities by their properties, including hierarchically.
+The Query Parser is a utility for creating complex Nymph entity queries from a simple text input. Essentially, it turns a string into a Nymph query.
+The GUID and unique code generators are used to generate new GUIDs for Nymph objects and various random unique strings.
+In version 1.0.0-beta.78, the database schema changed significantly, and data will need to be exported with an older version, then imported into a fresh database with this version. The meaning of the contain clause also changed to only check if the given value exists in an array.
In version 1.0.0-beta.41, the server side API was rewritten to match the client side API. All synchronous database calls were removed. This is to prevent a very rare potential bug, because synchronous database calls were made outside of transactions. Here is a list of some things that changed that could break your code:
+$gatekeeper is now asyncconstructor or factorySynccheckClientUIDPermissions is now asyncauthenticate is now asyncfillSession is now asynclogin is now asyncloginSwitch is now asynclogout is now asynclogoutSwitch is now async$addGroup is now async$delGroup is now async$inGroup is now async$getLevel is now async$ready changed to $wake$readyAll changed to $wakeAllYou will also now need to call $wake on sleeping references before you access their data or they will throw and error.
To develop Nymph.js, checkout the repo and run:
+npm i
npm run bootstrap
rm packages/*/package-lock.json
+Once you make changes in one package, you can either build that package directly or build all packages with bootstrap, then the other packages will be aware of the changes.
When you're ready to run all the tests, in a separate shell, bring up the test DBs.
+npm run test:db:start
+Now in your main terminal, you can run the tests.
+npm run test
+Once you're all done, in your main terminal, you can bring down the test DBs (don't use Ctrl-C where the tests are running).
+npm run test:db:stop
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Data Object interface.
+Objects which hold data from some type of storage.
+The object's data.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Refresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Entity interface.
+The instance of Nymph to use for queries.
+The creation date of the entity as a Unix timestamp in milliseconds.
+The entity's Globally Unique ID.
+This is a 12 byte number represented as a lower case HEX string (24 +characters).
+The modified date of the entity as a Unix timestamp in milliseconds.
+Array of the entity's tags.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Get a patch of this entity's dirty data to be applied on the server.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Initialize this entity from a JSON representation.
+The entity JSON.
+Refresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Call an instance method on the server version of this entity.
+The entity's data will be sent up to the server as well, so the server's +state can match the client's state. It won't be propagated into the DB, +though.
+The name of the method.
+The parameters to call the method with.
+Whether the server should return, and the client update, the data in the entity after the method has run.
+The value that the method on the server returned.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Retrieve this entity's data from the server.
+The entity.
+Ready this entity's data, and the data of entity's within this one's.
+Optional level: numberThe number of levels deep to wake. If undefined, it will keep going until there are no more entities. (Careful of infinite loops.)
+The entity.
+MySQL Driver Config
+If you need to use custom options, like SSL, you can provide them here in +place of the above options.
+The MySQL database.
+The MySQL table engine.
+You should use MYISAM if you are using MySQL < 5.6.
+Options are: Any MySQL storage engine supported on your server.
+Whether to use foreign keys. If your table engine doesn't support +it (like MYISAM), you should turn this off.
+The host on which to connect to MySQL. Can include a port, like +hostname:port.
+The MySQL password.
+The port on which to connect to MySQL.
+The MySQL table name prefix.
+Whether to use row locking. If your table engine doesn't support +it (like MYISAM), you should turn this off.
+Whether to use table locking. If you use row locking, this should be off. +If you can't use row locking (like with MYISAM), you can use table +locking to ensure data consistency.
+Whether to use transactions. If your table engine doesn't support +it (like MYISAM), you should turn this off.
+The MySQL user.
+PostgreSQL Driver Config
+If you need to use custom options, like SSL, you can provide them here in +place of the above options.
+The Postgres database.
+The host on which to connect to Postgres. Can include a port, like +hostname:port.
+The Postgres password.
+The port on which to connect to Postgres.
+The Postgres table name prefix.
+The Postgres user.
+SQLite3 Driver Config
+Open explicitly for writing.
+By default, the driver will always open the DB as readonly, and attempt to +open another link to perform write operations. If you know that only one +instance will be writing, you can force the driver to open for writing by +default, which will block any other instance from opening it for writing.
+One thing to note is that starting a transaction is a write operation, so +as long as an instance is in a transaction, no other instances can write.
+PubSub also needs to open the DB, and it only needs read access.
+If the file does not exist, an Error will be thrown instead of creating a +new file.
+This option is ignored for in-memory, temporary, or readonly database +connections.
+The filename of the SQLite3 DB. Use ':memory:' for an in-memory DB.
+Additional pragma statements to run upon connection.
+The default pragmas:
+(Don't include the PRAGMA keyword, but do include the semicolon.)
+The SQLite3 table name prefix.
+The timeout to use for waiting for the DB to become available.
+Function that gets called with every SQL string executed.
+Optional message: anyRest ...additionalArgs: any[]Turn on WAL mode.
+This will generally increase performance, but does mean that the DB must be +on a local disk.
+ +Nymph Config
+Cache recently retrieved entities to speed up database queries. Uses more +memory.
+The number of recently retrieved entities to cache. If you're running out +of memory, try lowering this value. 0 means unlimited.
+Cache entities after they're accessed this many times.
+A function to log error messages. By default, uses the debug package.
A function to log info messages. By default, uses the debug package.
A function to log debug messages. By default, uses the debug package.
When querying for multiple entities with NymphREST, if the list is empty, +return a 404 error.
+Data Object interface.
+Objects which hold data from some type of storage.
+The object's data.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Refresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Entity interface.
+The instance of Nymph to use for queries.
+The creation date of the entity as a Unix timestamp in milliseconds.
+The entity's Globally Unique ID.
+This is a 12 byte number represented as a lower case HEX string (24 +characters).
+The modified date of the entity as a Unix timestamp in milliseconds.
+Array of the entity's tags.
+Search the array for this object and return the corresponding index.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+The index if the object is in the array, -1 if it isn't.
+Get the current values of the AC properties.
+An object of AC properties.
+Used to retrieve the data object.
+This should only be used by Nymph to save the data into storage.
+Optional includeSData: booleanWhether to include the serialized data as well.
+The entity's data object.
+Get the original values of the AC properties.
+An object of AC properties.
+Used to retrieve the serialized data object.
+This should only be used by Nymph to save the data object into storage.
+This method is used by Nymph to avoid unserializing data that hasn't been +requested yet.
+It should always be called after getData().
+The entity's serialized data object.
+Get an array of strings that must be unique across the current etype.
+When you try to save another entity with any of the same unique strings, +Nymph will throw an error.
+The default implementation of this method returns an empty array, meaning +there are no uniqueness constraints applied to its etype.
+Resolves to an array of entity's unique constraint strings.
+Check whether this object is in an array.
+If strict is false, is() is used to compare. If strict is true,
+equals() is used.
The array to search.
+Optional strict: booleanWhether to use stronger comparison.
+True if the object is in the array, false if it isn't.
+Accept JSON data from the client.
+This function uses the security protection lists:
+The input data. Please note, this will be modified (destroyed).
+Optional allowConflict: booleanAllow to accept data that is older than the current data.
+Accept JSON patch from the client.
+This function uses the security protection lists:
+The patch data. Please note, this will be modified (destroyed).
+Optional allowConflict: booleanAllow to accept data that is older than the current data.
+Used to set the data.
+This should only be used by Nymph to push the data from storage.
+sdata is used by Nymph to avoid unserializing data that hasn't been
+requested yet.
The data object.
+Optional sdata: SerializedEntityDataThe serialized data object.
+Refresh the object from storage. (Bypasses Nymph's cache.)
+If the object has been deleted from storage, the database cannot be
+reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
+Return a Nymph Entity Reference for this entity.
+If the entity hasn't been saved yet (and has no GUID), it will be +returned instead.
+A Nymph Entity Reference array as an unsaved entity.
+Optional type: TilmeldAccessLevelsNymph PubSub Config
+Allow clients to request to be notified when other clients subscribe to the +same queries.
+The URLs of the Nymph-PubSub servers to directly publish to. These servers +are how this host will enter the PubSub network. If you only have one +PubSub server, it needs to be listed here.
+Function to log PubSub info/error messages.
+Rest ...args: any[]Determine whether a client's origin is allowed to connect.
+The URLs of additional Nymph-PubSub servers to relay publishes to. If this +host is a PubSub server, these servers are how it will continue into your +PubSub network.
+Tilmeld Config
+Allow users to register.
+Allow users to change their username.
+The name of the app. Used in emails sent to users and as the TOTP issuer.
+The URL of the app. Used to define cookie domain, path, and security. Must +be accessible to the Tilmeld client JS. (Note, cookies are not specific to +individual ports, so tokens will be sent to any port running on this host.)
+After the user cancels an address change, redirect them to this URL.
+A list of UIDs that can be created from the client by anyone. (newUID)
+Inclusion in this list implies inclusion in clientReadableUIDs.
+Note: If you'd like to limit the access to logged in users, give them an + ability like "uid/new/nameofuid".
+A list of UIDs that can be read from the client by anyone. (getUID)
+Note: If you'd like to limit the access to logged in users, give them an + ability like "uid/get/nameofuid".
+A list of UIDs that can be set from the client by anyone. (setUID, +renameUID)
+Inclusion in this list implies inclusion in clientReadableUIDs and +clientEnabledUIDs.
+Note: There is no way to run renameUID from the client.
+Note: If you'd like to limit the access to logged in users, give them an + ability like "uid/set/nameofuid".
+Configure an email object to prepare for sending.
+You can use this, for example, for DKIM signing.
+See: https://github.com/forwardemail/email-templates/blob/v8.0.9/README.md#Options
+The domain of the auth cookie.
+The path of the auth cookie.
+Allow the creation of an admin user. When a user is created, if there are +no other users in the system, they will be granted all abilities.
+Don't let users change their email address more often than this. You can +enter one value and one unit of time, such as "2 weeks". Leave blank to +disable rate limiting.
+This also controls how long a user has to cancel an email address change +from a link emailed to the old address.
+The absolute path to the email template directory. Used by the default +email sender.
+Instead of a "username", a user logs in and is referred to by their email +address. Enabling this after many users have been created can be messy. +Make sure they all have email addresses first.
+Whether frontend can search groups. (Probably not a good idea if privacy is +a concern. Same risks as user search if generatePrimary is true.)
+Whether frontend can search users. (Probably not a good idea if privacy is +a concern.)
+Whether to create a new primary group for every user who registers. This +can be useful for providing access to entities the user creates.
+In the case this is set, the default primary group, rather than being +assigned to the user, is assigned as the parent of the generated group.
+The GUID of the group above the highest groups allowed to be assigned as +primary groups. True means all groups, and false means no groups.
+The GUID of the group above the highest groups allowed to be assigned as +secondary groups. True means all groups, and false means no groups.
+Function to build the JWT for user sessions.
+How long from current time, in seconds, the JWT token expires.
+Function to verify that a JWT was signed with the secret key, validate its +data, validate the XSRF token, and extract the GUID and dates.
+If no XSRF token is supplied, ignore it.
+Return false if the JWT is not valid, or an object with GUID, issued date, +and expire date otherwise.
+Optional xsrfToken: stringHow long, in seconds, before the JWT token expires to give the user a new +one.
+The secret used to sign the JWT.
+How long from current time, in seconds, the JWT token for a user switch +expires.
+The maximum length for usernames. Infinity for unlimited.
The minimum length for usernames.
+Method used to store passwords. Salt is more secure if the database is +compromised. Plain: store the password in plaintext. Digest: store the +password's digest (hash). Salt: store the password's digest using a +complex, unique salt.
+Digests are SHA-256, so a salt probably isn't necessary, but who knows.
+Options are: "plain", "digest", "salt"
+Allow users to recover their username and/or password through their +registered email.
+How long a recovery request is valid.
+These fields will be available for the user to fill in when they register.
+Send an email to a user. Uses email-templates by default.
Check out the emails directory to see the templates used.
In addition to the specific locals for each template, there are
+additional locals added by the default email sender:
The path (with leading slash and no trailing slash) where the setup utility +is accessible. This is also used for email address verification.
+This portion of the app will not check for the XSRF token, so make sure +your REST endpoint is not under this URL.
+Unverified users will be able to log in, but will only have the "unverified +users" secondary group(s) until they verify their email. If set to false, +their account will instead be disabled until they verify.
+These will be the available fields for users. (Some fields, like username, +can't be excluded.)
+The address you'd like to receive a notification of registered users, if +any.
+Only these characters can be used when creating usernames and groupnames. +(Doesn't apply to emails as usernames.)
+When a user enters an invalid name, this message will be displayed.
+Email addresses must match this regular expression. By default, this uses +the regex from the W3C HTML email element validation:
+https://html.spec.whatwg.org/multipage/input.html#email-state-(type=email)
+When a user enters an email that doesn't match the regex, this message will +be displayed.
+Usernames and groupnames must match this regular expression. (Doesn't apply +to emails as usernames.) By default, this ensures that the name begins and +ends with an alphanumeric. (To allow anything, use .* inside the slashes.)
+When a user enters a name that doesn't match the regex, this message will +be displayed.
+The validator used to check groups before saving.
+The validator used to check users before saving.
+After the user verifies an address change, redirect them to this URL.
+Verify users' email addresses upon registration/email change before +allowing them to log in/change it.
+After the user verifies their address, redirect them to this URL.
+Powerful object data storage and querying.
+The Nymph Client allows you to query and push data to a Nymph REST server from the browser. You can also subscribe to entities and queries on a Nymph PubSub server and be notified of changes.
+npm install --save @nymphjs/client
+This package is the Nymph client for browsers. You can find UMD in dist, or TS source in src. There is also a Node.js client.
Here's an overview:
+import { Nymph, PubSub } from '@nymphjs/client';
import TodoClass from 'Todo';
const nymphOptions = {
restUrl: 'https://yournymphrestserver/path/to/your/endpoint',
pubsubUrl: 'wss://yournymphpubsubserver',
};
const nymph = new Nymph(nymphOptions);
const pubsub = new PubSub(nymphOptions, nymph);
const Todo = nymph.addEntityClass(TodoClass);
// Now you can use Nymph and PubSub.
const myTodo = new Todo();
myTodo.name = 'This is a new todo!';
myTodo.done = false;
await myTodo.$save();
let allMyTodos = await nymph.getEntities({ class: Todo });
let subscription = pubsub.subscribeWith(myTodo, () => {
// When this is called, the entity will already contain new data from the
// publish event. If the entity is deleted, the GUID will be set to null.
if (myTodo.guid != null) {
alert('Somebody touched my todo!');
} else {
alert('Somebody deleted my todo!');
subscription.unsubscribe();
}
});
// ...
// Subscribing to a query.
let todos = [];
let userCount = 0;
let subscription = pubsub.subscribeEntities(
{
class: Todo.class,
},
{
type: '&',
'!tag': 'archived',
},
)(
(update) => {
// The first time this is called, `update` will be an array of Todo
// entities. After that, `update` will be a publish event object.
// This takes an existing array of entities and either updates it to match
// another array, or performs actions from a publish event object to update
// it.
pubsub.updateArray(todos, update);
// `todos` is now up to date with the latest publishes from the server.
},
(err) => alert(err),
(count) => {
// If you provide this callback, the server will send updates of how many
// clients are subscribed to this query.
userCount = count;
},
);
// ...
// Remember to clean up your subscriptions when you no longer need them.
subscription.unsubscribe();
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The Nymph Node Client lets you do everything the Nymph Client does, but from Node.JS instead of the browser.
+npm install --save @nymphjs/client-node
+This package is the Nymph client for Node.js. You can find CJS in dist, or TS source in src. There is also a browser client.
This package provides fetch and WebSocket ponyfills to Nymph and handles Tilmeld auth tokens.
+To use, require it instead of @nymphjs/client:
const { Nymph, PubSub } = require('@nymphjs/client-node');
+Then set up Nymph and PubSub like normal:
+const nymphOptions = {
restUrl: 'https://yournymphrestserver/path/to/your/endpoint',
pubsubUrl: 'wss://yournymphpubsubserver',
};
const nymph = new Nymph(nymphOptions);
const pubsub = new PubSub(nymphOptions, nymph);
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The MySQL driver lets you configure Nymph to query and save data to a MySQL database.
+npm install --save @nymphjs/driver-mysql
+Supply an instance of this driver with its configuration to Nymph's constructor.
+import { Nymph } from '@nymphjs/nymph';
import MySQLDriver from '@nymphjs/driver-mysql';
const mysqlConfig = {
host: 'your_db_host',
database: 'your_database',
user: 'your_user',
password: 'your_password',
};
const nymph = new Nymph({}, new MySQLDriver(mysqlConfig));
// All done. Nymph is ready to use.
+See the config declaration file.
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The PostgreSQL driver lets you configure Nymph to query and save data to a Postgres database.
+npm install --save @nymphjs/driver-postgresql
+Supply an instance of this driver with its configuration to Nymph's constructor.
+import { Nymph } from '@nymphjs/nymph';
import PostgreSQLDriver from '@nymphjs/driver-postgresql';
const postgresqlConfig = {
host: 'your_db_host',
database: 'your_database',
user: 'your_user',
password: 'your_password',
};
const nymph = new Nymph({}, new PostgreSQLDriver(postgresqlConfig));
// All done. Nymph is ready to use.
+See the config declaration file.
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The SQLite3 driver lets you configure Nymph to query and save data to a SQLite3 database. This includes an in memory SQLite3 database.
+npm install --save @nymphjs/driver-sqlite3
+Supply an instance of this driver with its configuration to Nymph's constructor.
+import { Nymph } from '@nymphjs/nymph';
import SQLite3Driver from '@nymphjs/driver-sqlite3';
const sqliteConfig = {
filename: __dirname + '/mydatabase.db',
};
const nymph = new Nymph({}, new SQLite3Driver(sqliteConfig));
// All done. Nymph is ready to use.
+See the config declaration file.
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The GUID and unique code generators are used to generate new GUIDs for Nymph objects and various random unique strings.
+npm install --save @nymphjs/guid
+There are a few functions for generating different kinds of strings.
+import {
guid,
makeTableSuffix,
humanSecret,
nanoid,
customAlphabet,
} from '@nymphjs/guid';
// This generates a GUID. It will be 24 characters long, and the first four
// characters will be the same during a whole week. (This helps make DB index
// paging more efficient.)
const myGuid = guid();
// This can be used as a table suffix in SQL queries. It will be 20 characters
// long and alphanumeric.
const myTableSuffix = makeTableSuffix();
// This will be a human readable secret code. It will be 10 characters long and
// use the nolookalikesSafe dictionary from nanoid-dictionary.
const mySecretCode = humanSecret();
// This is the nanoid library's main export. It is exported in commonjs format.
const id = nanoid();
// This is the nanoid library's customAlphabet export.
const customId = customAlphabet('abc', 20)();
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The Nymph core provides the base level classes and utilities to query the database, save data to it, and define different data types.
+npm install --save @nymphjs/nymph
+To use Nymph, you need a database driver. Nymph.js provides a MySQL driver, a PostgreSQL driver, and a SQLite3 driver. They all provide the exact same functionality.
+Here's an overview:
+// main.ts
import { Nymph } from '@nymphjs/nymph';
import MySQLDriver from '@nymphjs/driver-mysql';
import TodoClass from './Todo';
const mysqlConfig = {
host: 'your_db_host',
database: 'your_database',
user: 'your_user',
password: 'your_password',
};
// Create a new instance of Nymph.
const nymph = new Nymph({}, new MySQLDriver(mysqlConfig));
// addEntityClass returns the class you should use for this instance of Nymph.
const Todo = nymph.addEntityClass(TodoClass);
// You are set up. Now you can use entity classes like `Todo` to store data,
// and Nymph's query methods like `getEntities` to retrieve them.
async function run() {
const myEntity = await Todo.factory();
myEntity.text = 'Get it done!';
await myEntity.$save();
const otherPendingTodos = await nymph.getEntities(
{ class: Todo },
{ type: '&', '!guid': myEntity.guid, equal: ['done', false] },
);
const total = otherPendingTodos.length;
const single = total === 1;
console.log(
`Besides the one I just created, there ${
single ? 'is' : 'are'
} ${total} pending todo${single ? '' : 's'} in the database.`,
);
}
+// Todo.ts
import { Entity } from '@nymphjs/nymph';
export type TodoData = {
text: string;
done: boolean;
};
export default class Todo extends Entity<TodoData> {
static ETYPE = 'todo'; // This is used for the table name(s) in the DB.
static class = 'Todo'; // This is used to map references to their class.
constructor() {
super();
// Within the methods of an entity, you will use `this.$data` to access
// its data. Outside, you don't need the $data part.
this.$data.text = '';
this.$data.done = false;
}
async $getOtherTodos() {
// this.$nymph (or this.nymph in a static function) is the instance of Nymph
// this entity was loaded with. Creating transactions will create a new
// instance of Nymph, so it could be a transactional instance.
const otherTodos = await this.$nymph.getEntities(
{ class: Todo },
{ type: '!&', guid: this.guid },
);
return otherTodos;
}
}
+See the config declaration file.
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The PubSub server provides a WebSocket server that allows Nymph to publish changes and the Nymph Client to subscribe to those changes. You can subscribe to individual entities, entity queries, or UIDs.
+npm install --save @nymphjs/pubsub
+Any Nymph instance will only publish changes if you initialize PubSub publisher before Nymph is used! This step is absolutely required to have a working PubSub system.
+import SQLite3Driver from '@nymphjs/driver-sqlite3';
import { Nymph } from '@nymphjs/nymph';
import { PubSub } from '@nymphjs/pubsub';
const pubSubConfig = {
entries: ['ws://yourpubsubserver.tld:8080/'], // This should be set to your PubSub server URL(s).
};
const nymph = new Nymph(
{},
new SQLite3Driver({
filename: ':memory:', // Put the correct driver/config here.
}),
);
PubSub.initPublisher(pubSubConfig, nymph);
+Now, on your PubSub server, you can use the createServer function to create a new PubSub server using HTTP (without TLS). If you want, this can be done on the same server you use as a REST server, with a different port.
+import SQLite3Driver from '@nymphjs/driver-sqlite3';
import { Nymph } from '@nymphjs/nymph';
import createServer, { PubSub } from '@nymphjs/pubsub';
const pubSubConfig = {
originIsAllowed: (origin) => {
// Your logic to determine allowed origins goes here.
return true;
},
entries: ['ws://yourpubsubserver.tld:8080/'],
};
const nymph = new Nymph(
{},
new SQLite3Driver({
filename: ':memory:', // Put the correct driver/config here.
}),
);
// Don't forget to do this; even here!
PubSub.initPublisher(pubSubConfig, nymph);
const pubsub = createServer(8080, pubSubConfig, nymph);
+If you need to provide custom handling in your server (like TLS), you can use the PubSub class directly and provide it a WebSocket server instance.
+import http from 'http';
import { server as WebSocketServer } from 'websocket';
import SQLite3Driver from '@nymphjs/driver-sqlite3';
import { Nymph } from '@nymphjs/nymph';
import { PubSub } from '@nymphjs/pubsub';
const pubSubConfig = {
originIsAllowed: (origin) => {
// Your logic to determine allowed origins goes here.
return true;
},
entries: ['ws://yourpubsubserver.tld:8080/'],
};
// Set up Nymph.
const nymph = new Nymph(
{},
new SQLite3Driver({
filename: ':memory:', // Put the correct driver/config here.
}),
);
// Don't forget to do this; even here!
PubSub.initPublisher(pubSubConfig, nymph);
// Set up the PubSub server.
const port = 8080;
const server = http.createServer((_request, response) => {
response.writeHead(404);
response.end();
});
const listener = server.listen(port, () => {
console.log(
new Date().toISOString(),
`Nymph-PubSub server started listening on port ${port}.`,
);
});
const wsServer = new WebSocketServer({
httpServer: listener,
// You should not use autoAcceptConnections for production
// applications, as it defeats all standard cross-origin protection
// facilities built into the protocol and the browser. You should
// *always* verify the connection's origin and decide whether or not
// to accept it.
autoAcceptConnections: false,
});
const pubsub = new PubSub(pubSubConfig, nymph, wsServer);
+See the config declaration file.
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The Query Parser is a utility for creating complex Nymph entity queries from a simple text input. Essentially, it turns a string into a Nymph query.
+npm install --save @nymphjs/query-parser
+The query parser will turn a string into an Options and Selectors array for the Nymph Client. It has a syntax that allows for most features of a Nymph query to be expressed in a text input.
+import queryParser from '@nymphjs/query-parser';
import BlogPost from './BlogPost';
import Category from './Category';
async function doQuery() {
const [options, ...selectors] = queryParser({
query:
'limit:4 sort:mdate foobar (| [archived] mdate<"2 weeks ago") category<{cat Tech}>',
entityClass: BlogPost,
defaultFields: ['title', 'body'],
qrefMap: {
cat: {
class: Category,
defaultFields: ['name'],
},
},
});
/*
Options will be
{
class: BlogPost,
limit: 4,
sort: 'mdate'
}
And selectors will be (equivalent to)
[
{
type: "|",
truthy: [
"archived"
],
lt: [
["mdate", null, "2 weeks ago"]
]
},
{
type: "&",
qref: [
"category",
[
{
class: Category
},
{
type: "|",
ilike: ["name", "%Tech%"]
}
]
]
},
{
type: "|",
ilike: [
["title", "%foobar%"],
["body", "%foobar%"]
]
}
]
*/
const entities = await nymph.getEntities(options, ...selectors);
}
+You can set limit, offset, sort, and reverse like this.
+limit:numberoffset:numbersort:stringreverse:true, reverse:false, reverse:1, or reverse:0These must appear in the top level of the query (outside of any parentheses).
+These are the available clauses, and their syntax.
+Check for string or JSON representation equality.
+name=string or name!=stringname="string value" or name!="string value"name=JSON or name!=JSONtrue, 1, [1,2,3], or {"prop":"val"}).)Check for entity GUID.
+{guid} or {!guid}Check for a tag.
+<name> or <!name>Check for truthiness.
+[name] or [!name]Check for a reference to another entity.
+name<{guid}> or name!<{guid}>Check for a reference to another entity using a query.
+name<{refclassname inner query}> or name!<{refclassname inner query}>Check if the array at the named property contains a value.
+name<value> or name!<value>name<JSON> or name!<JSON>true, 1, [1,2,3], or {"prop":"val"}).)Check for POSIX regex match.
+name~/pattern/ or name!~/pattern/Check for case insensitive POSIX regex match.
+name~/pattern/i or name!~/pattern/iCheck for pattern match where _ is single char wildcard and % is any length wildcard.
+name~pattern or name!~patternname~"pattern" or name!~"pattern"Check for case insensitive pattern match where _ is single char wildcard and % is any length wildcard.
+name~"pattern"i or name!~"pattern"iCheck a prop's value is greater than a given value.
+name>numbername>relativenow or yesterday.)name>"relative time value""two days from now", "last thursday", "+4 weeks", or "5 minutes ago".)Check a prop's value is greater than or equal to a given value.
+name>=numbername>=relativenow or yesterday.)name>="relative time value""two days from now", "last thursday", "+4 weeks", or "5 minutes ago".)Check a prop's value is less than a given value.
+name<numbername<relativenow or yesterday.)name<"relative time value""two days from now", "last thursday", "+4 weeks", or "5 minutes ago".)Check a prop's value is less than or equal to a given value.
+name<=numbername<=relativenow or yesterday.)name<="relative time value""two days from now", "last thursday", "+4 weeks", or "5 minutes ago".)You can specify nested selectors with different types using pairs of parentheses. The first character (or two) inside the parentheses can be a type: "&", "!&", "|", "!|", or "!" (the same as "!&").
+Here are some examples of nested selectors.
+Either enabled is truthy and abilities contains "subscriber", or abilities contains "lifelong-subscriber".
(| ([enabled] abilities<"subscriber">) abilities<"lifeline-subscriber">)
Published is not truthy and cdate is not greater than 6 months ago.
(! [published] cdate>"6 months ago")
+Anything contained in the query (including in selector parentheses) that doesn't match any of the options or clause syntaxes listed above (bare query parts) will be added (at the appropriate nesting level) to a selector with an "|" type in an ilike clause surrounded by "%" characters for each field passed in to the defaultFields argument.
You can also supply a function in the option bareHandler that will handle bare query parts instead of the "Default Fields" behavior described above. It will receive three arguments, the query parts, the entity class, and the default fields entry for that class. It should return a partial selector that will replace or extend the "|" selector.
Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The REST server lets you configure an endpoint for the Nymph client to query and push data to. The server provides this endpoint as an Express middleware, which can be used in a new or existing Express (or compatible) server.
+npm install --save @nymphjs/server
+You need to install Express, Nymph, and a Nymph driver, then you can use the REST server with an optional path. For this example, I'll use the SQLite3 driver with an in-memory database.
+import express from 'express';
import { Nymph } from '@nymphjs/nymph';
import SQLite3Driver from '@nymphjs/driver-sqlite3';
import createServer from '@nymphjs/server';
// Import all the entities you will be using on the server.
import MyEntityClass from './entities/MyEntity';
// Configure Nymph.
const nymph = new Nymph(
{},
new SQLite3Driver({
filename: ':memory:',
}),
);
const MyEntity = nymph.addEntityClass(MyEntityClass);
// Create your Express app.
const app = express();
// Create and use the REST server (with an optional path).
app.use('/rest', createServer(nymph));
// Do anything else you need to do...
// Start your server.
app.listen(80);
+You will need to import any entities you use on the server, so they are available to Nymph.
+Now you can configure your client, using your server's address (and the optional path, if set).
+import { Nymph } from '@nymphjs/client';
import MyEntityClass from './entities/MyEntityClient';
const nymph = new Nymph({
// You should configure your Express server to
// use HTTPS, but you don't have to.
restUrl: 'https://mydomain.tld/rest',
});
const MyEntity = nymph.addEntityClass(MyEntityClass);
+The REST server will authenticate for you using the Tilmeld auth cookie and XSRF token, but if you need to, you can authenticate in some other way (like OAuth2), and place the user in response.locals.user.
import express from 'express';
import { Nymph } from '@nymphjs/nymph';
import SQLite3Driver from '@nymphjs/driver-sqlite3';
import { Tilmeld } from '@nymphjs/tilmeld';
import createServer from '@nymphjs/server';
import setup from '@nymphjs/tilmeld-setup';
// Import all the entities you will be using on the server.
import MyEntityClass from './entities/MyEntity';
// Consfigure Tilmeld.
const tilmeld = new Tilmeld({
appName: 'My Awesome App',
appUrl: 'https://mydomain.tld',
setupPath: '/user',
});
// Configure Nymph.
const nymph = new Nymph(
{},
new SQLite3Driver({
filename: ':memory:',
}),
tilmeld,
);
const MyEntity = nymph.addEntityClass(MyEntityClass);
// Create your Express app.
const app = express();
// Authenticate the user manually.
app.use('/rest', async (request, response, next) => {
const { User } = tilmeld;
try {
// Somehow authenticate the user...
const user = await User.factoryUsername(username);
if (user.guid != null && user.enabled) {
response.locals.user = user;
}
next();
} catch (e: any) {
response.status(500);
response.send('Internal server error.');
}
});
// Create and use the REST server (with an optional path).
app.use('/rest', createServer(nymph));
// Create Tilmeld setup app.
app.user(
'/user',
setup(
{
restUrl: 'https://mydomain.tld/rest',
},
nymph,
),
);
// Do anything else you need to do...
// Start your server.
app.listen(80);
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The Nymph Entity Sorter lets you sort entities by their properties, including hierarchically.
+npm install --save @nymphjs/sorter
+Here's an overview:
+import { Nymph } from '@nymphjs/nymph';
// or
import { Nymph } from '@nymphjs/client';
import PageClass from 'Page';
import { Sorter } from '@nymphjs/sorter';
const nymphOptions = {
// the options for your Nymph instance.
};
const nymph = new Nymph(nymphOptions);
const Page = nymph.addEntityClass(PageClass);
let pages = await nymph.getEntities({ class: Page });
const sorter = new Sorter(pages);
//
// ## Simple sort by some property.
//
sorter.sort('name');
// Pages are now sorted by name, with locale aware sorting.
console.log(pages);
sorter.sort('cdate');
// Pages are now sorted by creation date.
console.log(pages);
sorter.sort('cdate', { reverse: true });
// Pages are now sorted by creation date, newest first.
console.log(pages);
// Specifying your own comparator.
sorter.sort('name', { comparator: (a, b) => (a < b ? -1 : a > b ? 1 : 0) });
// Pages are now sorted by name, based on UTF-16 code points.
console.log(pages);
// Specifying options to the collator.
sorter.sort('name', {
collatorOptions: {
sensitivity: 'case',
caseFirst: 'upper',
numeric: true,
},
});
// Pages are now sorted by name, with uppercase coming first in case of
// otherwise identical entries, and numbers being sorted logically (2 < 10).
console.log(pages);
//
// ## Hierarchical sorting.
//
sorter.hsort('name', 'parent');
// Pages are now sorted by name, hierarchically. (All child pages come
// immediately after their parent.)
console.log(pages);
// You can specify the same options as before.
sorter.hsort('name', 'parent', {
collatorOptions: {
sensitivity: 'case',
caseFirst: 'upper',
numeric: true,
},
});
// Pages are now sorted by name, hierarchically, with uppercase coming first
// in case of otherwise identical entries, and numbers being sorted
// logically (2 < 10).
console.log(pages);
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+Tilmeld (the d is silent) is a user and group management system for Nymph. It provides strict access controls to protect entities from unauthorized access/modification. It allows for granting and revoking ad hoc abilities to users and groups, then checking for those abilities. It provides authentication services and features protection against XSRF attacks.
+npm install --save @nymphjs/tilmeld
+When you initialize Nymph, provide it with an instance of the Tilmeld class from this package. You now have access to the User and Group classes that are specific to that instance of Nymph/Tilmeld.
+Here's an overview.
+import SQLite3Driver from '@nymphjs/driver-sqlite3';
import { Tilmeld } from '@nymphjs/tilmeld';
import { Nymph } from '@nymphjs/nymph';
const tilmeld = new Tilmeld({
appName: 'My App',
appUrl: 'http://localhost',
cookieDomain: 'localhost',
cookiePath: '/',
setupPath: '/user',
verifyRedirect: 'http://localhost',
verifyChangeRedirect: 'http://localhost',
cancelChangeRedirect: 'http://localhost',
jwtSecret: 'shhhhh',
});
const nymph = new Nymph(
{},
new SQLite3Driver({
filename: ':memory:',
}),
tilmeld,
);
// These are the classes specific to this instance of Tilmeld.
const { User, Group } = tilmeld;
+See the config declaration file.
+There are a few abilities that Tilmeld uses internally:
+system/admin - A user with this ability has all abilities.tilmeld/admin - Allow the user to manage and edit other user's account and group information and grant/revoke abilities.tilmeld/switch - Allow the user to switch to other users (log in as them without their password).uid/get/[name] - Allow the user to read the named UID.uid/new/[name] - Allow the user to read, create, and increment the named UID.uid/set/[name] - Allow the user to read, create, increment, set, and delete the named UID.The admin and switch abilities cannot be inherited from groups.
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The Tilmeld Client lets you register, login, and perform user account related functions remotely on a Nymph server.
+npm install --save @nymphjs/tilmeld-client
+You can find UMD in dist, or TS source in src.
The Tilmeld client contains the client versions of the User and Group entities. It also contains helpers, login, register, and checkUsername.
Once you've initialized Nymph Client, set the User and Group classes on it. Then initialize the new User class with the Nymph instance. (This allows the class to set up authentication listeners.)
+import { Nymph } from '@nymphjs/client';
import {
User as UserClass,
Group as GroupClass,
} from '@nymphjs/tilmeld-client';
const nymph = new Nymph({
restUrl: 'https://yournymphrestserver/path/to/your/endpoint',
});
const User = nymph.addEntityClass(UserClass);
const Group = nymph.addEntityClass(GroupClass);
User.init(nymph);
+If you're running more than one instance of Nymph client, be sure to use the classes returned by addEntityClass, so as not to accidentally submit entities from one instances to another instance.
Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The Tilmeld Components are front end registration/login, account recovery, account details, and password change components built with Svelte and SMUI.
+npm install --save @nymphjs/tilmeld-components
+You need to have an SMUI theme compiled and installed on your front end app. If you're using Svelte, you need to have TypeScript support and you should use the 'svelte' mainfield from package.json.
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Powerful object data storage and querying.
+The Tilmeld Setup App allows administrators to create, modify, and delete users and groups and configure how Tilmeld works. It also acts as the endpoint for email address verification.
+npm install --save @nymphjs/tilmeld-setup
+You need to setup a Nymph REST endpoint, then you can use the Tilmeld Setup App as another endpoint in your Express server.
+IMPORTANT: Within the setup app, Tilmeld does not check for XSRF tokens, so do not put your REST endpoint under the setup app's path, or you will be vulnerable to XSRF attacks!
+For this example, I'll use the SQLite3 driver with an in-memory database.
+import express from 'express';
import SQLite3Driver from '@nymphjs/driver-sqlite3';
import { Nymph } from '@nymphjs/nymph';
import { Tilmeld } from '@nymphjs/tilmeld';
import createServer from '@nymphjs/server';
import setup from '@nymphjs/tilmeld-setup';
// Import all the entities you will be using on the server.
import './entities/MyEntity';
// Configure Nymph.
const nymph = new Nymph(
{},
new SQLite3Driver({
filename: ':memory:',
}),
new Tilmeld({
appName: 'My App',
appUrl: 'http://localhost',
cookieDomain: 'localhost',
cookiePath: '/',
setupPath: '/user',
verifyRedirect: 'http://localhost',
verifyChangeRedirect: 'http://localhost',
cancelChangeRedirect: 'http://localhost',
jwtSecret: 'shhhhh',
}),
);
// Create your Express app.
const app = express();
// Use the REST server.
app.use('/rest', createServer(nymph));
// Create Tilmeld setup app.
app.use(
'/user',
setup(
{
restUrl: 'http://localhost/rest',
},
nymph,
),
);
// Do anything else you need to do...
// Start your server.
app.listen(80);
+Copyright 2021 SciActive Inc
+Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.
+Optional headers?: { Optional WebA WebSocket implementation.
+Optional fetch?: WindowOrWorkerGlobalScope["fetch"]A fetch implementation.
+Optional noDon't automatically try to connect to PubSub server.
+Optional noWhether to not output status messages to the console.
+Optional pubsubThe URL of your Nymph PubSub server.
+Optional renewWhether to renew tokens when a request is made.
+If you turn this off, the client will request that the server not renew an +authentication token, even if it is within the renewal time of the +expiration date.
+This defaults to true.
+The URL of your Nymph REST server.
+Optional weakUse a WeakRef based cache of entities.
+This ensures all entities returned are the same instance if they have the +same class and GUID. This also means that whenever an entity is returned +from the server, the single instance in memory will be refreshed. This +could have annoying results, like destroying dirty data (the dreaded +triple-D).
+This could also be a potential source of memory leaks. Although the +entities themselves are referenced weakly so they get garbage collected, +the GUID used as a key and the WeakRef object itself are not weak +references, so not destroyed when the instance is garbage collected.
+However, even with these caveats, this might help you if you have a big app +with the same entities stored in several different places in memory. This +can help to synchronize them correctly and avoid data conflicts.
+The Entity class to query.
+Optional limit?: numberThe limit of entities to be returned. Not needed when using getEntity, as
+it always returns only one.
Optional offset?: numberThe offset from the first matching entity, in order, to start retrieving.
+Optional return?: "entity" | "guid" | "count"What to return, the entities with their data, just the GUIDs, or just a +count.
+Optional reverse?: booleanIf true, entities will be retrieved from newest to oldest/largest to
+smallest (with regard to sort).
Optional skipIf true, Nymph will skip the cache and retrieve the entity from the DB.
+Optional sort?: "cdate" | "mdate" | stringHow to sort the entities. Should be "cdate", "mdate", or the name of a +property.
+The error event is for unknown errors. Query errors fire their own reject +callbacks.
+Optional resolve: PubSubResolveCallback<T>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackOptional !contain?: Clause<OrWithTime<PrimitiveSelector["contain"]>>Optional !defined?: Clause<PrimitiveSelector["defined"]>Optional !equal?: Clause<OrWithTime<PrimitiveSelector["equal"]>>Optional !gt?: Clause<OrWithTime<PrimitiveSelector["gt"]>>Optional !gte?: Clause<OrWithTime<PrimitiveSelector["gte"]>>Optional !guid?: Clause<PrimitiveSelector["guid"]>Optional !ilike?: Clause<PrimitiveSelector["ilike"]>Optional !imatch?: Clause<PrimitiveSelector["imatch"]>Optional !like?: Clause<PrimitiveSelector["like"]>Optional !lt?: Clause<OrWithTime<PrimitiveSelector["lt"]>>Optional !lte?: Clause<OrWithTime<PrimitiveSelector["lte"]>>Optional !match?: Clause<PrimitiveSelector["match"]>Optional !qref?: Selector["qref"]Optional !ref?: Clause<PrimitiveSelector["ref"]>Optional !selector?: Selector["selector"]Optional !tag?: Clause<PrimitiveSelector["tag"]>Optional !truthy?: Clause<PrimitiveSelector["truthy"]>Optional contain?: Clause<OrWithTime<PrimitiveSelector["contain"]>>Optional defined?: Clause<PrimitiveSelector["defined"]>Optional equal?: Clause<OrWithTime<PrimitiveSelector["equal"]>>Optional gt?: Clause<OrWithTime<PrimitiveSelector["gt"]>>Optional gte?: Clause<OrWithTime<PrimitiveSelector["gte"]>>Optional guid?: Clause<PrimitiveSelector["guid"]>Optional ilike?: Clause<PrimitiveSelector["ilike"]>Optional imatch?: Clause<PrimitiveSelector["imatch"]>Optional like?: Clause<PrimitiveSelector["like"]>Optional lt?: Clause<OrWithTime<PrimitiveSelector["lt"]>>Optional lte?: Clause<OrWithTime<PrimitiveSelector["lte"]>>Optional match?: Clause<PrimitiveSelector["match"]>Optional qref?: Clause<[string, [Options, ...Selector[]]]>Optional ref?: Clause<PrimitiveSelector["ref"]>Optional selector?: Clause<Selector>Optional tag?: Clause<PrimitiveSelector["tag"]>Optional truthy?: Clause<PrimitiveSelector["truthy"]>Optional entity?: EntityJsonOptional !contain?: PrimitiveSelector["contain"][]Optional !defined?: PrimitiveSelector["defined"][][]Optional !equal?: PrimitiveSelector["equal"][]Optional !gt?: PrimitiveSelector["gt"][]Optional !gte?: PrimitiveSelector["gte"][]Optional !guid?: PrimitiveSelector["guid"][][]Optional !ilike?: PrimitiveSelector["ilike"][]Optional !imatch?: PrimitiveSelector["imatch"][]Optional !like?: PrimitiveSelector["like"][]Optional !lt?: PrimitiveSelector["lt"][]Optional !lte?: PrimitiveSelector["lte"][]Optional !match?: PrimitiveSelector["match"][]Optional !qref?: FormattedSelector["qref"]Optional !ref?: PrimitiveSelector["ref"][]Optional !selector?: FormattedSelector["selector"]Optional !tag?: PrimitiveSelector["tag"][][]Optional !truthy?: PrimitiveSelector["truthy"][][]Optional contain?: PrimitiveSelector["contain"][]Optional defined?: PrimitiveSelector["defined"][][]Optional equal?: PrimitiveSelector["equal"][]Optional gt?: PrimitiveSelector["gt"][]Optional gte?: PrimitiveSelector["gte"][]Optional guid?: PrimitiveSelector["guid"][][]Optional ilike?: PrimitiveSelector["ilike"][]Optional imatch?: PrimitiveSelector["imatch"][]Optional like?: PrimitiveSelector["like"][]Optional lt?: PrimitiveSelector["lt"][]Optional lte?: PrimitiveSelector["lte"][]Optional match?: PrimitiveSelector["match"][]Optional qref?: [string, [Options, ...FormattedSelector[]]][]Optional ref?: PrimitiveSelector["ref"][]Optional selector?: FormattedSelector[]Optional tag?: PrimitiveSelector["tag"][][]Optional truthy?: PrimitiveSelector["truthy"][][]Optional className: stringThe NymphQueryCallback will be called on both top level and qref queries.
+This is the only callback that is not asynchronous.
+This also isn't necessarily run on every "query". It is run before a database +query for an entity, but it is not run during PubSub entity change +propagation. Therefore, it shouldn't do anything entity specific, instead +it should be query specific. For example, throw an error if the user is not +permitted to run the query at all.
+Optional class?: TThe Entity class to query.
+Optional limit?: numberThe limit of entities to be returned. Not needed when using getEntity, as
+it always returns only one.
Optional offset?: numberThe offset from the first matching entity, in order, to start retrieving.
+Optional return?: "entity" | "guid" | "count"What to return, the entities with their data, just the GUIDs, or just a +count.
+Optional reverse?: booleanIf true, entities will be retrieved from newest to oldest/largest to
+smallest (with regard to sort).
Optional skipIf true, Tilmeld will not filter returned entities according to access +controls. (If Tilmeld is installed.) (This is always set to false by the +REST endpoint and PubSub server.)
+Optional skipIf true, Nymph will skip the cache and retrieve the entity from the DB.
+Optional sort?: "cdate" | "mdate" | stringHow to sort the entities. Should be "cdate", "mdate", or the name of a +property.
+Optional source?: stringWill be 'client' if the query came from a REST request or the PubSub +server. (Mainly used in Tilmeld for access control.)
+Optional !contain?: Clause<OrWithTime<PrimitiveSelector["contain"]>>Optional !defined?: Clause<PrimitiveSelector["defined"]>Optional !equal?: Clause<OrWithTime<PrimitiveSelector["equal"]>>Optional !gt?: Clause<OrWithTime<PrimitiveSelector["gt"]>>Optional !gte?: Clause<OrWithTime<PrimitiveSelector["gte"]>>Optional !guid?: Clause<PrimitiveSelector["guid"]>Optional !ilike?: Clause<PrimitiveSelector["ilike"]>Optional !imatch?: Clause<PrimitiveSelector["imatch"]>Optional !like?: Clause<PrimitiveSelector["like"]>Optional !lt?: Clause<OrWithTime<PrimitiveSelector["lt"]>>Optional !lte?: Clause<OrWithTime<PrimitiveSelector["lte"]>>Optional !match?: Clause<PrimitiveSelector["match"]>Optional !qref?: Selector["qref"]Optional !ref?: Clause<PrimitiveSelector["ref"]>Optional !selector?: Selector["selector"]Optional !tag?: Clause<PrimitiveSelector["tag"]>Optional !truthy?: Clause<PrimitiveSelector["truthy"]>Optional contain?: Clause<OrWithTime<PrimitiveSelector["contain"]>>Optional defined?: Clause<PrimitiveSelector["defined"]>Optional equal?: Clause<OrWithTime<PrimitiveSelector["equal"]>>Optional gt?: Clause<OrWithTime<PrimitiveSelector["gt"]>>Optional gte?: Clause<OrWithTime<PrimitiveSelector["gte"]>>Optional guid?: Clause<PrimitiveSelector["guid"]>Optional ilike?: Clause<PrimitiveSelector["ilike"]>Optional imatch?: Clause<PrimitiveSelector["imatch"]>Optional like?: Clause<PrimitiveSelector["like"]>Optional lt?: Clause<OrWithTime<PrimitiveSelector["lt"]>>Optional lte?: Clause<OrWithTime<PrimitiveSelector["lte"]>>Optional match?: Clause<PrimitiveSelector["match"]>Optional qref?: Clause<[string, [Options, ...Selector[]]]>Optional ref?: Clause<PrimitiveSelector["ref"]>Optional selector?: Clause<Selector>Optional tag?: Clause<PrimitiveSelector["tag"]>Optional truthy?: Clause<PrimitiveSelector["truthy"]>Optional switchOptional entity?: EntityJsonOptional name?: stringOptional newOptional oldOptional value?: numberOptional count?: booleanThis means the user directly subscribed to this query, as opposed +to indirectly subscribing with a qref clause.
+Optional count?: booleanOptional entityClass: EntityConstructorOptional defaultFields: string[]Optional defaultOptional caseSort case sensitively.
+Optional collatorOptions to pass to Intl.Collator for string comparisons. This overrides the caseSensitive options.
+Optional comparator?: ((a, b) => number)A custom comparator to use. This overrides all other options except reverse.
+Optional reverse?: booleanReverse the sort order.
+Optional acOptional acOptional acOptional acOptional acOptional acOptional group?: Group & GroupDataOptional user?: User & UserDataOptional abilities?: string[]The abilities granted to the group.
+Optional avatar?: stringThe group's avatar URL. (Use getAvatar() to support Gravatar.)
+Optional defaultWhether this group is the default primary group for new users.
+Optional defaultWhether this group is a default secondary group for new users.
+Optional email?: stringThe group's email address.
+Optional enabled?: booleanWhether the group can be used.
+Optional groupname?: stringThe group's groupname.
+Optional name?: stringThe group's name.
+Optional parent?: Group & GroupDataThe group's parent.
+Optional phone?: stringThe group's telephone number.
+Optional unverifiedWhether this group is a default secondary group for unverified users.
+Optional user?: User & UserData | nullIf generatePrimary is on, this will be the user who generated this group.
+This is run before the transaction is committed, and you can perform
+additional functions on the transaction, which is available in user.$nymph.
These are run after the authentication checks, but before the login action.
+Theses are run before the user data checks, so the only checks before are +whether registration is allowed and whether the user is already registered.
+This is run when the user has entered an otherwise valid username into the +signup form. It should return a result, which when false will stop the +process and return the included message, disallowing the username.
+Optional abilities?: string[]The abilities granted to the user.
+Optional avatar?: stringThe user's avatar URL. (Use $getAvatar() to support Gravatar.)
+Optional cancelThe old email address.
+Optional cancelAn email change cancellation secret.
+Optional email?: stringThe user's email address.
+Optional emailThe timestamp of when the email address was last changed.
+Optional enabled?: booleanWhether the user can log in.
+Optional group?: Group & GroupDataThe user's primary group.
+Optional groups?: (Group & GroupData)[]The user's secondary groups.
+Optional inheritWhether the user should inherit the abilities of his groups.
+Optional name?: stringThe user's full name. This is generated from the first, middle, and last +names.
+Optional nameThe user's first name.
+Optional nameThe user's last name.
+Optional nameThe user's middle name.
+Optional newIf the user has changed their email address, this is the new one, awaiting +verification.
+Optional newAn email change proceed secret.
+Optional password?: stringThe password or password hash.
+Optional passwordTemporary storage for passwords. This will be hashed before going into the +database.
+Optional phone?: stringThe user's telephone number.
+Optional recoverA recovery secret.
+Optional recoverThe timestamp of when the recovery secret was issued.
+Optional revokeIf set, this timestamp is the cutoff point for JWT issue dates. Any token +issued before this date will not authenticate the user.
+Optional salt?: stringThe password hash salt.
+Optional secret?: stringA verification secret.
+Optional totpTwo factor auth secret.
+Optional username?: stringThe user's username.
+Optional cancelThe old email address.
+Optional cancelAn email change cancellation secret.
+Optional emailThe timestamp of when the email address was last changed.
+Optional group?: Group & AdminGroupDataThe user's primary group.
+Optional groups?: (Group & AdminGroupData)[]The user's secondary groups.
+Optional newThe new email address.
+Optional newAn email change proceed secret.
+Optional passwordUsed by admins to change a user's password. Not saved to the database.
+Optional recoverA recovery secret.
+Optional recoverThe timestamp of when the recovery secret was issued.
+Optional revokeIf set, this timestamp is the cutoff point for JWT issue dates. Any token +issued before this date will not authenticate the user.
+Optional secret?: stringA verification secret.
+Optional abilities?: string[]The abilities granted to the group.
+Optional email?: stringThe group's email address.
+Optional phone?: stringThe group's telephone number.
+Optional user?: User & CurrentUserData | nullIf generatePrimary is on, this will be the user who generated this group.
+Optional abilities?: string[]The abilities granted to the user.
+Optional email?: stringThe user's email address.
+Optional group?: Group & CurrentGroupDataThe user's primary group.
+Optional groups?: (Group & CurrentGroupData)[]The user's secondary groups.
+Optional inheritWhether the user should inherit the abilities of his groups.
+Optional newIf the user has changed their email address, this is the new one, awaiting +verification.
+Optional phone?: stringThe user's telephone number.
+Optional avatar?: stringThe group's avatar URL. (Use getAvatar() to support Gravatar.)
+Optional defaultWhether this group is the default primary group for new users.
+Optional defaultWhether this group is a default secondary group for new users.
+Optional enabled?: booleanWhether the group can be used.
+Optional groupname?: stringThe group's groupname.
+Optional name?: stringThe group's name.
+Optional parent?: Group & GroupDataThe group's parent.
+Optional unverifiedWhether this group is a default secondary group for unverified users.
+Optional additionalAdditional data to be included in the request.
+Optional email?: stringThe new user's email address.
+Optional nameThe new user's given name.
+Optional nameThe new user's surname.
+New user's password.
+Repeat the password.
+Optional phone?: stringThe new user's phone number.
+New user's username.
+Whether the username passed verification.
+Optional avatar?: stringThe user's avatar URL. (Use $getAvatar() to support Gravatar.)
+Optional enabled?: booleanWhether the user can log in.
+Optional name?: stringThe user's full name.
+Optional nameThe user's first name.
+Optional nameThe user's last name.
+Optional nameThe user's middle name.
+Optional username?: stringThe user's username.
+Const HTTP status code to status text map.
+Optional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureEntity interface.
-Initialize an entity.
-Rest ..._rest: any[]Protected $dataThe data proxy object.
-Protected $dataThe data proxy handler.
-Protected $dataThe actual data store.
-Protected $dirtyA map of props to whether they're dirty (for patch).
-Protected $isASleepingWhether this instance is a sleeping reference.
-The instance of Nymph to use for queries.
-Protected $originalArray of the entity's original tags (for patch).
-Protected $sleepingThe reference to use to wake.
-Protected $wakeA promise that resolved when the entity's data is wake.
-The creation date of the entity as a high precision Unix timestamp.
-The entity's Globally Unique ID.
-The modified date of the entity as a high precision Unix timestamp.
-Array of the entity's tags.
-Static classThe lookup name for this entity.
+Entity interface.
+Initialize an entity.
+Rest ..._rest: any[]Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Protected $dirtyA map of props to whether they're dirty (for patch).
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Protected $originalArray of the entity's original tags (for patch).
+Protected $sleepingThe reference to use to wake.
+Protected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a high precision Unix timestamp.
+The entity's Globally Unique ID.
+The modified date of the entity as a high precision Unix timestamp.
+Array of the entity's tags.
+Static classThe lookup name for this entity.
This is used for reference arrays (and sleeping references) and server requests.
-Static nymphThe instance of Nymph to use for queries.
-Static nymphThe instance of Nymph to use for queries.
+Search the array for this object and return the corresponding index.
If strict is false, is() is used to compare. If strict is true,
equals() is used.
The array to search.
-Whether to use stronger comparison.
+The array to search.
+Whether to use stronger comparison.
The index if the object is in the array, -1 if it isn't.
-Protected $checkPerform a more strict comparison of this object to another.
-The object to compare.
+Protected $checkGet a patch of this entity's dirty data to be applied on the server.
-Check that the entity has all of the given tags.
-Rest ...tags: string[]List of tags.
+Get a patch of this entity's dirty data to be applied on the server.
+Check whether this object is in an array.
+Check whether this object is in an array.
If strict is false, is() is used to compare. If strict is true,
equals() is used.
The array to search.
-Whether to use stronger comparison.
+The array to search.
+Whether to use stronger comparison.
True if the object is in the array, false if it isn't.
-Initialize this entity from a JSON representation.
-The entity JSON.
-Perform a less strict comparison of this object to another.
-The object to compare.
+Initialize this entity from a JSON representation.
+The entity JSON.
+Protected $referenceRefresh the object from storage. (Bypasses Nymph's cache.)
+Protected $referenceRefresh the object from storage. (Bypasses Nymph's cache.)
If the object has been deleted from storage, the database cannot be
reached, or a database error occurs, refresh() will return 0.
False if the data has not been saved, 0 if it can't be refreshed, true on success.
-Call an instance method on the server version of this entity.
The entity's data will be sent up to the server as well, so the server's state can match the client's state. It won't be propagated into the DB, though.
-The name of the method.
-The parameters to call the method with.
-Whether the server should return, and the client update, the data in the entity after the method has run.
-The value that the method on the server returned.
-Return a Nymph Entity Reference for this entity.
+The name of the method.
+The parameters to call the method with.
+Whether the server should return, and the client update, the data in the entity after the method has run.
+The value that the method on the server returned.
+Return a Nymph Entity Reference for this entity.
If the entity hasn't been saved yet (and has no GUID), it will be returned instead.
A Nymph Entity Reference array as an unsaved entity.
-Ready this entity's data, and the data of entity's within this one's.
-Optional level: numberThe number of levels deep to wake. If undefined, it will keep going until there are no more entities. (Careful of infinite loops.)
-The entity.
-Static factoryCreate or retrieve a new entity instance.
+Ready this entity's data, and the data of entity's within this one's.
+Optional level: numberThe number of levels deep to wake. If undefined, it will keep going until there are no more entities. (Careful of infinite loops.)
+The entity.
+Static factoryCreate or retrieve a new entity instance.
Note that this will always return an entity, even if the GUID is not found.
-Optional guid: stringAn optional GUID to retrieve.
-Static factoryCreate a new sleeping reference instance.
+Static factoryCreate a new sleeping reference instance.
Sleeping references won't retrieve their data from the server until they
are readied with $wake() or a parent's $wakeAll().
The Nymph Entity Reference to use to wake.
-The new instance.
-Static factoryCreate a new entity instance.
-Static serverStatic serverCall a static iterator method on the server version of this entity.
-The name of the method.
-The parameters to call the method with.
-An iterator that iterates over values that the method on the server yields.
-Generated using TypeDoc
The Nymph Entity Reference to use to wake.
+The new instance.
+Static factoryCreate a new entity instance.
+Static serverStatic serverCall a static iterator method on the server version of this entity.
+The name of the method.
+The parameters to call the method with.
+An iterator that iterates over values that the method on the server yields.
+Optional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureThe entity class for this instance of Nymph.
-The entity cache.
-Private entityA simple map of names to Entity classes.
-Headers that will be sent with every request.
+The entity class for this instance of Nymph.
+The entity cache.
+Private entityA simple map of names to Entity classes.
+Headers that will be sent with every request.
These are used by Tilmeld for authentication.
-And optional PubSub client instance.
-Private requestPrivate responsePrivate restPrivate weakAnd optional PubSub client instance.
+Private requestPrivate responsePrivate restPrivate weakAdd your class to this instance.
This will create a class that extends your class within this instance of Nymph and return it. You can then use this class's constructor and methods, which will use this instance of Nymph.
Because this creates a subclass, don't use the class
returned from getEntityClass to check with instanceof.
Private requestGenerated using TypeDoc
Private requestPrivate WebOptional protocols: string | string[]Readonly CLOSED: 3Readonly CLOSING: 2Readonly CONNECTING: 0Readonly OPEN: 1Private authPrivate connectPrivate connectionPrivate disconnectPrivate errorPrivate noPrivate nymphPrivate pubsubPrivate subscriptionsPrivate switchPrivate waitPrivate _attemptPrivate _isPrivate _isPrivate _onclosePrivate _onmessagePrivate _onopenPrivate _sendPrivate _sendPrivate _sendUIDPrivate _sendPrivate _sendPrivate _subscribePrivate _subscribeUIDPrivate _unsubscribePrivate _unsubscribeUIDPrivate _waitOptional resolve: PubSubResolveCallback<number>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackOptional resolve: PubSubResolveCallback<T>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackGenerated using TypeDoc
Private WebOptional protocols: string | string[]Readonly CLOSED: 3Readonly CLOSING: 2Readonly CONNECTING: 0Readonly OPEN: 1Private authPrivate connectPrivate connectionPrivate disconnectPrivate errorPrivate noPrivate nymphPrivate pubsubPrivate subscriptionsPrivate switchPrivate waitPrivate _attemptPrivate _isPrivate _isPrivate _onclosePrivate _onmessagePrivate _onopenPrivate _sendPrivate _sendPrivate _sendUIDPrivate _sendPrivate _sendPrivate _subscribePrivate _subscribeUIDPrivate _unsubscribePrivate _unsubscribeUIDPrivate _waitOptional resolve: PubSubResolveCallback<number>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackOptional resolve: PubSubResolveCallback<T>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureThe entity class for this instance of Nymph.
-The entity cache.
-Headers that will be sent with every request.
+The entity class for this instance of Nymph.
+The entity cache.
+Headers that will be sent with every request.
These are used by Tilmeld for authentication.
-And optional PubSub client instance.
-And optional PubSub client instance.
+Add your class to this instance.
This will create a class that extends your class within this instance of Nymph and return it. You can then use this class's constructor and methods, which will use this instance of Nymph.
Because this creates a subclass, don't use the class
returned from getEntityClass to check with instanceof.
Optional _plural: booleanOptional stateless: booleanGenerated using TypeDoc
Optional _plural: booleanOptional stateless: booleanOptional resolve: PubSubResolveCallback<number>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackOptional resolve: PubSubResolveCallback<T>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackGenerated using TypeDoc
Optional resolve: PubSubResolveCallback<number>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackOptional resolve: PubSubResolveCallback<T>Optional reject: PubSubRejectCallbackOptional count: PubSubCountCallbackThe MySQL Nymph database driver.
-Optional link: PoolOptional transaction: MySQLDriverTransactionProtected connectedProtected entityA cache to make entity retrieval faster.
-Protected entityA counter for the entity cache to determine the most accessed entities.
-Protected linkPrivate mysqlProtected nymphProtected prefixProtected transactionOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
+The MySQL Nymph database driver.
+Optional link: PoolOptional transaction: MySQLDriverTransactionProtected connectedProtected entityA cache to make entity retrieval faster.
+Protected entityA counter for the entity cache to determine the most accessed entities.
+Protected linkPrivate mysqlProtected nymphProtected prefixProtected transactionOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
A clone of this instance.
-Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
-Any value to search.
-An entity, GUID, or array of either to search for.
+Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
+Any value to search.
+An entity, GUID, or array of either to search for.
True if the reference is found, false otherwise.
-Protected exportProtected findPrivate getProtected getProtected importOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | (() => Promise<void>)Initialize the Nymph driver.
+Protected findPrivate getProtected getInitialize the Nymph driver.
This is meant to be called internally by Nymph. Don't call this directly.
-The Nymph instance.
-Private internalCheck connection status.
+The Nymph instance.
+Protected internalProtected iteratePrivate makeGenerate the MySQL query.
-The options array.
-The formatted selector array.
-Used to track internal params.
-Used to store internal params.
-Whether only a subquery should be returned.
-The SQL query.
-Protected performProtected posixProtected pullPull an entity from the cache.
-The entity's GUID.
-The entity's class.
-Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
-The entity or null if it's not cached.
-Protected pushPush an entity onto the cache.
-The entity's GUID.
-The entity's cdate.
-The entity's mdate.
-The entity's tags.
-The entity's data.
-The entity's sdata.
-Private queryPrivate queryPrivate queryPrivate queryProtected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Private translateStatic escapeStatic escapeGenerated using TypeDoc
Protected iteratePrivate makeGenerate the MySQL query.
+The options array.
+The formatted selector array.
+Used to track internal params.
+Used to store internal params.
+Whether only a subquery should be returned.
+The SQL query.
+Protected performProtected posixProtected pullPull an entity from the cache.
+The entity's GUID.
+The entity's class.
+Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
+The entity or null if it's not cached.
+Protected pushPush an entity onto the cache.
+The entity's GUID.
+The entity's cdate.
+The entity's mdate.
+The entity's tags.
+The entity's data.
+The entity's sdata.
+Private queryPrivate queryPrivate queryPrivate queryProtected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Private translateStatic escapeStatic escapeThe PostgreSQL Nymph database driver.
-Optional link: PoolOptional transaction: PostgreSQLDriverTransactionProtected connectedProtected entityA cache to make entity retrieval faster.
-Protected entityA counter for the entity cache to determine the most accessed entities.
-Protected linkProtected nymphPrivate postgresqlProtected prefixProtected transactionOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
+The PostgreSQL Nymph database driver.
+Optional link: PoolOptional transaction: PostgreSQLDriverTransactionProtected connectedProtected entityA cache to make entity retrieval faster.
+Protected entityA counter for the entity cache to determine the most accessed entities.
+Protected linkProtected nymphPrivate postgresqlProtected prefixProtected transactionOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
A clone of this instance.
-Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
-Any value to search.
-An entity, GUID, or array of either to search for.
+Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
+Any value to search.
+An entity, GUID, or array of either to search for.
True if the reference is found, false otherwise.
-Protected exportProtected findPrivate getProtected getProtected importOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | (() => Promise<void>)Initialize the Nymph driver.
+Protected findPrivate getProtected getInitialize the Nymph driver.
This is meant to be called internally by Nymph. Don't call this directly.
-The Nymph instance.
-Private internalCheck connection status.
+The Nymph instance.
+Protected internalProtected iteratePrivate makeGenerate the PostgreSQL query.
-The options array.
-The formatted selector array.
-Used to track internal params.
-Used to store internal params.
-Whether only a subquery should be returned.
-The SQL query.
-Protected performProtected posixProtected pullPull an entity from the cache.
-The entity's GUID.
-The entity's class.
-Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
-The entity or null if it's not cached.
-Protected pushPush an entity onto the cache.
-The entity's GUID.
-The entity's cdate.
-The entity's mdate.
-The entity's tags.
-The entity's data.
-The entity's sdata.
-Private queryPrivate queryPrivate queryPrivate queryProtected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Private translateStatic escapeStatic escapeGenerated using TypeDoc
Protected iteratePrivate makeGenerate the PostgreSQL query.
+The options array.
+The formatted selector array.
+Used to track internal params.
+Used to store internal params.
+Whether only a subquery should be returned.
+The SQL query.
+Protected performProtected posixProtected pullPull an entity from the cache.
+The entity's GUID.
+The entity's class.
+Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
+The entity or null if it's not cached.
+Protected pushPush an entity onto the cache.
+The entity's GUID.
+The entity's cdate.
+The entity's mdate.
+The entity's tags.
+The entity's data.
+The entity's sdata.
+Private queryPrivate queryPrivate queryPrivate queryOptional connection?: PostgreSQLDriverConnectionOptional etypes?: string[]Optional params?: { Protected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Private translateStatic escapeStatic escapeStatic escapeStatic escapeStatic unescapeStatic unescapeThe SQLite3 Nymph database driver.
-Optional store: InternalStoreProtected entityA cache to make entity retrieval faster.
-Protected entityA counter for the entity cache to determine the most accessed entities.
-Protected nymphProtected prefixProtected storePrivate _connectOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
+The SQLite3 Nymph database driver.
+Optional store: InternalStoreProtected entityA cache to make entity retrieval faster.
+Protected entityA counter for the entity cache to determine the most accessed entities.
+Protected nymphProtected prefixProtected storePrivate _connectOptional guid: null | stringOptional tags: null | string[]Protected cleanThis is used internally by Nymph. Don't call it yourself.
A clone of this instance.
-Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
-Any value to search.
-An entity, GUID, or array of either to search for.
+Private createOptional className: null | string | EntityConstructorProtected entitySearch through a value for an entity reference.
+Any value to search.
+An entity, GUID, or array of either to search for.
True if the reference is found, false otherwise.
-Protected exportProtected findProtected getProtected importOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | (() => Promise<void>)Initialize the Nymph driver.
+Protected findProtected getInitialize the Nymph driver.
This is meant to be called internally by Nymph. Don't call this directly.
-The Nymph instance.
-Check connection status.
+The Nymph instance.
+Protected iteratePrivate makeGenerate the SQLite3 query.
-The options array.
-The formatted selector array.
-Used to track internal params.
-Used to store internal params.
-Whether only a subquery should be returned.
-The SQL query.
-Protected performProtected posixProtected pullPull an entity from the cache.
-The entity's GUID.
-The entity's class.
-Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
-The entity or null if it's not cached.
-Protected pushPush an entity onto the cache.
-The entity's GUID.
-The entity's cdate.
-The entity's mdate.
-The entity's tags.
-The entity's data.
-The entity's sdata.
-Private queryPrivate queryPrivate queryPrivate queryProtected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Static escapeGenerated using TypeDoc
Protected iteratePrivate makeGenerate the SQLite3 query.
+The options array.
+The formatted selector array.
+Used to track internal params.
+Used to store internal params.
+Whether only a subquery should be returned.
+The SQL query.
+Protected performProtected posixProtected pullPull an entity from the cache.
+The entity's GUID.
+The entity's class.
+Optional useSkipAc: booleanWhether to tell the entity to use skip_ac.
+The entity or null if it's not cached.
+Protected pushPush an entity onto the cache.
+The entity's GUID.
+The entity's cdate.
+The entity's mdate.
+The entity's tags.
+The entity's data.
+The entity's sdata.
+Private queryPrivate queryPrivate queryPrivate queryProtected saveOptional startTransactionCallback: null | (() => Promise<void>)Optional commitTransactionCallback: null | ((success) => Promise<boolean>)Static escapeOptional stackStatic Optional prepareOptional override for formatting stack traces
-Static stackStatic captureGenerated using TypeDoc
Optional causeOptional stackStatic Optional prepareOptional override for formatting stack traces
+Static stackStatic captureDatabase abstraction object.
+Database abstraction object.
Provides a way to access, manipulate, and store data in Nymph.
The GUID is not set until the entity is saved. GUIDs must be unique forever, even after deletion. It's the job of the Nymph DB driver to make sure no two @@ -55,94 +55,94 @@ When you first access an entity's data, if it is a sleeping reference, it will fill its data from the DB. You can call clearCache() to turn all the entities back into sleeping references.
-Initialize an entity.
-Rest ..._rest: any[]Protected Optional $allowlistIf this is defined, then it lists the only properties that will be +
Initialize an entity.
+Rest ..._rest: any[]Protected Optional $allowlistIf this is defined, then it lists the only properties that will be accepted from incoming JSON. Any other properties will be ignored.
If you use an allowlist, you don't need to use protectedData, since you can simply leave those entries out of allowlistData.
-Protected Optional $allowlistIf this is defined, then it lists the only tags that will be accepted from +
Protected Optional $allowlistIf this is defined, then it lists the only tags that will be accepted from incoming JSON. Any other tags will be ignored.
-Protected $clientThe names of methods allowed to be called by the frontend with serverCall.
-Protected $dataThe data proxy object.
-Protected $dataThe data proxy handler.
-Protected $dataThe actual data store.
-Protected $isASleepingWhether this instance is a sleeping reference.
-The instance of Nymph to use for queries.
-Private $originalThe AC properties' values when the entity was loaded.
-Protected $privateProperties that will not be serialized into JSON with toJSON(). This +
Protected $clientThe names of methods allowed to be called by the frontend with serverCall.
+Protected $dataThe data proxy object.
+Protected $dataThe data proxy handler.
+Protected $dataThe actual data store.
+Protected $isASleepingWhether this instance is a sleeping reference.
+The instance of Nymph to use for queries.
+Private $originalThe AC properties' values when the entity was loaded.
+Protected $privateProperties that will not be serialized into JSON with toJSON(). This can be considered a denylist, because these properties will not be set with incoming JSON.
Clients CAN still determine what is in these properties, unless they are also listed in searchRestrictedData.
-Protected $protectedProperties that can only be modified by server side code. They will still +
Protected $protectedProperties that can only be modified by server side code. They will still be visible on the frontend, unlike $privateData, but any changes to them that come from the frontend will be ignored.
In addition to what's listed here, all of the access control properties @@ -159,95 +159,95 @@
You should modify these through client enabled methods or the $save method instead, for safety.
-Protected $protectedTags that can only be added/removed by server side code. They will still be +
Protected $protectedTags that can only be added/removed by server side code. They will still be visible on the frontend, but any changes to them that come from the frontend will be ignored.
-Protected $sdataThe actual sdata store.
-Private $skipWhether to use "skipAc" when accessing entity references.
-Protected $sleepingThe reference to use to wake.
-Protected $wakeA promise that resolved when the entity's data is wake.
-The creation date of the entity as a Unix timestamp in milliseconds.
-The entity's Globally Unique ID.
+Protected $sdataThe actual sdata store.
+Private $skipWhether to use "skipAc" when accessing entity references.
+Protected $sleepingThe reference to use to wake.
+Protected $wakeA promise that resolved when the entity's data is wake.
+The creation date of the entity as a Unix timestamp in milliseconds.
+The entity's Globally Unique ID.
This is a 12 byte number represented as a lower case HEX string (24 characters).
-The modified date of the entity as a Unix timestamp in milliseconds.
-Array of the entity's tags.
-Static ETYPEA unique name for this type of entity used to separate its data from other +
The modified date of the entity as a Unix timestamp in milliseconds.
+Array of the entity's tags.
+Static ETYPEA unique name for this type of entity used to separate its data from other types of entities in the database.
-Static classThe lookup name for this entity.
+Static classThe lookup name for this entity.
This is used for reference arrays (and sleeping references) and client requests.
-Static clientThe names of static methods allowed to be called by the frontend with +
Static clientThe names of static methods allowed to be called by the frontend with serverCallStatic.
-Static nymphThe instance of Nymph to use for queries.
-Static pubWhether this entity should publish changes to PubSub servers.
-Static restWhether this entity should be accessible on the frontend through the REST +
Static nymphThe instance of Nymph to use for queries.
+Static pubWhether this entity should publish changes to PubSub servers.
+Static restWhether this entity should be accessible on the frontend through the REST server.
If this is false, any request from the client that attempts to use this entity will fail.
-Static searchProperties that will not be searchable from the frontend. If the frontend +
Static searchProperties that will not be searchable from the frontend. If the frontend includes any of these properties in any of their clauses, they will be filtered out before the search is executed.
-Search the array for this object and return the corresponding index.
If strict is false, is() is used to compare. If strict is true,
equals() is used.
The array to search.
-Whether to use stronger comparison.
+The array to search.
+Whether to use stronger comparison.
The index if the object is in the array, -1 if it isn't.
-Protected $checkReplace any referenced entities in the data with sleeping references.
+Protected $checkPerform a more strict comparison of this object to another.
-The object to compare.
+Get the client enabled methods.
+Get the current values of the AC properties.
+Get the current values of the AC properties.
An object of AC properties.
-Used to retrieve the data object.
+Used to retrieve the data object.
This should only be used by Nymph to save the data into storage.
-Whether to include the serialized data as well.
+Whether to include the serialized data as well.
The entity's data object.
-Get the original values of the AC properties.
+Get the original values of the AC properties.
An object of AC properties.
-Used to retrieve the serialized data object.
+Used to retrieve the serialized data object.
This should only be used by Nymph to save the data object into storage.
This method is used by Nymph to avoid unserializing data that hasn't been requested yet.
It should always be called after getData().
The entity's serialized data object.
-Get the entity's tags.
+Get an array of strings that must be unique across the current etype.
+Get an array of strings that must be unique across the current etype.
When you try to save another entity with any of the same unique strings, Nymph will throw an error.
The default implementation of this method returns an empty array, meaning there are no uniqueness constraints applied to its etype.
-Resolves to an array of entity's unique constraint strings.
-Check that the entity has all of the given tags.
-
Optional override for formatting stack traces
+