@earendil-works/chord 1.4.0 → 1.5.0

package/dist/next/store/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../../src/next/store/import.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,qHAAqH;AACrH,iHAAiH;AACjH,qHAAqH;AACrH,sHAAsH;AACtH,sBAAsB;AAEtB,OAAO,EAAE,gBAAgB,EAAgB,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAA0C,SAAS,EAAE,MAAM,cAAc,CAAC;AAEjG,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAgB,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAiC,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,OAAgB,EAChB,KAAiD,EACjD,OAAgB,EAChB,OAAO,GAAiB,EAAE;IAE1B,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC;QACJ,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,+CAA+C,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5F,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC,MAAM,EAAE,2CAA2C,CAAC,CAAC;QAC/F,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACpD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACzD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC;YACJ,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACR,iDAAiD;QAClD,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED,+GAA+G;AAC/G,SAAS,aAAa,CAAC,QAAwB;IAC9C,OAAO;QACN,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QACjC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACrD,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACnE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACrD,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACrD,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7C,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;KACrF,CAAC;AACH,CAAC;AAKD;;;;GAIG;AACH,MAAM,aAAa;IACT,SAAS,CAAiB;IAC1B,QAAQ,CAAU;IAC3B,SAAS,GAAG,CAAC,CAAC;IACd,SAAS,CAA8B;IACvC,KAAK,CAAmB;IACxB,kCAAkC;IAClC,MAAM,GAAU,UAAU,CAAC;IAC3B,qCAAqC;IACrC,MAAM,CAAqB;IAClB,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5B,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,4FAA4F;IACnF,UAAU,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC5D,kGAAkG;IAClG,SAAS,CAAyF;IAClG,OAAO,GAAG,CAAC,CAAC;IAEZ,YAAY,QAAwB,EAAE,OAAgB;QACrD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,IAAI,CAAC,KAAc;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,gBAAgB,QAAQ,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC;QACvD,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO;YAAE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,iBAAiB,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxB,OAAO;QACR,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,YAAY,IAAI,CAAC,MAAM,4BAA4B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACjG,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACtB,OAAO;QACR,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,iHAAiH;IACjH,KAAK,CAAC,MAAM,CAAC,IAAa,EAAE,MAAe;QAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACzF,MAAM,OAAO,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3C,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CACvB,UAAU,MAAM,CAAC,IAAI,kFAAkF,EACvG,OAAO,EACP,MAAM,EACN,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACd,OAAO,CACP,CAAC;QACF,OAAO;YACN,GAAG,IAAI;YACP,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,YAAY,EAAE,OAAO;SACrB,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,MAAM,CAAC,IAAiB,EAAE,IAAY;QACrC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YACvD,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,kCAAkC,CAAC,CAAC;QAClE,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc;YACjC,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,YAAY,IAAI,CAAC,MAAM,WAAW,cAAc,EAAE,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,MAAM,GAAG,YAAY;YAC7B,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,YAAY,IAAI,CAAC,MAAM,kBAAkB,YAAY,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,+GAA+G;IAC/G,QAAQ,CAAC,IAAiE,EAAE,IAAY;QACvF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,OAAO;gBACX,IAAI,KAAK,KAAK,WAAW;oBAAE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,oCAAoC,CAAC,CAAC;gBAC9F,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,WAAW,IAAI,CAAC,KAAK,eAAe,CAAC,CAAC;gBACrG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;gBACzB,OAAO,MAAM,CAAC;YACf,KAAK,KAAK;gBACT,IAAI,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;oBACpD,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,6DAA6D,CAAC,CAAC;gBAC7F,CAAC;gBACD,OAAO,MAAM,CAAC;YACf,KAAK,OAAO;gBACX,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;oBAC7E,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,qDAAqD,CAAC,CAAC;gBACrF,CAAC;gBACD,OAAO,SAAS,CAAC;YAClB,KAAK,iBAAiB;gBACrB,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAChC,OAAO,WAAW,CAAC;YACpB,KAAK,mBAAmB;gBACvB,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAChC,OAAO,WAAW,CAAC;QACrB,CAAC;IACF,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,IAAgE,EAAE,IAAY;QAC5F,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACxB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAU,CAAC;QAC5C,MAAM,SAAS,GAAG,MAAM,KAAK,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC;QAC7E,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,IAAI,CAAC,SAAS;YAAE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,QAAQ,MAAM,CAAC,EAAE,iBAAiB,MAAM,EAAE,CAAC,CAAC;QAChH,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,QAAQ,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC;QAC7F,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QACxC,IAAI,SAAS,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,SAAS,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;YACxG,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,6CAA6C,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAChD,0DAA0D;QAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YAClD,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI;gBAAE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,sCAAsC,CAAC,CAAC;QAC3G,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3D,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,oCAAoC,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAqB,CAAC,SAAS,EAAE,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACtF,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACrD,oHAAoH;QACpH,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YACzG,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,8DAA8D,CAAC,CAAC;QAC9F,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,IAAkE,EAAE,IAAY;QAC9F,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YAC9D,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,0CAA0C,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC5B,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;YACvE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,eAAe,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;QACzF,CAAC;QACD,IACC,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,GAAG;YACxB,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS;YAC3B,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAU,CAAC,OAAO,CAAC,EACvD,CAAC;YACF,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,uDAAuD,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;aACxD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;YAC5C,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,yCAAyC,CAAC,CAAC;QACzE,CAAC;QACD,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,IAAY;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACnC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;QAClC,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC;QAClF,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;YACjE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,YAAY,MAAM,CAAC,EAAE,6BAA6B,CAAC,CAAC;QAClF,CAAC;IACF,CAAC;CACD;AAED,mHAAmH;AACnH,KAAK,UAAU,IAAI,CAClB,KAAiD,EACjD,OAAgB,EAChB,IAAsC;IAEtC,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1G,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,CAAC;QACJ,SAAS,CAAC;YACT,IAAI,MAA+B,CAAC;YACpC,IAAI,CAAC;gBACJ,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO;oBAAE,MAAM,KAAK,CAAC;gBAC/C,MAAM,IAAI,UAAU,CACnB,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAC/C,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,CACrC,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjB,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO;YACR,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACF,CAAC;YAAS,CAAC;QACV,oEAAoE;QACpE,IAAI,CAAC,IAAI;YAAE,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACtE,CAAC;AACF,CAAC","sourcesContent":["// `importStore(backend, parts, ctx, { outbox? })` (slice 6a §13, rules 12, 24, 25): a store made from an archive, a\n// trust boundary. Every part is checked against the archive schema, its place in the archive's order and its content\n// (names, rows against their table's recorded columns, ids and seqs, lifetimes at one address never overlapping,\n// revisions in seq order from a base, versions, duplicates, the `end` count, the manifest); everything is applied in\n// one backend transaction with the applier, so a refused import leaves the backend as it was. An input that stalls is\n// cancelled by `ctx`.\n\nimport { awaitWithContext, type Context } from \"../../context/index.ts\";\nimport type { SqliteDatabase, SqliteExecutor } from \"../../sqlite/index.ts\";\nimport { ChordError } from \"../data/index.ts\";\nimport { invalid } from \"../data/internal.ts\";\nimport { IdAllocator } from \"./allocator.ts\";\nimport { applyWrite } from \"./applier.ts\";\nimport { ARCHIVE_FORMAT, type ArchiveManifest, type ArchivePart, checkPart } from \"./archive.ts\";\nimport type { Backend } from \"./backend.ts\";\nimport { readCatalog, writeCatalog } from \"./catalog.ts\";\nimport type { DocumentRecord } from \"./engine.ts\";\nimport { applyStoreSchema, type MetaRow, STORE_SCHEMA, TABLES } from \"./schema.ts\";\nimport { Step } from \"./step.ts\";\nimport { ChordStore, type Store, type StoreOptions } from \"./store.ts\";\nimport { storedText } from \"./text.ts\";\n\n/**\n * A store holding the archive `parts` on `backend`, which must not hold a store yet: at the manifest's `lastSeq`, its\n * outbox (when `options.outbox`) starting after it. A refused archive, a stalled input cancelled by `context` or a\n * backend error rejects; the backend is closed then (rule 12).\n */\nexport async function importStore(\n\tbackend: Backend,\n\tparts: AsyncIterable<unknown> | Iterable<unknown>,\n\tcontext: Context,\n\toptions: StoreOptions = {},\n): Promise<Store> {\n\tconst { db } = backend;\n\ttry {\n\t\tcontext.abortSignal?.throwIfAborted();\n\t\tconst existing = await db.get(`SELECT name FROM sqlite_master WHERE name = ?`, TABLES.meta);\n\t\tif (existing !== undefined) throw invalid(\"args\", \"import: the backend holds a store already\");\n\t\tconst meta = await db.transaction(async (executor) => {\n\t\t\tconst meta = await applyStoreSchema(inTransaction(executor));\n\t\t\tconst archive = new ArchiveImport(executor, context);\n\t\t\tawait each(parts, context, (part) => archive.take(part));\n\t\t\treturn archive.finish(meta, options.outbox === true);\n\t\t});\n\t\treturn new ChordStore(db, meta, await readCatalog(db));\n\t} catch (error) {\n\t\ttry {\n\t\t\tawait db.close();\n\t\t} catch {\n\t\t\t// The import's own failure is the one to report.\n\t\t}\n\t\tthrow error;\n\t}\n}\n\n/** The store's schema migrations run inside the import's backend transaction (they open none of their own). */\nfunction inTransaction(executor: SqliteExecutor): SqliteDatabase {\n\treturn {\n\t\texec: (sql) => executor.exec(sql),\n\t\trun: (sql, ...params) => executor.run(sql, ...params),\n\t\trunCounted: (sql, ...params) => executor.runCounted(sql, ...params),\n\t\tget: (sql, ...params) => executor.get(sql, ...params),\n\t\tall: (sql, ...params) => executor.all(sql, ...params),\n\t\ttransaction: (callback) => callback(executor),\n\t\tclose: () => Promise.reject(new Error(\"import: the backend closes after the import\")),\n\t};\n}\n\n/** A place in the archive's order: before the manifest, in a table group's puts or indexes, the documents, the end. */\ntype Place = \"manifest\" | \"puts\" | \"indexes\" | \"documents\" | \"ended\";\n\n/**\n * One archive being imported: the place reached in its order (the manifest, then table groups of a `table` write, its\n * `put`s and its `index` writes, then the documents, then `end`), what was seen (tables, ids, live addresses, the\n * write count) and the step its writes are applied in.\n */\nclass ArchiveImport {\n\treadonly #executor: SqliteExecutor;\n\treadonly #context: Context;\n\t#position = 0;\n\t#manifest: ArchiveManifest | undefined;\n\t#step: Step | undefined;\n\t/** Where the next part may go. */\n\t#place: Place = \"manifest\";\n\t/** The table whose group is open. */\n\t#table: string | undefined;\n\treadonly #tables = new Set<string>();\n\treadonly #ids = new Set<number>();\n\t/** The lifetimes seen at each address, `[createdAt, retiredAt)` (`Infinity` while live). */\n\treadonly #lifetimes = new Map<string, [number, number][]>();\n\t/** The record whose revisions may follow, with the last revision's seq and its base's version. */\n\t#document: { readonly record: DocumentRecord; seq: number; base: number | undefined } | undefined;\n\t#writes = 0;\n\n\tconstructor(executor: SqliteExecutor, context: Context) {\n\t\tthis.#executor = executor;\n\t\tthis.#context = context;\n\t}\n\n\t/** Checks the next part and applies it. */\n\tasync take(value: unknown): Promise<void> {\n\t\tconst position = this.#position++;\n\t\tconst part = checkPart(value, position, this.#context);\n\t\tconst what = `import: part ${position} (${part.kind})`;\n\t\tif (this.#place === \"ended\") throw invalid(\"args\", `${what}: after the end`);\n\t\tif (part.kind === \"manifest\" || this.#step === undefined) {\n\t\t\tthis.#start(part, what);\n\t\t\treturn;\n\t\t}\n\t\tif (part.kind === \"end\") {\n\t\t\tif (part.writes !== this.#writes) {\n\t\t\t\tthrow invalid(\"args\", `${what}: counts ${part.writes} writes, the archive has ${this.#writes}`);\n\t\t\t}\n\t\t\tthis.#endDocument(what);\n\t\t\tthis.#place = \"ended\";\n\t\t\treturn;\n\t\t}\n\t\tthis.#place = this.#placeOf(part, what);\n\t\tthis.#writes++;\n\t\tawait applyWrite(this.#step, part, what);\n\t}\n\n\t/** The stored metadata once the archive ended: its `lastSeq`, the allocator's next id and the outbox setting. */\n\tasync finish(meta: MetaRow, outbox: boolean): Promise<MetaRow> {\n\t\tif (this.#place !== \"ended\" || this.#step === undefined || this.#manifest === undefined) {\n\t\t\tthrow invalid(\"args\", \"import: the archive has no end part\");\n\t\t}\n\t\tconst { lastSeq, nextId } = this.#manifest;\n\t\tawait writeCatalog(this.#step);\n\t\tawait this.#executor.run(\n\t\t\t`UPDATE ${TABLES.meta} SET last_seq = ?, next_id = ?, outbox = ?, outbox_floor = ? WHERE singleton = 1`,\n\t\t\tlastSeq,\n\t\t\tnextId,\n\t\t\toutbox ? 1 : 0,\n\t\t\tlastSeq,\n\t\t);\n\t\treturn {\n\t\t\t...meta,\n\t\t\tlast_seq: lastSeq,\n\t\t\tnext_id: nextId,\n\t\t\toutbox: outbox ? 1 : 0,\n\t\t\toutbox_floor: lastSeq,\n\t\t};\n\t}\n\n\t/** The manifest, first: a format and schema this code reads. */\n\t#start(part: ArchivePart, what: string): void {\n\t\tif (part.kind !== \"manifest\" || this.#step !== undefined)\n\t\t\tthrow invalid(\"args\", `${what}: the manifest comes first, once`);\n\t\tif (part.format !== ARCHIVE_FORMAT)\n\t\t\tthrow invalid(\"args\", `${what}: format ${part.format} is not ${ARCHIVE_FORMAT}`);\n\t\tif (part.schema > STORE_SCHEMA)\n\t\t\tthrow invalid(\"args\", `${what}: schema ${part.schema} is newer than ${STORE_SCHEMA}`);\n\t\tthis.#manifest = part;\n\t\tthis.#step = new Step(this.#executor, part.lastSeq, new IdAllocator(part.nextId), new Map());\n\t}\n\n\t/** Where `part` puts the archive, refused when out of order, a duplicate, or outside the manifest's ranges. */\n\t#placeOf(part: Exclude<ArchivePart, { readonly kind: \"manifest\" | \"end\" }>, what: string): Place {\n\t\tconst place = this.#place;\n\t\tswitch (part.kind) {\n\t\t\tcase \"table\":\n\t\t\t\tif (place === \"documents\") throw invalid(\"args\", `${what}: tables come before the documents`);\n\t\t\t\tif (this.#tables.has(part.table)) throw invalid(\"args\", `${what}: table ${part.table} occurs twice`);\n\t\t\t\tthis.#tables.add(part.table);\n\t\t\t\tthis.#table = part.table;\n\t\t\t\treturn \"puts\";\n\t\t\tcase \"put\":\n\t\t\t\tif (place !== \"puts\" || part.table !== this.#table) {\n\t\t\t\t\tthrow invalid(\"args\", `${what}: a put follows its table's table write, before its indexes`);\n\t\t\t\t}\n\t\t\t\treturn \"puts\";\n\t\t\tcase \"index\":\n\t\t\t\tif ((place !== \"puts\" && place !== \"indexes\") || part.table !== this.#table) {\n\t\t\t\t\tthrow invalid(\"args\", `${what}: an index follows its table's table write and puts`);\n\t\t\t\t}\n\t\t\t\treturn \"indexes\";\n\t\t\tcase \"document.create\":\n\t\t\t\tthis.#checkDocument(part, what);\n\t\t\t\treturn \"documents\";\n\t\t\tcase \"document.revision\":\n\t\t\t\tthis.#checkRevision(part, what);\n\t\t\t\treturn \"documents\";\n\t\t}\n\t}\n\n\t/**\n\t * A record within the manifest's ids and seqs (an id equal to a saturated `nextId` too), unique, its lifetime\n\t * overlapping no other at its address; its address and meta well-formed text without NUL (SQLite would cut a NUL off,\n\t * slice 6a §8). The record before it must have ended well (`#endDocument`).\n\t */\n\t#checkDocument(part: Extract<ArchivePart, { readonly kind: \"document.create\" }>, what: string): void {\n\t\tthis.#endDocument(what);\n\t\tconst { record } = part;\n\t\tconst { lastSeq, nextId } = this.#manifest!;\n\t\tconst saturated = nextId === Number.MAX_SAFE_INTEGER && record.id === nextId;\n\t\tif (record.id >= nextId && !saturated) throw invalid(\"args\", `${what}: id ${record.id} is not below ${nextId}`);\n\t\tif (this.#ids.has(record.id)) throw invalid(\"args\", `${what}: id ${record.id} occurs twice`);\n\t\tconst { createdAt, retiredAt } = record;\n\t\tif (createdAt > lastSeq || (retiredAt !== undefined && (retiredAt < createdAt || retiredAt > lastSeq))) {\n\t\t\tthrow invalid(\"args\", `${what}: a lifetime outside the manifest's lastSeq`);\n\t\t}\n\t\tconst { namespace, owner, kind, meta } = record;\n\t\t// A singleton's record has no key; its column keeps `\"\"`.\n\t\tconst key = record.key ?? \"\";\n\t\tfor (const text of [namespace, owner, kind, key]) {\n\t\t\tif (storedText(text, what) !== text) throw invalid(\"args\", `${what}: an address is not well-formed text`);\n\t\t}\n\t\tif (meta !== undefined && storedText(meta, what) !== meta) {\n\t\t\tthrow invalid(\"args\", `${what}: the meta is not well-formed text`);\n\t\t}\n\t\tconst address = JSON.stringify([owner, namespace, kind, key]);\n\t\tconst lifetime: [number, number] = [createdAt, retiredAt ?? Number.POSITIVE_INFINITY];\n\t\tconst lifetimes = this.#lifetimes.get(address) ?? [];\n\t\t// Two live records are two infinite lifetimes, which overlap; an empty one (`createdAt = retiredAt`) overlaps none.\n\t\tif (lifetime[0] < lifetime[1] && lifetimes.some(([from, to]) => from < lifetime[1] && lifetime[0] < to)) {\n\t\t\tthrow invalid(\"args\", `${what}: a second record at one address for an overlapping lifetime`);\n\t\t}\n\t\tlifetimes.push(lifetime);\n\t\tthis.#lifetimes.set(address, lifetimes);\n\t\tthis.#ids.add(record.id);\n\t\tthis.#document = { record, seq: 0, base: undefined };\n\t}\n\n\t/**\n\t * A revision of the record before it, in seq order within its lifetime, from a base, each delta at its base's\n\t * version.\n\t */\n\t#checkRevision(part: Extract<ArchivePart, { readonly kind: \"document.revision\" }>, what: string): void {\n\t\tconst document = this.#document;\n\t\tif (document === undefined || document.record.id !== part.id) {\n\t\t\tthrow invalid(\"args\", `${what}: a revision follows its record's create`);\n\t\t}\n\t\tconst { record } = document;\n\t\tif (record.retiredAt !== undefined && record.history !== \"rewindable\") {\n\t\t\tthrow invalid(\"args\", `${what}: a retired ${record.history} record keeps no revisions`);\n\t\t}\n\t\tif (\n\t\t\tpart.seq <= document.seq ||\n\t\t\tpart.seq < record.createdAt ||\n\t\t\tpart.seq > (record.retiredAt ?? this.#manifest!.lastSeq)\n\t\t) {\n\t\t\tthrow invalid(\"args\", `${what}: a revision out of seq order or outside its lifetime`);\n\t\t}\n\t\tconst { content } = part;\n\t\tif (content.kind === \"base\") document.base = content.version;\n\t\telse if (document.base !== content.version) {\n\t\t\tthrow invalid(\"args\", `${what}: a delta without a base at its version`);\n\t\t}\n\t\tdocument.seq = part.seq;\n\t}\n\n\t/**\n\t * The record before ends well: its last base is at the record's version; only a retired `latest` record has none\n\t * (its content was dropped at retirement; a retired `rewindable` one keeps its history).\n\t */\n\t#endDocument(what: string): void {\n\t\tconst document = this.#document;\n\t\tthis.#document = undefined;\n\t\tif (document === undefined) return;\n\t\tconst { record, base } = document;\n\t\tconst contentless = record.retiredAt !== undefined && record.history === \"latest\";\n\t\tif (base === undefined ? !contentless : base !== record.version) {\n\t\t\tthrow invalid(\"args\", `${what}: record ${record.id} has no base at its version`);\n\t\t}\n\t}\n}\n\n/** Runs `take` on each part in turn; a wait for the next part ends when `context` aborts (the input is closed). */\nasync function each(\n\tparts: AsyncIterable<unknown> | Iterable<unknown>,\n\tcontext: Context,\n\ttake: (part: unknown) => Promise<void>,\n): Promise<void> {\n\tconst iterator = Symbol.asyncIterator in parts ? parts[Symbol.asyncIterator]() : parts[Symbol.iterator]();\n\tlet done = false;\n\ttry {\n\t\tfor (;;) {\n\t\t\tlet result: IteratorResult<unknown>;\n\t\t\ttry {\n\t\t\t\tresult = await awaitWithContext(Promise.resolve(iterator.next()), context);\n\t\t\t} catch (error) {\n\t\t\t\tif (!context.abortSignal?.aborted) throw error;\n\t\t\t\tthrow new ChordError(\n\t\t\t\t\t{ code: \"aborted\", message: \"import: aborted\" },\n\t\t\t\t\t{ cause: context.abortSignal.reason },\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (result.done) {\n\t\t\t\tdone = true;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tawait take(result.value);\n\t\t}\n\t} finally {\n\t\t// A stalled input is not awaited: the backend transaction ends now.\n\t\tif (!done) void Promise.resolve(iterator.return?.()).catch(() => {});\n\t}\n}\n"]}

package/dist/next/store/index.d.ts

@@ -0,0 +1,16 @@
+export type { ArchiveManifest, ArchivePart } from "./archive.ts";
+export { type Backend, sqliteBackend } from "./backend.ts";
+export type { Columns, PutRowOf, RowOf } from "./columns.ts";
+export { add, and, type ColumnRef, type Condition, coalesce, concat, type Expression, eq, gt, gte, inArray, isNull, lt, lte, max, min, ne, not, or, prefix, replacePrefix, type SetOf, sub, when, } from "./expression.ts";
+export { importStore } from "./import.ts";
+export { type JsonColumnOptions, type JsonColumnSchema, json } from "./json-column.ts";
+export { decodeJsonl, encodeJsonl } from "./jsonl.ts";
+export type { Outbox, OutboxCommit } from "./outbox.ts";
+export { type ColumnRefs, type Query, query } from "./query.ts";
+export { openStore, type Store, type StoreOptions } from "./store.ts";
+export { defineTable, type KeyOf, type TableDefinition, type TableOptions } from "./table.ts";
+export { type AddedColumn, evolveTable, type PatchOf, type TableEditor, type TableTailEditor, } from "./table-evolve.ts";
+export type { Page, PageOptions, Table, TableOf } from "./table-handle.ts";
+export { compareText } from "./text.ts";
+export type { StoreWrite } from "./writes.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/next/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next/store/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACN,GAAG,EACH,GAAG,EACH,KAAK,SAAS,EACd,KAAK,SAAS,EACd,QAAQ,EACR,MAAM,EACN,KAAK,UAAU,EACf,EAAE,EACF,EAAE,EACF,GAAG,EACH,OAAO,EACP,MAAM,EACN,EAAE,EACF,GAAG,EACH,GAAG,EACH,GAAG,EACH,EAAE,EACF,GAAG,EACH,EAAE,EACF,MAAM,EACN,aAAa,EACb,KAAK,KAAK,EACV,GAAG,EACH,IAAI,GACJ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EACN,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,eAAe,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/next/store/index.js

@@ -0,0 +1,13 @@
+// The store for apps: opening it over a backend, tables with their queries, writes and migrations, export and
+// import of archives (with their JSONL encoding), the outbox, text order.
+export { sqliteBackend } from "./backend.js";
+export { add, and, coalesce, concat, eq, gt, gte, inArray, isNull, lt, lte, max, min, ne, not, or, prefix, replacePrefix, sub, when, } from "./expression.js";
+export { importStore } from "./import.js";
+export { json } from "./json-column.js";
+export { decodeJsonl, encodeJsonl } from "./jsonl.js";
+export { query } from "./query.js";
+export { openStore } from "./store.js";
+export { defineTable } from "./table.js";
+export { evolveTable, } from "./table-evolve.js";
+export { compareText } from "./text.js";
+//# sourceMappingURL=index.js.map

package/dist/next/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/next/store/index.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,0EAA0E;AAG1E,OAAO,EAAgB,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EACN,GAAG,EACH,GAAG,EAGH,QAAQ,EACR,MAAM,EAEN,EAAE,EACF,EAAE,EACF,GAAG,EACH,OAAO,EACP,MAAM,EACN,EAAE,EACF,GAAG,EACH,GAAG,EACH,GAAG,EACH,EAAE,EACF,GAAG,EACH,EAAE,EACF,MAAM,EACN,aAAa,EAEb,GAAG,EACH,IAAI,GACJ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAiD,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAA+B,KAAK,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,SAAS,EAAiC,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,WAAW,EAAuD,MAAM,YAAY,CAAC;AAC9F,OAAO,EAEN,WAAW,GAIX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC","sourcesContent":["// The store for apps: opening it over a backend, tables with their queries, writes and migrations, export and\n// import of archives (with their JSONL encoding), the outbox, text order.\n\nexport type { ArchiveManifest, ArchivePart } from \"./archive.ts\";\nexport { type Backend, sqliteBackend } from \"./backend.ts\";\nexport type { Columns, PutRowOf, RowOf } from \"./columns.ts\";\nexport {\n\tadd,\n\tand,\n\ttype ColumnRef,\n\ttype Condition,\n\tcoalesce,\n\tconcat,\n\ttype Expression,\n\teq,\n\tgt,\n\tgte,\n\tinArray,\n\tisNull,\n\tlt,\n\tlte,\n\tmax,\n\tmin,\n\tne,\n\tnot,\n\tor,\n\tprefix,\n\treplacePrefix,\n\ttype SetOf,\n\tsub,\n\twhen,\n} from \"./expression.ts\";\nexport { importStore } from \"./import.ts\";\nexport { type JsonColumnOptions, type JsonColumnSchema, json } from \"./json-column.ts\";\nexport { decodeJsonl, encodeJsonl } from \"./jsonl.ts\";\nexport type { Outbox, OutboxCommit } from \"./outbox.ts\";\nexport { type ColumnRefs, type Query, query } from \"./query.ts\";\nexport { openStore, type Store, type StoreOptions } from \"./store.ts\";\nexport { defineTable, type KeyOf, type TableDefinition, type TableOptions } from \"./table.ts\";\nexport {\n\ttype AddedColumn,\n\tevolveTable,\n\ttype PatchOf,\n\ttype TableEditor,\n\ttype TableTailEditor,\n} from \"./table-evolve.ts\";\nexport type { Page, PageOptions, Table, TableOf } from \"./table-handle.ts\";\nexport { compareText } from \"./text.ts\";\nexport type { StoreWrite } from \"./writes.ts\";\n"]}

package/dist/next/store/json-column.d.ts

@@ -0,0 +1,33 @@
+import type { JsonSchema } from "@earendil-works/pi-schema";
+import type { Context } from "../../context/index.ts";
+import type { JsonValue } from "../../json.ts";
+import type { Schema, Static } from "../contracts/index.ts";
+/** What `json(...)` takes besides the schema. */
+export type JsonColumnOptions<T> = {
+    /** The version of the cells' shape; a cell stores the version it was written at. */
+    readonly version: number;
+    /** Maps a cell of an older version `from` to this version's shape; pure. Without it older cells are refused. */
+    readonly migrate?: (old: JsonValue, from: number) => T;
+};
+/** A `json(...)` column as `columns` takes it: a schema of the cells' type carrying the column. */
+export interface JsonColumnSchema<T> extends Schema<T> {
+    readonly json: JsonColumn;
+}
+/** A column holding one JSON value of `schema` per row, at `version`; wrap it in `opt(...)` to make it nullable. */
+export declare function json<S extends Schema>(schema: S, options: JsonColumnOptions<Static<S>>): JsonColumnSchema<Static<S>>;
+/** A `json(...)` column's definition: its schema snapshot, version and fingerprint, and the read of a stored cell. */
+export declare class JsonColumn {
+    #private;
+    readonly schema: JsonSchema;
+    readonly version: number;
+    /** The fingerprint of the schema's normal form, recorded with the table: the same version with another is `broken`. */
+    readonly fingerprint: string;
+    constructor(schema: Schema, version: number, migrate: ((old: JsonValue, from: number) => unknown) | undefined);
+    /**
+     * The value of a stored cell written at `version`: parsed; an older one migrated and checked once (R8, counted). A
+     * newer version, a missing or throwing `migrate` and an invalid result throw `unavailable` (`what` names the cell);
+     * the caller fails the owner (slice 6a §1.4), the data stays.
+     */
+    read(text: string, version: number, what: string, context: Context): unknown;
+}
+//# sourceMappingURL=json-column.d.ts.map

package/dist/next/store/json-column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-column.d.ts","sourceRoot":"","sources":["../../../src/next/store/json-column.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM5D,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IAClC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gHAAgH;IAChH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;CACvD,CAAC;AAEF,mGAAmG;AACnG,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC1B;AAED,oHAAoH;AACpH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAGpH;AAED,sHAAsH;AACtH,qBAAa,UAAU;;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uHAAuH;IACvH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAG7B,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,EAS5G;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAgB3E;CACD"}

package/dist/next/store/json-column.js

@@ -0,0 +1,61 @@
+// `json(schema, { version, migrate? })` table columns (decision "The `json(...)` column helper", W11): one JSON `TEXT`
+// cell with its own version, typed when read, migrated on access (the result checked once, R8), never walked on write
+// (R9).
+import { fingerprintOf } from "../contracts/internal.js";
+import { snapshotSchema } from "../contracts/snapshot.js";
+import { ChordError } from "../data/index.js";
+import { validatorFor } from "../data/internal.js";
+/** A column holding one JSON value of `schema` per row, at `version`; wrap it in `opt(...)` to make it nullable. */
+export function json(schema, options) {
+    // Typed as the cells' schema, so `opt(...)` and `Static` take it; the table reads its `json` field.
+    return { json: new JsonColumn(schema, options.version, options.migrate) };
+}
+/** A `json(...)` column's definition: its schema snapshot, version and fingerprint, and the read of a stored cell. */
+export class JsonColumn {
+    schema;
+    version;
+    /** The fingerprint of the schema's normal form, recorded with the table: the same version with another is `broken`. */
+    fingerprint;
+    #migrate;
+    constructor(schema, version, migrate) {
+        // Declaration policy: JavaScript callers reach this check.
+        if (!Number.isSafeInteger(version) || version < 1)
+            throw new Error(`json(...): version ${version} is not a positive integer`);
+        const snapshot = snapshotSchema(schema, "json(...)");
+        this.schema = snapshot.schema;
+        this.version = version;
+        this.fingerprint = fingerprintOf(snapshot.normal);
+        this.#migrate = migrate;
+    }
+    /**
+     * The value of a stored cell written at `version`: parsed; an older one migrated and checked once (R8, counted). A
+     * newer version, a missing or throwing `migrate` and an invalid result throw `unavailable` (`what` names the cell);
+     * the caller fails the owner (slice 6a §1.4), the data stays.
+     */
+    read(text, version, what, context) {
+        const value = JSON.parse(text);
+        if (version === this.version)
+            return value;
+        if (version > this.version)
+            throw refused(`${what}: stored at version ${version}, newer than ${this.version}`);
+        if (this.#migrate === undefined)
+            throw refused(`${what}: no migrate from version ${version} to ${this.version}`);
+        let migrated;
+        try {
+            migrated = this.#migrate(value, version);
+        }
+        catch (error) {
+            throw refused(`${what}: migrate from version ${version} threw`, error);
+        }
+        context.telemetry.metrics?.counter("chord.data.validations").add(1);
+        if (!validatorFor(this, context).check(migrated)) {
+            throw refused(`${what}: migrate from version ${version} does not match the schema`);
+        }
+        return migrated;
+    }
+}
+/** The error of a cell the code cannot read: the owner fails `broken` with it. */
+function refused(message, cause) {
+    return new ChordError({ code: "unavailable", message }, cause === undefined ? undefined : { cause });
+}
+//# sourceMappingURL=json-column.js.map

package/dist/next/store/json-column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-column.js","sourceRoot":"","sources":["../../../src/next/store/json-column.ts"],"names":[],"mappings":"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","sourcesContent":["// `json(schema, { version, migrate? })` table columns (decision \"The `json(...)` column helper\", W11): one JSON `TEXT`\n// cell with its own version, typed when read, migrated on access (the result checked once, R8), never walked on write\n// (R9).\n\nimport type { JsonSchema } from \"@earendil-works/pi-schema\";\nimport type { Context } from \"../../context/index.ts\";\nimport type { JsonValue } from \"../../json.ts\";\nimport type { Schema, Static } from \"../contracts/index.ts\";\nimport { fingerprintOf } from \"../contracts/internal.ts\";\nimport { snapshotSchema } from \"../contracts/snapshot.ts\";\nimport { ChordError } from \"../data/index.ts\";\nimport { validatorFor } from \"../data/internal.ts\";\n\n/** What `json(...)` takes besides the schema. */\nexport type JsonColumnOptions<T> = {\n\t/** The version of the cells' shape; a cell stores the version it was written at. */\n\treadonly version: number;\n\t/** Maps a cell of an older version `from` to this version's shape; pure. Without it older cells are refused. */\n\treadonly migrate?: (old: JsonValue, from: number) => T;\n};\n\n/** A `json(...)` column as `columns` takes it: a schema of the cells' type carrying the column. */\nexport interface JsonColumnSchema<T> extends Schema<T> {\n\treadonly json: JsonColumn;\n}\n\n/** A column holding one JSON value of `schema` per row, at `version`; wrap it in `opt(...)` to make it nullable. */\nexport function json<S extends Schema>(schema: S, options: JsonColumnOptions<Static<S>>): JsonColumnSchema<Static<S>> {\n\t// Typed as the cells' schema, so `opt(...)` and `Static` take it; the table reads its `json` field.\n\treturn { json: new JsonColumn(schema, options.version, options.migrate) };\n}\n\n/** A `json(...)` column's definition: its schema snapshot, version and fingerprint, and the read of a stored cell. */\nexport class JsonColumn {\n\treadonly schema: JsonSchema;\n\treadonly version: number;\n\t/** The fingerprint of the schema's normal form, recorded with the table: the same version with another is `broken`. */\n\treadonly fingerprint: string;\n\treadonly #migrate: ((old: JsonValue, from: number) => unknown) | undefined;\n\n\tconstructor(schema: Schema, version: number, migrate: ((old: JsonValue, from: number) => unknown) | undefined) {\n\t\t// Declaration policy: JavaScript callers reach this check.\n\t\tif (!Number.isSafeInteger(version) || version < 1)\n\t\t\tthrow new Error(`json(...): version ${version} is not a positive integer`);\n\t\tconst snapshot = snapshotSchema(schema, \"json(...)\");\n\t\tthis.schema = snapshot.schema;\n\t\tthis.version = version;\n\t\tthis.fingerprint = fingerprintOf(snapshot.normal);\n\t\tthis.#migrate = migrate;\n\t}\n\n\t/**\n\t * The value of a stored cell written at `version`: parsed; an older one migrated and checked once (R8, counted). A\n\t * newer version, a missing or throwing `migrate` and an invalid result throw `unavailable` (`what` names the cell);\n\t * the caller fails the owner (slice 6a §1.4), the data stays.\n\t */\n\tread(text: string, version: number, what: string, context: Context): unknown {\n\t\tconst value = JSON.parse(text) as JsonValue;\n\t\tif (version === this.version) return value;\n\t\tif (version > this.version) throw refused(`${what}: stored at version ${version}, newer than ${this.version}`);\n\t\tif (this.#migrate === undefined) throw refused(`${what}: no migrate from version ${version} to ${this.version}`);\n\t\tlet migrated: unknown;\n\t\ttry {\n\t\t\tmigrated = this.#migrate(value, version);\n\t\t} catch (error) {\n\t\t\tthrow refused(`${what}: migrate from version ${version} threw`, error);\n\t\t}\n\t\tcontext.telemetry.metrics?.counter(\"chord.data.validations\").add(1);\n\t\tif (!validatorFor(this, context).check(migrated)) {\n\t\t\tthrow refused(`${what}: migrate from version ${version} does not match the schema`);\n\t\t}\n\t\treturn migrated;\n\t}\n}\n\n/** The error of a cell the code cannot read: the owner fails `broken` with it. */\nfunction refused(message: string, cause?: unknown): ChordError {\n\treturn new ChordError({ code: \"unavailable\", message }, cause === undefined ? undefined : { cause });\n}\n"]}

package/dist/next/store/jsonl.d.ts

@@ -0,0 +1,9 @@
+import type { ArchivePart } from "./archive.ts";
+/** `parts` as JSONL bytes, in chunks of whole lines. */
+export declare function encodeJsonl(parts: AsyncIterable<ArchivePart>): AsyncIterable<Uint8Array>;
+/**
+ * The values of JSONL `bytes`, one per nonempty line, for `importStore` to check (a trust boundary: bytes that are
+ * no UTF-8 and a line that is no JSON are `invalid/args`).
+ */
+export declare function decodeJsonl(bytes: AsyncIterable<Uint8Array>): AsyncIterable<unknown>;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/next/store/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/next/store/jsonl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,wDAAwD;AACxD,wBAAuB,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAW/F;AAED;;;GAGG;AACH,wBAAuB,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAgC3F"}

package/dist/next/store/jsonl.js

@@ -0,0 +1,61 @@
+// Plain JSONL for archives (slice 6a §13): one part per line, UTF-8. The store yields and takes parts; this is the
+// encoding it ships (others, compressed ones, come later without touching the applier).
+import { invalid } from "../data/internal.js";
+/** The bytes a chunk of encoded lines collects before it is yielded. */
+const CHUNK = 64 * 1024;
+/** `parts` as JSONL bytes, in chunks of whole lines. */
+export async function* encodeJsonl(parts) {
+    const encoder = new TextEncoder();
+    let lines = "";
+    for await (const part of parts) {
+        lines += `${JSON.stringify(part)}\n`;
+        if (lines.length >= CHUNK) {
+            yield encoder.encode(lines);
+            lines = "";
+        }
+    }
+    if (lines.length > 0)
+        yield encoder.encode(lines);
+}
+/**
+ * The values of JSONL `bytes`, one per nonempty line, for `importStore` to check (a trust boundary: bytes that are
+ * no UTF-8 and a line that is no JSON are `invalid/args`).
+ */
+export async function* decodeJsonl(bytes) {
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    let rest = "";
+    let line = 0;
+    const parse = (text) => {
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw invalid("args", `jsonl: line ${line} is not JSON`);
+        }
+    };
+    const decode = (chunk) => {
+        try {
+            return chunk === undefined ? decoder.decode() : decoder.decode(chunk, { stream: true });
+        }
+        catch {
+            throw invalid("args", `jsonl: line ${line + 1} is not UTF-8`);
+        }
+    };
+    for await (const chunk of bytes) {
+        rest += decode(chunk);
+        let start = 0;
+        for (let end = rest.indexOf("\n"); end >= 0; end = rest.indexOf("\n", start)) {
+            const text = rest.slice(start, end);
+            start = end + 1;
+            line++;
+            if (text.trim().length > 0)
+                yield parse(text);
+        }
+        rest = rest.slice(start);
+    }
+    rest += decode();
+    line++;
+    if (rest.trim().length > 0)
+        yield parse(rest);
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/next/store/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../../src/next/store/jsonl.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,wFAAwF;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C,wEAAwE;AACxE,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC;AAExB,wDAAwD;AACxD,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAAC,KAAiC;IACnE,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAChC,KAAK,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC3B,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,KAAK,GAAG,EAAE,CAAC;QACZ,CAAC;IACF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAAC,KAAgC;IAClE,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,KAAK,GAAG,CAAC,IAAY,EAAW,EAAE;QACvC,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,OAAO,CAAC,MAAM,EAAE,eAAe,IAAI,cAAc,CAAC,CAAC;QAC1D,CAAC;IACF,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,KAAkB,EAAU,EAAE;QAC7C,IAAI,CAAC;YACJ,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACzF,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,OAAO,CAAC,MAAM,EAAE,eAAe,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;QAC/D,CAAC;IACF,CAAC,CAAC;IACF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACpC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;YAChB,IAAI,EAAE,CAAC;YACP,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC;IACP,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["// Plain JSONL for archives (slice 6a §13): one part per line, UTF-8. The store yields and takes parts; this is the\n// encoding it ships (others, compressed ones, come later without touching the applier).\n\nimport { invalid } from \"../data/internal.ts\";\nimport type { ArchivePart } from \"./archive.ts\";\n\n/** The bytes a chunk of encoded lines collects before it is yielded. */\nconst CHUNK = 64 * 1024;\n\n/** `parts` as JSONL bytes, in chunks of whole lines. */\nexport async function* encodeJsonl(parts: AsyncIterable<ArchivePart>): AsyncIterable<Uint8Array> {\n\tconst encoder = new TextEncoder();\n\tlet lines = \"\";\n\tfor await (const part of parts) {\n\t\tlines += `${JSON.stringify(part)}\\n`;\n\t\tif (lines.length >= CHUNK) {\n\t\t\tyield encoder.encode(lines);\n\t\t\tlines = \"\";\n\t\t}\n\t}\n\tif (lines.length > 0) yield encoder.encode(lines);\n}\n\n/**\n * The values of JSONL `bytes`, one per nonempty line, for `importStore` to check (a trust boundary: bytes that are\n * no UTF-8 and a line that is no JSON are `invalid/args`).\n */\nexport async function* decodeJsonl(bytes: AsyncIterable<Uint8Array>): AsyncIterable<unknown> {\n\tconst decoder = new TextDecoder(\"utf-8\", { fatal: true });\n\tlet rest = \"\";\n\tlet line = 0;\n\tconst parse = (text: string): unknown => {\n\t\ttry {\n\t\t\treturn JSON.parse(text);\n\t\t} catch {\n\t\t\tthrow invalid(\"args\", `jsonl: line ${line} is not JSON`);\n\t\t}\n\t};\n\tconst decode = (chunk?: Uint8Array): string => {\n\t\ttry {\n\t\t\treturn chunk === undefined ? decoder.decode() : decoder.decode(chunk, { stream: true });\n\t\t} catch {\n\t\t\tthrow invalid(\"args\", `jsonl: line ${line + 1} is not UTF-8`);\n\t\t}\n\t};\n\tfor await (const chunk of bytes) {\n\t\trest += decode(chunk);\n\t\tlet start = 0;\n\t\tfor (let end = rest.indexOf(\"\\n\"); end >= 0; end = rest.indexOf(\"\\n\", start)) {\n\t\t\tconst text = rest.slice(start, end);\n\t\t\tstart = end + 1;\n\t\t\tline++;\n\t\t\tif (text.trim().length > 0) yield parse(text);\n\t\t}\n\t\trest = rest.slice(start);\n\t}\n\trest += decode();\n\tline++;\n\tif (rest.trim().length > 0) yield parse(rest);\n}\n"]}

package/dist/next/store/outbox.d.ts

@@ -0,0 +1,26 @@
+import type { Context } from "../../context/index.ts";
+import type { ChordStore } from "./store.ts";
+import type { StoreWrite } from "./writes.ts";
+/** The write vocabulary's version an outbox commit is stored in; a newer one is refused, data intact. */
+export declare const OUTBOX_FORMAT = 1;
+/** One commit as the outbox gives it: its seq, the allocator's value it persisted (D3) and its writes in applied order. */
+export type OutboxCommit = {
+    readonly seq: number;
+    readonly nextId: number;
+    readonly writes: readonly StoreWrite[];
+};
+/** A store's outbox: its commits after the floor (the seq it was turned on at, advanced by `trim`). */
+export declare class Outbox {
+    #private;
+    constructor(store: ChordStore, floor: number);
+    /** The seq the outbox starts after: `read` takes any `afterSeq` from it to `lastSeq`. */
+    get floor(): number;
+    /** Up to `limit` commits after `afterSeq`, in seq order; `afterSeq` outside floor..lastSeq is `invalid/args`. */
+    read(afterSeq: number, limit: number, context: Context): Promise<OutboxCommit[]>;
+    /**
+     * Drops the commits through `throughSeq` and advances the floor; idempotent; beyond `lastSeq` is `invalid/args`.
+     * Trims run one at a time, so the stored floor only rises and equals the one in memory.
+     */
+    trim(throughSeq: number, context: Context): Promise<void>;
+}
+//# sourceMappingURL=outbox.d.ts.map

package/dist/next/store/outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../../src/next/store/outbox.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAItD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,yGAAyG;AACzG,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,2HAA2H;AAC3H,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAAC;AAIrH,uGAAuG;AACvG,qBAAa,MAAM;;IASlB,YAAY,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAG3C;IAED,yFAAyF;IACzF,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,iHAAiH;IAC3G,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAIrF;IAED;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxD;CA6CD"}

package/dist/next/store/outbox.js

@@ -0,0 +1,80 @@
+// The outbox (slice 6a §2; decisions "The outbox is optional, internal and versioned", small items 3-4): the store's
+// commits as the sync layer reads them, one `{ seq, writes }` per commit from its floor on, in the current format.
+import { ChordError } from "../data/index.js";
+import { invalid } from "../data/internal.js";
+import { TABLES } from "./schema.js";
+/** The write vocabulary's version an outbox commit is stored in; a newer one is refused, data intact. */
+export const OUTBOX_FORMAT = 1;
+const NOTHING = () => { };
+/** A store's outbox: its commits after the floor (the seq it was turned on at, advanced by `trim`). */
+export class Outbox {
+    #store;
+    #floor;
+    /**
+     * The outbox's reads and trims, one at a time: a read checks the floor and reads with no trim running (a trim's
+     * commit may have deleted rows before its floor is set), a trim waits for the reads in flight.
+     */
+    #queue = Promise.resolve();
+    constructor(store, floor) {
+        this.#store = store;
+        this.#floor = floor;
+    }
+    /** The seq the outbox starts after: `read` takes any `afterSeq` from it to `lastSeq`. */
+    get floor() {
+        return this.#floor;
+    }
+    /** Up to `limit` commits after `afterSeq`, in seq order; `afterSeq` outside floor..lastSeq is `invalid/args`. */
+    async read(afterSeq, limit, context) {
+        if (!Number.isSafeInteger(afterSeq))
+            throw invalid("args", `outbox: read after ${afterSeq}, not an integer`);
+        if (!Number.isSafeInteger(limit) || limit < 1)
+            throw invalid("args", "outbox: limit is a positive integer");
+        return this.#queued(() => this.#read(afterSeq, limit, context));
+    }
+    /**
+     * Drops the commits through `throughSeq` and advances the floor; idempotent; beyond `lastSeq` is `invalid/args`.
+     * Trims run one at a time, so the stored floor only rises and equals the one in memory.
+     */
+    trim(throughSeq, context) {
+        try {
+            context.abortSignal?.throwIfAborted();
+            if (!Number.isSafeInteger(throughSeq) || throughSeq > this.#store.lastSeq) {
+                throw invalid("args", `outbox: trim through ${throughSeq}, beyond ${this.#store.lastSeq}`);
+            }
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        return this.#queued(() => this.#trim(throughSeq));
+    }
+    /** Runs `operation` once the outbox operations before it settled. */
+    #queued(operation) {
+        const run = this.#queue.then(operation);
+        this.#queue = run.then(NOTHING, NOTHING);
+        return run;
+    }
+    /** `read`, its turn come: the floor as no trim moves it. */
+    async #read(afterSeq, limit, context) {
+        if (afterSeq < this.#floor || afterSeq > this.#store.lastSeq) {
+            throw invalid("args", `outbox: read after ${afterSeq}, outside ${this.#floor}..${this.#store.lastSeq}`);
+        }
+        const rows = await this.#store.read((executor) => executor.all(`SELECT seq, format, next_id, writes FROM ${TABLES.outbox} WHERE seq > ? ORDER BY seq LIMIT ?`, afterSeq, limit), context);
+        return rows.map(({ seq, format, next_id, writes }) => {
+            if (format !== OUTBOX_FORMAT) {
+                const message = `outbox: commit ${seq} is in format ${format}, newer than ${OUTBOX_FORMAT}`;
+                throw new ChordError({ code: "unavailable", message });
+            }
+            return { seq, nextId: next_id, writes: JSON.parse(writes) };
+        });
+    }
+    async #trim(throughSeq) {
+        if (throughSeq <= this.#floor)
+            return;
+        await this.#store.maintain(async (executor) => {
+            await executor.run(`DELETE FROM ${TABLES.outbox} WHERE seq <= ?`, throughSeq);
+            await executor.run(`UPDATE ${TABLES.meta} SET outbox_floor = ? WHERE singleton = 1`, throughSeq);
+        });
+        this.#floor = throughSeq;
+    }
+}
+//# sourceMappingURL=outbox.js.map

package/dist/next/store/outbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.js","sourceRoot":"","sources":["../../../src/next/store/outbox.ts"],"names":[],"mappings":"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","sourcesContent":["// The outbox (slice 6a §2; decisions \"The outbox is optional, internal and versioned\", small items 3-4): the store's\n// commits as the sync layer reads them, one `{ seq, writes }` per commit from its floor on, in the current format.\n\nimport type { Context } from \"../../context/index.ts\";\nimport { ChordError } from \"../data/index.ts\";\nimport { invalid } from \"../data/internal.ts\";\nimport { TABLES } from \"./schema.ts\";\nimport type { ChordStore } from \"./store.ts\";\nimport type { StoreWrite } from \"./writes.ts\";\n\n/** The write vocabulary's version an outbox commit is stored in; a newer one is refused, data intact. */\nexport const OUTBOX_FORMAT = 1;\n\n/** One commit as the outbox gives it: its seq, the allocator's value it persisted (D3) and its writes in applied order. */\nexport type OutboxCommit = { readonly seq: number; readonly nextId: number; readonly writes: readonly StoreWrite[] };\n\nconst NOTHING = (): void => {};\n\n/** A store's outbox: its commits after the floor (the seq it was turned on at, advanced by `trim`). */\nexport class Outbox {\n\treadonly #store: ChordStore;\n\t#floor: number;\n\t/**\n\t * The outbox's reads and trims, one at a time: a read checks the floor and reads with no trim running (a trim's\n\t * commit may have deleted rows before its floor is set), a trim waits for the reads in flight.\n\t */\n\t#queue: Promise<void> = Promise.resolve();\n\n\tconstructor(store: ChordStore, floor: number) {\n\t\tthis.#store = store;\n\t\tthis.#floor = floor;\n\t}\n\n\t/** The seq the outbox starts after: `read` takes any `afterSeq` from it to `lastSeq`. */\n\tget floor(): number {\n\t\treturn this.#floor;\n\t}\n\n\t/** Up to `limit` commits after `afterSeq`, in seq order; `afterSeq` outside floor..lastSeq is `invalid/args`. */\n\tasync read(afterSeq: number, limit: number, context: Context): Promise<OutboxCommit[]> {\n\t\tif (!Number.isSafeInteger(afterSeq)) throw invalid(\"args\", `outbox: read after ${afterSeq}, not an integer`);\n\t\tif (!Number.isSafeInteger(limit) || limit < 1) throw invalid(\"args\", \"outbox: limit is a positive integer\");\n\t\treturn this.#queued(() => this.#read(afterSeq, limit, context));\n\t}\n\n\t/**\n\t * Drops the commits through `throughSeq` and advances the floor; idempotent; beyond `lastSeq` is `invalid/args`.\n\t * Trims run one at a time, so the stored floor only rises and equals the one in memory.\n\t */\n\ttrim(throughSeq: number, context: Context): Promise<void> {\n\t\ttry {\n\t\t\tcontext.abortSignal?.throwIfAborted();\n\t\t\tif (!Number.isSafeInteger(throughSeq) || throughSeq > this.#store.lastSeq) {\n\t\t\t\tthrow invalid(\"args\", `outbox: trim through ${throughSeq}, beyond ${this.#store.lastSeq}`);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t\treturn this.#queued(() => this.#trim(throughSeq));\n\t}\n\n\t/** Runs `operation` once the outbox operations before it settled. */\n\t#queued<T>(operation: () => Promise<T>): Promise<T> {\n\t\tconst run = this.#queue.then(operation);\n\t\tthis.#queue = run.then(NOTHING, NOTHING);\n\t\treturn run;\n\t}\n\n\t/** `read`, its turn come: the floor as no trim moves it. */\n\tasync #read(afterSeq: number, limit: number, context: Context): Promise<OutboxCommit[]> {\n\t\tif (afterSeq < this.#floor || afterSeq > this.#store.lastSeq) {\n\t\t\tthrow invalid(\"args\", `outbox: read after ${afterSeq}, outside ${this.#floor}..${this.#store.lastSeq}`);\n\t\t}\n\t\tconst rows = await this.#store.read(\n\t\t\t(executor) =>\n\t\t\t\texecutor.all<{\n\t\t\t\t\treadonly seq: number;\n\t\t\t\t\treadonly format: number;\n\t\t\t\t\treadonly next_id: number;\n\t\t\t\t\treadonly writes: string;\n\t\t\t\t}>(\n\t\t\t\t\t`SELECT seq, format, next_id, writes FROM ${TABLES.outbox} WHERE seq > ? ORDER BY seq LIMIT ?`,\n\t\t\t\t\tafterSeq,\n\t\t\t\t\tlimit,\n\t\t\t\t),\n\t\t\tcontext,\n\t\t);\n\t\treturn rows.map(({ seq, format, next_id, writes }) => {\n\t\t\tif (format !== OUTBOX_FORMAT) {\n\t\t\t\tconst message = `outbox: commit ${seq} is in format ${format}, newer than ${OUTBOX_FORMAT}`;\n\t\t\t\tthrow new ChordError({ code: \"unavailable\", message });\n\t\t\t}\n\t\t\treturn { seq, nextId: next_id, writes: JSON.parse(writes) as StoreWrite[] };\n\t\t});\n\t}\n\n\tasync #trim(throughSeq: number): Promise<void> {\n\t\tif (throughSeq <= this.#floor) return;\n\t\tawait this.#store.maintain(async (executor) => {\n\t\t\tawait executor.run(`DELETE FROM ${TABLES.outbox} WHERE seq <= ?`, throughSeq);\n\t\t\tawait executor.run(`UPDATE ${TABLES.meta} SET outbox_floor = ? WHERE singleton = 1`, throughSeq);\n\t\t});\n\t\tthis.#floor = throughSeq;\n\t}\n}\n"]}

package/dist/next/store/query.d.ts

@@ -0,0 +1,39 @@
+import type { SqliteValue } from "../../sqlite/index.ts";
+import type { Columns, ColumnTypeOf, ValueOf } from "./columns.ts";
+import { type ColumnRef, type Condition, type WhereNode } from "./expression.ts";
+import type { Order } from "./sql.ts";
+import type { TableDefinition } from "./table.ts";
+/** The column references a table's callbacks get: `e.path`, `e.at`. */
+export type ColumnRefs<C extends Columns> = {
+    readonly [K in keyof C & string]: ColumnRef<ValueOf<C[K]>, ColumnTypeOf<C[K]>>;
+};
+/** A query of `table`: its rows, in key order. */
+export declare function query<C extends Columns, K extends readonly string[]>(table: TableDefinition<C, K>): Query<C, K>;
+/**
+ * An immutable query of one table: an optional condition (several `where`s are `and`ed) and an order (`orderBy`
+ * columns, one direction, the key appended unless already there).
+ */
+export declare class Query<C extends Columns = Columns, K extends readonly string[] = readonly string[]> {
+    #private;
+    readonly table: TableDefinition<C, K>;
+    readonly condition: WhereNode | undefined;
+    constructor(table: TableDefinition<C, K>, condition: WhereNode | undefined, orderBy: readonly string[], direction: "asc" | "desc" | undefined);
+    /** This query with `fn`'s condition too. */
+    where(fn: (row: ColumnRefs<C>) => Condition): Query<C, K>;
+    /**
+     * This query ordered by `fn`'s column next (a non-`opt` `str` or `int` one), in `direction`: one direction per
+     * query, no column twice (`invalid/args`).
+     */
+    orderBy(fn: (row: ColumnRefs<C>) => ColumnRef<unknown, "str" | "int">, direction?: "asc" | "desc"): Query<C, K>;
+    /** The order of its rows: the `orderBy` columns, then the key columns not among them. */
+    get order(): Order;
+}
+/** The cursor of the position after a row with the order values `values` in the table named `table` (its SQL name). */
+export declare function encodeCursor(table: string, order: Order, values: readonly SqliteValue[]): string;
+/**
+ * The order values of `cursor` (a trust boundary: an app hands it back): one made for `table`'s `order` (any
+ * condition) in the table named `sqlName` (another object's table of the same definition is another table), each value
+ * of its column's type; `invalid/args` otherwise.
+ */
+export declare function decodeCursor(table: TableDefinition, sqlName: string, order: Order, cursor: unknown): SqliteValue[];
+//# sourceMappingURL=query.d.ts.map

package/dist/next/store/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/next/store/query.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAgB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE/F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,uEAAuE;AACvE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,OAAO,IAAI;IAC3C,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9E,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,KAAK,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAE/G;AAED;;;GAGG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE;;IAC9F,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IAI1C,YACC,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,EAMrC;IAED,4CAA4C;IAC5C,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,SAAS,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAKxD;IAED;;;OAGG;IACH,OAAO,CACN,EAAE,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,OAAO,EAAE,KAAK,GAAG,KAAK,CAAC,EAC7D,SAAS,GAAE,KAAK,GAAG,MAAc,GAC/B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAab;IAED,yFAAyF;IACzF,IAAI,KAAK,IAAI,KAAK,CAGjB;CACD;AAED,uHAAuH;AACvH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAKhG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAuBlH"}

package/dist/next/store/query.js

@@ -0,0 +1,97 @@
+// Queries (decision "Query runner"; slice 6a §6, rule 17): `query(Table).where(…).orderBy(…)` as immutable data
+// (the condition compiled when given, the order with the key appended as the tie-break), and the opaque cursors that
+// continue a page, bound to the table, the order columns and the direction.
+import { invalid } from "../data/internal.js";
+import { compileWhere } from "./expression.js";
+import { checkScalar } from "./rows.js";
+/** A query of `table`: its rows, in key order. */
+export function query(table) {
+    return new Query(table, undefined, [], undefined);
+}
+/**
+ * An immutable query of one table: an optional condition (several `where`s are `and`ed) and an order (`orderBy`
+ * columns, one direction, the key appended unless already there).
+ */
+export class Query {
+    table;
+    condition;
+    #orderBy;
+    #direction;
+    constructor(table, condition, orderBy, direction) {
+        this.table = table;
+        this.condition = condition;
+        this.#orderBy = orderBy;
+        this.#direction = direction;
+    }
+    /** This query with `fn`'s condition too. */
+    where(fn) {
+        // The refs are the table's columns, typed by `C`.
+        const compiled = compileWhere(this.table, fn(this.table.refs), "where");
+        const condition = this.condition === undefined ? compiled : { and: [this.condition, compiled] };
+        return new Query(this.table, condition, this.#orderBy, this.#direction);
+    }
+    /**
+     * This query ordered by `fn`'s column next (a non-`opt` `str` or `int` one), in `direction`: one direction per
+     * query, no column twice (`invalid/args`).
+     */
+    orderBy(fn, direction = "asc") {
+        const table = this.table;
+        // The refs are `C`'s columns; what the plugin's callback returns is checked below.
+        const ref = fn(table.refs);
+        const column = table.byName.get(ref?.column ?? "");
+        if (column === undefined || column.optional || (column.type !== "str" && column.type !== "int")) {
+            throw invalid("args", `${table.name}: orderBy: expected a non-opt str() or int() column`);
+        }
+        if (this.#orderBy.includes(column.name))
+            throw invalid("args", `${table.name}: orderBy: "${column.name}" twice`);
+        if (this.#direction !== undefined && this.#direction !== direction) {
+            throw invalid("args", `${table.name}: orderBy: one direction per query`);
+        }
+        return new Query(table, this.condition, [...this.#orderBy, column.name], direction);
+    }
+    /** The order of its rows: the `orderBy` columns, then the key columns not among them. */
+    get order() {
+        const columns = [...this.#orderBy, ...this.table.key.filter((column) => !this.#orderBy.includes(column))];
+        return { columns, direction: this.#direction ?? "asc" };
+    }
+}
+/** The cursor of the position after a row with the order values `values` in the table named `table` (its SQL name). */
+export function encodeCursor(table, order, values) {
+    const json = JSON.stringify({ t: table, o: order.columns, d: order.direction, v: values });
+    let binary = "";
+    for (const byte of new TextEncoder().encode(json))
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+}
+/**
+ * The order values of `cursor` (a trust boundary: an app hands it back): one made for `table`'s `order` (any
+ * condition) in the table named `sqlName` (another object's table of the same definition is another table), each value
+ * of its column's type; `invalid/args` otherwise.
+ */
+export function decodeCursor(table, sqlName, order, cursor) {
+    const refuse = () => {
+        throw invalid("args", `${table.name}: the cursor is not one of this table's order`);
+    };
+    if (typeof cursor !== "string")
+        return refuse();
+    let decoded;
+    try {
+        const binary = atob(cursor.replaceAll("-", "+").replaceAll("_", "/"));
+        decoded = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(Uint8Array.from(binary, (c) => c.charCodeAt(0))));
+    }
+    catch {
+        return refuse();
+    }
+    // Wire input: every field is checked below.
+    const { t, o, d, v } = (decoded ?? {});
+    if (t !== sqlName || d !== order.direction || JSON.stringify(o) !== JSON.stringify(order.columns))
+        refuse();
+    if (!Array.isArray(v) || v.length !== order.columns.length)
+        return refuse();
+    return order.columns.map((name, index) => {
+        const column = table.byName.get(name);
+        // Order columns are non-opt `str` or `int` (checked when the query was built).
+        return checkScalar(column.type, v[index], `${table.name}: cursor`);
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/next/store/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/next/store/query.ts"],"names":[],"mappings":"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","sourcesContent":["// Queries (decision \"Query runner\"; slice 6a §6, rule 17): `query(Table).where(…).orderBy(…)` as immutable data\n// (the condition compiled when given, the order with the key appended as the tie-break), and the opaque cursors that\n// continue a page, bound to the table, the order columns and the direction.\n\nimport type { SqliteValue } from \"../../sqlite/index.ts\";\nimport { invalid } from \"../data/internal.ts\";\nimport type { Columns, ColumnTypeOf, ValueOf } from \"./columns.ts\";\nimport { type ColumnRef, type Condition, compileWhere, type WhereNode } from \"./expression.ts\";\nimport { checkScalar } from \"./rows.ts\";\nimport type { Order } from \"./sql.ts\";\nimport type { TableDefinition } from \"./table.ts\";\n\n/** The column references a table's callbacks get: `e.path`, `e.at`. */\nexport type ColumnRefs<C extends Columns> = {\n\treadonly [K in keyof C & string]: ColumnRef<ValueOf<C[K]>, ColumnTypeOf<C[K]>>;\n};\n\n/** A query of `table`: its rows, in key order. */\nexport function query<C extends Columns, K extends readonly string[]>(table: TableDefinition<C, K>): Query<C, K> {\n\treturn new Query(table, undefined, [], undefined);\n}\n\n/**\n * An immutable query of one table: an optional condition (several `where`s are `and`ed) and an order (`orderBy`\n * columns, one direction, the key appended unless already there).\n */\nexport class Query<C extends Columns = Columns, K extends readonly string[] = readonly string[]> {\n\treadonly table: TableDefinition<C, K>;\n\treadonly condition: WhereNode | undefined;\n\treadonly #orderBy: readonly string[];\n\treadonly #direction: \"asc\" | \"desc\" | undefined;\n\n\tconstructor(\n\t\ttable: TableDefinition<C, K>,\n\t\tcondition: WhereNode | undefined,\n\t\torderBy: readonly string[],\n\t\tdirection: \"asc\" | \"desc\" | undefined,\n\t) {\n\t\tthis.table = table;\n\t\tthis.condition = condition;\n\t\tthis.#orderBy = orderBy;\n\t\tthis.#direction = direction;\n\t}\n\n\t/** This query with `fn`'s condition too. */\n\twhere(fn: (row: ColumnRefs<C>) => Condition): Query<C, K> {\n\t\t// The refs are the table's columns, typed by `C`.\n\t\tconst compiled = compileWhere(this.table, fn(this.table.refs as ColumnRefs<C>), \"where\");\n\t\tconst condition = this.condition === undefined ? compiled : { and: [this.condition, compiled] };\n\t\treturn new Query(this.table, condition, this.#orderBy, this.#direction);\n\t}\n\n\t/**\n\t * This query ordered by `fn`'s column next (a non-`opt` `str` or `int` one), in `direction`: one direction per\n\t * query, no column twice (`invalid/args`).\n\t */\n\torderBy(\n\t\tfn: (row: ColumnRefs<C>) => ColumnRef<unknown, \"str\" | \"int\">,\n\t\tdirection: \"asc\" | \"desc\" = \"asc\",\n\t): Query<C, K> {\n\t\tconst table = this.table;\n\t\t// The refs are `C`'s columns; what the plugin's callback returns is checked below.\n\t\tconst ref = fn(table.refs as ColumnRefs<C>) as ColumnRef | undefined;\n\t\tconst column = table.byName.get(ref?.column ?? \"\");\n\t\tif (column === undefined || column.optional || (column.type !== \"str\" && column.type !== \"int\")) {\n\t\t\tthrow invalid(\"args\", `${table.name}: orderBy: expected a non-opt str() or int() column`);\n\t\t}\n\t\tif (this.#orderBy.includes(column.name)) throw invalid(\"args\", `${table.name}: orderBy: \"${column.name}\" twice`);\n\t\tif (this.#direction !== undefined && this.#direction !== direction) {\n\t\t\tthrow invalid(\"args\", `${table.name}: orderBy: one direction per query`);\n\t\t}\n\t\treturn new Query(table, this.condition, [...this.#orderBy, column.name], direction);\n\t}\n\n\t/** The order of its rows: the `orderBy` columns, then the key columns not among them. */\n\tget order(): Order {\n\t\tconst columns = [...this.#orderBy, ...this.table.key.filter((column) => !this.#orderBy.includes(column))];\n\t\treturn { columns, direction: this.#direction ?? \"asc\" };\n\t}\n}\n\n/** The cursor of the position after a row with the order values `values` in the table named `table` (its SQL name). */\nexport function encodeCursor(table: string, order: Order, values: readonly SqliteValue[]): string {\n\tconst json = JSON.stringify({ t: table, o: order.columns, d: order.direction, v: values });\n\tlet binary = \"\";\n\tfor (const byte of new TextEncoder().encode(json)) binary += String.fromCharCode(byte);\n\treturn btoa(binary).replaceAll(\"+\", \"-\").replaceAll(\"/\", \"_\").replace(/=+$/, \"\");\n}\n\n/**\n * The order values of `cursor` (a trust boundary: an app hands it back): one made for `table`'s `order` (any\n * condition) in the table named `sqlName` (another object's table of the same definition is another table), each value\n * of its column's type; `invalid/args` otherwise.\n */\nexport function decodeCursor(table: TableDefinition, sqlName: string, order: Order, cursor: unknown): SqliteValue[] {\n\tconst refuse = (): never => {\n\t\tthrow invalid(\"args\", `${table.name}: the cursor is not one of this table's order`);\n\t};\n\tif (typeof cursor !== \"string\") return refuse();\n\tlet decoded: unknown;\n\ttry {\n\t\tconst binary = atob(cursor.replaceAll(\"-\", \"+\").replaceAll(\"_\", \"/\"));\n\t\tdecoded = JSON.parse(\n\t\t\tnew TextDecoder(\"utf-8\", { fatal: true }).decode(Uint8Array.from(binary, (c) => c.charCodeAt(0))),\n\t\t);\n\t} catch {\n\t\treturn refuse();\n\t}\n\t// Wire input: every field is checked below.\n\tconst { t, o, d, v } = (decoded ?? {}) as { t?: unknown; o?: unknown; d?: unknown; v?: unknown };\n\tif (t !== sqlName || d !== order.direction || JSON.stringify(o) !== JSON.stringify(order.columns)) refuse();\n\tif (!Array.isArray(v) || v.length !== order.columns.length) return refuse();\n\treturn order.columns.map((name, index) => {\n\t\tconst column = table.byName.get(name)!;\n\t\t// Order columns are non-opt `str` or `int` (checked when the query was built).\n\t\treturn checkScalar(column.type as \"str\" | \"int\", v[index], `${table.name}: cursor`) as string | number;\n\t});\n}\n"]}