@ubercode/chronicler 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/constants.ts","../src/core/errors.ts","../src/core/backend.ts","../src/core/reserved.ts","../src/core/context.ts","../src/core/fields.ts","../src/core/events.ts","../src/core/validation.ts","../src/core/chronicle.ts"],"names":[],"mappings":";;;AAQO,IAAM,UAAA,GAAa;AAAA,EACxB,KAAA,EAAO,CAAA;AAAA;AAAA,EACP,QAAA,EAAU,CAAA;AAAA;AAAA,EACV,KAAA,EAAO,CAAA;AAAA;AAAA,EACP,KAAA,EAAO,CAAA;AAAA;AAAA,EACP,IAAA,EAAM,CAAA;AAAA;AAAA,EACN,KAAA,EAAO,CAAA;AAAA;AAAA,EACP,IAAA,EAAM,CAAA;AAAA;AAAA,EACN,KAAA,EAAO,CAAA;AAAA;AAAA,EACP,KAAA,EAAO;AAAA;AACT,CAAA;AAWO,IAAM,uBAAA,GAA0B,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA;AAKtD,IAAM,8BAAA,GAAiC,IAAI,EAAA,GAAK,GAAA;AAKhD,IAAM,YAAA,GAAe,GAAA;AAMrB,IAAM,iBAAA,GAAoB,GAAA;AAK1B,IAAM,wBAAA,GAA2B,GAAA;AAKjC,IAAM,sBAAA,GAAyB,EAAA;AAK/B,IAAM,+BAAA,GAAkC,GAAA;;;AChDxC,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA,EAChC,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT,WAAA,CAAY,MAA2B,OAAA,EAAiB;AACtD,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;;;ACjBA,IAAM,iBAAA,GAAqD;AAAA,EACzD,KAAA,EAAO,OAAA;AAAA,EACP,QAAA,EAAU,OAAA;AAAA,EACV,KAAA,EAAO,OAAA;AAAA,EACP,KAAA,EAAO,OAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,OAAA;AAAA,EACP,KAAA,EAAO;AACT,CAAA;AAGA,IAAM,qBAAA,GAA+D;AAAA,EACnE,KAAA,EAAO,CAAC,UAAA,EAAY,OAAA,EAAS,QAAQ,MAAM,CAAA;AAAA,EAC3C,QAAA,EAAU,CAAC,OAAA,EAAS,MAAA,EAAQ,MAAM,CAAA;AAAA,EAClC,KAAA,EAAO,CAAC,OAAA,EAAS,MAAA,EAAQ,MAAM,CAAA;AAAA,EAC/B,KAAA,EAAO,CAAC,MAAA,EAAQ,MAAM,CAAA;AAAA,EACtB,IAAA,EAAM,CAAC,MAAM,CAAA;AAAA,EACb,KAAA,EAAO,CAAC,MAAM,CAAA;AAAA,EACd,MAAM,EAAC;AAAA,EACP,KAAA,EAAO,CAAC,MAAM,CAAA;AAAA,EACd,KAAA,EAAO,CAAC,OAAA,EAAS,MAAM;AACzB,CAAA;AA2BO,IAAM,iBAAA,GAAoB,CAC/B,OAAA,EACA,KAAA,EACA,SACA,OAAA,KACS;AACT,EAAA,IAAI,OAAO,OAAA,CAAQ,KAAK,CAAA,KAAM,UAAA,EAAY;AACxC,IAAA,MAAM,IAAI,eAAA,CAAgB,gBAAA,EAAkB,CAAA,oCAAA,EAAuC,KAAK,CAAA,CAAE,CAAA;AAAA,EAC5F;AACA,EAAA,IAAI;AACF,IAAA,OAAA,CAAQ,KAAK,CAAA,CAAE,OAAA,EAAS,OAAO,CAAA;AAAA,EACjC,SAAS,GAAA,EAAc;AACrB,IAAA,OAAA,CAAQ,KAAA;AAAA,MACN,iDAAA;AAAA,MACA,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU;AAAA,KACvC;AAAA,EACF;AACF,CAAA;AAWO,IAAM,uBAAuB,MAAkB;AACpD,EAAA,MAAM,UAAU,EAAC;AACjB,EAAA,KAAA,MAAW,SAAS,uBAAA,EAAyB;AAC3C,IAAA,MAAM,MAAA,GAAS,kBAAkB,KAAK,CAAA;AAEtC,IAAA,OAAA,CAAQ,KAAK,IAAI,CAAC,OAAA,EAAiB,YAAwB,OAAA,CAAQ,MAAM,CAAA,CAAE,OAAA,EAAS,OAAO,CAAA;AAAA,EAC7F;AACA,EAAA,OAAO,OAAA;AACT;AAYO,IAAM,aAAA,GAAgB,CAAC,OAAA,KAA6C;AACzE,EAAA,MAAM,UAAU,EAAC;AACjB,EAAA,KAAA,MAAW,SAAS,uBAAA,EAAyB;AAC3C,IAAA,IAAI,OAAO,OAAA,CAAQ,KAAK,CAAA,KAAM,UAAA,EAAY;AACxC,MAAA,OAAA,CAAQ,KAAK,CAAA,GAAI,OAAA,CAAQ,KAAK,CAAA;AAC9B,MAAA;AAAA,IACF;AACA,IAAA,MAAM,QAAA,GAAW,qBAAA,CAAsB,KAAK,CAAA,CAAE,IAAA,CAAK,CAAC,EAAA,KAAO,OAAO,OAAA,CAAQ,EAAE,CAAA,KAAM,UAAU,CAAA;AAC5F,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,OAAA,CAAQ,KAAK,CAAA,GAAI,OAAA,CAAQ,QAAQ,CAAA;AAAA,IACnC,CAAA,MAAO;AACL,MAAA,MAAM,MAAA,GAAS,kBAAkB,KAAK,CAAA;AAEtC,MAAA,OAAA,CAAQ,KAAK,IAAI,CAAC,OAAA,EAAiB,YAAwB,OAAA,CAAQ,MAAM,CAAA,CAAE,OAAA,EAAS,OAAO,CAAA;AAAA,IAC7F;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAmCO,IAAM,mBAAA,GAAsB,CAAC,MAAA,KAAuC;AACzE,EAAA,IAAI,MAAA,CAAO,WAAW,CAAA,EAAG;AACvB,IAAA,MAAM,IAAI,MAAM,kDAAkD,CAAA;AAAA,EACpE;AACA,EAAA,MAAM,UAAU,EAAC;AACjB,EAAA,KAAA,MAAW,SAAS,uBAAA,EAAyB;AAC3C,IAAA,OAAA,CAAQ,KAAK,CAAA,GAAI,CAAC,OAAA,EAAiB,OAAA,KAAwB;AACzD,MAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,QAAA,IAAI,CAAC,KAAA,CAAM,MAAA,IAAU,MAAM,MAAA,CAAO,KAAA,EAAO,OAAO,CAAA,EAAG;AACjD,UAAA,iBAAA,CAAkB,KAAA,CAAM,OAAA,EAAS,KAAA,EAAO,OAAA,EAAS,OAAO,CAAA;AAAA,QAC1D;AAAA,MACF;AAAA,IACF,CAAA;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;;;AC3KO,IAAM,yBAAA,GAA4B;AAAA,EACvC,UAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EACA,eAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAA;AAKA,IAAM,aAAA,GAAgB,IAAI,GAAA,CAAY,yBAAyB,CAAA;AAQxD,IAAM,uBAAA,GAA0B,CAAC,GAAA,KACtC,aAAA,CAAc,IAAI,GAAG,CAAA;AAOhB,IAAM,oBAAA,GAAuB,CAAC,MAAA,KAA8C;AACjF,EAAA,MAAM,UAAoB,EAAC;AAC3B,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAG;AACrC,IAAA,IAAI,uBAAA,CAAwB,GAAG,CAAA,EAAG;AAChC,MAAA,OAAA,CAAQ,KAAK,GAAG,CAAA;AAAA,IAClB;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT,CAAA;;;ACpCA,IAAM,aAAA,GAAgB,CAAC,KAAA,KACrB,KAAA,KAAU,IAAA,IACV,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,SAAA;AAGnB,IAAM,cAAA,uBAAqB,GAAA,CAAI;AAAA,EAC7B,WAAA;AAAA,EACA,aAAA;AAAA,EACA,WAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,gBAAA;AAAA,EACA,eAAA;AAAA,EACA,sBAAA;AAAA,EACA,gBAAA;AAAA,EACA,kBAAA;AAAA,EACA,kBAAA;AAAA,EACA,kBAAA;AAAA,EACA;AACF,CAAC,CAAA;AA0CM,IAAM,uBAAuB,CAClC,OAAA,EACA,kBAAiC,EAAC,EAClC,aAAa,QAAA,KAIV;AACH,EAAA,MAAM,YAA2B,EAAC;AAClC,EAAA,MAAM,WAAqB,EAAC;AAC5B,EAAA,MAAM,mBAA6C,EAAC;AACpD,EAAA,MAAM,UAAoB,EAAC;AAC3B,EAAA,IAAI,aAAA,GAAgB,CAAA;AAEpB,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,QAAQ,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACrD,IAAA,IAAI,uBAAA,CAAwB,GAAG,CAAA,EAAG;AAChC,MAAA,QAAA,CAAS,KAAK,GAAG,CAAA;AACjB,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA,EAAG;AAC3B,MAAA,QAAA,CAAS,KAAK,GAAG,CAAA;AACjB,MAAA;AAAA,IACF;AAGA,IAAA,IAAI,CAAC,aAAA,CAAc,QAAQ,CAAA,EAAG;AAE9B,IAAA,IAAI,MAAA,CAAO,OAAO,eAAA,EAAiB,GAAG,KAAK,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,GAAG,CAAA,EAAG;AACxE,MAAA,MAAM,aAAA,GACJ,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,GAAG,IAAI,SAAA,CAAU,GAAG,CAAA,GAAI,eAAA,CAAgB,GAAG,CAAA;AAEtE,MAAA,gBAAA,CAAiB,KAAK,EAAE,GAAA,EAAK,aAAA,EAAe,cAAA,EAAgB,UAAU,CAAA;AACtE,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,iBAAiB,UAAA,EAAY;AAC/B,MAAA,OAAA,CAAQ,KAAK,GAAG,CAAA;AAChB,MAAA;AAAA,IACF;AAEA,IAAA,SAAA,CAAU,GAAG,CAAA,GAAI,QAAA;AACjB,IAAA,aAAA,EAAA;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,SAAS,SAAA,EAAW,UAAA,EAAY,EAAE,QAAA,EAAU,gBAAA,EAAkB,SAAQ,EAAE;AACnF,CAAA;AAWO,IAAM,eAAN,MAAmB;AAAA,EACP,UAAyB,EAAC;AAAA,EAC1B,OAAA;AAAA,EAEjB,WAAA,CAAY,OAAA,GAAyB,EAAC,EAAG,UAAU,QAAA,EAAU;AAC3D,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AACf,IAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,qBAAqB,OAAA,EAAS,IAAI,OAAO,CAAA;AAC7D,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,GAAA,EAA6C;AAC/C,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,OAAA,GAAU,MAAA,CAAO,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA,CAAE,MAAM,CAAA;AAC7E,IAAA,MAAM,EAAE,SAAS,UAAA,EAAW,GAAI,qBAAqB,GAAA,EAAK,IAAA,CAAK,SAAS,SAAS,CAAA;AAEjF,IAAA,MAAA,CAAO,MAAA,CAAO,IAAA,CAAK,OAAA,EAAS,OAAO,CAAA;AACnC,IAAA,OAAO,UAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAA,GAA0B;AACxB,IAAA,OAAO,EAAE,GAAG,IAAA,CAAK,OAAA,EAAQ;AAAA,EAC3B;AACF,CAAA;;;AC/HA,SAAS,YAAA,CAA+B,MAAS,GAAA,EAAkD;AACjG,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,IAAA;AAAA,IACP,SAAA,EAAW,KAAA;AAAA,IACX,IAAA,EAAM,GAAA;AAAA,IACN,GAAA,EAAK,CAAC,WAAA,KAAwB,YAAA,CAAa,MAAM,WAAW;AAAA,GAC9D;AACF;AAEA,SAAS,YAAA,CAA+B,MAAS,GAAA,EAAkD;AACjG,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,IAAA;AAAA,IACP,SAAA,EAAW,IAAA;AAAA,IACX,IAAA,EAAM,GAAA;AAAA,IACN,QAAA,EAAU,MAAM,YAAA,CAAa,IAAA,EAAM,GAAG,CAAA;AAAA,IACtC,GAAA,EAAK,CAAC,WAAA,KAAwB,YAAA,CAAa,MAAM,WAAW;AAAA,GAC9D;AACF;AAoBO,IAAM,KAAA,GAAQ;AAAA,EACnB,MAAA,EAAQ,MAAsC,YAAA,CAAa,QAAA,EAAU,MAAS,CAAA;AAAA,EAC9E,MAAA,EAAQ,MAAsC,YAAA,CAAa,QAAA,EAAU,MAAS,CAAA;AAAA,EAC9E,OAAA,EAAS,MAAuC,YAAA,CAAa,SAAA,EAAW,MAAS,CAAA;AAAA,EACjF,KAAA,EAAO,MAAqC,YAAA,CAAa,OAAA,EAAS,MAAS;AAC7E;;;ACjBA,IAAM,qBAAA,GAAwB;AAAA,EAE5B,QAAA,EAAU;AAAA,IACR,UAAU,KAAA,CAAM,MAAA,GAAS,QAAA,EAAS,CAAE,IAAI,6CAA6C;AAAA,GACvF;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,UAAU,KAAA,CAAM,MAAA,GAAS,QAAA,EAAS,CAAE,IAAI,6CAA6C,CAAA;AAAA,IACrF,OAAO,KAAA,CAAM,KAAA,GAAQ,QAAA,EAAS,CAAE,IAAI,+BAA+B;AAAA,GAGvE,CAAA;AAeA,IAAM,oBAAA,GAAuB,GAAA;AAE7B,IAAM,YAAA,GAAe,2CAAA;AAGrB,IAAM,gBAAA,GAAmB,CAAC,GAAA,EAAa,KAAA,KAAwB;AAC7D,EAAA,IAAI,GAAA,CAAI,SAAS,oBAAA,EAAsB;AACrC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,EAAG,KAAK,CAAA,MAAA,EAAS,GAAA,CAAI,MAAM,CAAA,EAAG,EAAE,CAAC,CAAA,+BAAA,EAAkC,oBAAoB,CAAA,YAAA;AAAA,KACzF;AAAA,EACF;AACA,EAAA,IAAI,CAAC,YAAA,CAAa,IAAA,CAAK,GAAG,CAAA,EAAG;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,QAAA,EAAW,KAAK,CAAA,MAAA,EAAS,GAAG,CAAA,2FAAA;AAAA,KAC9B;AAAA,EACF;AACF,CAAA;AA4BO,IAAM,WAAA,GAAc,CAIzB,KAAA,KACiC;AACjC,EAAA,gBAAA,CAAiB,KAAA,CAAM,KAAK,OAAO,CAAA;AACnC,EAAA,OAAO,KAAA;AACT;AAWA,IAAM,eAAA,GAAkB,CACtB,QAAA,EACA,MAAA,KAC4B;AAC5B,EAAA,IAAI,CAAC,QAAQ,OAAO,MAAA;AACpB,EAAA,MAAM,SAAsB,EAAC;AAC7B,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AAClD,IAAA,IAAI,MAAM,GAAA,CAAI,UAAA,CAAW,CAAA,EAAG,QAAQ,GAAG,CAAA,EAAG;AACxC,MAAA,MAAA,CAAO,IAAI,CAAA,GAAI,KAAA;AAAA,IACjB,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,IAAI,CAAA,GAAI,EAAE,GAAG,KAAA,EAAO,KAAK,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAG;AAAA,IACxD;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT,CAAA;AAWO,IAAM,gBAAA,GAAmB,CAC9B,KAAA,KACU;AACV,EAAA,gBAAA,CAAiB,KAAA,CAAM,KAAK,OAAO,CAAA;AACnC,EAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,KAAA,CAAM,GAAA,EAAK,MAAM,MAAM,CAAA;AACxD,EAAA,IAAI,QAAA,KAAa,MAAM,MAAA,EAAQ;AAC7B,IAAA,OAAO,EAAE,GAAG,KAAA,EAAO,MAAA,EAAQ,QAAA,EAAS;AAAA,EACtC;AACA,EAAA,OAAO,KAAA;AACT;AAGA,IAAM,eAAA,GAAkB,CAAC,QAAA,MAA6C;AAAA,EACpE,KAAA,EAAO;AAAA,IACL,GAAA,EAAK,GAAG,QAAQ,CAAA,MAAA,CAAA;AAAA,IAChB,KAAA,EAAO,MAAA;AAAA,IACP,OAAA,EAAS,GAAG,QAAQ,CAAA,QAAA,CAAA;AAAA,IACpB,GAAA,EAAK;AAAA,GACP;AAAA,EACA,QAAA,EAAU;AAAA,IACR,GAAA,EAAK,GAAG,QAAQ,CAAA,SAAA,CAAA;AAAA,IAChB,KAAA,EAAO,MAAA;AAAA,IACP,OAAA,EAAS,GAAG,QAAQ,CAAA,UAAA,CAAA;AAAA,IACpB,GAAA,EAAK,6CAAA;AAAA,IACL,QAAQ,qBAAA,CAAsB;AAAA,GAChC;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,GAAA,EAAK,GAAG,QAAQ,CAAA,KAAA,CAAA;AAAA,IAChB,KAAA,EAAO,OAAA;AAAA,IACP,OAAA,EAAS,GAAG,QAAQ,CAAA,OAAA,CAAA;AAAA,IACpB,GAAA,EAAK,0CAAA;AAAA,IACL,QAAQ,qBAAA,CAAsB;AAAA,GAChC;AAAA,EACA,OAAA,EAAS;AAAA,IACP,GAAA,EAAK,GAAG,QAAQ,CAAA,QAAA,CAAA;AAAA,IAChB,KAAA,EAAO,MAAA;AAAA,IACP,OAAA,EAAS,GAAG,QAAQ,CAAA,UAAA,CAAA;AAAA,IACpB,GAAA,EAAK;AAAA;AAET,CAAA,CAAA;AA0DO,IAAM,sBAAA,GAAyB,CACpC,KAAA,KAIG;AACH,EAAA,gBAAA,CAAiB,KAAA,CAAM,KAAK,OAAO,CAAA;AACnC,EAAA,MAAM,UAAA,GAAa,eAAA,CAAgB,KAAA,CAAM,GAAG,CAAA;AAC5C,EAAA,MAAM,WAAW,eAAA,CAAgB,KAAA,CAAM,KAAK,KAAA,CAAM,MAAM,KAAK,EAAC;AAE9D,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA;AACvC,EAAA,MAAM,SAAA,GAAY,SAAS,MAAA,CAAO,CAAC,MAAM,MAAA,CAAO,MAAA,CAAO,QAAA,EAAU,CAAC,CAAC,CAAA;AACnE,EAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG;AACxB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,sBAAsB,KAAA,CAAM,GAAG,uEAAuE,SAAA,CAAU,IAAA,CAAK,IAAI,CAAC,CAAA,4CAAA;AAAA,KAC5H;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,GAAG,KAAA;AAAA,IACH,OAAA,EAAS,MAAM,OAAA,IAAW,8BAAA;AAAA,IAC1B,MAAA,EAAQ;AAAA,MACN,GAAG,QAAA;AAAA,MACH,GAAG;AAAA;AACL,GACF;AACF;;;AC9QA,IAAM,cAAA,GAAiB,wCAAA;AAGvB,IAAM,UAAA,GAAa,SAAA;AAMnB,IAAM,cAAA,GAAiB,CAAC,KAAA,KACtB,KAAA,CAAM,OAAA,CAAQ,gBAAgB,EAAE,CAAA,CAAE,OAAA,CAAQ,UAAA,EAAY,KAAK,CAAA;AAMtD,IAAM,iBAAA,GAAoB,CAAC,MAAA,KAA6D;AAC7F,EAAA,MAAM,SAAkC,EAAC;AACzC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,IAAA,MAAA,CAAO,GAAG,CAAA,GAAI,OAAO,UAAU,QAAA,GAAW,cAAA,CAAe,KAAK,CAAA,GAAI,KAAA;AAAA,EACpE;AACA,EAAA,OAAO,MAAA;AACT,CAAA;AAOA,IAAM,cAAA,GAAiB,CAAC,KAAA,EAAgB,IAAA,KAAkC;AACxE,EAAA,QAAQ,IAAA;AAAM,IACZ,KAAK,OAAA;AACH,MAAA,OAAO,KAAA,YAAiB,KAAA,IAAS,OAAO,KAAA,KAAU,WAAW,IAAA,GAAO,YAAA;AAAA,IACtE,KAAK,QAAA;AACH,MAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,IAAA,GAAO,YAAA;AAAA,IAC5C,KAAK,QAAA;AACH,MAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,YAAA;AACtC,MAAA,OAAO,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,GAAI,IAAA,GAAO,eAAA;AAAA,IACzC,KAAK,SAAA;AACH,MAAA,OAAO,OAAO,KAAA,KAAU,SAAA,GAAY,IAAA,GAAO,YAAA;AAAA,IAC7C;AAGE,MAAA,OAAO,YAAA;AAAA;AAEb,CAAA;AAUO,IAAM,cAAA,GAAiB,CAG5B,KAAA,EACA,OAAA,KAC0B;AAC1B,EAAA,MAAM,cAAA,GAAkB,WAAW,EAAC;AACpC,EAAA,MAAM,mBAA4C,EAAC;AACnD,EAAA,MAAM,gBAA0B,EAAC;AACjC,EAAA,MAAM,aAAuB,EAAC;AAC9B,EAAA,MAAM,gBAA0B,EAAC;AACjC,EAAA,MAAM,gBAA0B,EAAC;AAEjC,EAAA,MAAM,aAAA,GAAgB,KAAA,CAAM,MAAA,IAAW,EAAC;AACxC,EAAA,MAAM,oBAAoB,IAAI,GAAA,CAAI,MAAA,CAAO,IAAA,CAAK,aAAa,CAAC,CAAA;AAE5D,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,aAAa,CAAA,EAAG;AAC3D,IAAA,MAAM,KAAA,GAAQ,eAAe,IAAI,CAAA;AAGjC,IAAA,MAAM,YAAY,OAAA,CAAQ,KAAA;AAC1B,IAAA,MAAM,aAAa,OAAA,CAAQ,SAAA;AAE3B,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AACzC,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,aAAA,CAAc,KAAK,IAAI,CAAA;AAAA,MACzB;AACA,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,cAAA,CAAe,KAAA,EAAO,SAAS,CAAA;AACjD,IAAA,IAAI,cAAc,YAAA,EAAc;AAC9B,MAAA,UAAA,CAAW,KAAK,IAAI,CAAA;AACpB,MAAA;AAAA,IACF;AACA,IAAA,IAAI,cAAc,eAAA,EAAiB;AACjC,MAAA,aAAA,CAAc,KAAK,IAAI,CAAA;AACvB,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,cAAc,OAAA,EAAS;AACzB,MAAA,IAAI;AAEF,QAAA,gBAAA,CAAiB,IAAI,CAAA,GACnB,KAAA,YAAiB,KAAA,GACZ,KAAA,CAAM,KAAA,IAAS,KAAA,CAAM,OAAA,GACtB,OAAO,KAAA,KAAU,QAAA,GACf,KAAA,GACA,iBAAA;AAAA,MACV,CAAA,CAAA,MAAQ;AACN,QAAA,gBAAA,CAAiB,IAAI,CAAA,GAAI,wBAAA;AAAA,MAC3B;AAAA,IACF,CAAA,MAAA,IAAW,SAAA,KAAc,QAAA,IAAY,OAAO,UAAU,QAAA,EAAU;AAC9D,MAAA,gBAAA,CAAiB,IAAI,CAAA,GAAI,cAAA,CAAe,KAAK,CAAA;AAAA,IAC/C,CAAA,MAAO;AACL,MAAA,gBAAA,CAAiB,IAAI,CAAA,GAAI,KAAA;AAAA,IAC3B;AAAA,EACF;AAGA,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,cAAc,CAAA,EAAG;AAC1D,IAAA,IAAI,CAAC,kBAAkB,GAAA,CAAI,IAAI,KAAK,KAAA,KAAU,MAAA,IAAa,UAAU,IAAA,EAAM;AACzE,MAAA,aAAA,CAAc,KAAK,IAAI,CAAA;AACvB,MAAA,IAAI,OAAO,KAAA,KAAU,UAAA,IAAc,OAAO,UAAU,QAAA,EAAU;AAC5D,QAAA;AAAA,MACF;AACA,MAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,QAAA,gBAAA,CAAiB,IAAI,CAAA,GAAI,cAAA,CAAe,KAAK,CAAA;AAAA,MAC/C,CAAA,MAAO;AACL,QAAA,gBAAA,CAAiB,IAAI,CAAA,GAAI,KAAA;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,aAAA,EAAe,UAAA,EAAY,aAAA,EAAe,eAAe,gBAAA,EAAiB;AACrF,CAAA;AASO,IAAM,uBAAA,GAA0B,CACrC,eAAA,KACmC;AACnC,EAAA,MAAM,OAAA,GAAU,OAAO,OAAA,CAAQ;AAAA,IAC7B,eAAe,eAAA,CAAgB,aAAA;AAAA,IAC/B,YAAY,eAAA,CAAgB,UAAA;AAAA,IAC5B,eAAe,eAAA,CAAgB,aAAA;AAAA,IAC/B,eAAe,eAAA,CAAgB;AAAA,GAChC,CAAA,CAAE,MAAA,CAAO,CAAC,GAAG,CAAC,CAAA,KAAM,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,IAAK,CAAA,CAAE,SAAS,CAAC,CAAA;AAErD,EAAA,OAAO,QAAQ,MAAA,GAAS,CAAA,GAAI,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA,GAAI,MAAA;AAC5D,CAAA;;;AC3BA,IAAM,YAAA,GAAe,CAAC,IAAA,KAAuC;AAC3D,EAAA,MAAM,eAAA,GAAkB,cAAA,CAAe,IAAA,CAAK,QAAA,EAAU,KAAK,MAAM,CAAA;AAEjE,EAAA,IAAI,KAAK,MAAA,EAAQ;AACf,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,IAAI,eAAA,CAAgB,aAAA,CAAc,MAAA,GAAS,CAAA,EAAG;AAC5C,MAAA,MAAA,CAAO,KAAK,CAAA,yBAAA,EAA4B,eAAA,CAAgB,cAAc,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,IACpF;AACA,IAAA,IAAI,eAAA,CAAgB,UAAA,CAAW,MAAA,GAAS,CAAA,EAAG;AACzC,MAAA,MAAA,CAAO,KAAK,CAAA,uBAAA,EAA0B,eAAA,CAAgB,WAAW,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,IAC/E;AACA,IAAA,IAAI,eAAA,CAAgB,aAAA,CAAc,MAAA,GAAS,CAAA,EAAG;AAC5C,MAAA,MAAA,CAAO,KAAK,CAAA,0BAAA,EAA6B,eAAA,CAAgB,cAAc,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,IACrF;AACA,IAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,MAAA,MAAM,IAAI,eAAA;AAAA,QACR,kBAAA;AAAA,QACA,CAAA,OAAA,EAAU,KAAK,QAAA,CAAS,GAAG,wBAAwB,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,OACtE;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,kBAAA,GAAqB,wBAAwB,eAAe,CAAA;AAElE,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,KAAK,QAAA,CAAS,GAAA;AAAA,IACxB,QAAQ,eAAA,CAAgB,gBAAA;AAAA,IACxB,aAAA,EAAe,KAAK,oBAAA,EAAqB;AAAA,IACzC,QAAQ,IAAA,CAAK,MAAA;AAAA,IACb,QAAA,EAAU,IAAA,CAAK,YAAA,CAAa,QAAA,EAAS;AAAA,IACrC,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,IAClC,GAAI,kBAAA,GAAqB,EAAE,WAAA,EAAa,kBAAA,KAAuB;AAAC,GAClE;AACF,CAAA;AAGA,IAAM,eAAA,GAAkB,CAAC,MAAA,KACvB,MAAA,KAAW,eAAe,CAAA,GAAI,MAAA,CAAO,KAAA,CAAM,iBAAiB,CAAA,CAAE,MAAA;AAMhE,IAAM,UAAA,GAAa,CAAC,YAAA,EAAsB,OAAA,EAAiB,QAAA,KAA6B;AACtF,EAAA,MAAM,WAAA,GACJ,YAAA,KAAiB,YAAA,GACb,MAAA,CAAO,OAAO,CAAA,GACd,CAAA,EAAG,YAAY,CAAA,EAAG,iBAAiB,CAAA,EAAG,OAAO,CAAA,CAAA;AACnD,EAAA,MAAM,KAAA,GAAQ,gBAAgB,WAAW,CAAA;AACzC,EAAA,IAAI,QAAQ,QAAA,EAAU;AACpB,IAAA,MAAM,IAAI,eAAA;AAAA,MACR,qBAAA;AAAA,MACA,CAAA,WAAA,EAAc,KAAK,CAAA,kCAAA,EAAqC,QAAQ,CAAA;AAAA,KAClE;AAAA,EACF;AACA,EAAA,OAAO,WAAA;AACT,CAAA;AAYA,IAAM,mBAAA,GAAsB,CAAC,KAAA,KAC3B,OAAO,KAAA,CAAM,OAAA,KAAY,QAAA,IAAY,KAAA,CAAM,MAAA,KAAW,MAAA,IAAa,OAAA,IAAW,KAAA,CAAM,MAAA;AAGtF,IAAM,uBAAA,GAA0B,CAAC,KAAA,KAC/B,mBAAA,CAAoB,KAAK,CAAA,GACrB,KAAA,GACC,uBAAuB,KAAK,CAAA;AAenC,IAAM,uBAAA,GAA0B,CAAC,IAAA,KAA4C;AAC3E,EAAA,MAAM;AAAA,IACJ,MAAA;AAAA,IACA,YAAA;AAAA,IACA,oBAAA;AAAA,IACA,sBAAA;AAAA,IACA,MAAA;AAAA,IACA,QAAQ,EAAC;AAAA,IACT,kBAAA,GAAqB,EAAE,KAAA,EAAO,CAAA;AAAE,GAClC,GAAI,IAAA;AAEJ,EAAA,IAAI,WAAA,GAAc,CAAA;AAElB,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,UAAU,MAAA,EAAQ;AACtB,MAAA,IAAI,UAAA,CAAW,QAAA,CAAS,KAAK,CAAA,GAAI,OAAO,QAAA,EAAU;AAClD,MAAA,MAAM,UAAU,YAAA,CAAa;AAAA,QAC3B,YAAA;AAAA,QACA,QAAA;AAAA;AAAA,QAEA,MAAA;AAAA,QACA,oBAAA;AAAA,QACA,MAAA;AAAA,QACA,QAAQ,MAAA,CAAO;AAAA,OAChB,CAAA;AACD,MAAA,iBAAA,CAAkB,OAAO,OAAA,EAAS,QAAA,CAAS,KAAA,EAAO,QAAA,CAAS,SAAS,OAAO,CAAA;AAC3E,MAAA,KAAA,CAAM,UAAA,IAAa;AAAA,IACrB,CAAA;AAAA,IACA,GAAA,CAAI,KAAA,EAAO,OAAA,EAAS,MAAA,GAAS,EAAC,EAAG;AAC/B,MAAA,IAAI,UAAA,CAAW,KAAK,CAAA,GAAI,MAAA,CAAO,QAAA,EAAU;AACzC,MAAA,MAAM,OAAA,GAAsB;AAAA,QAC1B,QAAA,EAAU,EAAA;AAAA,QACV,MAAA,EAAQ,kBAAkB,MAAM,CAAA;AAAA,QAChC,eAAe,oBAAA,EAAqB;AAAA,QACpC,MAAA;AAAA,QACA,QAAA,EAAU,aAAa,QAAA,EAAS;AAAA,QAChC,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,OACpC;AACA,MAAA,iBAAA,CAAkB,MAAA,CAAO,OAAA,EAAS,KAAA,EAAO,OAAA,EAAS,OAAO,CAAA;AACzD,MAAA,KAAA,CAAM,UAAA,IAAa;AAAA,IACrB,CAAA;AAAA,IACA,WAAW,OAAA,EAAS;AAClB,MAAA,OAAO,YAAA,CAAa,IAAI,OAAO,CAAA;AAAA,IACjC,CAAA;AAAA,IACA,IAAA,CAAK,YAAA,GAAe,EAAC,EAAG;AACtB,MAAA,WAAA,EAAA;AACA,MAAA,MAAM,cAAc,UAAA,CAAW,MAAA,EAAQ,WAAA,EAAa,MAAA,CAAO,OAAO,YAAY,CAAA;AAC9E,MAAA,MAAM,SAAA,GAAY,IAAI,YAAA,CAAa,YAAA,CAAa,UAAS,EAAG,MAAA,CAAO,OAAO,cAAc,CAAA;AACxF,MAAA,MAAM,gBAAgB,uBAAA,CAAwB;AAAA,QAC5C,MAAA;AAAA,QACA,YAAA,EAAc,SAAA;AAAA,QACd,oBAAA;AAAA,QACA,sBAAA;AAAA,QACA,MAAA,EAAQ,WAAA;AAAA,QACR,KAAA;AAAA,QACA;AAAA,OACD,CAAA;AACD,MAAA,IAAI,MAAA,CAAO,IAAA,CAAK,YAAY,CAAA,CAAE,SAAS,CAAA,EAAG;AACxC,QAAA,aAAA,CAAc,WAAW,YAAY,CAAA;AAAA,MACvC;AACA,MAAA,OAAO,aAAA;AAAA,IACT,CAAA;AAAA,IACA,gBAAA,CAAiB,KAAA,EAAO,QAAA,GAAW,EAAC,EAAG;AACrC,MAAA,IAAI,kBAAA,CAAmB,KAAA,IAAS,MAAA,CAAO,MAAA,CAAO,qBAAA,EAAuB;AACnE,QAAA,MAAM,IAAI,eAAA;AAAA,UACR,4BAAA;AAAA,UACA,CAAA,4BAAA,EAA+B,MAAA,CAAO,MAAA,CAAO,qBAAqB,CAAA,SAAA;AAAA,SACpE;AAAA,MACF;AACA,MAAA,MAAM,YAAA,GAAe,wBAAwB,KAAK,CAAA;AAClD,MAAA,kBAAA,CAAmB,KAAA,EAAA;AACnB,MAAA,MAAM,mBAAmB,IAAI,YAAA;AAAA,QAC3B,aAAa,QAAA,EAAS;AAAA,QACtB,OAAO,MAAA,CAAO;AAAA,OAChB;AACA,MAAA,IAAI,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,CAAE,SAAS,CAAA,EAAG;AACpC,QAAA,gBAAA,CAAiB,IAAI,QAAQ,CAAA;AAAA,MAC/B;AACA,MAAA,MAAM,gBAAgB,sBAAA,EAAuB;AAC7C,MAAA,OAAO,IAAI,wBAAA,CAAyB;AAAA,QAClC,MAAA;AAAA,QACA,KAAA,EAAO,YAAA;AAAA,QACP,YAAA,EAAc,gBAAA;AAAA,QACd,sBAAsB,MAAM,aAAA;AAAA,QAC5B,sBAAA;AAAA,QACA,MAAA;AAAA,QACA;AAAA,OACD,CAAA;AAAA,IACH;AAAA,GACF;AACF,CAAA;AAMO,IAAM,mBAAN,MAAuB;AAAA,EAG5B,WAAA,CACmB,SACA,SAAA,EACjB;AAFiB,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AAAA,EAChB;AAAA,EALK,SAAA;AAAA,EAOR,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,KAAA,EAAM;AACX,IAAA,IAAI,IAAA,CAAK,UAAU,CAAA,EAAG;AACpB,MAAA,IAAA,CAAK,SAAA,GAAY,UAAA,CAAW,IAAA,CAAK,SAAA,EAAW,KAAK,OAAO,CAAA;AACxD,MAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,IACvB;AAAA,EACF;AAAA;AAAA,EAGA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,KAAA,EAAM;AAAA,EACb;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAI,IAAA,CAAK,cAAc,MAAA,EAAW;AAChC,MAAA,YAAA,CAAa,KAAK,SAAS,CAAA;AAC3B,MAAA,IAAA,CAAK,SAAA,GAAY,MAAA;AAAA,IACnB;AAAA,EACF;AACF,CAAA;AAYA,IAAM,2BAAN,MAA+D;AAAA,EAC5C,MAAA;AAAA,EACA,YAAA;AAAA,EACA,oBAAA;AAAA,EACA,sBAAA;AAAA,EACA,MAAA;AAAA,EACA,kBAAA;AAAA,EACA,KAAA;AAAA,EACT,SAAA,GAAY,KAAA;AAAA,EACH,SAAA,GAAY,KAAK,GAAA,EAAI;AAAA,EACrB,UAAA;AAAA,EACT,WAAA,GAAc,CAAA;AAAA,EAEtB,YAAY,IAAA,EAAgC;AAC1C,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA;AACnB,IAAA,IAAA,CAAK,eAAe,IAAA,CAAK,YAAA;AACzB,IAAA,IAAA,CAAK,uBAAuB,IAAA,CAAK,oBAAA;AACjC,IAAA,IAAA,CAAK,yBAAyB,IAAA,CAAK,sBAAA;AACnC,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA;AACnB,IAAA,IAAA,CAAK,kBAAA,GAAqB,IAAA,CAAK,kBAAA,IAAsB,EAAE,OAAO,CAAA,EAAE;AAChE,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAI,gBAAA,CAAiB,IAAA,CAAK,MAAM,OAAA,EAAS,MAAM,IAAA,CAAK,OAAA,EAAS,CAAA;AAC1E,IAAA,IAAA,CAAK,UAAA,GAAa,KAAK,KAAA,CAAM,MAAA;AAC7B,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AACjB,IAAA,IAAA,CAAK,aAAA,CAAc,IAAA,CAAK,UAAA,CAAW,KAAA,EAAO,EAAE,CAAA;AAAA,EAC9C;AAAA,EAEA,KAAA,CAAiC,UAAa,MAAA,EAA8B;AAC1E,IAAA,IAAI,KAAK,SAAA,EAAW;AACpB,IAAA,IAAI,WAAW,QAAA,CAAS,KAAK,CAAA,GAAI,IAAA,CAAK,OAAO,QAAA,EAAU;AACvD,IAAA,MAAM,UAAU,YAAA,CAAa;AAAA,MAC3B,cAAc,IAAA,CAAK,YAAA;AAAA,MACnB,QAAA;AAAA;AAAA,MAEA,MAAA;AAAA,MACA,sBAAsB,IAAA,CAAK,oBAAA;AAAA,MAC3B,QAAQ,IAAA,CAAK,MAAA;AAAA,MACb,MAAA,EAAQ,KAAK,MAAA,CAAO;AAAA,KACrB,CAAA;AACD,IAAA,iBAAA,CAAkB,KAAK,MAAA,CAAO,OAAA,EAAS,SAAS,KAAA,EAAO,QAAA,CAAS,SAAS,OAAO,CAAA;AAChF,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACnB;AAAA,EAEA,GAAA,CAAI,KAAA,EAAiB,OAAA,EAAiB,MAAA,GAAkC,EAAC,EAAS;AAChF,IAAA,IAAI,KAAK,SAAA,EAAW;AACpB,IAAA,IAAI,UAAA,CAAW,KAAK,CAAA,GAAI,IAAA,CAAK,OAAO,QAAA,EAAU;AAC9C,IAAA,MAAM,OAAA,GAAsB;AAAA,MAC1B,QAAA,EAAU,EAAA;AAAA,MACV,MAAA,EAAQ,kBAAkB,MAAM,CAAA;AAAA,MAChC,aAAA,EAAe,KAAK,oBAAA,EAAqB;AAAA,MACzC,QAAQ,IAAA,CAAK,MAAA;AAAA,MACb,QAAA,EAAU,IAAA,CAAK,YAAA,CAAa,QAAA,EAAS;AAAA,MACrC,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,KACpC;AACA,IAAA,iBAAA,CAAkB,IAAA,CAAK,MAAA,CAAO,OAAA,EAAS,KAAA,EAAO,SAAS,OAAO,CAAA;AAC9D,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACnB;AAAA,EAEA,WAAW,OAAA,EAAiD;AAC1D,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,OAAO,CAAA;AAAA,EACtC;AAAA,EAEA,IAAA,CAAK,YAAA,GAA8B,EAAC,EAAe;AACjD,IAAA,IAAA,CAAK,WAAA,EAAA;AACL,IAAA,MAAM,WAAA,GAAc,WAAW,IAAA,CAAK,MAAA,EAAQ,KAAK,WAAA,EAAa,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,YAAY,CAAA;AAC7F,IAAA,MAAM,YAAY,IAAI,YAAA;AAAA,MACpB,IAAA,CAAK,aAAa,QAAA,EAAS;AAAA,MAC3B,IAAA,CAAK,OAAO,MAAA,CAAO;AAAA,KACrB;AAEA,IAAA,MAAM,gBAAgB,uBAAA,CAAwB;AAAA,MAC5C,QAAQ,IAAA,CAAK,MAAA;AAAA,MACb,YAAA,EAAc,SAAA;AAAA,MACd,sBAAsB,IAAA,CAAK,oBAAA;AAAA,MAC3B,wBAAwB,IAAA,CAAK,sBAAA;AAAA,MAC7B,MAAA,EAAQ,WAAA;AAAA,MACR,OAAO,EAAE,UAAA,EAAY,MAAM,IAAA,CAAK,KAAA,CAAM,OAAM,EAAE;AAAA,MAC9C,oBAAoB,IAAA,CAAK;AAAA,KAC1B,CAAA;AAED,IAAA,IAAI,MAAA,CAAO,IAAA,CAAK,YAAY,CAAA,CAAE,SAAS,CAAA,EAAG;AACxC,MAAA,aAAA,CAAc,WAAW,YAAY,CAAA;AAAA,IACvC;AAEA,IAAA,OAAO,aAAA;AAAA,EACT;AAAA,EAEA,QAAA,CAAS,MAAA,GAAkC,EAAC,EAAS;AACnD,IAAA,IAAI,CAAC,IAAA,CAAK,QAAA,EAAS,EAAG;AACtB,IAAA,IAAA,CAAK,aAAA,CAAc,IAAA,CAAK,UAAA,CAAW,QAAA,EAAU;AAAA,MAC3C,QAAA,EAAU,IAAA,CAAK,GAAA,EAAI,GAAI,IAAA,CAAK,SAAA;AAAA,MAC5B,GAAG;AAAA,KACJ,CAAA;AAAA,EACH;AAAA,EAEA,IAAA,CAAK,KAAA,EAAiB,MAAA,GAAkC,EAAC,EAAS;AAChE,IAAA,IAAI,CAAC,IAAA,CAAK,QAAA,EAAS,EAAG;AACtB,IAAA,IAAA,CAAK,aAAA,CAAc,IAAA,CAAK,UAAA,CAAW,IAAA,EAAM;AAAA,MACvC,QAAA,EAAU,IAAA,CAAK,GAAA,EAAI,GAAI,IAAA,CAAK,SAAA;AAAA,MAC5B,KAAA;AAAA,MACA,GAAG;AAAA,KACJ,CAAA;AAAA,EACH;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAI,CAAC,IAAA,CAAK,QAAA,EAAS,EAAG;AACtB,IAAA,IAAA,CAAK,aAAA,CAAc,IAAA,CAAK,UAAA,CAAW,OAAA,EAAS,EAAE,CAAA;AAAA,EAChD;AAAA;AAAA,EAGQ,QAAA,GAAoB;AAC1B,IAAA,IAAI,IAAA,CAAK,WAAW,OAAO,KAAA;AAC3B,IAAA,IAAA,CAAK,kBAAA,CAAmB,KAAA,EAAA;AACxB,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AACjB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEQ,aAAA,CAAc,UAA2B,MAAA,EAAuC;AACtF,IAAA,IAAI,WAAW,QAAA,CAAS,KAAK,CAAA,GAAI,IAAA,CAAK,OAAO,QAAA,EAAU;AACvD,IAAA,MAAM,UAAU,YAAA,CAAa;AAAA,MAC3B,cAAc,IAAA,CAAK,YAAA;AAAA,MACnB,QAAA;AAAA,MACA,MAAA;AAAA,MACA,sBAAsB,IAAA,CAAK,oBAAA;AAAA,MAC3B,QAAQ,IAAA,CAAK,MAAA;AAAA,MACb,MAAA,EAAQ,KAAK,MAAA,CAAO;AAAA,KACrB,CAAA;AACD,IAAA,iBAAA,CAAkB,KAAK,MAAA,CAAO,OAAA,EAAS,SAAS,KAAA,EAAO,QAAA,CAAS,SAAS,OAAO,CAAA;AAAA,EAClF;AACF,CAAA;AAGA,IAAM,uBAAA,GAA0B,CAC9B,MAAA,KAEiF;AACjF,EAAA,MAAM,eAAA,GAAkB,MAAA,CAAO,OAAA,IAAW,oBAAA,EAAqB;AAE/D,EAAA,MAAM,gBAAgB,uBAAA,CAAwB,MAAA;AAAA,IAC5C,CAAC,KAAA,KAAU,OAAO,eAAA,CAAgB,KAAK,CAAA,KAAM;AAAA,GAC/C;AACA,EAAA,IAAI,aAAA,CAAc,SAAS,CAAA,EAAG;AAC5B,IAAA,MAAM,IAAI,eAAA;AAAA,MACR,uBAAA;AAAA,MACA,CAAA,iCAAA,EAAoC,cAAc,IAAA,CAAK,IAAI,CAAC,CAAA,+CAAA,EAAkD,uBAAA,CAAwB,IAAA,CAAK,IAAI,CAAC,CAAA,sDAAA;AAAA,KAClJ;AAAA,EACF;AAEA,EAAA,MAAM,gBAAA,GAAmB,oBAAA,CAAqB,MAAA,CAAO,QAAQ,CAAA;AAC7D,EAAA,IAAI,gBAAA,CAAiB,SAAS,CAAA,EAAG;AAC/B,IAAA,MAAM,IAAI,eAAA;AAAA,MACR,gBAAA;AAAA,MACA,CAAA,4CAAA,EAA+C,gBAAA,CAAiB,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KAC5E;AAAA,EACF;AAEA,EAAA,MAAM,cAAA,GAAiC;AAAA,IACrC,cAAA,EAAgB,MAAA,CAAO,MAAA,EAAQ,cAAA,IAAkB,wBAAA;AAAA,IACjD,YAAA,EAAc,MAAA,CAAO,MAAA,EAAQ,YAAA,IAAgB,sBAAA;AAAA,IAC7C,qBAAA,EAAuB,MAAA,CAAO,MAAA,EAAQ,qBAAA,IAAyB;AAAA,GACjE;AAEA,EAAA,OAAO;AAAA,IACL,QAAA,EAAU;AAAA,MACR,OAAA,EAAS,eAAA;AAAA,MACT,MAAA,EAAQ,cAAA;AAAA,MACR,QAAA,EAAU,UAAA,CAAW,MAAA,CAAO,QAAA,IAAY,OAAO,CAAA;AAAA,MAC/C,QAAQ,MAAA,CAAO;AAAA,KACjB;AAAA,IACA,sBAAA,EAAwB,MAAA,CAAO,sBAAA,KAA2B,MAAM,OAAO,UAAA,EAAW;AAAA,GACpF;AACF,CAAA;AAaO,IAAM,eAAA,GAAkB,CAAC,MAAA,KAAyC;AACvE,EAAA,MAAM,EAAE,QAAA,EAAU,sBAAA,EAAuB,GAAI,wBAAwB,MAAM,CAAA;AAC3E,EAAA,MAAM,mBAAmB,IAAI,YAAA,CAAa,OAAO,QAAA,EAAU,QAAA,CAAS,OAAO,cAAc,CAAA;AAEzF,EAAA,OAAO,uBAAA,CAAwB;AAAA,IAC7B,MAAA,EAAQ,QAAA;AAAA,IACR,YAAA,EAAc,gBAAA;AAAA,IACd,sBAAsB,MAAM,EAAA;AAAA,IAC5B,sBAAA;AAAA,IACA,MAAA,EAAQ,YAAA;AAAA;AAAA,IAER,kBAAA,EAAoB,EAAE,KAAA,EAAO,CAAA;AAAE,GAChC,CAAA;AACH","file":"index.cjs","sourcesContent":["/**\n * Global constants used throughout Chronicler\n */\n\n/**\n * Log level priority mapping\n * Lower numbers = higher priority/severity\n */\nexport const LOG_LEVELS = {\n  fatal: 0, // System is unusable\n  critical: 1, // Critical conditions requiring immediate attention\n  alert: 2, // Action must be taken immediately\n  error: 3, // Error conditions\n  warn: 4, // Warning conditions\n  audit: 5, // Audit trail events (compliance, security)\n  info: 6, // Informational messages\n  debug: 7, // Debug-level messages\n  trace: 8, // Trace-level messages (very verbose)\n} as const;\n\n/**\n * Union of all valid log level names, derived from {@link LOG_LEVELS}.\n */\nexport type LogLevel = keyof typeof LOG_LEVELS;\n\n/**\n * All required log levels that backends must implement.\n * Derived from LOG_LEVELS keys to prevent drift.\n */\nexport const DEFAULT_REQUIRED_LEVELS = Object.keys(LOG_LEVELS) as readonly LogLevel[];\n\n/**\n * Default correlation timeout in milliseconds (5 minutes)\n */\nexport const DEFAULT_CORRELATION_TIMEOUT_MS = 5 * 60 * 1000;\n\n/**\n * Root fork ID for the base chronicle instance\n */\nexport const ROOT_FORK_ID = '0';\n\n/**\n * Separator used in hierarchical fork IDs\n * @example '1.1', '1.2.3'\n */\nexport const FORK_ID_SEPARATOR = '.';\n\n/**\n * Default maximum number of context keys per ContextStore\n */\nexport const DEFAULT_MAX_CONTEXT_KEYS = 100;\n\n/**\n * Default maximum fork nesting depth\n */\nexport const DEFAULT_MAX_FORK_DEPTH = 10;\n\n/**\n * Default maximum number of active (uncompleted) correlations\n */\nexport const DEFAULT_MAX_ACTIVE_CORRELATIONS = 1000;\n","export type ChroniclerErrorCode =\r\n  | 'UNSUPPORTED_LOG_LEVEL'\r\n  | 'RESERVED_FIELD'\r\n  | 'BACKEND_METHOD'\r\n  | 'FORK_DEPTH_EXCEEDED'\r\n  | 'CORRELATION_LIMIT_EXCEEDED'\r\n  | 'FIELD_VALIDATION';\r\n\r\n/**\r\n * Typed error class for Chronicler configuration and runtime failures.\r\n * Uses a discriminator `code` to identify the specific error category.\r\n */\r\nexport class ChroniclerError extends Error {\r\n  readonly code: ChroniclerErrorCode;\r\n\r\n  /**\r\n   * @param code - Machine-readable error category discriminator\r\n   * @param message - Human-readable description of the error\r\n   */\r\n  constructor(code: ChroniclerErrorCode, message: string) {\r\n    super(message);\r\n    this.name = 'ChroniclerError';\r\n    this.code = code;\r\n  }\r\n}\r\n","import { DEFAULT_REQUIRED_LEVELS, type LogLevel } from './constants';\nimport { ChroniclerError } from './errors';\nimport type { ValidationMetadata } from './validation';\n\ntype ConsoleMethod = 'error' | 'warn' | 'info' | 'debug';\n\n/** Maps each Chronicler log level to its corresponding console method. */\nconst CONSOLE_LEVEL_MAP: Record<LogLevel, ConsoleMethod> = {\n  fatal: 'error',\n  critical: 'error',\n  alert: 'error',\n  error: 'error',\n  warn: 'warn',\n  audit: 'info',\n  info: 'info',\n  debug: 'debug',\n  trace: 'debug',\n};\n\n/** Ordered fallback chains for backend levels — tried sequentially when a level handler is missing. */\nconst LEVEL_FALLBACK_CHAINS: Record<LogLevel, readonly LogLevel[]> = {\n  fatal: ['critical', 'error', 'warn', 'info'],\n  critical: ['error', 'warn', 'info'],\n  alert: ['error', 'warn', 'info'],\n  error: ['warn', 'info'],\n  warn: ['info'],\n  audit: ['info'],\n  info: [],\n  debug: ['info'],\n  trace: ['debug', 'info'],\n};\n\nexport interface LogPayload {\n  readonly eventKey: string;\n  readonly fields: Record<string, unknown>;\n  readonly correlationId: string;\n  readonly forkId: string;\n  readonly metadata: Record<string, unknown>;\n  readonly timestamp: string;\n  readonly _validation?: ValidationMetadata;\n}\n\nexport type LogBackend = Record<LogLevel, (message: string, payload: LogPayload) => void>;\n\n/**\n * Call a backend logger method.\n *\n * Backend exceptions are caught and reported to `console.error` so that\n * logging never crashes the caller.  Only missing backend methods (a\n * configuration error) still throw.\n *\n * @param backend - Logger object\n * @param level - Log level\n * @param message - Log message\n * @param payload - Log payload\n * @throws {ChroniclerError} `BACKEND_METHOD` if the backend does not support the log level\n */\nexport const callBackendMethod = (\n  backend: LogBackend,\n  level: LogLevel,\n  message: string,\n  payload: LogPayload,\n): void => {\n  if (typeof backend[level] !== 'function') {\n    throw new ChroniclerError('BACKEND_METHOD', `Backend does not support log level: ${level}`);\n  }\n  try {\n    backend[level](message, payload);\n  } catch (err: unknown) {\n    console.error(\n      '[chronicler] Backend error during log emission:',\n      err instanceof Error ? err.message : 'Unknown error',\n    );\n  }\n};\n\n/**\n * Create a zero-config backend that logs to the console.\n *\n * Maps each of the 9 Chronicler levels to the appropriate `console` method:\n * fatal/critical/alert/error → `console.error`, warn → `console.warn`,\n * audit/info → `console.info`, debug/trace → `console.debug`.\n *\n * @returns A fully populated LogBackend using console methods for all levels\n */\nexport const createConsoleBackend = (): LogBackend => {\n  const backend = {} as LogBackend;\n  for (const level of DEFAULT_REQUIRED_LEVELS) {\n    const method = CONSOLE_LEVEL_MAP[level];\n    // eslint-disable-next-line no-console -- createConsoleBackend: console IS the backend\n    backend[level] = (message: string, payload: LogPayload) => console[method](message, payload);\n  }\n  return backend;\n};\n\n/**\n * Create a backend from a partial set of handlers.\n *\n * For each missing level, the fallback chain is tried in order (e.g. `fatal` →\n * `critical` → `error` → `warn` → `info`). If no fallback is provided either,\n * the corresponding `console` method is used.\n *\n * @param partial - Partial backend with handlers for a subset of log levels\n * @returns A fully populated LogBackend with fallbacks applied for missing levels\n */\nexport const createBackend = (partial: Partial<LogBackend>): LogBackend => {\n  const backend = {} as LogBackend;\n  for (const level of DEFAULT_REQUIRED_LEVELS) {\n    if (typeof partial[level] === 'function') {\n      backend[level] = partial[level];\n      continue;\n    }\n    const fallback = LEVEL_FALLBACK_CHAINS[level].find((fb) => typeof partial[fb] === 'function');\n    if (fallback) {\n      backend[level] = partial[fallback]!;\n    } else {\n      const method = CONSOLE_LEVEL_MAP[level];\n      // eslint-disable-next-line no-console -- createBackend fallback: console IS the fallback backend\n      backend[level] = (message: string, payload: LogPayload) => console[method](message, payload);\n    }\n  }\n  return backend;\n};\n\n/**\n * A routing rule that pairs a backend with an optional filter.\n *\n * When `filter` is omitted the backend receives all events.\n * When provided, the backend only receives events for which `filter` returns `true`.\n */\nexport interface BackendRoute {\n  readonly backend: LogBackend;\n  readonly filter?: (level: LogLevel, payload: LogPayload) => boolean;\n}\n\n/**\n * Create a backend that routes events to multiple backends based on filter rules.\n *\n * Each route pairs a backend with an optional filter function. Events are\n * dispatched to every route whose filter matches (or to all routes without a\n * filter). This enables splitting logs into separate streams — for example,\n * maintenance/debug logs to stdout and audit events to a dedicated store.\n *\n * @param routes - One or more backend routes with optional filters\n * @returns A single LogBackend that fans out to the matching routes\n * @throws {Error} If no routes are provided\n *\n * @example\n * ```typescript\n * const router = createRouterBackend([\n *   { backend: consoleBackend, filter: (level, payload) => !payload.eventKey.startsWith('audit.') },\n *   { backend: auditBackend,   filter: (level, payload) => payload.eventKey.startsWith('audit.') },\n * ]);\n *\n * const chronicle = createChronicle({ backend: router, metadata: { appName: 'my-app' } });\n * ```\n */\nexport const createRouterBackend = (routes: BackendRoute[]): LogBackend => {\n  if (routes.length === 0) {\n    throw new Error('createRouterBackend requires at least one route.');\n  }\n  const backend = {} as LogBackend;\n  for (const level of DEFAULT_REQUIRED_LEVELS) {\n    backend[level] = (message: string, payload: LogPayload) => {\n      for (const route of routes) {\n        if (!route.filter || route.filter(level, payload)) {\n          callBackendMethod(route.backend, level, message, payload);\n        }\n      }\n    };\n  }\n  return backend;\n};\n","/** Reserved top-level field names that cannot be used in user context or metadata. */\nexport const RESERVED_TOP_LEVEL_FIELDS = [\n  'eventKey',\n  'level',\n  'message',\n  'correlationId',\n  'forkId',\n  'timestamp',\n  'fields',\n  '_validation',\n] as const;\n\nexport type ReservedTopLevelField = (typeof RESERVED_TOP_LEVEL_FIELDS)[number];\n\n/** Set for O(1) lookup during validation. */\nconst TOP_LEVEL_SET = new Set<string>(RESERVED_TOP_LEVEL_FIELDS);\n\n/**\n * Check if a key is a reserved top-level field.\n *\n * @param key - Field name to check against the reserved set\n * @returns True if the key is reserved and must not be used in user context or metadata\n */\nexport const isReservedTopLevelField = (key: string): key is ReservedTopLevelField =>\n  TOP_LEVEL_SET.has(key);\n\n/**\n * Check a record for reserved keys and return array of violations\n * @param record - Object to check\n * @returns Array of reserved keys found in the record\n */\nexport const assertNoReservedKeys = (record: Record<string, unknown>): string[] => {\n  const invalid: string[] = [];\n  for (const key of Object.keys(record)) {\n    if (isReservedTopLevelField(key)) {\n      invalid.push(key);\n    }\n  }\n  return invalid;\n};\n","import { isReservedTopLevelField } from './reserved';\n\n/** Type guard for context-safe primitive values. */\nconst isSimpleValue = (value: unknown): value is string | number | boolean | null =>\n  value === null ||\n  typeof value === 'string' ||\n  typeof value === 'number' ||\n  typeof value === 'boolean';\n\n/** Object prototype keys blocked to prevent prototype pollution. */\nconst DANGEROUS_KEYS = new Set([\n  '__proto__',\n  'constructor',\n  'prototype',\n  'toString',\n  'valueOf',\n  'hasOwnProperty',\n  'isPrototypeOf',\n  'propertyIsEnumerable',\n  'toLocaleString',\n  '__defineGetter__',\n  '__defineSetter__',\n  '__lookupGetter__',\n  '__lookupSetter__',\n]);\n\nexport type ContextValue = string | number | boolean | null;\n\nexport type ContextRecord = Record<string, ContextValue>;\n\nexport interface ContextCollisionDetail {\n  readonly key: string;\n  readonly existingValue: ContextValue;\n  readonly attemptedValue: ContextValue;\n}\n\nexport interface ContextValidationResult {\n  readonly reserved: string[];\n  readonly collisionDetails: ContextCollisionDetail[];\n  readonly dropped: string[];\n}\n\n/**\n * Sanitize and validate context input\n *\n * **Validation Strategy:**\n * - Returns validation results rather than throwing errors\n * - Logs should succeed even with invalid metadata\n * - Validation errors are reported via system events and _validation metadata\n *\n * **Collision Handling:**\n * - When a key exists with a different value, the ORIGINAL value is preserved\n * - The attempted new value is rejected\n * - A collision detail is recorded for system event emission\n *\n * **Reserved Fields:**\n * - Reserved field attempts are silently dropped\n * - A warning is recorded for system event emission\n *\n * @param context - New context to add\n * @param existingContext - Current context (for collision detection)\n * @returns Sanitized context and validation results\n *\n * @see {@link ContextValidationResult} for validation result structure\n */\n/* eslint-disable complexity -- validation branches are each a distinct concern */\nexport const sanitizeContextInput = (\n  context: ContextRecord,\n  existingContext: ContextRecord = {},\n  maxNewKeys = Infinity,\n): {\n  context: ContextRecord;\n  validation: ContextValidationResult;\n} => {\n  const sanitized: ContextRecord = {};\n  const reserved: string[] = [];\n  const collisionDetails: ContextCollisionDetail[] = [];\n  const dropped: string[] = [];\n  let acceptedCount = 0;\n\n  for (const [key, rawValue] of Object.entries(context)) {\n    if (isReservedTopLevelField(key)) {\n      reserved.push(key);\n      continue;\n    }\n\n    if (DANGEROUS_KEYS.has(key)) {\n      reserved.push(key);\n      continue;\n    }\n\n    // Invalid type (object, array, undefined, etc.) - skip this key\n    if (!isSimpleValue(rawValue)) continue;\n\n    if (Object.hasOwn(existingContext, key) || Object.hasOwn(sanitized, key)) {\n      const existingValue = (\n        Object.hasOwn(sanitized, key) ? sanitized[key] : existingContext[key]\n      )!;\n      collisionDetails.push({ key, existingValue, attemptedValue: rawValue });\n      continue;\n    }\n\n    if (acceptedCount >= maxNewKeys) {\n      dropped.push(key);\n      continue;\n    }\n\n    sanitized[key] = rawValue;\n    acceptedCount++;\n  }\n\n  return { context: sanitized, validation: { reserved, collisionDetails, dropped } };\n};\n/* eslint-enable complexity */\n\n/**\n * Immutable-snapshot context store for structured log metadata.\n *\n * Context is accumulated over time via {@link add}. Collisions (duplicate keys\n * with different values) preserve the original value and are reported via the\n * returned {@link ContextValidationResult}. Reserved field names are silently\n * dropped.\n */\nexport class ContextStore {\n  private readonly context: ContextRecord = {};\n  private readonly maxKeys: number;\n\n  constructor(initial: ContextRecord = {}, maxKeys = Infinity) {\n    this.maxKeys = maxKeys;\n    const { context } = sanitizeContextInput(initial, {}, maxKeys);\n    this.context = context;\n  }\n\n  /**\n   * Merge new context into the store.\n   *\n   * @param raw - Key-value pairs to add\n   * @returns Validation result with any collisions or reserved field attempts\n   */\n  add(raw: ContextRecord): ContextValidationResult {\n    const remaining = Math.max(0, this.maxKeys - Object.keys(this.context).length);\n    const { context, validation } = sanitizeContextInput(raw, this.context, remaining);\n    // Intentional mutation: `readonly` prevents reassignment but allows property addition\n    Object.assign(this.context, context);\n    return validation;\n  }\n\n  /**\n   * Return a shallow copy of the current context.\n   *\n   * @returns A new object containing all accumulated context key-value pairs\n   */\n  snapshot(): ContextRecord {\n    return { ...this.context };\n  }\n}\n","/**\n * Field type definitions with compile-time type safety\n */\n\n/**\n * Field builder with compile-time type inference\n */\nexport interface FieldBuilder<T extends string, R extends boolean> {\n  readonly _type: T;\n  readonly _required: R;\n  readonly _doc: string | undefined;\n}\n\n/**\n * Field builder with optional marker\n */\nexport interface OptionalFieldBuilder<T extends string> extends FieldBuilder<T, false> {\n  readonly doc: (description: string) => OptionalFieldBuilder<T>;\n}\n\n/**\n * Field builder with required marker (default)\n */\nexport interface RequiredFieldBuilder<T extends string> extends FieldBuilder<T, true> {\n  readonly optional: () => OptionalFieldBuilder<T>;\n  readonly doc: (description: string) => RequiredFieldBuilder<T>;\n}\n\nfunction makeOptional<T extends string>(type: T, doc: string | undefined): OptionalFieldBuilder<T> {\n  return {\n    _type: type,\n    _required: false as const,\n    _doc: doc,\n    doc: (description: string) => makeOptional(type, description),\n  };\n}\n\nfunction makeRequired<T extends string>(type: T, doc: string | undefined): RequiredFieldBuilder<T> {\n  return {\n    _type: type,\n    _required: true as const,\n    _doc: doc,\n    optional: () => makeOptional(type, doc),\n    doc: (description: string) => makeRequired(type, description),\n  };\n}\n\n/**\n * Field type builders — use these to define fields in events.\n *\n * @example\n * ```typescript\n * const event = defineEvent({\n *   key: 'user.created',\n *   level: 'info',\n *   message: 'User created',\n *   fields: {\n *     userId: field.string().doc('User ID'),\n *     age: field.number().optional().doc('User age'),\n *     isActive: field.boolean(),\n *     error: field.error().optional(),\n *   },\n * });\n * ```\n */\nexport const field = {\n  string: (): RequiredFieldBuilder<'string'> => makeRequired('string', undefined),\n  number: (): RequiredFieldBuilder<'number'> => makeRequired('number', undefined),\n  boolean: (): RequiredFieldBuilder<'boolean'> => makeRequired('boolean', undefined),\n  error: (): RequiredFieldBuilder<'error'> => makeRequired('error', undefined),\n} as const;\n\n/**\n * Utility type to simplify intersections\n */\ntype Simplify<T> = { [K in keyof T]: T[K] } & {};\n\n/**\n * Infer the TypeScript type from a field builder\n */\nexport type InferFieldType<F> =\n  F extends FieldBuilder<infer T, boolean>\n    ? T extends 'string'\n      ? string\n      : T extends 'number'\n        ? number\n        : T extends 'boolean'\n          ? boolean\n          : T extends 'error'\n            ? Error | string\n            : never\n    : never;\n\n/**\n * Build required fields object\n */\ntype BuildRequired<F extends Record<string, FieldBuilder<string, boolean>>> = {\n  [K in keyof F as F[K]['_required'] extends true ? K : never]: InferFieldType<F[K]>;\n};\n\n/**\n * Build optional fields object\n */\ntype BuildOptional<F extends Record<string, FieldBuilder<string, boolean>>> = {\n  [K in keyof F as F[K]['_required'] extends false ? K : never]?: InferFieldType<F[K]>;\n};\n\n/**\n * Infer complete field types from field builders\n * Required fields become required properties, optional fields become optional\n */\nexport type InferFields<F extends Record<string, FieldBuilder<string, boolean>>> = Simplify<\n  BuildRequired<F> & BuildOptional<F>\n>;\n","import { DEFAULT_CORRELATION_TIMEOUT_MS, type LogLevel } from './constants';\nimport { field, type FieldBuilder, type InferFields } from './fields';\n\n/**\n * Event definition with compile-time type safety\n */\nexport interface EventDefinition<\n  Key extends string = string,\n  Fields extends Record<string, FieldBuilder<string, boolean>> = Record<\n    string,\n    FieldBuilder<string, boolean>\n  >,\n> {\n  readonly key: Key;\n  readonly level: LogLevel;\n  readonly message: string;\n  readonly doc?: string;\n  readonly fields?: Fields;\n}\n\n/**\n * Helper to extract field types from an event definition\n */\nexport type EventFields<E> =\n  E extends EventDefinition<string, infer F>\n    ? F extends Record<string, FieldBuilder<string, boolean>>\n      ? InferFields<F>\n      : Record<string, never>\n    : never;\n\nexport type EventRecord = Record<\n  string,\n  EventDefinition<string, Record<string, FieldBuilder<string, boolean>>>\n>;\n\nexport interface SystemEventGroup {\n  readonly key: string;\n  readonly type: 'system';\n  readonly doc?: string;\n  readonly events?: EventRecord;\n  readonly groups?: Record<string, SystemEventGroup | CorrelationEventGroup>;\n}\n\nexport interface CorrelationEventGroup {\n  readonly key: string;\n  readonly type: 'correlation';\n  readonly doc?: string;\n  readonly timeout?: number;\n  readonly events?: EventRecord;\n  readonly groups?: Record<string, SystemEventGroup | CorrelationEventGroup>;\n}\n\n/** Field definitions for auto-generated correlation lifecycle events. */\nconst correlationAutoFields = {\n  start: {},\n  complete: {\n    duration: field.number().optional().doc('Duration of the correlation in milliseconds'),\n  },\n  fail: {\n    duration: field.number().optional().doc('Duration of the correlation in milliseconds'),\n    error: field.error().optional().doc('Error that caused the failure'),\n  },\n  timeout: {},\n};\n\nexport type CorrelationAutoEvents = {\n  [Key in keyof typeof correlationAutoFields]: EventDefinition<\n    string,\n    (typeof correlationAutoFields)[Key]\n  >;\n};\n\ntype WithAutoEvents<Event extends EventRecord | undefined> = (Event extends EventRecord\n  ? Event\n  : Record<never, EventDefinition<string, Record<string, FieldBuilder<string, boolean>>>>) &\n  CorrelationAutoEvents;\n\n/** Maximum allowed length for event keys to prevent unbounded key sizes. */\nconst MAX_EVENT_KEY_LENGTH = 256;\n\nconst EVENT_KEY_RE = /^[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$/;\n\n/** Validate an event or group key against length and format constraints. */\nconst validateEventKey = (key: string, label: string): void => {\n  if (key.length > MAX_EVENT_KEY_LENGTH) {\n    throw new Error(\n      `${label} key \"${key.slice(0, 50)}...\" exceeds maximum length of ${MAX_EVENT_KEY_LENGTH} characters.`,\n    );\n  }\n  if (!EVENT_KEY_RE.test(key)) {\n    throw new Error(\n      `Invalid ${label} key \"${key}\". Keys must be dotted camelCase identifiers (e.g. \"user.created\", \"http.request.started\").`,\n    );\n  }\n};\n\n/**\n * Define an event with compile-time type safety.\n *\n * `as const` is **not required** — `defineEvent` uses TypeScript `const` generic\n * parameters (TS 5.0+), so literal types and field builders are narrowed automatically.\n * You may still add `as const` if you prefer, but it has no effect.\n *\n * @example\n * ```typescript\n * const userCreated = defineEvent({\n *   key: 'user.created',\n *   level: 'info',\n *   message: 'User created',\n *   doc: 'Emitted when a new user is created',\n *   fields: {\n *     userId: field.string().doc('User ID'),\n *     email: field.string(),\n *     age: field.number().optional(),\n *   },\n * });\n * ```\n *\n * @param event - Event definition with key, level, message, optional doc and fields\n * @returns The same event definition, typed for compile-time inference\n * @throws {Error} If the event key does not match the required dotted camelCase format\n */\nexport const defineEvent = <\n  const Key extends string,\n  const Fields extends Record<string, FieldBuilder<string, boolean>>,\n>(\n  event: EventDefinition<Key, Fields>,\n): EventDefinition<Key, Fields> => {\n  validateEventKey(event.key, 'Event');\n  return event;\n};\n\n/**\n * Auto-prefix event keys in a group's events with `${groupKey}.${propertyName}`\n * when the event's key doesn't already start with `${groupKey}.`.\n * Existing fully-qualified keys pass through unchanged.\n *\n * @param groupKey - The parent group's key used as prefix\n * @param events - Record of events to prefix (may be undefined)\n * @returns New event record with prefixed keys, or undefined if input was undefined\n */\nconst prefixEventKeys = (\n  groupKey: string,\n  events: EventRecord | undefined,\n): EventRecord | undefined => {\n  if (!events) return events;\n  const result: EventRecord = {};\n  for (const [name, event] of Object.entries(events)) {\n    if (event.key.startsWith(`${groupKey}.`)) {\n      result[name] = event;\n    } else {\n      result[name] = { ...event, key: `${groupKey}.${name}` };\n    }\n  }\n  return result;\n};\n\n/**\n * Define a system or correlation event group for organizational purposes.\n *\n * Groups provide a namespace hierarchy for events. For correlation groups,\n * prefer {@link defineCorrelationGroup} which adds automatic lifecycle events.\n *\n * @param group - Event group definition (system or correlation)\n * @returns The same group definition, typed for compile-time inference\n */\nexport const defineEventGroup = <Group extends SystemEventGroup | CorrelationEventGroup>(\n  group: Group,\n): Group => {\n  validateEventKey(group.key, 'Group');\n  const prefixed = prefixEventKeys(group.key, group.events);\n  if (prefixed !== group.events) {\n    return { ...group, events: prefixed } as Group;\n  }\n  return group;\n};\n\n/** Build the four auto-generated lifecycle events for a correlation group. */\nconst buildAutoEvents = (groupKey: string): CorrelationAutoEvents => ({\n  start: {\n    key: `${groupKey}.start`,\n    level: 'info',\n    message: `${groupKey} started`,\n    doc: 'Auto-generated correlation start event',\n  },\n  complete: {\n    key: `${groupKey}.complete`,\n    level: 'info',\n    message: `${groupKey} completed`,\n    doc: 'Auto-generated correlation completion event',\n    fields: correlationAutoFields.complete,\n  },\n  fail: {\n    key: `${groupKey}.fail`,\n    level: 'error',\n    message: `${groupKey} failed`,\n    doc: 'Auto-generated correlation failure event',\n    fields: correlationAutoFields.fail,\n  },\n  timeout: {\n    key: `${groupKey}.timeout`,\n    level: 'warn',\n    message: `${groupKey} timed out`,\n    doc: 'Auto-generated correlation timeout event',\n  },\n});\n\n/**\n * Define a correlation event group with automatic lifecycle events\n *\n * **What is a correlation group?**\n * A correlation represents a logical unit of work with a defined lifecycle\n * (start, complete, timeout). Common examples: HTTP requests, batch jobs, workflows.\n *\n * **Automatic events added:**\n * - `{key}.start` - Emitted when startCorrelation() is called\n * - `{key}.complete` - Emitted when complete() is called (includes duration)\n * - `{key}.fail` - Emitted when fail() is called (includes duration and error)\n * - `{key}.timeout` - Emitted if no activity within timeout period\n *\n * **Timeout behavior:**\n * - Defaults to 5 minutes (300,000ms) if not specified\n * - Timer resets on ANY activity (log events, fork creation)\n * - Set to 0 to disable timeout\n *\n * **Type safety:**\n * TypeScript will infer all event keys and field types. The return type\n * includes both your events and the auto-generated lifecycle events.\n *\n * @param group - Correlation group definition\n * @returns Normalized group with auto-events and default timeout\n *\n * @example\n * ```typescript\n * const requestGroup = defineCorrelationGroup({\n *   key: 'api.request',\n *   doc: 'HTTP request lifecycle',\n *   timeout: 30_000, // 30 seconds\n *   events: {\n *     validated: defineEvent({\n *       key: 'api.request.validated',\n *       level: 'debug',\n *       message: 'Request validated',\n *       doc: 'Validation passed',\n *     }),\n *     processed: defineEvent({\n *       key: 'api.request.processed',\n *       level: 'info',\n *       message: 'Request processed',\n *       doc: 'Processing complete',\n *       fields: { statusCode: { type: 'number', required: true } },\n *     }),\n *   },\n * });\n *\n * // Auto-events available:\n * // - requestGroup.events.start\n * // - requestGroup.events.complete\n * // - requestGroup.events.timeout\n * // - requestGroup.events.validated (your event)\n * // - requestGroup.events.processed (your event)\n * ```\n */\nexport const defineCorrelationGroup = <Group extends CorrelationEventGroup>(\n  group: Group,\n): Omit<Group, 'events' | 'timeout'> & {\n  events: WithAutoEvents<Group['events']>;\n  timeout: number;\n} => {\n  validateEventKey(group.key, 'Group');\n  const autoEvents = buildAutoEvents(group.key);\n  const prefixed = prefixEventKeys(group.key, group.events) ?? {};\n\n  const autoKeys = Object.keys(autoEvents);\n  const conflicts = autoKeys.filter((k) => Object.hasOwn(prefixed, k));\n  if (conflicts.length > 0) {\n    throw new Error(\n      `Correlation group \"${group.key}\" defines events that collide with auto-generated lifecycle events: ${conflicts.join(', ')}. Rename these events to avoid the conflict.`,\n    );\n  }\n\n  return {\n    ...group,\n    timeout: group.timeout ?? DEFAULT_CORRELATION_TIMEOUT_MS,\n    events: {\n      ...prefixed,\n      ...autoEvents,\n    } as WithAutoEvents<Group['events']>,\n  };\n};\n","import type { EventDefinition, EventFields } from './events';\nimport type { FieldBuilder } from './fields';\n\nexport interface ValidationMetadata {\n  readonly missingFields?: string[];\n  readonly typeErrors?: string[];\n  readonly invalidValues?: string[];\n  readonly unknownFields?: string[];\n}\n\ninterface FieldValidationResult {\n  readonly missingFields: string[];\n  readonly typeErrors: string[];\n  readonly invalidValues: string[];\n  readonly unknownFields: string[];\n  readonly normalizedFields: Record<string, unknown>;\n}\n\n/** Matches ANSI escape sequences (CSI, OSC, etc.) for sanitization. */\nconst ANSI_ESCAPE_RE = /\\x1b(?:[@-Z\\\\-_]|\\[[0-?]*[ -/]*[@-~])/g;\n\n/** Matches carriage return and newline characters for sanitization. */\nconst NEWLINE_RE = /[\\r\\n]/g;\n\n/**\n * Sanitize a string value to prevent log injection.\n * Strips ANSI escape sequences and replaces newlines with a visible placeholder.\n */\nconst sanitizeString = (value: string): string =>\n  value.replace(ANSI_ESCAPE_RE, '').replace(NEWLINE_RE, '\\\\n');\n\n/**\n * Sanitize string values in an untyped fields record.\n * Used by the `log()` escape hatch to apply the same sanitization as typed events.\n */\nexport const sanitizeLogFields = (fields: Record<string, unknown>): Record<string, unknown> => {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(fields)) {\n    result[key] = typeof value === 'string' ? sanitizeString(value) : value;\n  }\n  return result;\n};\n\n/** Result of checking a runtime value against an expected field type. */\ntype TypeCheckResult = 'ok' | 'type_error' | 'invalid_value';\n\n/** Check if a runtime value matches the expected field type. */\n// eslint-disable-next-line complexity -- switch arms for each field type are inherently branchy\nconst checkFieldType = (value: unknown, type: string): TypeCheckResult => {\n  switch (type) {\n    case 'error':\n      return value instanceof Error || typeof value === 'string' ? 'ok' : 'type_error';\n    case 'string':\n      return typeof value === 'string' ? 'ok' : 'type_error';\n    case 'number':\n      if (typeof value !== 'number') return 'type_error';\n      return Number.isFinite(value) ? 'ok' : 'invalid_value';\n    case 'boolean':\n      return typeof value === 'boolean' ? 'ok' : 'type_error';\n    default:\n      // Unknown field type — always fail validation so new types\n      // surface as type errors until this switch is updated.\n      return 'type_error';\n  }\n};\n\n/**\n * Validate event fields against their definitions and normalize values.\n *\n * @param event - Event definition containing field schemas to validate against\n * @param payload - User-provided field values to validate\n * @returns Validation result with missing fields, type errors, unknown fields, and normalized values\n */\n/* eslint-disable max-lines-per-function, complexity -- field validation checks missing/type/unknown/sanitization in one pass */\nexport const validateFields = <\n  E extends EventDefinition<string, Record<string, FieldBuilder<string, boolean>>>,\n>(\n  event: E,\n  payload: EventFields<E>,\n): FieldValidationResult => {\n  const providedFields = (payload ?? {}) as Record<string, unknown>;\n  const normalizedFields: Record<string, unknown> = {};\n  const missingFields: string[] = [];\n  const typeErrors: string[] = [];\n  const invalidValues: string[] = [];\n  const unknownFields: string[] = [];\n\n  const fieldBuilders = event.fields ?? ({} as Record<string, FieldBuilder<string, boolean>>);\n  const definedFieldNames = new Set(Object.keys(fieldBuilders));\n\n  for (const [name, builder] of Object.entries(fieldBuilders)) {\n    const value = providedFields[name];\n\n    // Extract metadata from builder (runtime info)\n    const fieldType = builder._type;\n    const isRequired = builder._required;\n\n    if (value === undefined || value === null) {\n      if (isRequired) {\n        missingFields.push(name);\n      }\n      continue;\n    }\n\n    const typeCheck = checkFieldType(value, fieldType);\n    if (typeCheck === 'type_error') {\n      typeErrors.push(name);\n      continue;\n    }\n    if (typeCheck === 'invalid_value') {\n      invalidValues.push(name);\n      continue;\n    }\n\n    if (fieldType === 'error') {\n      try {\n        // checkFieldType('error') guarantees value is Error | string\n        normalizedFields[name] =\n          value instanceof Error\n            ? (value.stack ?? value.message)\n            : typeof value === 'string'\n              ? value\n              : '[unknown error]';\n      } catch {\n        normalizedFields[name] = '[unserializable error]';\n      }\n    } else if (fieldType === 'string' && typeof value === 'string') {\n      normalizedFields[name] = sanitizeString(value);\n    } else {\n      normalizedFields[name] = value;\n    }\n  }\n\n  // Pass through extra fields not in the event definition, filtering non-serializable values\n  for (const [name, value] of Object.entries(providedFields)) {\n    if (!definedFieldNames.has(name) && value !== undefined && value !== null) {\n      unknownFields.push(name);\n      if (typeof value === 'function' || typeof value === 'symbol') {\n        continue;\n      }\n      if (typeof value === 'string') {\n        normalizedFields[name] = sanitizeString(value);\n      } else {\n        normalizedFields[name] = value;\n      }\n    }\n  }\n\n  return { missingFields, typeErrors, invalidValues, unknownFields, normalizedFields };\n};\n/* eslint-enable max-lines-per-function, complexity */\n\n/**\n * Build validation metadata from field validation results, omitting empty arrays.\n *\n * @param fieldValidation - Result from {@link validateFields} containing validation issues\n * @returns Validation metadata object, or undefined if there are no issues\n */\nexport const buildValidationMetadata = (\n  fieldValidation: FieldValidationResult,\n): ValidationMetadata | undefined => {\n  const entries = Object.entries({\n    missingFields: fieldValidation.missingFields,\n    typeErrors: fieldValidation.typeErrors,\n    invalidValues: fieldValidation.invalidValues,\n    unknownFields: fieldValidation.unknownFields,\n  }).filter(([, v]) => Array.isArray(v) && v.length > 0);\n\n  return entries.length > 0 ? Object.fromEntries(entries) : undefined;\n};\n","import {\n  callBackendMethod,\n  createConsoleBackend,\n  type LogBackend,\n  type LogPayload,\n} from './backend';\nimport {\n  DEFAULT_MAX_ACTIVE_CORRELATIONS,\n  DEFAULT_MAX_CONTEXT_KEYS,\n  DEFAULT_MAX_FORK_DEPTH,\n  DEFAULT_REQUIRED_LEVELS,\n  FORK_ID_SEPARATOR,\n  LOG_LEVELS,\n  type LogLevel,\n  ROOT_FORK_ID,\n} from './constants';\nimport { type ContextRecord, ContextStore, type ContextValidationResult } from './context';\nimport { ChroniclerError } from './errors';\nimport {\n  type CorrelationAutoEvents,\n  type CorrelationEventGroup,\n  defineCorrelationGroup,\n  type EventDefinition,\n  type EventFields,\n  type EventRecord,\n} from './events';\nimport { assertNoReservedKeys } from './reserved';\nimport { buildValidationMetadata, sanitizeLogFields, validateFields } from './validation';\n\nexport interface ChroniclerLimits {\n  readonly maxContextKeys?: number;\n  /**\n   * Maximum fork nesting depth. A depth of N means N levels of nesting\n   * from root (e.g. depth 3 allows root → child → grandchild → great-grandchild).\n   * Defaults to {@link DEFAULT_MAX_FORK_DEPTH}.\n   */\n  readonly maxForkDepth?: number;\n  readonly maxActiveCorrelations?: number;\n}\n\nexport interface ChroniclerConfig {\n  readonly backend?: LogBackend;\n  readonly metadata: ContextRecord;\n  readonly correlationIdGenerator?: () => string;\n  readonly limits?: ChroniclerLimits;\n  /**\n   * When `true`, throws a `ChroniclerError` with code `FIELD_VALIDATION`\n   * for field validation errors (missing required fields, type mismatches).\n   * Useful for CI/CD enforcement. Defaults to `false`.\n   */\n  readonly strict?: boolean;\n  /**\n   * Minimum log level to emit. Events below this level are silently dropped.\n   * Uses priority ordering: fatal(0) > critical(1) > ... > trace(8).\n   * Defaults to `'trace'` (all events emitted).\n   */\n  readonly minLevel?: LogLevel;\n}\n\ninterface ResolvedLimits {\n  readonly maxContextKeys: number;\n  readonly maxForkDepth: number;\n  readonly maxActiveCorrelations: number;\n}\n\ninterface ResolvedChroniclerConfig {\n  readonly backend: LogBackend;\n  readonly limits: ResolvedLimits;\n  readonly minLevel: number;\n  readonly strict?: boolean | undefined;\n}\n\nexport interface Chronicler {\n  /** Emit a typed event. Fields are validated against the event definition. */\n  event<E extends EventDefinition>(event: E, fields: EventFields<E>): void;\n\n  /**\n   * Untyped escape hatch — log at any level without a pre-defined event.\n   * Useful for incremental adoption or ad-hoc debugging.\n   */\n  log(level: LogLevel, message: string, fields?: Record<string, unknown>): void;\n\n  /** Add key-value context that is attached to all subsequent events. */\n  addContext(context: ContextRecord): ContextValidationResult;\n\n  /** Start a correlation — a logical unit of work with lifecycle events. */\n  startCorrelation(group: CorrelationEventGroup, metadata?: ContextRecord): CorrelationChronicle;\n\n  /** Create an isolated child chronicle that inherits context. */\n  fork(context?: ContextRecord): Chronicler;\n}\n\n/**\n * A correlation represents a logical unit of work with a defined lifecycle.\n *\n * Unlike a root Chronicler, a correlation:\n * - Has a single shared correlation ID for all events\n * - Has lifecycle events (start, complete, fail, timeout)\n * - Can timeout if not completed within the configured duration\n * - Cannot start nested correlations (use fork() for parallel work within a correlation)\n */\nexport interface CorrelationChronicle {\n  /** Emit a typed event within this correlation. */\n  event<E extends EventDefinition>(event: E, fields: EventFields<E>): void;\n\n  /**\n   * Untyped escape hatch — log at any level without a pre-defined event.\n   * Useful for incremental adoption or ad-hoc debugging.\n   */\n  log(level: LogLevel, message: string, fields?: Record<string, unknown>): void;\n\n  /** Add key-value context that is attached to all subsequent events. */\n  addContext(context: ContextRecord): ContextValidationResult;\n\n  /** Create an isolated child chronicle that inherits context. */\n  fork(context?: ContextRecord): Chronicler;\n\n  /** Mark the correlation as successfully completed. Emits the `.complete` event. */\n  complete(fields?: Record<string, unknown>): void;\n\n  /** Mark the correlation as failed. Emits the `.fail` event at error level. */\n  fail(error?: unknown, fields?: Record<string, unknown>): void;\n\n  /** Mark the correlation as timed out. Called automatically by the timer. */\n  timeout(): void;\n}\n\ninterface BuildPayloadArgs {\n  readonly contextStore: ContextStore;\n  readonly eventDef: EventDefinition;\n  readonly fields: Record<string, unknown>;\n  readonly currentCorrelationId: () => string;\n  readonly forkId: string;\n  readonly strict?: boolean | undefined;\n}\n\n/**\n * Build a complete log payload from event definition and runtime data.\n * @internal\n * @param args - Payload construction arguments including context, event, and fields\n * @returns Assembled log payload ready for backend emission\n */\nconst buildPayload = (args: BuildPayloadArgs): LogPayload => {\n  const fieldValidation = validateFields(args.eventDef, args.fields);\n\n  if (args.strict) {\n    const issues: string[] = [];\n    if (fieldValidation.missingFields.length > 0) {\n      issues.push(`missing required fields: ${fieldValidation.missingFields.join(', ')}`);\n    }\n    if (fieldValidation.typeErrors.length > 0) {\n      issues.push(`type errors on fields: ${fieldValidation.typeErrors.join(', ')}`);\n    }\n    if (fieldValidation.invalidValues.length > 0) {\n      issues.push(`invalid values on fields: ${fieldValidation.invalidValues.join(', ')}`);\n    }\n    if (issues.length > 0) {\n      throw new ChroniclerError(\n        'FIELD_VALIDATION',\n        `Event \"${args.eventDef.key}\" failed validation: ${issues.join('; ')}`,\n      );\n    }\n  }\n\n  const validationMetadata = buildValidationMetadata(fieldValidation);\n\n  return {\n    eventKey: args.eventDef.key,\n    fields: fieldValidation.normalizedFields,\n    correlationId: args.currentCorrelationId(),\n    forkId: args.forkId,\n    metadata: args.contextStore.snapshot(),\n    timestamp: new Date().toISOString(),\n    ...(validationMetadata ? { _validation: validationMetadata } : {}),\n  };\n};\n\n/** Compute fork nesting depth from a dotted fork ID. */\nconst forkDepthFromId = (forkId: string): number =>\n  forkId === ROOT_FORK_ID ? 0 : forkId.split(FORK_ID_SEPARATOR).length;\n\n/**\n * Derive the next child fork ID and enforce depth limits.\n * @throws {ChroniclerError} `FORK_DEPTH_EXCEEDED` if the new depth exceeds maxDepth\n */\nconst nextForkId = (parentForkId: string, counter: number, maxDepth: number): string => {\n  const childForkId =\n    parentForkId === ROOT_FORK_ID\n      ? String(counter)\n      : `${parentForkId}${FORK_ID_SEPARATOR}${counter}`;\n  const depth = forkDepthFromId(childForkId);\n  if (depth > maxDepth) {\n    throw new ChroniclerError(\n      'FORK_DEPTH_EXCEEDED',\n      `Fork depth ${depth} exceeds maximum allowed depth of ${maxDepth}`,\n    );\n  }\n  return childForkId;\n};\n\ninterface ChronicleHooks {\n  readonly onActivity?: () => void;\n}\n\ntype NormalizedCorrelationGroup = Omit<CorrelationEventGroup, 'events' | 'timeout'> & {\n  readonly timeout: number;\n  readonly events: EventRecord & CorrelationAutoEvents;\n};\n\n/** Guard: returns true if the group has already been processed by defineCorrelationGroup. */\nconst isAlreadyNormalized = (group: CorrelationEventGroup): group is NormalizedCorrelationGroup =>\n  typeof group.timeout === 'number' && group.events !== undefined && 'start' in group.events;\n\n/** Normalize a correlation group, skipping if already processed to avoid collision false-positives. */\nconst resolveCorrelationGroup = (group: CorrelationEventGroup): NormalizedCorrelationGroup =>\n  isAlreadyNormalized(group)\n    ? group\n    : (defineCorrelationGroup(group) as NormalizedCorrelationGroup);\n\ninterface ChronicleInstanceArgs {\n  readonly config: ResolvedChroniclerConfig;\n  readonly contextStore: ContextStore;\n  /** Returns the current correlation ID for this chronicle. */\n  readonly currentCorrelationId: () => string;\n  /** Creates NEW correlation IDs for startCorrelation(). */\n  readonly correlationIdGenerator: () => string;\n  readonly forkId: string;\n  readonly hooks?: ChronicleHooks;\n  readonly activeCorrelations?: { count: number };\n}\n\n// eslint-disable-next-line max-lines-per-function -- Accepted deviation: object-literal constructor, splitting reduces readability\nconst createChronicleInstance = (args: ChronicleInstanceArgs): Chronicler => {\n  const {\n    config,\n    contextStore,\n    currentCorrelationId,\n    correlationIdGenerator,\n    forkId,\n    hooks = {},\n    activeCorrelations = { count: 0 },\n  } = args;\n  /** Monotonically increasing counter for generating unique child fork IDs. */\n  let forkCounter = 0;\n\n  return {\n    event(eventDef, fields) {\n      if (LOG_LEVELS[eventDef.level] > config.minLevel) return;\n      const payload = buildPayload({\n        contextStore,\n        eventDef,\n        // Deliberate type erasure: EventFields<E> → Record<string, unknown>\n        fields: fields as Record<string, unknown>,\n        currentCorrelationId,\n        forkId,\n        strict: config.strict,\n      });\n      callBackendMethod(config.backend, eventDef.level, eventDef.message, payload);\n      hooks.onActivity?.();\n    },\n    log(level, message, fields = {}) {\n      if (LOG_LEVELS[level] > config.minLevel) return;\n      const payload: LogPayload = {\n        eventKey: '',\n        fields: sanitizeLogFields(fields),\n        correlationId: currentCorrelationId(),\n        forkId,\n        metadata: contextStore.snapshot(),\n        timestamp: new Date().toISOString(),\n      };\n      callBackendMethod(config.backend, level, message, payload);\n      hooks.onActivity?.();\n    },\n    addContext(context) {\n      return contextStore.add(context);\n    },\n    fork(extraContext = {}) {\n      forkCounter++;\n      const childForkId = nextForkId(forkId, forkCounter, config.limits.maxForkDepth);\n      const forkStore = new ContextStore(contextStore.snapshot(), config.limits.maxContextKeys);\n      const forkChronicle = createChronicleInstance({\n        config,\n        contextStore: forkStore,\n        currentCorrelationId,\n        correlationIdGenerator,\n        forkId: childForkId,\n        hooks,\n        activeCorrelations,\n      });\n      if (Object.keys(extraContext).length > 0) {\n        forkChronicle.addContext(extraContext);\n      }\n      return forkChronicle;\n    },\n    startCorrelation(group, metadata = {}) {\n      if (activeCorrelations.count >= config.limits.maxActiveCorrelations) {\n        throw new ChroniclerError(\n          'CORRELATION_LIMIT_EXCEEDED',\n          `Active correlation limit of ${config.limits.maxActiveCorrelations} exceeded`,\n        );\n      }\n      const definedGroup = resolveCorrelationGroup(group);\n      activeCorrelations.count++;\n      const correlationStore = new ContextStore(\n        contextStore.snapshot(),\n        config.limits.maxContextKeys,\n      );\n      if (Object.keys(metadata).length > 0) {\n        correlationStore.add(metadata);\n      }\n      const correlationId = correlationIdGenerator();\n      return new CorrelationChronicleImpl({\n        config,\n        group: definedGroup,\n        contextStore: correlationStore,\n        currentCorrelationId: () => correlationId,\n        correlationIdGenerator,\n        forkId,\n        activeCorrelations,\n      });\n    },\n  };\n};\n\n/**\n * Auto-reset timeout for correlation groups.\n * Resets on any activity; invokes callback if idle for the configured duration.\n */\nexport class CorrelationTimer {\n  private timeoutId: NodeJS.Timeout | undefined;\n\n  constructor(\n    private readonly timeout: number,\n    private readonly onTimeout: () => void,\n  ) {}\n\n  start(): void {\n    this.clear();\n    if (this.timeout > 0) {\n      this.timeoutId = setTimeout(this.onTimeout, this.timeout);\n      this.timeoutId.unref();\n    }\n  }\n\n  /** Reset the timer (keep-alive on activity). */\n  touch(): void {\n    this.start();\n  }\n\n  clear(): void {\n    if (this.timeoutId !== undefined) {\n      clearTimeout(this.timeoutId);\n      this.timeoutId = undefined;\n    }\n  }\n}\n\ninterface CorrelationChronicleArgs {\n  readonly config: ResolvedChroniclerConfig;\n  readonly group: NormalizedCorrelationGroup;\n  readonly contextStore: ContextStore;\n  readonly currentCorrelationId: () => string;\n  readonly correlationIdGenerator: () => string;\n  readonly forkId: string;\n  readonly activeCorrelations?: { count: number };\n}\n\nclass CorrelationChronicleImpl implements CorrelationChronicle {\n  private readonly config: ResolvedChroniclerConfig;\n  private readonly contextStore: ContextStore;\n  private readonly currentCorrelationId: () => string;\n  private readonly correlationIdGenerator: () => string;\n  private readonly forkId: string;\n  private readonly activeCorrelations: { count: number };\n  private readonly timer: CorrelationTimer;\n  private completed = false;\n  private readonly startedAt = Date.now();\n  private readonly autoEvents: CorrelationAutoEvents;\n  private forkCounter = 0;\n\n  constructor(args: CorrelationChronicleArgs) {\n    this.config = args.config;\n    this.contextStore = args.contextStore;\n    this.currentCorrelationId = args.currentCorrelationId;\n    this.correlationIdGenerator = args.correlationIdGenerator;\n    this.forkId = args.forkId;\n    this.activeCorrelations = args.activeCorrelations ?? { count: 0 };\n    this.timer = new CorrelationTimer(args.group.timeout, () => this.timeout());\n    this.autoEvents = args.group.events as CorrelationAutoEvents;\n    this.timer.start();\n    this.emitAutoEvent(this.autoEvents.start, {});\n  }\n\n  event<E extends EventDefinition>(eventDef: E, fields: EventFields<E>): void {\n    if (this.completed) return;\n    if (LOG_LEVELS[eventDef.level] > this.config.minLevel) return;\n    const payload = buildPayload({\n      contextStore: this.contextStore,\n      eventDef,\n      // Deliberate type erasure: EventFields<E> → Record<string, unknown>\n      fields: fields as Record<string, unknown>,\n      currentCorrelationId: this.currentCorrelationId,\n      forkId: this.forkId,\n      strict: this.config.strict,\n    });\n    callBackendMethod(this.config.backend, eventDef.level, eventDef.message, payload);\n    this.timer.touch();\n  }\n\n  log(level: LogLevel, message: string, fields: Record<string, unknown> = {}): void {\n    if (this.completed) return;\n    if (LOG_LEVELS[level] > this.config.minLevel) return;\n    const payload: LogPayload = {\n      eventKey: '',\n      fields: sanitizeLogFields(fields),\n      correlationId: this.currentCorrelationId(),\n      forkId: this.forkId,\n      metadata: this.contextStore.snapshot(),\n      timestamp: new Date().toISOString(),\n    };\n    callBackendMethod(this.config.backend, level, message, payload);\n    this.timer.touch();\n  }\n\n  addContext(context: ContextRecord): ContextValidationResult {\n    return this.contextStore.add(context);\n  }\n\n  fork(extraContext: ContextRecord = {}): Chronicler {\n    this.forkCounter++;\n    const childForkId = nextForkId(this.forkId, this.forkCounter, this.config.limits.maxForkDepth);\n    const forkStore = new ContextStore(\n      this.contextStore.snapshot(),\n      this.config.limits.maxContextKeys,\n    );\n\n    const forkChronicle = createChronicleInstance({\n      config: this.config,\n      contextStore: forkStore,\n      currentCorrelationId: this.currentCorrelationId,\n      correlationIdGenerator: this.correlationIdGenerator,\n      forkId: childForkId,\n      hooks: { onActivity: () => this.timer.touch() },\n      activeCorrelations: this.activeCorrelations,\n    });\n\n    if (Object.keys(extraContext).length > 0) {\n      forkChronicle.addContext(extraContext);\n    }\n\n    return forkChronicle;\n  }\n\n  complete(fields: Record<string, unknown> = {}): void {\n    if (!this.finalize()) return;\n    this.emitAutoEvent(this.autoEvents.complete, {\n      duration: Date.now() - this.startedAt,\n      ...fields,\n    });\n  }\n\n  fail(error?: unknown, fields: Record<string, unknown> = {}): void {\n    if (!this.finalize()) return;\n    this.emitAutoEvent(this.autoEvents.fail, {\n      duration: Date.now() - this.startedAt,\n      error,\n      ...fields,\n    });\n  }\n\n  timeout(): void {\n    if (!this.finalize()) return;\n    this.emitAutoEvent(this.autoEvents.timeout, {});\n  }\n\n  /** Mark correlation as done: decrement counter, clear timer. Returns false if already completed. */\n  private finalize(): boolean {\n    if (this.completed) return false;\n    this.activeCorrelations.count--;\n    this.completed = true;\n    this.timer.clear();\n    return true;\n  }\n\n  private emitAutoEvent(eventDef: EventDefinition, fields: Record<string, unknown>): void {\n    if (LOG_LEVELS[eventDef.level] > this.config.minLevel) return;\n    const payload = buildPayload({\n      contextStore: this.contextStore,\n      eventDef,\n      fields,\n      currentCorrelationId: this.currentCorrelationId,\n      forkId: this.forkId,\n      strict: this.config.strict,\n    });\n    callBackendMethod(this.config.backend, eventDef.level, eventDef.message, payload);\n  }\n}\n\n/** Validate and resolve user-provided config into fully-resolved internal config. */\nconst resolveChroniclerConfig = (\n  config: ChroniclerConfig,\n  // eslint-disable-next-line complexity -- config resolution requires checking all option paths\n): { resolved: ResolvedChroniclerConfig; correlationIdGenerator: () => string } => {\n  const resolvedBackend = config.backend ?? createConsoleBackend();\n\n  const missingLevels = DEFAULT_REQUIRED_LEVELS.filter(\n    (level) => typeof resolvedBackend[level] !== 'function',\n  );\n  if (missingLevels.length > 0) {\n    throw new ChroniclerError(\n      'UNSUPPORTED_LOG_LEVEL',\n      `Log backend is missing level(s): ${missingLevels.join(', ')}. A valid backend must implement all 9 levels: ${DEFAULT_REQUIRED_LEVELS.join(', ')}. Use createBackend() for automatic fallback handling.`,\n    );\n  }\n\n  const reservedMetadata = assertNoReservedKeys(config.metadata);\n  if (reservedMetadata.length > 0) {\n    throw new ChroniclerError(\n      'RESERVED_FIELD',\n      `Reserved fields cannot be used in metadata: ${reservedMetadata.join(', ')}`,\n    );\n  }\n\n  const resolvedLimits: ResolvedLimits = {\n    maxContextKeys: config.limits?.maxContextKeys ?? DEFAULT_MAX_CONTEXT_KEYS,\n    maxForkDepth: config.limits?.maxForkDepth ?? DEFAULT_MAX_FORK_DEPTH,\n    maxActiveCorrelations: config.limits?.maxActiveCorrelations ?? DEFAULT_MAX_ACTIVE_CORRELATIONS,\n  };\n\n  return {\n    resolved: {\n      backend: resolvedBackend,\n      limits: resolvedLimits,\n      minLevel: LOG_LEVELS[config.minLevel ?? 'trace'],\n      strict: config.strict,\n    },\n    correlationIdGenerator: config.correlationIdGenerator ?? (() => crypto.randomUUID()),\n  };\n};\n\n/**\n * Create a root Chronicler instance.\n *\n * This is the main entry point for the library. The returned `Chronicler`\n * can log events, add context, start correlations, and create forks.\n *\n * @param config - Chronicler configuration with optional backend, metadata, and optional correlation settings\n * @returns A configured `Chronicler` instance\n * @throws {ChroniclerError} `UNSUPPORTED_LOG_LEVEL` if the backend is missing required methods\n * @throws {ChroniclerError} `RESERVED_FIELD` if `config.metadata` contains reserved field names\n */\nexport const createChronicle = (config: ChroniclerConfig): Chronicler => {\n  const { resolved, correlationIdGenerator } = resolveChroniclerConfig(config);\n  const baseContextStore = new ContextStore(config.metadata, resolved.limits.maxContextKeys);\n\n  return createChronicleInstance({\n    config: resolved,\n    contextStore: baseContextStore,\n    currentCorrelationId: () => '',\n    correlationIdGenerator,\n    forkId: ROOT_FORK_ID,\n    /** Shared mutable counter tracking uncompleted correlations for limit enforcement. */\n    activeCorrelations: { count: 0 },\n  });\n};\n"]}

package/dist/index.d.cts

@@ -0,0 +1,427 @@
+/**
+ * Global constants used throughout Chronicler
+ */
+/**
+ * Log level priority mapping
+ * Lower numbers = higher priority/severity
+ */
+declare const LOG_LEVELS: {
+    readonly fatal: 0;
+    readonly critical: 1;
+    readonly alert: 2;
+    readonly error: 3;
+    readonly warn: 4;
+    readonly audit: 5;
+    readonly info: 6;
+    readonly debug: 7;
+    readonly trace: 8;
+};
+/**
+ * Union of all valid log level names, derived from {@link LOG_LEVELS}.
+ */
+type LogLevel = keyof typeof LOG_LEVELS;
+
+/**
+ * Field type definitions with compile-time type safety
+ */
+/**
+ * Field builder with compile-time type inference
+ */
+interface FieldBuilder<T extends string, R extends boolean> {
+    readonly _type: T;
+    readonly _required: R;
+    readonly _doc: string | undefined;
+}
+/**
+ * Field builder with optional marker
+ */
+interface OptionalFieldBuilder<T extends string> extends FieldBuilder<T, false> {
+    readonly doc: (description: string) => OptionalFieldBuilder<T>;
+}
+/**
+ * Field builder with required marker (default)
+ */
+interface RequiredFieldBuilder<T extends string> extends FieldBuilder<T, true> {
+    readonly optional: () => OptionalFieldBuilder<T>;
+    readonly doc: (description: string) => RequiredFieldBuilder<T>;
+}
+/**
+ * Field type builders — use these to define fields in events.
+ *
+ * @example
+ * ```typescript
+ * const event = defineEvent({
+ *   key: 'user.created',
+ *   level: 'info',
+ *   message: 'User created',
+ *   fields: {
+ *     userId: field.string().doc('User ID'),
+ *     age: field.number().optional().doc('User age'),
+ *     isActive: field.boolean(),
+ *     error: field.error().optional(),
+ *   },
+ * });
+ * ```
+ */
+declare const field: {
+    readonly string: () => RequiredFieldBuilder<"string">;
+    readonly number: () => RequiredFieldBuilder<"number">;
+    readonly boolean: () => RequiredFieldBuilder<"boolean">;
+    readonly error: () => RequiredFieldBuilder<"error">;
+};
+/**
+ * Utility type to simplify intersections
+ */
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/**
+ * Infer the TypeScript type from a field builder
+ */
+type InferFieldType<F> = F extends FieldBuilder<infer T, boolean> ? T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : T extends 'error' ? Error | string : never : never;
+/**
+ * Build required fields object
+ */
+type BuildRequired<F extends Record<string, FieldBuilder<string, boolean>>> = {
+    [K in keyof F as F[K]['_required'] extends true ? K : never]: InferFieldType<F[K]>;
+};
+/**
+ * Build optional fields object
+ */
+type BuildOptional<F extends Record<string, FieldBuilder<string, boolean>>> = {
+    [K in keyof F as F[K]['_required'] extends false ? K : never]?: InferFieldType<F[K]>;
+};
+/**
+ * Infer complete field types from field builders
+ * Required fields become required properties, optional fields become optional
+ */
+type InferFields<F extends Record<string, FieldBuilder<string, boolean>>> = Simplify<BuildRequired<F> & BuildOptional<F>>;
+
+/**
+ * Event definition with compile-time type safety
+ */
+interface EventDefinition<Key extends string = string, Fields extends Record<string, FieldBuilder<string, boolean>> = Record<string, FieldBuilder<string, boolean>>> {
+    readonly key: Key;
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly doc?: string;
+    readonly fields?: Fields;
+}
+/**
+ * Helper to extract field types from an event definition
+ */
+type EventFields<E> = E extends EventDefinition<string, infer F> ? F extends Record<string, FieldBuilder<string, boolean>> ? InferFields<F> : Record<string, never> : never;
+type EventRecord = Record<string, EventDefinition<string, Record<string, FieldBuilder<string, boolean>>>>;
+interface SystemEventGroup {
+    readonly key: string;
+    readonly type: 'system';
+    readonly doc?: string;
+    readonly events?: EventRecord;
+    readonly groups?: Record<string, SystemEventGroup | CorrelationEventGroup>;
+}
+interface CorrelationEventGroup {
+    readonly key: string;
+    readonly type: 'correlation';
+    readonly doc?: string;
+    readonly timeout?: number;
+    readonly events?: EventRecord;
+    readonly groups?: Record<string, SystemEventGroup | CorrelationEventGroup>;
+}
+/** Field definitions for auto-generated correlation lifecycle events. */
+declare const correlationAutoFields: {
+    start: {};
+    complete: {
+        duration: OptionalFieldBuilder<"number">;
+    };
+    fail: {
+        duration: OptionalFieldBuilder<"number">;
+        error: OptionalFieldBuilder<"error">;
+    };
+    timeout: {};
+};
+type CorrelationAutoEvents = {
+    [Key in keyof typeof correlationAutoFields]: EventDefinition<string, (typeof correlationAutoFields)[Key]>;
+};
+type WithAutoEvents<Event extends EventRecord | undefined> = (Event extends EventRecord ? Event : Record<never, EventDefinition<string, Record<string, FieldBuilder<string, boolean>>>>) & CorrelationAutoEvents;
+/**
+ * Define an event with compile-time type safety.
+ *
+ * `as const` is **not required** — `defineEvent` uses TypeScript `const` generic
+ * parameters (TS 5.0+), so literal types and field builders are narrowed automatically.
+ * You may still add `as const` if you prefer, but it has no effect.
+ *
+ * @example
+ * ```typescript
+ * const userCreated = defineEvent({
+ *   key: 'user.created',
+ *   level: 'info',
+ *   message: 'User created',
+ *   doc: 'Emitted when a new user is created',
+ *   fields: {
+ *     userId: field.string().doc('User ID'),
+ *     email: field.string(),
+ *     age: field.number().optional(),
+ *   },
+ * });
+ * ```
+ *
+ * @param event - Event definition with key, level, message, optional doc and fields
+ * @returns The same event definition, typed for compile-time inference
+ * @throws {Error} If the event key does not match the required dotted camelCase format
+ */
+declare const defineEvent: <const Key extends string, const Fields extends Record<string, FieldBuilder<string, boolean>>>(event: EventDefinition<Key, Fields>) => EventDefinition<Key, Fields>;
+/**
+ * Define a system or correlation event group for organizational purposes.
+ *
+ * Groups provide a namespace hierarchy for events. For correlation groups,
+ * prefer {@link defineCorrelationGroup} which adds automatic lifecycle events.
+ *
+ * @param group - Event group definition (system or correlation)
+ * @returns The same group definition, typed for compile-time inference
+ */
+declare const defineEventGroup: <Group extends SystemEventGroup | CorrelationEventGroup>(group: Group) => Group;
+/**
+ * Define a correlation event group with automatic lifecycle events
+ *
+ * **What is a correlation group?**
+ * A correlation represents a logical unit of work with a defined lifecycle
+ * (start, complete, timeout). Common examples: HTTP requests, batch jobs, workflows.
+ *
+ * **Automatic events added:**
+ * - `{key}.start` - Emitted when startCorrelation() is called
+ * - `{key}.complete` - Emitted when complete() is called (includes duration)
+ * - `{key}.fail` - Emitted when fail() is called (includes duration and error)
+ * - `{key}.timeout` - Emitted if no activity within timeout period
+ *
+ * **Timeout behavior:**
+ * - Defaults to 5 minutes (300,000ms) if not specified
+ * - Timer resets on ANY activity (log events, fork creation)
+ * - Set to 0 to disable timeout
+ *
+ * **Type safety:**
+ * TypeScript will infer all event keys and field types. The return type
+ * includes both your events and the auto-generated lifecycle events.
+ *
+ * @param group - Correlation group definition
+ * @returns Normalized group with auto-events and default timeout
+ *
+ * @example
+ * ```typescript
+ * const requestGroup = defineCorrelationGroup({
+ *   key: 'api.request',
+ *   doc: 'HTTP request lifecycle',
+ *   timeout: 30_000, // 30 seconds
+ *   events: {
+ *     validated: defineEvent({
+ *       key: 'api.request.validated',
+ *       level: 'debug',
+ *       message: 'Request validated',
+ *       doc: 'Validation passed',
+ *     }),
+ *     processed: defineEvent({
+ *       key: 'api.request.processed',
+ *       level: 'info',
+ *       message: 'Request processed',
+ *       doc: 'Processing complete',
+ *       fields: { statusCode: { type: 'number', required: true } },
+ *     }),
+ *   },
+ * });
+ *
+ * // Auto-events available:
+ * // - requestGroup.events.start
+ * // - requestGroup.events.complete
+ * // - requestGroup.events.timeout
+ * // - requestGroup.events.validated (your event)
+ * // - requestGroup.events.processed (your event)
+ * ```
+ */
+declare const defineCorrelationGroup: <Group extends CorrelationEventGroup>(group: Group) => Omit<Group, "events" | "timeout"> & {
+    events: WithAutoEvents<Group["events"]>;
+    timeout: number;
+};
+
+interface ValidationMetadata {
+    readonly missingFields?: string[];
+    readonly typeErrors?: string[];
+    readonly invalidValues?: string[];
+    readonly unknownFields?: string[];
+}
+
+interface LogPayload {
+    readonly eventKey: string;
+    readonly fields: Record<string, unknown>;
+    readonly correlationId: string;
+    readonly forkId: string;
+    readonly metadata: Record<string, unknown>;
+    readonly timestamp: string;
+    readonly _validation?: ValidationMetadata;
+}
+type LogBackend = Record<LogLevel, (message: string, payload: LogPayload) => void>;
+/**
+ * Create a zero-config backend that logs to the console.
+ *
+ * Maps each of the 9 Chronicler levels to the appropriate `console` method:
+ * fatal/critical/alert/error → `console.error`, warn → `console.warn`,
+ * audit/info → `console.info`, debug/trace → `console.debug`.
+ *
+ * @returns A fully populated LogBackend using console methods for all levels
+ */
+declare const createConsoleBackend: () => LogBackend;
+/**
+ * Create a backend from a partial set of handlers.
+ *
+ * For each missing level, the fallback chain is tried in order (e.g. `fatal` →
+ * `critical` → `error` → `warn` → `info`). If no fallback is provided either,
+ * the corresponding `console` method is used.
+ *
+ * @param partial - Partial backend with handlers for a subset of log levels
+ * @returns A fully populated LogBackend with fallbacks applied for missing levels
+ */
+declare const createBackend: (partial: Partial<LogBackend>) => LogBackend;
+/**
+ * A routing rule that pairs a backend with an optional filter.
+ *
+ * When `filter` is omitted the backend receives all events.
+ * When provided, the backend only receives events for which `filter` returns `true`.
+ */
+interface BackendRoute {
+    readonly backend: LogBackend;
+    readonly filter?: (level: LogLevel, payload: LogPayload) => boolean;
+}
+/**
+ * Create a backend that routes events to multiple backends based on filter rules.
+ *
+ * Each route pairs a backend with an optional filter function. Events are
+ * dispatched to every route whose filter matches (or to all routes without a
+ * filter). This enables splitting logs into separate streams — for example,
+ * maintenance/debug logs to stdout and audit events to a dedicated store.
+ *
+ * @param routes - One or more backend routes with optional filters
+ * @returns A single LogBackend that fans out to the matching routes
+ * @throws {Error} If no routes are provided
+ *
+ * @example
+ * ```typescript
+ * const router = createRouterBackend([
+ *   { backend: consoleBackend, filter: (level, payload) => !payload.eventKey.startsWith('audit.') },
+ *   { backend: auditBackend,   filter: (level, payload) => payload.eventKey.startsWith('audit.') },
+ * ]);
+ *
+ * const chronicle = createChronicle({ backend: router, metadata: { appName: 'my-app' } });
+ * ```
+ */
+declare const createRouterBackend: (routes: BackendRoute[]) => LogBackend;
+
+type ContextValue = string | number | boolean | null;
+type ContextRecord = Record<string, ContextValue>;
+interface ContextCollisionDetail {
+    readonly key: string;
+    readonly existingValue: ContextValue;
+    readonly attemptedValue: ContextValue;
+}
+interface ContextValidationResult {
+    readonly reserved: string[];
+    readonly collisionDetails: ContextCollisionDetail[];
+    readonly dropped: string[];
+}
+
+interface ChroniclerLimits {
+    readonly maxContextKeys?: number;
+    /**
+     * Maximum fork nesting depth. A depth of N means N levels of nesting
+     * from root (e.g. depth 3 allows root → child → grandchild → great-grandchild).
+     * Defaults to {@link DEFAULT_MAX_FORK_DEPTH}.
+     */
+    readonly maxForkDepth?: number;
+    readonly maxActiveCorrelations?: number;
+}
+interface ChroniclerConfig {
+    readonly backend?: LogBackend;
+    readonly metadata: ContextRecord;
+    readonly correlationIdGenerator?: () => string;
+    readonly limits?: ChroniclerLimits;
+    /**
+     * When `true`, throws a `ChroniclerError` with code `FIELD_VALIDATION`
+     * for field validation errors (missing required fields, type mismatches).
+     * Useful for CI/CD enforcement. Defaults to `false`.
+     */
+    readonly strict?: boolean;
+    /**
+     * Minimum log level to emit. Events below this level are silently dropped.
+     * Uses priority ordering: fatal(0) > critical(1) > ... > trace(8).
+     * Defaults to `'trace'` (all events emitted).
+     */
+    readonly minLevel?: LogLevel;
+}
+interface Chronicler {
+    /** Emit a typed event. Fields are validated against the event definition. */
+    event<E extends EventDefinition>(event: E, fields: EventFields<E>): void;
+    /**
+     * Untyped escape hatch — log at any level without a pre-defined event.
+     * Useful for incremental adoption or ad-hoc debugging.
+     */
+    log(level: LogLevel, message: string, fields?: Record<string, unknown>): void;
+    /** Add key-value context that is attached to all subsequent events. */
+    addContext(context: ContextRecord): ContextValidationResult;
+    /** Start a correlation — a logical unit of work with lifecycle events. */
+    startCorrelation(group: CorrelationEventGroup, metadata?: ContextRecord): CorrelationChronicle;
+    /** Create an isolated child chronicle that inherits context. */
+    fork(context?: ContextRecord): Chronicler;
+}
+/**
+ * A correlation represents a logical unit of work with a defined lifecycle.
+ *
+ * Unlike a root Chronicler, a correlation:
+ * - Has a single shared correlation ID for all events
+ * - Has lifecycle events (start, complete, fail, timeout)
+ * - Can timeout if not completed within the configured duration
+ * - Cannot start nested correlations (use fork() for parallel work within a correlation)
+ */
+interface CorrelationChronicle {
+    /** Emit a typed event within this correlation. */
+    event<E extends EventDefinition>(event: E, fields: EventFields<E>): void;
+    /**
+     * Untyped escape hatch — log at any level without a pre-defined event.
+     * Useful for incremental adoption or ad-hoc debugging.
+     */
+    log(level: LogLevel, message: string, fields?: Record<string, unknown>): void;
+    /** Add key-value context that is attached to all subsequent events. */
+    addContext(context: ContextRecord): ContextValidationResult;
+    /** Create an isolated child chronicle that inherits context. */
+    fork(context?: ContextRecord): Chronicler;
+    /** Mark the correlation as successfully completed. Emits the `.complete` event. */
+    complete(fields?: Record<string, unknown>): void;
+    /** Mark the correlation as failed. Emits the `.fail` event at error level. */
+    fail(error?: unknown, fields?: Record<string, unknown>): void;
+    /** Mark the correlation as timed out. Called automatically by the timer. */
+    timeout(): void;
+}
+/**
+ * Create a root Chronicler instance.
+ *
+ * This is the main entry point for the library. The returned `Chronicler`
+ * can log events, add context, start correlations, and create forks.
+ *
+ * @param config - Chronicler configuration with optional backend, metadata, and optional correlation settings
+ * @returns A configured `Chronicler` instance
+ * @throws {ChroniclerError} `UNSUPPORTED_LOG_LEVEL` if the backend is missing required methods
+ * @throws {ChroniclerError} `RESERVED_FIELD` if `config.metadata` contains reserved field names
+ */
+declare const createChronicle: (config: ChroniclerConfig) => Chronicler;
+
+type ChroniclerErrorCode = 'UNSUPPORTED_LOG_LEVEL' | 'RESERVED_FIELD' | 'BACKEND_METHOD' | 'FORK_DEPTH_EXCEEDED' | 'CORRELATION_LIMIT_EXCEEDED' | 'FIELD_VALIDATION';
+/**
+ * Typed error class for Chronicler configuration and runtime failures.
+ * Uses a discriminator `code` to identify the specific error category.
+ */
+declare class ChroniclerError extends Error {
+    readonly code: ChroniclerErrorCode;
+    /**
+     * @param code - Machine-readable error category discriminator
+     * @param message - Human-readable description of the error
+     */
+    constructor(code: ChroniclerErrorCode, message: string);
+}
+
+export { type BackendRoute, type Chronicler, type ChroniclerConfig, ChroniclerError, type ChroniclerErrorCode, type ChroniclerLimits, type ContextCollisionDetail, type ContextRecord, type ContextValidationResult, type CorrelationChronicle, type CorrelationEventGroup, type EventDefinition, type EventFields, type FieldBuilder, type InferFieldType, type InferFields, type LogBackend, type LogLevel, type LogPayload, type SystemEventGroup, createBackend, createChronicle, createConsoleBackend, createRouterBackend, defineCorrelationGroup, defineEvent, defineEventGroup, field };