@wildo-ai/saas-models 1.1.2 → 1.1.4

package/dist/esm/resources/resources.shared.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.shared.utils.js","sourceRoot":"","sources":["../../../../src/resources/resources.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,2BAA2B,EAE3B,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,4BAA4B,EAAE,MAAM,sDAAsD,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAqB,MAAM,qCAAqC,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,kCAAkC,EAClC,sCAAsC,EACtC,qCAAqC,EAIrC,yBAAyB,EACzB,kBAAkB,EAClB,8BAA8B,EAC9B,iDAAiD,EACjD,qBAAqB,EACrB,iCAAiC,EAEjC,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAOlB,mCAAmC,GAGpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAE5D,OAAO,EAAE,qCAAqC,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAyCvH;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAU,0CAA0C,GAAG,0BAA0B,CAAC;IAChG;;;;OAIG;IACK,MAAM,CAAU,4CAA4C,GAAG,mBAAmB,CAAC;IAEnF,MAAM,CAAC,wBAAwB,CAAC,OAAe;QACrD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,KAA8B,CAAC,IAAI,GAAG,SAAS,CAAC,aAAa,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,0CAA0C,CACvD,IAAmC,EACnC,KAAoC;QAEpC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IAEO,MAAM,CAAC,qCAAqC,CAClD,SAAkB;QAElB,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,SAAmD,CAAC;QAEtE,OAAO,CACL,OAAO,SAAS,CAAC,qBAAqB,KAAK,QAAQ;YACnD,CACE,SAAS,CAAC,mBAAmB,KAAK,UAAU;gBAC5C,SAAS,CAAC,mBAAmB,KAAK,6BAA6B;gBAC/D,SAAS,CAAC,mBAAmB,KAAK,wBAAwB,CAC3D;YACD,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAA4B,CAAC;YAClF,SAAS,CAAC,qBAAqB,KAAK,UAAU;YAC9C,kCAAkC,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO;YACxE,qCAAqC,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO;YAC9E,CACE,SAAS,CAAC,eAAe,KAAK,SAAS;gBACvC,2BAA2B,CAAC,SAAS,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,OAAO,CACzE,CACF,CAAC;IACJ,CAAC;IAGD,+EAA+E;IAC/E,sBAAsB;IACtB,+EAA+E;IAE/E;;OAEG;IACK,MAAM,CAAU,iBAAiB,GAAG,mBAAmB,CAAC;IAEhE;;;OAGG;IACK,MAAM,CAAU,YAAY,GAAG,+EAA+E,CAAC;IAEvH;;;OAGG;IACK,MAAM,CAAU,eAAe,GAAG,wFAAwF,CAAC;IAEnI,+EAA+E;IAC/E,uBAAuB;IACvB,+EAA+E;IAE/E;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,CAAC,EAAU;QAC1B,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzC,OAAO,qBAAqB,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,EAAU;QACtB,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzC,OAAO,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAU;QACxB,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzC,OAAO,qBAAqB,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAc,CAAC,EAAU;QAC9B,IAAI,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,OAAO,gBAAgB,CAAC,SAAS,CAAC;QAC5E,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,iBAAiB,CAAC,EAAU;QACjC,OAAO,qBAAqB,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,0BAA0B,CAAC,EAAU,EAAE,MAAwB;QACpE,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,gBAAgB,CAAC,SAAS;gBAC7B,OAAO,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC9C,KAAK,gBAAgB,CAAC,IAAI;gBACxB,OAAO,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1C,KAAK,gBAAgB,CAAC,oBAAoB;gBACxC,OAAO,qBAAqB,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;YAC1D,KAAK,gBAAgB,CAAC,yBAAyB;gBAC7C,OAAO,qBAAqB,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;YAChE;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,sBAAsB,CAAC,EAAU;QACtC,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzC,OAAO,4BAA4B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,4BAA4B,CAAC,EAAU;QAC5C,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzC,OAAO,4BAA4B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,qBAAqB,CAAC,EAAW,EAAE,YAAoB,IAAI;QAChE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,0BAA0B,OAAO,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,iEAAiE,EAAE,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,0BAA0B;IAC1B,+EAA+E;IAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,MAAM,CAAC,iCAAiC,CACtC,YAGC,EACD,mBAAiC,EACjC,WAA4C,EAC5C,2BAA2F;QAE3F,MAAM,eAAe,GAAG,YAAY,CAAC,aAAa,KAAK,YAAY,CAAC,aAAa,CAAC;QAClF,MAAM,oBAAoB,GAAG,mBAAmB,KAAK,YAAY,CAAC,aAAa,CAAC;QAChF,MAAM,sBAAsB,GAAG,eAAe,IAAI,oBAAoB,CAAC;QAEvE,MAAM,2BAA2B,GAAG,CAAC,sBAAsB,IAAI,YAAY,CAAC,eAAe,CAAC;eACvF,2BAA2B,CAAC,mBAAmB,CAAC;eAChD,0BAA0B,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;QAE/E,OAAO;YACL,mBAAmB;YACnB,2BAA2B;YAC3B,eAAe,EAAE,qBAAqB,CAAC,WAAW,CAAC;gBACjD,CAAC,CAAC,0BAA0B,CAAC,eAAe,CAAC,2BAA2B,CAAC;gBACzE,CAAC,CAAC,0BAA0B,CAAC,cAAc,CAAC,2BAA2B,CAAC;YAC1E,UAAU,EAAE,sBAAsB,IAAI,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC;SAC5E,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,4CAA4C,CACjD,YAGC,EACD,mBAAiC,EACjC,2BAA2F;QAE3F,IAAI,YAAY,CAAC,aAAa,KAAK,mBAAmB,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,iCAAiC,CAC3C,YAAY,EACZ,YAAY,CAAC,aAAa,EAC1B,YAAY,CAAC,YAAY,EACzB,2BAA2B,CAC5B,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,CAAC,aAAa,KAAK,mBAAmB,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,iCAAiC,CAC3C,YAAY,EACZ,YAAY,CAAC,aAAa,EAC1B,YAAY,CAAC,YAAY,EACzB,2BAA2B,CAC5B,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CACb,6DAA6D,mBAAmB,KAAK;YACrF,oBAAoB,YAAY,CAAC,aAAa,OAAO,YAAY,CAAC,aAAa,uCAAuC,CACvH,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,qCAAqC,CAC1C,YAA2E,EAC3E,mBAAiC;QAEjC,IAAI,YAAY,CAAC,aAAa,KAAK,mBAAmB,IAAI,YAAY,CAAC,aAAa,KAAK,mBAAmB,EAAE,CAAC;YAC7G,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,YAAY,CAAC,aAAa,KAAK,mBAAmB,EAAE,CAAC;YACvD,OAAO,eAAe,CAAC;QACzB,CAAC;QACD,IAAI,YAAY,CAAC,aAAa,KAAK,mBAAmB,EAAE,CAAC;YACvD,OAAO,eAAe,CAAC;QACzB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,uCAAuC,CAC5C,YAA+F,EAC/F,OAGC;QAED,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC;QACvC,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC;QACvC,MAAM,EAAE,GAAG,YAAY,CAAC,eAAe,CAAC;QAExC,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACtD,IAAI,QAAQ,IAAI,CAAC,QAAQ;gBAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,CAAC;YAC3F,IAAI,QAAQ,IAAI,CAAC,QAAQ;gBAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,CAAC;YAE3F,gFAAgF;YAChF,IAAI,OAAO,CAAC,2BAA2B,CAAC,GAAG,CAAC,KAAK,EAAE;gBAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,CAAC;YACrH,IAAI,OAAO,CAAC,2BAA2B,CAAC,GAAG,CAAC,KAAK,EAAE;gBAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,CAAC;QACvH,CAAC;QAED,6EAA6E;QAC7E,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,qCAAqC,CAAC,KAQ5C;QACC,MAAM,6BAA6B,GAA2B,EAAE,CAAC;QACjE,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC9D,KAAK,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC;YAChG,MAAM,QAAQ,GAAG,6BAA6B,CAAC,eAAe,CAAC,CAAC;YAChE,IAAI,QAAQ,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC1C,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;oBACjD,sBAAsB,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACnE,CAAC;gBACD,sBAAsB,CAAC,GAAG,CAAC,eAAe,CAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACjE,CAAC;YACD,6BAA6B,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;QAChE,CAAC;QAED,MAAM,mBAAmB,GAAG,CAAC,YAAoB,EAAE,SAAiB,EAAW,EAAE;YAC/E,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YAC1B,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;QAC1F,CAAC,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,eAAe;gBAAE,SAAS;YACnC,MAAM,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,GAAG,qBAAqB,CAAC,uCAAuC,CAClH,GAAG,EACH,EAAE,2BAA2B,EAAE,KAAK,CAAC,2BAA2B,EAAE,mBAAmB,EAAE,CACxF,CAAC;YACF,MAAM,YAAY,GAAG,6BAA6B,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACxE,IAAI,YAAY,IAAI,YAAY,KAAK,sBAAsB,EAAE,CAAC;gBAC5D,MAAM,WAAW,GAAG,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBACpE,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;oBAC9F,SAAS;gBACX,CAAC;gBACD,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;gBAC7D,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC/G,IAAI,cAAc,IAAI,qCAAqC,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC5E,SAAS;gBACX,CAAC;gBACD,KAAK,CAAC,qBAAqB,EAAE,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC,CAAC;gBAC9G,SAAS;YACX,CAAC;YACD,6BAA6B,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,sBAAsB,CAAC;QAC9E,CAAC;QAED,KAAK,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,CAAC;YACrF,IAAI,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,6BAA6B,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC;YACzD,CAAC;QACH,CAAC;QACD,OAAO,6BAA6B,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,mCAAmC,CAAC,KAI1C;QACC,MAAM,UAAU,GAAuD,EAAE,CAAC;QAC1E,KAAK,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;YACrF,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7D,IAAI,CAAC,iBAAiB,CAAC,WAA2B,CAAC;oBAAE,SAAS;gBAC9D,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,SAAS,CAAC,EAAE,CAAC;oBACpD,UAAU,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,mCAAmC,CACxC,YAGC;QAED,IAAI,YAAY,CAAC,aAAa,KAAK,YAAY,CAAC,aAAa,EAAE,CAAC;YAC9D,OAAO,YAAY,CAAC,aAAa,CAAC;QACpC,CAAC;QAED,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACxE,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAExE,IAAI,iBAAiB,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5C,OAAO,YAAY,CAAC,aAAa,CAAC;QACpC,CAAC;QACD,IAAI,iBAAiB,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5C,OAAO,YAAY,CAAC,aAAa,CAAC;QACpC,CAAC;QAED,OAAO,YAAY,CAAC,aAAa,CAAC;IACpC,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qCAAqC,CAC1C,eAAuB,EACvB,kBAA0B,EAC1B,aAA+G;QAE/G,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,GAAG,CAAC,eAAe,KAAK,eAAe;gBAAE,SAAS;YACtD,IAAI,GAAG,CAAC,aAAa,KAAK,kBAAkB;gBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;iBAC5E,IAAI,GAAG,CAAC,aAAa,KAAK,kBAAkB;gBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,+CAA+C,CAAC,OAMtD;QACC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC5D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAClE,MAAM,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,KAAK,kBAAkB,CAAC,CAAC;QACxF,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,OAAO,OAAO,CAAC,wBAAwB,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE;YAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;YAC9D,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACtC,OAAQ,mCAAmC,CAAC,KAAK,CAAY,KAAK,OAAO,CAAC,kBAAkB,CAAC;QAC/F,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,0BAA0B,CAAC,kBAA0B,EAAE,iBAAyB;QACrF,OAAO,GAAG,kBAAkB,IAAI,iBAAiB,EAAE,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,+BAA+B,CACpC,aAAiH,EACjH,2BAAmD;QAEnD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmC,CAAC;QAEvD,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,KAAa,EAAE,QAAgB,EAAE,QAAgB,EAAE,OAAe,EAAQ,EAAE;YAC1G,MAAM,GAAG,GAAG,IAAI,CAAC,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,QAAQ,IAAI,QAAQ,CAAC,oBAAoB,KAAK,QAAQ,EAAE,CAAC;gBAC3D,MAAM,IAAI,CAAC,wBAAwB,CACjC,4CAA4C,MAAM,gBAAgB,KAAK,UAAU;oBACjF,IAAI,QAAQ,CAAC,oBAAoB,UAAU,QAAQ,gCAAgC;oBACnF,qFAAqF;oBACrF,0BAA0B,CAC3B,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;QACnG,CAAC,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,iBAAiB,CAAC;YACvC,IAAI,CAAC,QAAQ;gBAAE,SAAS,CAAkC,0CAA0C;YACpG,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC;YAChC,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC;YAChC,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ;gBAAE,SAAS,CAAG,qCAAqC;YAC/F,IAAI,KAAK,KAAK,KAAK;gBAAE,SAAS,CAA4B,+CAA+C;YACzG,MAAM,OAAO,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO;gBAAE,SAAS,CAAuB,sDAAsD;YAEhH,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,mCAAmC,CACxC,wBAAoD,EACpD,kBAA0B,EAC1B,sBAA2C;QAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,wBAAwB,EAAE,CAAC;YACvD,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,WAAW,GAAG,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YAC/E,IAAI,WAAW,KAAK,kBAAkB;gBAAE,SAAS;YACjD,IAAI,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACtD,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,wCAAwC,CAC7C,MAAsC,EACtC,iBAAyB;QAEzB,OAAO,GAAG,iDAAiD,CAAC,MAAM,CAAC,GAAG,iBAAiB,EAAE,CAAC;IAC5F,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,wCAAwC,CAC7C,mBAA2B;QAE3B,IAAI,mBAAmB,CAAC,UAAU,CAAC,iDAAiD,CAAC,8BAA8B,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1H,OAAO;gBACL,MAAM,EAAE,8BAA8B,CAAC,GAAG;gBAC1C,iBAAiB,EAAE,mBAAmB,CAAC,KAAK,CAC1C,iDAAiD,CAAC,8BAA8B,CAAC,GAAG,CAAC,CAAC,MAAM,CAC7F;aACF,CAAC;QACJ,CAAC;QAED,IAAI,mBAAmB,CAAC,UAAU,CAAC,iDAAiD,CAAC,8BAA8B,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC5H,OAAO;gBACL,MAAM,EAAE,8BAA8B,CAAC,KAAK;gBAC5C,iBAAiB,EAAE,mBAAmB,CAAC,KAAK,CAC1C,iDAAiD,CAAC,8BAA8B,CAAC,KAAK,CAAC,CAAC,MAAM,CAC/F;aACF,CAAC;QACJ,CAAC;QAED,IAAI,mBAAmB,CAAC,UAAU,CAAC,iDAAiD,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7H,OAAO;gBACL,MAAM,EAAE,8BAA8B,CAAC,MAAM;gBAC7C,iBAAiB,EAAE,mBAAmB,CAAC,KAAK,CAC1C,iDAAiD,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,MAAM,CAChG;aACF,CAAC;QACJ,CAAC;QAED,IAAI,mBAAmB,CAAC,UAAU,CAAC,iDAAiD,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC3H,OAAO;gBACL,MAAM,EAAE,8BAA8B,CAAC,IAAI;gBAC3C,iBAAiB,EAAE,mBAAmB,CAAC,KAAK,CAC1C,iDAAiD,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC,MAAM,CAC9F;aACF,CAAC;QACJ,CAAC;QAED,IAAI,mBAAmB,CAAC,UAAU,CAAC,iDAAiD,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7H,OAAO;gBACL,MAAM,EAAE,8BAA8B,CAAC,MAAM;gBAC7C,iBAAiB,EAAE,mBAAmB,CAAC,KAAK,CAC1C,iDAAiD,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,MAAM,CAChG;aACF,CAAC;QACJ,CAAC;QAED,IAAI,mBAAmB,CAAC,UAAU,CAAC,iDAAiD,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC9H,OAAO;gBACL,MAAM,EAAE,8BAA8B,CAAC,OAAO;gBAC9C,iBAAiB,EAAE,mBAAmB,CAAC,KAAK,CAC1C,iDAAiD,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,MAAM,CACjG;aACF,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,+CAA+C,CAAC,SAAiB;QACtE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACtB,MAAM,qBAAqB,CAAC,wBAAwB,CAAC,oEAAoE,CAAC,CAAC;QAC7H,CAAC;QACD,OAAO,GAAG,qBAAqB,CAAC,0CAA0C,GAAG,SAAS,EAAE,CAAC;IAC3F,CAAC;IAED,MAAM,CAAC,+CAA+C,CACpD,mBAA2B;QAE3B,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,qBAAqB,CAAC,0CAA0C,CAAC,EAAE,CAAC;YACtG,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,KAAK,CACzC,qBAAqB,CAAC,0CAA0C,CAAC,MAAM,CACxE,CAAC;QACF,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,iDAAiD,CAAC,yBAAiC;QACxF,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,qBAAqB,CAAC,wBAAwB,CAClD,wFAAwF,CACzF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,qBAAqB,CAAC,4CAA4C,GAAG,yBAAyB,EAAE,CAAC;IAC7G,CAAC;IAED,MAAM,CAAC,iDAAiD,CACtD,mBAA2B;QAE3B,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,qBAAqB,CAAC,4CAA4C,CAAC,EAAE,CAAC;YACxG,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,yBAAyB,GAAG,mBAAmB,CAAC,KAAK,CACzD,qBAAqB,CAAC,4CAA4C,CAAC,MAAM,CAC1E,CAAC;QACF,OAAO,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,qCAAqC,CAC1C,YAA+F,EAC/F,2BAA2F;QAE3F,IAAI,YAAY,CAAC,eAAe,EAAE,CAAC;YACjC,OAAO;gBACL,kBAAkB,EAAE,YAAY,CAAC,aAAa;gBAC9C,iBAAiB,EAAE,YAAY,CAAC,aAAa;gBAC7C,eAAe,EAAE,YAAY,CAAC,eAAe;gBAC7C,UAAU,EAAE,IAAI;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,2BAA2B,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QAChF,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,4CAA4C,YAAY,CAAC,aAAa,OAAO,YAAY,CAAC,aAAa,IAAI;gBAC3G,+DAA+D,YAAY,CAAC,aAAa,+CAA+C,CACzI,CAAC;QACJ,CAAC;QAED,OAAO;YACL,kBAAkB,EAAE,YAAY,CAAC,aAAa;YAC9C,iBAAiB,EAAE,YAAY,CAAC,aAAa;YAC7C,eAAe;YACf,UAAU,EAAE,KAAK;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,wCAAwC,CAC7C,YAA+F,EAC/F,2BAA2F;QAE3F,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,qCAAqC,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;QAC/F,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,gDAAgD,CACrD,YAAkC,EAClC,mBAAiC;QAEjC,IAAI,YAAY,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACrC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,qCAAqC,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;QAClG,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,oCAAoC,CAAC,YAAY,CAAC,CAAC;QAE1E,qDAAqD;QACrD,IACE,SAAS,CAAC,MAAM,KAAK,kBAAkB,CAAC,SAAS;YACjD,WAAW,KAAK,eAAe,EAC/B,CAAC;YACD,OAAO;gBACL,8BAA8B,CAAC,GAAG;gBAClC,8BAA8B,CAAC,KAAK;aACrC,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,IACE,SAAS,CAAC,MAAM,KAAK,kBAAkB,CAAC,WAAW;YACnD,WAAW,KAAK,eAAe;YAC/B,IAAI,CAAC,uCAAuC,CAAC,YAAY,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACxF,CAAC;YACD,OAAO,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC;QAED,yEAAyE;QACzE,6BAA6B;QAC7B,IACE,SAAS,CAAC,MAAM,KAAK,kBAAkB,CAAC,WAAW;YACnD,YAAY,CAAC,iBAAiB,EAC9B,CAAC;YACD,OAAO;gBACL,8BAA8B,CAAC,IAAI;gBACnC,8BAA8B,CAAC,MAAM;gBACrC,8BAA8B,CAAC,OAAO;aACvC,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,yBAAyB,CAC9B,YAA6D;QAE7D,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,wBAAwB,CACjC,2DAA2D;gBAC3D,sGAAsG,CACvG,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,YAAY,CAAC,MAAM;YAC3B,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,iCAAiC,CAC9C,MAA0B,EAC1B,eAA8C;QAE9C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,kBAAkB,CAAC,WAAW;gBACjC,OAAO,eAAe,EAAE,MAAM,EAAE,MAAM;oBACpC,CAAC,CAAC,qBAAqB,CAAC,QAAQ;oBAChC,CAAC,CAAC,qBAAqB,CAAC,cAAc,CAAC;YAC3C,KAAK,kBAAkB,CAAC,WAAW;gBACjC,OAAO,eAAe,EAAE,MAAM,EAAE,MAAM;oBACpC,CAAC,CAAC,qBAAqB,CAAC,oBAAoB;oBAC5C,CAAC,CAAC,qBAAqB,CAAC,cAAc,CAAC;YAC3C,KAAK,kBAAkB,CAAC,SAAS,CAAC;YAClC;gBACE,OAAO,qBAAqB,CAAC,cAAc,CAAC;QAChD,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,kCAAkC,CAAC,MAIjD;QAIC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK;gBAChC,MAAM,EAAE,UAAU;aACnB,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC3C,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,iCAAiC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC;gBACpF,MAAM,EAAE,6BAA6B;aACtC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,qBAAqB,CAAC,cAAc;YAC3C,MAAM,EAAE,wBAAwB;SACjC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,4BAA4B,CACjC,YAGC,EACD,2BAA4F;QAE5F,MAAM,cAAc,GAAG,IAAI,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC;QACpE,MAAM,qBAAqB,GAAG,YAAY,CAAC,eAAe;YACxD,CAAC,CAAC,2BAA2B,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC;YACjE,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI;YACpC,CAAC,CAAC,sCAAsC,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC;YACjE,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,CAAC,oCAAoC,CACvC,YAAY,EACZ,cAAc,CAAC,MAAM,EACrB,qBAAqB,EACrB,YAAY,CACb,CAAC;QAEF,MAAM,uBAAuB,GAAG,IAAI,CAAC,kCAAkC,CAAC;YACtE,MAAM,EAAE,cAAc,CAAC,MAAM;YAC7B,eAAe,EAAE,qBAAqB;YACtC,YAAY;SACb,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,kCAAkC,CACtD,cAAc,CAAC,MAAM,EACrB,qBAAqB,EACrB,uBAAuB,CAAC,KAAK,CAC9B,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,qCAAqC,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;QAE1G,OAAO;YACL,MAAM,EAAE,cAAc,CAAC,MAAM;YAC7B,qBAAqB,EAAE,cAAc,CAAC,MAAM;YAC5C,mBAAmB,EAAE,uBAAuB,CAAC,MAAM;YACnD,QAAQ;YACR,WAAW;YACX,eAAe,EAAE,qBAAqB;SACvC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,uCAAuC,CAC5C,YAAkC,EAClC,SAAgC;QAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,oCAAoC,CAAC,YAAY,CAAC,CAAC;QAE1E,IACE,SAAS,CAAC,QAAQ,CAAC,YAAY,KAAK,oBAAoB,CAAC,gBAAgB;YACzE,SAAS,CAAC,QAAQ,CAAC,iBAAiB,KAAK,yBAAyB,CAAC,IAAI,EACvE,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,CACL,SAAS,KAAK,qBAAqB,CAAC,MAAM;YAC1C,SAAS,KAAK,qBAAqB,CAAC,WAAW,CAChD;YACC,CAAC,CAAC,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ;YAC7C,CAAC,CAAC,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,mCAAmC,CAAC,YAAkC;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,oCAAoC,CAAC,YAAY,CAAC,CAAC;QAE1E,IACE,SAAS,CAAC,QAAQ,CAAC,YAAY,KAAK,oBAAoB,CAAC,gBAAgB;YACzE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,qBAAqB,CAAC,cAAc,EACtE,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,gDAAgD,CACrD,YAAkC;QAElC,MAAM,SAAS,GAAG,IAAI,CAAC,oCAAoC,CAAC,YAAY,CAAC,CAAC;QAE1E,IAAI,SAAS,CAAC,QAAQ,CAAC,kBAAkB,KAAK,0BAA0B,CAAC,WAAW,EAAE,CAAC;YACrF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC,eAAe,EAAE,SAAS,EAAE,cAAc,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,gDAAgD,CACrD,YAAkC;QAElC,MAAM,SAAS,GAAG,IAAI,CAAC,oCAAoC,CAAC,YAAY,CAAC,CAAC;QAE1E,IAAI,SAAS,CAAC,QAAQ,CAAC,kBAAkB,KAAK,0BAA0B,CAAC,WAAW,EAAE,CAAC;YACrF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC,eAAe,EAAE,SAAS,EAAE,cAAc,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,8BAA8B,CACnC,YAA6C,EAC7C,2BAA4F;QAE5F,OAAO;YACL,GAAG,YAAY;YACf,iBAAiB,EAAE,IAAI,CAAC,4BAA4B,CAAC,YAAY,EAAE,2BAA2B,CAAC;SAChG,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,0BAA0B,CAC/B,YAAoE,EACpE,2BAA4F;QAE5F,MAAM,oBAAoB,GAAG,IAAI,CAAC,8BAA8B,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;QAE5G,IACE,mBAAmB,IAAI,YAAY;YACnC,IAAI,CAAC,qCAAqC,CAAC,YAAY,CAAC,iBAAiB,CAAC;YAC1E,IAAI,CAAC,0CAA0C,CAC7C,YAAY,CAAC,iBAAiB,EAC9B,oBAAoB,CAAC,iBAAiB,CACvC,EACD,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,IACE,CAAC,2BAA2B;YAC5B,mBAAmB,IAAI,YAAY;YACnC,IAAI,CAAC,qCAAqC,CAAC,YAAY,CAAC,iBAAiB,CAAC;YAC1E,YAAY,CAAC,iBAAiB,CAAC,WAAW,CAAC,UAAU;YACrD,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,WAAW,CAAC,UAAU,EAC9D,CAAC;YACD,OAAO;gBACL,GAAG,oBAAoB;gBACvB,iBAAiB,EAAE;oBACjB,GAAG,oBAAoB,CAAC,iBAAiB;oBACzC,WAAW,EAAE,YAAY,CAAC,iBAAiB,CAAC,WAAW;iBACxD;aACF,CAAC;QACJ,CAAC;QAED,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,2BAA2B,CAChC,aAAkF,EAClF,2BAA4F;QAE5F,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CACxC,IAAI,CAAC,0BAA0B,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,iCAAiC,CAOtC,qBAA6C,EAC7C,2BAA4F;QAM5F,OAAO;YACL,mBAAmB,EAAE,IAAI,CAAC,2BAA2B,CACnD,qBAAqB,CAAC,mBAAmB,IAAI,EAAE,EAC/C,2BAA2B,CAC5B;YACD,kBAAkB,EAAE,IAAI,CAAC,2BAA2B,CAClD,qBAAqB,CAAC,kBAAkB,IAAI,EAAE,EAC9C,2BAA2B,CAC5B;YACD,iBAAiB,EAAE,IAAI,CAAC,2BAA2B,CACjD,qBAAqB,CAAC,iBAAiB,IAAI,EAAE,EAC7C,2BAA2B,CAC5B;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,oCAAoC,CACzC,YAAkC;QAElC,IAAI,CAAC,IAAI,CAAC,qCAAqC,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAChF,MAAM,IAAI,KAAK,CACb,kEAAkE;gBAClE,sFAAsF,CACvF,CAAC;QACJ,CAAC;QAED,OAAO,YAAY,CAAC,iBAAiB,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gCAAgC,CACrC,YAG4D;QAE5D,OAAO,IAAI,CAAC,qCAAqC,CAAC,YAAY,CAAC,iBAAiB,CAAC;YAC/E,CAAC,CAAC,YAAY,CAAC,iBAAiB;YAChC,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACK,MAAM,CAAC,kCAAkC,CAC/C,MAA0B,EAC1B,eAA8C,EAC9C,iBAAyC;QAEzC,MAAM,YAAY,GAAiC;YACjD,YAAY,EAAE,oBAAoB,CAAC,gBAAgB;YACnD,iBAAiB,EAAE,yBAAyB,CAAC,IAAI;YACjD,kBAAkB,EAAE,0BAA0B,CAAC,WAAW;YAC1D,aAAa,EAAE,iBAAiB;YAChC,IAAI,EAAE;gBACJ,KAAK,EAAE,iBAAiB;aACzB;SACF,CAAC;QAEF,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,kBAAkB,CAAC,WAAW;gBACjC,YAAY,CAAC,YAAY,GAAG,oBAAoB,CAAC,eAAe,CAAC;gBACjE,YAAY,CAAC,iBAAiB,GAAG,yBAAyB,CAAC,iBAAiB,CAAC;gBAC7E,YAAY,CAAC,kBAAkB,GAAG,0BAA0B,CAAC,SAAS,CAAC;gBACvE,MAAM;YACR,KAAK,kBAAkB,CAAC,WAAW;gBACjC,YAAY,CAAC,YAAY,GAAG,oBAAoB,CAAC,kBAAkB,CAAC;gBACpE,YAAY,CAAC,iBAAiB,GAAG,yBAAyB,CAAC,mBAAmB,CAAC;gBAC/E,YAAY,CAAC,kBAAkB,GAAG,0BAA0B,CAAC,SAAS,CAAC;gBACvE,MAAM;YACR,KAAK,kBAAkB,CAAC,SAAS,CAAC;YAClC;gBACE,MAAM;QACV,CAAC;QAED,MAAM,YAAY,GAAG,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC;QACvD,MAAM,YAAY,GAAG,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC;QACvD,MAAM,iBAAiB,GAAG,eAAe,EAAE,SAAS,EAAE,cAAc,CAAC;QAErE,IAAI,YAAY,IAAI,YAAY,EAAE,CAAC;YACjC,YAAY,CAAC,QAAQ,GAAG;gBACtB,iBAAiB,EAAE,OAAO,CAAC,YAAY,CAAC;gBACxC,iBAAiB,EAAE,OAAO,CAAC,YAAY,CAAC;gBACxC,iBAAiB,EAAE,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;gBACrD,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,IAAI,CAAC,EAAE,YAAY,EAAE,QAAQ,IAAI,CAAC,CAAC;aAC7E,CAAC;QACJ,CAAC;QAED,IAAI,iBAAiB,EAAE,CAAC;YACtB,YAAY,CAAC,SAAS,GAAG;gBACvB,cAAc,EAAE;oBACd,OAAO,EAAE,iBAAiB,CAAC,OAAO;oBAClC,IAAI,EAAE,iBAAiB,CAAC,IAAI,IAAI,kBAAkB,CAAC,SAAS;oBAC5D,sFAAsF;oBACtF,0EAA0E;oBAC1E,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,IAAI,sBAAsB,CAAC,MAAM;oBACrE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;iBACrC;aACF,CAAC;QACJ,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACK,MAAM,CAAC,qCAAqC,CAClD,YAGC,EACD,2BAA4F;QAE5F,MAAM,kBAAkB,GAAG,2BAA2B;YACpD,CAAC,CAAC,IAAI,CAAC,wCAAwC,CAAC,YAAY,EAAE,2BAA2B,CAAC;YAC1F,CAAC,CAAC,YAAY,CAAC,eAAe;gBAC5B,CAAC,CAAC;oBACE,eAAe,EAAE,YAAY,CAAC,eAAe;iBAC9C;gBACH,CAAC,CAAC,SAAS,CAAC;QAEhB,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7E,MAAM,kBAAkB,GAAG,IAAI,CAAC,mCAAmC,CAAC,YAAY,CAAC,CAAC;QAClF,MAAM,cAAc,GAClB,qBAAqB,CAAC,YAAY,CAAC,YAAY,CAAC;YAChD,qBAAqB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAEnD,OAAO;YACL,UAAU,EAAE;gBACV,eAAe,EAAE,kBAAkB,CAAC,eAAe;gBACnD,kBAAkB;gBAClB,OAAO,EAAE,iBAAiB;gBAC1B,gBAAgB,EAAE,IAAI;gBACtB,QAAQ,EAAE,YAAY,CAAC,yBAAyB,KAAK,iCAAiC,CAAC,QAAQ;gBAC/F,MAAM,EAAE,CAAC,iBAAiB,IAAI,cAAc;aAC7C;SACF,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,oCAAoC,CACjD,YAAqG,EACrG,cAAkC,EAClC,eAA8C,EAC9C,YAA+C;QAE/C,MAAM,eAAe,GAAG,IAAI,CAAC,iCAAiC,CAC5D,cAAc,EACd,eAAe,CAChB,CAAC;QAEF,IAAI,cAAc,KAAK,kBAAkB,CAAC,WAAW,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC;YACzF,MAAM,IAAI,KAAK,CACb,mDAAmD;gBACnD,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,CAAC,iBAAiB,IAAI,YAAY,CAAC,MAAM,IAAI,cAAc,KAAK,kBAAkB,CAAC,WAAW,EAAE,CAAC;YAC/G,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QAED,IAAI,cAAc,KAAK,kBAAkB,CAAC,WAAW,IAAI,eAAe,EAAE,CAAC;YACzE,MAAM,yBAAyB,GAC7B,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,IAAI,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChF,MAAM,wBAAwB,GAC5B,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAE1C,IAAI,yBAAyB,IAAI,wBAAwB,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CACb,0GAA0G;oBAC1G,gHAAgH,CACjH,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,cAAc,KAAK,kBAAkB,CAAC,SAAS,IAAI,eAAe,EAAE,CAAC;YACvE,MAAM,qBAAqB,GACzB,eAAe,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;YAC9D,MAAM,uBAAuB,GAC3B,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,IAAI,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChF,MAAM,sBAAsB,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAE1C,IAAI,qBAAqB,IAAI,uBAAuB,IAAI,sBAAsB,EAAE,CAAC;gBAC/E,MAAM,IAAI,KAAK,CACb,+FAA+F;oBAC/F,yFAAyF,CAC1F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,IACE,YAAY,CAAC,KAAK,KAAK,qBAAqB,CAAC,QAAQ;gBACrD,cAAc,KAAK,kBAAkB,CAAC,WAAW,EACjD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,qDAAqD,CACtD,CAAC;YACJ,CAAC;YAED,IACE,YAAY,CAAC,KAAK,KAAK,qBAAqB,CAAC,oBAAoB;gBACjE,cAAc,KAAK,kBAAkB,CAAC,WAAW,EACjD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;YACJ,CAAC;YAED,IACE,eAAe,EAAE,MAAM,EAAE,MAAM;gBAC/B,YAAY,CAAC,KAAK,KAAK,eAAe,EACtC,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,iFAAiF;oBACjF,yFAAyF,CAC1F,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,2CAA2C,CAChD,YAAiG;QAEjG,IAAI,YAAY,CAAC,iBAAiB,IAAI,YAAY,CAAC,aAAa,KAAK,YAAY,CAAC,aAAa,EAAE,CAAC;YAChG,MAAM,IAAI,KAAK,CACb,4FAA4F;gBAC5F,oGAAoG,CACrG,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,kCAAkC,CACvC,aAAqD;QAErD,OAAO,OAAO,CACZ,aAAa,EAAE,kBAAkB;YACjC,aAAa,CAAC,MAAM;YACpB,aAAa,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAChC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,mCAAmC,CACxC,YAAuE;QAEvE,OAAO,OAAO,CACZ,IAAI,CAAC,kCAAkC,CAAC,YAAY,CAAC,aAAa,CAAC;YACnE,YAAY,CAAC,SAAS,CACvB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,gCAAgC,CACrC,QAAW,EACX,aAAqD;QAErD,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC,aAAa,CAAC,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;QAC9D,OAAO,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,6BAA6B,CAClC,YAAuE,EACvE,cAAoC,EACpC,UAAmD,EAAE;QAErD,MAAM,EACJ,uBAAuB,GAAG,SAAS,EACnC,gBAAgB,GAAG,OAAO,GAC3B,GAAG,OAAO,CAAC;QAEZ,MAAM,aAAa,GAAG,IAAI,CAAC,mCAAmC,CAAC,YAAY,CAAC,CAAC;QAC7E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,aAAa,CAAC,CAAC,CAAC,uBAAuB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,CAAC;QAED,IAAI,IAAI,CAAC,kCAAkC,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;YACxE,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,cAAc,EAAE,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;gBACvF,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,YAAY,CAAC,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC5C,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;oBACnC,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kCAAkC,CACvC,aAAkB,EAClB,cAAoC,EACpC,OAAiD;QAEjD,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAC3C,IAAI,CAAC,6BAA6B,CAAC,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC,CAC1E,CAAC;IACJ,CAAC","sourcesContent":["/**\n * Resources Shared Utils\n *\n * Cross-layer resource helpers shared by backend, frontend, and shared-model\n * consumers. This includes ID helpers plus runtime relationship activation\n * evaluation.\n */\n\nimport {\n  ChildOperationsConfigSchema,\n  type ChildOperationsConfig_Parsed,\n  ChildLifecycleMode,\n  ChildLifecycleStrategy,\n} from './child-operations.shared.schemas';\nimport { HTTP_API_RESOURCE_ID_CHARSET } from '../http-api-binding/http-api-binding-id.shared.utils';\nimport { ResourcesConfigNamingUtils } from './utils/resources-config-naming.utils';\nimport { CoreResourceOperation, type ResourceType } from './resources.shared.core.definitions';\nimport {\n  RelationshipDtoModel,\n  RelationshipLifecycleModel,\n  RelationshipHandlingContractSchema,\n  RelationshipHandlingReadSettingsSchema,\n  RelationshipPersistenceContractSchema,\n  type RelationshipHandlingReadSettings,\n  type RelationshipHandlingContract,\n  type RelationshipPersistenceContract,\n  RelationshipMutationModel,\n  RelationshipNature,\n  ResourceRelationshipBulkAction,\n  ResourceRelationshipBulkOperationIdentifierPrefix,\n  RelationshipReadModel,\n  ResourceParentResourceRequirement,\n  type ResolvedRelationshipReadCalculationMode,\n  ResourceIdFormat,\n  isOneToOneCardinality,\n  isArrayCardinality,\n  type ResolvedRelationshipNatureCalculationMode,\n  type ResolvedRelationshipSemantics,\n  type ResourceRelationship,\n  type ResourceRelationshipDeclaration,\n  type ResourceRelationshipCardinality,\n  type ResourcePrimaryScope,\n  PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE,\n  type ManyToManyScopeJunction,\n  type ManyToManyScopeJunctionMap,\n} from './resources.shared.schemas';\nimport { ErrorType } from '../errors/errors.shared.schemas';\nimport type { PolymorphicFkVariant } from '@wildo-ai/zod-decorators';\nimport { getDiscriminatedPolymorphicForeignKey, getZodObjectShape, isForeignKeyField } from '@wildo-ai/zod-decorators';\nimport type { z } from 'zod';\n\nexport type RelationshipActivationConditionErrorMode = 'throw' | 'exclude';\nexport type RelationshipActivationMissingParentMode = 'include' | 'exclude';\n\nexport interface RelationshipActivationEvaluationOptions {\n  /**\n   * Behavior when the evaluator is asked to resolve a conditional relationship\n   * without parent data.\n   *\n   * - `exclude`: fail closed until parent data is available\n   * - `include`: treat the missing parent as non-blocking\n   */\n  onMissingParentResource?: RelationshipActivationMissingParentMode;\n\n  /**\n   * Behavior when a function-based relationship condition throws.\n   *\n   * Backend callers typically use `throw` so bugs propagate normally.\n   * Frontend callers may use `exclude` to fail safe without crashing the UI.\n   */\n  onConditionError?: RelationshipActivationConditionErrorMode;\n}\n\nexport interface ResolvedRelationshipForeignKeyIdentity {\n  parentResourceType: ResourceType;\n  childResourceType: ResourceType;\n  fieldIdentifier: string;\n  isExplicit: boolean;\n}\n\nexport interface ResolvedRelationshipObjectIdentity {\n  relatedResourceType: ResourceType;\n  relationshipIdentifierField: string;\n  objectFieldName: string;\n  isExplicit: boolean;\n}\n\nexport type RelationshipResourcePerspective = 'resourceType1' | 'resourceType2';\n\n/**\n * Database-agnostic Resource ID utilities\n *\n * Supports both MongoDB ObjectId (24-char hex) and PostgreSQL UUID formats.\n * Used across the entire stack for ID validation and format detection.\n */\nexport class Resources_SharedUtils {\n  private static readonly GENERATED_FILE_REGENERATE_OPERATION_PREFIX = 'pdfTemplates:regenerate:';\n  /**\n   * Namespace for the derived export companion of a LIST/SEARCH operation. Prefixed, like its\n   * sibling above, so a derived identifier can never collide with an authored custom operation and a\n   * reader can tell at a glance that nobody wrote it by hand.\n   */\n  private static readonly GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX = 'collectionExport:';\n\n  private static createConfigurationError(message: string): Error {\n    const error = new Error(message);\n    (error as { type?: ErrorType }).type = ErrorType.CONFIGURATION;\n    return error;\n  }\n\n  private static areResolvedRelationshipSemanticsEquivalent(\n    left: ResolvedRelationshipSemantics,\n    right: ResolvedRelationshipSemantics\n  ): boolean {\n    return JSON.stringify(left) === JSON.stringify(right);\n  }\n\n  private static hasValidResolvedRelationshipSemantics(\n    semantics: unknown\n  ): semantics is ResolvedRelationshipSemantics {\n    if (!semantics || typeof semantics !== 'object') {\n      return false;\n    }\n\n    const candidate = semantics as Partial<ResolvedRelationshipSemantics>;\n\n    return (\n      typeof candidate.natureCalculationMode === 'string' &&\n      (\n        candidate.readCalculationMode === 'explicit' ||\n        candidate.readCalculationMode === 'legacy_nested_read_fallback' ||\n        candidate.readCalculationMode === 'default_reference_only'\n      ) &&\n      Object.values(RelationshipNature).includes(candidate.nature as RelationshipNature) &&\n      candidate.natureCalculationMode === 'explicit' &&\n      RelationshipHandlingContractSchema.safeParse(candidate.handling).success &&\n      RelationshipPersistenceContractSchema.safeParse(candidate.persistence).success &&\n      (\n        candidate.childOperations === undefined ||\n        ChildOperationsConfigSchema.safeParse(candidate.childOperations).success\n      )\n    );\n  }\n\n\n  // ============================================================================\n  // Validation Patterns\n  // ============================================================================\n\n  /**\n   * MongoDB ObjectId pattern: exactly 24 hexadecimal characters\n   */\n  private static readonly OBJECT_ID_PATTERN = /^[a-fA-F0-9]{24}$/;\n\n  /**\n   * UUID pattern: 8-4-4-4-12 format with dashes\n   * Accepts any UUID version (v1, v4, etc.)\n   */\n  private static readonly UUID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;\n\n  /**\n   * UUID v4 pattern: stricter validation for version 4 UUIDs\n   * Position 13 must be '4', position 17 must be '8', '9', 'a', or 'b'\n   */\n  private static readonly UUID_V4_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$/;\n\n  // ============================================================================\n  // Validation Functions\n  // ============================================================================\n\n  /**\n   * Validates if a string is a valid MongoDB ObjectId format\n   * @param id - String to validate\n   * @returns true if the string is a valid 24-character hexadecimal ObjectId\n   * \n   * @example\n   * Resources_SharedUtils.isObjectId('507f1f77bcf86cd799439011') // true\n   * Resources_SharedUtils.isObjectId('invalid') // false\n   * Resources_SharedUtils.isObjectId('550e8400-e29b-41d4-a716-446655440000') // false (this is UUID)\n   */\n  static isObjectId(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return Resources_SharedUtils.OBJECT_ID_PATTERN.test(id);\n  }\n\n  /**\n   * Validates if a string is a valid UUID format (any version)\n   * @param id - String to validate\n   * @returns true if the string is a valid UUID with dashes\n   * \n   * @example\n   * Resources_SharedUtils.isUUID('550e8400-e29b-41d4-a716-446655440000') // true\n   * Resources_SharedUtils.isUUID('507f1f77bcf86cd799439011') // false (this is ObjectId)\n   * Resources_SharedUtils.isUUID('not-a-uuid') // false\n   */\n  static isUUID(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return Resources_SharedUtils.UUID_PATTERN.test(id);\n  }\n\n  /**\n   * Validates if a string is a valid UUID v4 format (strict)\n   * @param id - String to validate\n   * @returns true if the string is a valid UUID version 4\n   * \n   * @example\n   * Resources_SharedUtils.isUUIDv4('550e8400-e29b-41d4-a716-446655440000') // true\n   * Resources_SharedUtils.isUUIDv4('550e8400-e29b-11d4-a716-446655440000') // false (this is UUID v1)\n   */\n  static isUUIDv4(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return Resources_SharedUtils.UUID_V4_PATTERN.test(id);\n  }\n\n  /**\n   * Detects the format of a resource ID\n   * @param id - String to analyze\n   * @returns The detected format, or null if the string is not a valid resource ID\n   * \n   * @example\n   * Resources_SharedUtils.detectIdFormat('507f1f77bcf86cd799439011') // ResourceIdFormat.OBJECT_ID\n   * Resources_SharedUtils.detectIdFormat('550e8400-e29b-41d4-a716-446655440000') // ResourceIdFormat.UUID\n   * Resources_SharedUtils.detectIdFormat('invalid') // null\n   */\n  static detectIdFormat(id: string): ResourceIdFormat | null {\n    if (Resources_SharedUtils.isObjectId(id)) return ResourceIdFormat.OBJECT_ID;\n    if (Resources_SharedUtils.isUUID(id)) return ResourceIdFormat.UUID;\n    return null;\n  }\n\n  /**\n   * Validates if a string is a valid resource ID in any supported format\n   * @param id - String to validate\n   * @returns true if the string is either a valid ObjectId or UUID\n   * \n   * @example\n   * Resources_SharedUtils.isValidResourceId('507f1f77bcf86cd799439011') // true (ObjectId)\n   * Resources_SharedUtils.isValidResourceId('550e8400-e29b-41d4-a716-446655440000') // true (UUID)\n   * Resources_SharedUtils.isValidResourceId('invalid') // false\n   */\n  static isValidResourceId(id: string): boolean {\n    return Resources_SharedUtils.detectIdFormat(id) !== null;\n  }\n\n  /**\n   * Validates if a string is a valid resource ID for a specific format\n   * @param id - String to validate\n   * @param format - Expected format\n   * @returns true if the string matches the expected format\n   * \n   * @example\n   * Resources_SharedUtils.isValidResourceIdForFormat('507f1f77bcf86cd799439011', ResourceIdFormat.OBJECT_ID) // true\n   * Resources_SharedUtils.isValidResourceIdForFormat('507f1f77bcf86cd799439011', ResourceIdFormat.UUID) // false\n   */\n  static isValidResourceIdForFormat(id: string, format: ResourceIdFormat): boolean {\n    switch (format) {\n      case ResourceIdFormat.OBJECT_ID:\n        return Resources_SharedUtils.isObjectId(id);\n      case ResourceIdFormat.UUID:\n        return Resources_SharedUtils.isUUID(id);\n      case ResourceIdFormat.HTTP_API_SYNTHESIZED:\n        return Resources_SharedUtils.isHttpApiSynthesizedId(id);\n      case ResourceIdFormat.INTROSPECTION_SYNTHESIZED:\n        return Resources_SharedUtils.isIntrospectionSynthesizedId(id);\n      default:\n        return false;\n    }\n  }\n\n  /**\n   * Lexical shape of an `HTTP_API`-backed resource's synthesized id — the codec charset law.\n   *\n   * Deliberately NOT consulted by {@link detectIdFormat} / {@link isValidResourceId}: every\n   * ObjectId and UUID also matches this charset, so lexical detection cannot distinguish the\n   * formats, and widening the generic validators would silently relax id validation for every\n   * PLATFORM-backed resource. This predicate participates only where the resource is already\n   * known to be HTTP_API-backed (`ResourceIdBackendService.getFormatForResource` resolves that\n   * from the registry). Canonicality (one row, one id) is enforced by the codec's decode, not\n   * here — this is shape admission, not decode.\n   */\n  static isHttpApiSynthesizedId(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return HTTP_API_RESOURCE_ID_CHARSET.test(id);\n  }\n\n  /**\n   * Lexical shape of an `INTROSPECTION`-backed resource's id.\n   *\n   * The SAME charset law as its HTTP-API sibling — URL-unreserved characters — reused rather than\n   * restated so the two cannot drift into disagreeing about what a URL-safe key is. The predicates\n   * stay separate because the FORMATS are separate: a caller asks \"is this a valid id for THIS\n   * resource\", and answering through the sibling's name would make the next reader think an\n   * introspected row had been through the HTTP-API codec.\n   *\n   * Carries the same exclusion: not consulted by {@link isValidResourceId}, so no platform-backed\n   * row is loosened by its existence.\n   */\n  static isIntrospectionSynthesizedId(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return HTTP_API_RESOURCE_ID_CHARSET.test(id);\n  }\n\n  /**\n   * Asserts that a value is a valid resource ID, throwing an error if not\n   * @param id - Value to validate\n   * @param fieldName - Name of the field for error messages\n   * @throws Error if the value is not a valid resource ID\n   * \n   * @example\n   * Resources_SharedUtils.assertValidResourceId('507f1f77bcf86cd799439011', 'userId') // passes\n   * Resources_SharedUtils.assertValidResourceId('invalid', 'userId') // throws Error\n   */\n  static assertValidResourceId(id: unknown, fieldName: string = 'id'): asserts id is string {\n    if (typeof id !== 'string') {\n      throw new Error(`${fieldName} must be a string, got ${typeof id}`);\n    }\n    if (!Resources_SharedUtils.isValidResourceId(id)) {\n      throw new Error(`${fieldName} must be a valid resource ID (MongoDB ObjectId or UUID), got: ${id}`);\n    }\n  }\n\n  // ============================================================================\n  // Relationship Activation\n  // ============================================================================\n\n  /**\n   * Resolve the relationship identifier field used to expose nested/context\n   * object names to framework consumers.\n   *\n   * Naming follows the FK-anchor / FK-target distinction:\n   *\n   *   - `foreignKeyField` lives on `resourceType2` (the FK-anchor side) and\n   *     semantically identifies `resourceType1` (the FK-target side).\n   *     `'assignedToUserId'` on a `tasks` row identifies the assigned-to user;\n   *     `'userId'` on an `organizationMembers` row identifies the user it\n   *     belongs to.\n   *\n   *   - When the caller is naming the **FK-target side** (i.e.\n   *     `relatedResourceType === resourceType1`), the FK is the semantic name\n   *     carrier — e.g. `'assignedToUser'` falls out of `'assignedToUserId'`.\n   *     Using the FK preserves multi-edge differentiation when several FKs\n   *     point to the same parent type (createdBy / assignedTo / reviewer all\n   *     resolve to distinct field names).\n   *\n   *   - When the caller is naming the **FK-anchor side** (i.e.\n   *     `relatedResourceType === resourceType2`), the FK is *not* a name for\n   *     this side — it names the OTHER side. Using it produces a wrong\n   *     parent-flavoured name on the child field (e.g. `userId` would yield\n   *     `'users'` instead of `'organizationMembers'`). The correct name is\n   *     derived from the related resource type itself.\n   *\n   *   - Self-references (`resourceType1 === resourceType2`) always use the FK\n   *     for semantic differentiation (`parentDocumentId` → `'parentDocument'`\n   *     vs `childDocumentId` → `'childDocument'`).\n   *\n   * Population (`fetchChildResourcesWithPolicy` /\n   * `populateForContext`) keys child collections directly off\n   * `resourceType2` with optional singularization for 1:1 — which is\n   * structurally equivalent to the FK-anchor-side branch below. Keeping the\n   * two sites aligned is what unblocks context-mode response fields like\n   * `organizationMembers`, `userSelfProfile`, `userSelfPreference` from being\n   * silently Zod-stripped on the way out the controller.\n   */\n  static resolveRelationshipObjectIdentity(\n    relationship: Pick<\n      ResourceRelationship,\n      'foreignKeyField' | 'resourceType1' | 'resourceType2'\n    >,\n    relatedResourceType: ResourceType,\n    cardinality: ResourceRelationshipCardinality,\n    allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipObjectIdentity {\n    const isSelfReference = relationship.resourceType1 === relationship.resourceType2;\n    const isNamingFkTargetSide = relatedResourceType === relationship.resourceType1;\n    const useForeignKeyForNaming = isSelfReference || isNamingFkTargetSide;\n\n    const relationshipIdentifierField = (useForeignKeyForNaming && relationship.foreignKeyField)\n      || allResourceFieldIdentifiers[relatedResourceType]\n      || ResourcesConfigNamingUtils.toResourceFieldIdentifier(relatedResourceType);\n\n    return {\n      relatedResourceType,\n      relationshipIdentifierField,\n      objectFieldName: isOneToOneCardinality(cardinality)\n        ? ResourcesConfigNamingUtils.extractBaseName(relationshipIdentifierField)\n        : ResourcesConfigNamingUtils.toResourceName(relationshipIdentifierField),\n      isExplicit: useForeignKeyForNaming && Boolean(relationship.foreignKeyField),\n    };\n  }\n\n  /**\n   * Resolve the relationship object identity from the perspective of one of the\n   * relationship's two resource types.\n   *\n   * This is the caller-facing field name the current resource would use when it\n   * refers to the relationship as an object/collection (`user`, `products`,\n   * `productConsumptions`, ...).\n   */\n  static resolveRelationshipObjectIdentityForResource(\n    relationship: Pick<\n      ResourceRelationship,\n      'resourceType1' | 'resourceType2' | 'cardinality1' | 'cardinality2' | 'foreignKeyField'\n    >,\n    currentResourceType: ResourceType,\n    allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipObjectIdentity {\n    if (relationship.resourceType1 === currentResourceType) {\n      return this.resolveRelationshipObjectIdentity(\n        relationship,\n        relationship.resourceType2,\n        relationship.cardinality2,\n        allResourceFieldIdentifiers\n      );\n    }\n\n    if (relationship.resourceType2 === currentResourceType) {\n      return this.resolveRelationshipObjectIdentity(\n        relationship,\n        relationship.resourceType1,\n        relationship.cardinality1,\n        allResourceFieldIdentifiers\n      );\n    }\n\n    throw new Error(\n      `Cannot resolve relationship object identity for resource \"${currentResourceType}\". ` +\n      `The relationship ${relationship.resourceType1} -> ${relationship.resourceType2} does not include that resource type.`\n    );\n  }\n\n  static getRelationshipPerspectiveForResource(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2'>,\n    currentResourceType: ResourceType\n  ): RelationshipResourcePerspective | undefined {\n    if (relationship.resourceType1 === currentResourceType && relationship.resourceType2 === currentResourceType) {\n      return undefined;\n    }\n    if (relationship.resourceType1 === currentResourceType) {\n      return 'resourceType1';\n    }\n    if (relationship.resourceType2 === currentResourceType) {\n      return 'resourceType2';\n    }\n    return undefined;\n  }\n\n  /**\n   * Resolve which resource a foreign-key relationship REFERENCES (the target),\n   * vs which resource HOLDS the FK column (the holder).\n   *\n   * The registry's `fieldIdentifierToResourceType` must map a foreign-key field\n   * to the resource it **references** (`assignedToUserId → users`,\n   * `createdByUserId → users`) so reference pickers, FK display links, and\n   * `resolveResourceTypeForForeignKey` all resolve the referenced resource — NOT\n   * the resource that stores the column.\n   *\n   * `resourceType1` / `resourceType2` order is author-declaration dependent and\n   * is therefore NOT a reliable target signal: a child-first declaration like\n   * `createResourcesRelationship(TODOS, USERS, MANY, ONE, { foreignKeyField:\n   * 'assignedToUserId' })` stores `rt1 = todos` (the HOLDER), `rt2 = users` (the\n   * target). Mapping the FK to `resourceType1` (the historical behavior) yields\n   * `assignedToUserId → todos`, which sends a user-reference picker to search\n   * todos and links FK values to the wrong resource.\n   *\n   * Ground truth = **schema membership**: the FK column is declared on exactly\n   * one of the two resources (the holder); the other side is the referenced\n   * target. The loop that builds the map only processes explicit\n   * `foreignKeyField`s, which are always real columns on their holder's schema,\n   * so membership resolves every real case (N:1, 1:N, 1:1) regardless of\n   * declaration order. `allResourceFieldIdentifiers` standard-id equality is a\n   * belt-and-suspenders fallback for callers that cannot introspect schemas.\n   *\n   * @param relationship the FK relationship (must carry `foreignKeyField`)\n   * @param context.allResourceFieldIdentifiers resourceType → its standard id field\n   * @param context.schemaDeclaresField `(resourceType, field) => true` iff the\n   *        resource's OWN main schema declares `field` as a column (it HOLDS the FK)\n   */\n  static resolveForeignKeyReferencedResourceType(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>,\n    context: {\n      allResourceFieldIdentifiers: Record<string, string>;\n      schemaDeclaresField: (resourceType: string, fieldName: string) => boolean;\n    },\n  ): { referencedResourceType: string; holderResourceType: string } {\n    const rt1 = relationship.resourceType1;\n    const rt2 = relationship.resourceType2;\n    const fk = relationship.foreignKeyField;\n\n    if (fk) {\n      const rt1Holds = context.schemaDeclaresField(rt1, fk);\n      const rt2Holds = context.schemaDeclaresField(rt2, fk);\n      if (rt1Holds && !rt2Holds) return { holderResourceType: rt1, referencedResourceType: rt2 };\n      if (rt2Holds && !rt1Holds) return { holderResourceType: rt2, referencedResourceType: rt1 };\n\n      // Fallback — the FK equals a side's standard id (a standard FK pointing at it).\n      if (context.allResourceFieldIdentifiers[rt2] === fk) return { holderResourceType: rt1, referencedResourceType: rt2 };\n      if (context.allResourceFieldIdentifiers[rt1] === fk) return { holderResourceType: rt2, referencedResourceType: rt1 };\n    }\n\n    // Last resort (no fk / genuinely ambiguous): preserve the legacy rt1 target.\n    return { holderResourceType: rt2, referencedResourceType: rt1 };\n  }\n\n  /**\n   * Build the registry's `fieldIdentifierToResourceType` reverse map — THE ONE\n   * implementation.\n   *\n   * This logic existed as two hand-kept copies (the backend registry service\n   * and the frontend resources repository) plus was about to grow a third for\n   * the app-creation FK-resolution verification check — exactly the\n   * security-predicate-drift shape `two-buildcontextualfilter-implementations`\n   * records. Every consumer now routes through here; a semantic change to FK\n   * resolution lands once.\n   *\n   * Semantics (unchanged from the two copies it replaces):\n   * 1. Seed from standard field identifiers (`userId → USERS`), tracking\n   *    identifiers SHARED by several resource types (USERS / USER_SELF).\n   * 2. Enrich with every relationship's explicit `foreignKeyField`, mapped to\n   *    the resource it REFERENCES (resolved structurally via schema\n   *    membership — declaration-order independent, see\n   *    {@link resolveForeignKeyReferencedResourceType}). Shared-identifier\n   *    convergence and per-record discriminated polymorphic FKs are tolerated;\n   *    a genuine same-name-different-target clash is reported through\n   *    `onForeignKeyCollision` (log, never throw — an authoring slip must not\n   *    crash registry boot) and the FIRST mapping is kept.\n   * 3. Canonical-priority pass for shared identifiers\n   *    (`coreResourceShared_FieldIdentifierPriority`), so the winner is policy,\n   *    not iteration order.\n   */\n  static buildFieldIdentifierToResourceTypeMap(input: {\n    allResourceFieldIdentifiers: Record<string, string>;\n    allResourceRelationships: ReadonlyArray<ResourceRelationship>;\n    /** resourceType → its materialized main schema (used for holder resolution + polymorphic tolerance). */\n    getMainSchema: (resourceType: string) => z.ZodTypeAny | undefined;\n    /** resourceType → canonical priority for SHARED standard identifiers. */\n    fieldIdentifierPriority: Record<string, string>;\n    onForeignKeyCollision?: (collision: { foreignKeyField: string; existingType: string; referencedResourceType: string }) => void;\n  }): Record<string, string> {\n    const fieldIdentifierToResourceType: Record<string, string> = {};\n    const sharedFieldIdentifiers = new Map<string, Set<string>>();\n    for (const [resourceType, fieldIdentifier] of Object.entries(input.allResourceFieldIdentifiers)) {\n      const existing = fieldIdentifierToResourceType[fieldIdentifier];\n      if (existing && existing !== resourceType) {\n        if (!sharedFieldIdentifiers.has(fieldIdentifier)) {\n          sharedFieldIdentifiers.set(fieldIdentifier, new Set([existing]));\n        }\n        sharedFieldIdentifiers.get(fieldIdentifier)!.add(resourceType);\n      }\n      fieldIdentifierToResourceType[fieldIdentifier] = resourceType;\n    }\n\n    const schemaDeclaresField = (resourceType: string, fieldName: string): boolean => {\n      const schema = input.getMainSchema(resourceType);\n      if (!schema) return false;\n      return Object.prototype.hasOwnProperty.call(getZodObjectShape(schema) ?? {}, fieldName);\n    };\n    for (const rel of input.allResourceRelationships) {\n      if (!rel.foreignKeyField) continue;\n      const { referencedResourceType, holderResourceType } = Resources_SharedUtils.resolveForeignKeyReferencedResourceType(\n        rel,\n        { allResourceFieldIdentifiers: input.allResourceFieldIdentifiers, schemaDeclaresField },\n      );\n      const existingType = fieldIdentifierToResourceType[rel.foreignKeyField];\n      if (existingType && existingType !== referencedResourceType) {\n        const sharedTypes = sharedFieldIdentifiers.get(rel.foreignKeyField);\n        if (sharedTypes && (sharedTypes.has(referencedResourceType) || sharedTypes.has(existingType))) {\n          continue;\n        }\n        const holderSchema = input.getMainSchema(holderResourceType);\n        const holderFkSchema = holderSchema ? (getZodObjectShape(holderSchema) ?? {})[rel.foreignKeyField] : undefined;\n        if (holderFkSchema && getDiscriminatedPolymorphicForeignKey(holderFkSchema)) {\n          continue;\n        }\n        input.onForeignKeyCollision?.({ foreignKeyField: rel.foreignKeyField, existingType, referencedResourceType });\n        continue;\n      }\n      fieldIdentifierToResourceType[rel.foreignKeyField] = referencedResourceType;\n    }\n\n    for (const [fieldId, canonicalType] of Object.entries(input.fieldIdentifierPriority)) {\n      if (sharedFieldIdentifiers.has(fieldId)) {\n        fieldIdentifierToResourceType[fieldId] = canonicalType;\n      }\n    }\n    return fieldIdentifierToResourceType;\n  }\n\n  /**\n   * The FK-resolution SWEEP: every schema field carrying `.isForeignKey()` that\n   * the map above cannot resolve to a resource type.\n   *\n   * This is the exact eager check the frontend registry runs at\n   * initialization (where an unresolved field is `frontend_fk_resolution_failed`\n   * and, in development, refuses the whole app). Exposed here so the\n   * app-creation verification lane can run the SAME sweep headless — after a\n   * compose or a coding mutation — instead of the defect surfacing in the\n   * builder's browser (wonder-crm, 2026-08-27: three composed resources carried\n   * a decorated `createdByUserId` with no relationship edge; typecheck and the\n   * backend boot were both green).\n   */\n  static collectUnresolvableForeignKeyFields(input: {\n    /** resourceType → materialized main schema. */\n    mainSchemasByResourceType: Record<string, z.ZodTypeAny | undefined>;\n    fieldIdentifierToResourceType: Record<string, string>;\n  }): Array<{ resourceType: string; fieldName: string }> {\n    const unresolved: Array<{ resourceType: string; fieldName: string }> = [];\n    for (const [resourceType, schema] of Object.entries(input.mainSchemasByResourceType)) {\n      if (!schema) continue;\n      const shape = getZodObjectShape(schema);\n      if (!shape) continue;\n      for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n        if (!isForeignKeyField(fieldSchema as z.ZodTypeAny)) continue;\n        if (!input.fieldIdentifierToResourceType[fieldName]) {\n          unresolved.push({ resourceType, fieldName });\n        }\n      }\n    }\n    return unresolved;\n  }\n\n  /**\n   * Resolve which side of a foreign-key relationship HOLDS the FK column, from\n   * cardinality topology alone — no registry / schema access required.\n   *\n   * The FK column physically lives on the collection side of a 1:N / N:1\n   * relationship: each of the \"many\" rows carries one reference to its \"one\"\n   * counterpart. Declaration order is an authoring convenience — parent-first\n   * `(ORGANIZATIONS, TODOS, ONE, MANY)` and child-first\n   * `(TODOS, USERS, MANY, ONE, { foreignKeyField: 'assignedToUserId' })` are\n   * both valid — so positional `resourceType2` reads are NOT a holder signal\n   * (see {@link resolveForeignKeyReferencedResourceType}, the schema-membership\n   * variant of the same invariant used where registry schemas are available).\n   *\n   * Resolution rules:\n   * - self-reference (`resourceType1 === resourceType2`) → the resource holds\n   *   its own FK (tree parent ids, self-referencing junction arrays);\n   * - exactly one collection side (`MANY` / `ONE_OR_MANY`) → that side holds;\n   * - 1:1 (no collection side) → `resourceType2`, per the parent-first child\n   *   convention (`resourceType1` = parent, `resourceType2` = child carrying\n   *   the unique FK — e.g. context-addressed composition singletons);\n   * - both sides collections (M:N) only carries a `foreignKeyField`\n   *   self-referentially (guarded at declaration time), which the\n   *   self-reference rule already covers; the defensive fallback stays\n   *   `resourceType2`.\n   */\n  static resolveForeignKeyHolderResourceType(\n    relationship: Pick<\n      ResourceRelationshipDeclaration,\n      'resourceType1' | 'resourceType2' | 'cardinality1' | 'cardinality2'\n    >\n  ): ResourceType {\n    if (relationship.resourceType1 === relationship.resourceType2) {\n      return relationship.resourceType1;\n    }\n\n    const side1IsCollection = isArrayCardinality(relationship.cardinality1);\n    const side2IsCollection = isArrayCardinality(relationship.cardinality2);\n\n    if (side1IsCollection && !side2IsCollection) {\n      return relationship.resourceType1;\n    }\n    if (side2IsCollection && !side1IsCollection) {\n      return relationship.resourceType2;\n    }\n\n    return relationship.resourceType2;\n  }\n\n  /**\n   * Collect the candidate referenced resource types for a SHARED foreign-key\n   * field on a given holder — every resource the holder's `foreignKeyField` can\n   * point at, gathered from the registered relationships.\n   *\n   * Used to enumerate the branches of a per-record discriminated polymorphic FK\n   * (e.g. referrals' `referrerBillingAccountId` → [`userBillingAccounts`,\n   * `organizationBillingAccounts`]). The holder DECLARES the FK column, so the\n   * referenced side of each matching relationship is the side that is NOT the\n   * holder.\n   */\n  static getForeignKeyCandidateReferencedTypes(\n    foreignKeyField: string,\n    holderResourceType: string,\n    relationships: ReadonlyArray<Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>>,\n  ): string[] {\n    const referenced: string[] = [];\n    for (const rel of relationships) {\n      if (rel.foreignKeyField !== foreignKeyField) continue;\n      if (rel.resourceType1 === holderResourceType) referenced.push(rel.resourceType2);\n      else if (rel.resourceType2 === holderResourceType) referenced.push(rel.resourceType1);\n    }\n    return referenced;\n  }\n\n  /**\n   * Resolve the concrete branch a per-record DISCRIMINATED polymorphic FK points\n   * at, for a specific holder record.\n   *\n   * A flat resource (e.g. `referrals`) may hold ONE shared FK column\n   * (`referrerBillingAccountId`) that targets a polymorphic branch GROUP\n   * (`billingAccounts` → `userBillingAccounts` | `organizationBillingAccounts`).\n   * Which branch a given record points at is decided by a sibling discriminator\n   * field on the SAME record (`referrerScopeType`).\n   *\n   * Resolution rides the scope axis the polymorphic system is already built on\n   * — there is NO bespoke value→target map:\n   *  1. Read the discriminator value off the record.\n   *  2. Find the {@link PolymorphicFkVariant} whose `discriminatorValue` matches —\n   *     this yields the variant's scope-root `parentResourceType` (e.g.\n   *     `'organizations'`).\n   *  3. Return the candidate branch whose `resourcePrimaryScope`, mapped back to\n   *     its scope root via `PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE`, equals that\n   *     `parentResourceType`.\n   *\n   * Returns `undefined` (caller degrades to the registry's non-authoritative\n   * representative) when the discriminator value is absent/unknown or no\n   * candidate branch matches the variant's scope.\n   *\n   * @param context.record the holder record (must carry the discriminator field)\n   * @param context.discriminatorField sibling field naming the branch selector\n   * @param context.variants the FK's polymorphic variants (each with `discriminatorValue`)\n   * @param context.candidateReferencedTypes branches from\n   *        {@link getForeignKeyCandidateReferencedTypes}\n   * @param context.getResourcePrimaryScope `(rt) => its primary scope` (registry lookup)\n   */\n  static resolveDiscriminatedPolymorphicForeignKeyTarget(context: {\n    record: Record<string, unknown>;\n    discriminatorField: string;\n    variants: ReadonlyArray<PolymorphicFkVariant>;\n    candidateReferencedTypes: ReadonlyArray<string>;\n    getResourcePrimaryScope: (resourceType: string) => ResourcePrimaryScope | undefined;\n  }): string | undefined {\n    const rawValue = context.record[context.discriminatorField];\n    if (rawValue === undefined || rawValue === null) return undefined;\n    const discriminatorValue = String(rawValue);\n\n    const variant = context.variants.find(v => v.discriminatorValue === discriminatorValue);\n    if (!variant) return undefined;\n\n    return context.candidateReferencedTypes.find(referencedType => {\n      const scope = context.getResourcePrimaryScope(referencedType);\n      if (scope === undefined) return false;\n      return (PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE[scope] as string) === variant.parentResourceType;\n    });\n  }\n\n  /**\n   * Stable key for {@link ManyToManyScopeJunctionMap}: a `(target, scope)` pair.\n   * Uses a `|` separator, which cannot appear in resource-type identifiers, so\n   * `(a, b|c)` and `(a|b, c)` can never collide.\n   */\n  static manyToManyScopeJunctionKey(targetResourceType: string, scopeResourceType: string): string {\n    return `${targetResourceType}|${scopeResourceType}`;\n  }\n\n  /**\n   * Derive the {@link ManyToManyScopeJunctionMap} from the registered\n   * relationships — the registry signal that powers inference-based scope-required\n   * reference search (see `.claude/plans/fk-filter-reference-search.md`).\n   *\n   * For every MANY-to-MANY relationship (one carrying a `jointResourceType` whose\n   * two sides are the PEERS, not the junction itself), both orderings are\n   * recorded: either peer may be the search TARGET with the other as the SCOPE.\n   * The junction's per-peer FK columns are resolved by convention as each peer's\n   * `resourceFieldIdentifier` (e.g. `organizationMembers` carries `userId` /\n   * `organizationId`).\n   *\n   * Robust to being called on raw OR post-expansion relationships: synthetic\n   * `peer → junction` edges (which also carry `jointResourceType`) are excluded\n   * because one of their sides IS the junction.\n   *\n   * Q4 (fail-closed): if two DISTINCT junctions relate the same `(target, scope)`\n   * pair, throws a configuration error — a scope-required search cannot\n   * deterministically choose a junction. No such case exists in core today\n   * (`organizations ↔ users via organizationMembers` is the only M:N).\n   *\n   * @param relationships the registered relationships (compiled or raw)\n   * @param allResourceFieldIdentifiers `resourceType → its standard id field`\n   */\n  static buildManyToManyScopeJunctionMap(\n    relationships: ReadonlyArray<Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'jointResourceType'>>,\n    allResourceFieldIdentifiers: Record<string, string>,\n  ): ManyToManyScopeJunctionMap {\n    const map = new Map<string, ManyToManyScopeJunction>();\n\n    const record = (target: string, scope: string, junction: string, targetFk: string, scopeFk: string): void => {\n      const key = this.manyToManyScopeJunctionKey(target, scope);\n      const existing = map.get(key);\n      if (existing && existing.junctionResourceType !== junction) {\n        throw this.createConfigurationError(\n          `Ambiguous M:N scope junction for target '${target}' scoped by '${scope}': both ` +\n          `'${existing.junctionResourceType}' and '${junction}' join them. A scope-required ` +\n          `reference search cannot deterministically choose a junction — declare a single M:N ` +\n          `between these resources.`,\n        );\n      }\n      map.set(key, { junctionResourceType: junction, targetFkField: targetFk, scopeFkField: scopeFk });\n    };\n\n    for (const rel of relationships) {\n      const junction = rel.jointResourceType;\n      if (!junction) continue;                                  // only M:N relationships carry a junction\n      const peerA = rel.resourceType1;\n      const peerB = rel.resourceType2;\n      if (peerA === junction || peerB === junction) continue;   // skip synthetic peer→junction edges\n      if (peerA === peerB) continue;                            // self-ref M:N is modeled explicitly, not here\n      const peerAFk = allResourceFieldIdentifiers[peerA];\n      const peerBFk = allResourceFieldIdentifiers[peerB];\n      if (!peerAFk || !peerBFk) continue;                       // junction FK columns unresolvable → skip defensively\n\n      record(peerA, peerB, junction, peerAFk, peerBFk);\n      record(peerB, peerA, junction, peerBFk, peerAFk);\n    }\n\n    return map;\n  }\n\n  /**\n   * Resolve the M:N scope junction to use for a **scope-required reference\n   * search** of `targetResourceType`, given the scope parameters available in\n   * the current context (e.g. a people-picker on a task filter has the caller's\n   * `organizationId` injected by the app scope).\n   *\n   * Returns the junction for the first `(target, scope)` entry whose\n   * `scopeFkField` is present in `availableContextFields` — i.e. \"search this\n   * target scoped through the junction to the scope the caller is already in\".\n   * Returns `undefined` when the target has no M:N junction reachable from the\n   * available context, meaning the picker should do a plain unscoped target\n   * search. This is the registry-inference that drives scope-required reference\n   * search on the frontend (see `.claude/plans/fk-filter-reference-search.md`) —\n   * no per-field declaration needed.\n   */\n  static findScopeJunctionForTargetInContext(\n    manyToManyScopeJunctions: ManyToManyScopeJunctionMap,\n    targetResourceType: string,\n    availableContextFields: ReadonlySet<string>,\n  ): ManyToManyScopeJunction | undefined {\n    for (const [key, junction] of manyToManyScopeJunctions) {\n      const separatorIndex = key.indexOf('|');\n      const entryTarget = separatorIndex === -1 ? key : key.slice(0, separatorIndex);\n      if (entryTarget !== targetResourceType) continue;\n      if (availableContextFields.has(junction.scopeFkField)) {\n        return junction;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Build the generated custom-operation identifier used to expose explicit bulk\n   * relationship actions at the resource-operation layer.\n   */\n  static buildRelationshipBulkOperationIdentifier(\n    action: ResourceRelationshipBulkAction,\n    relationshipField: string\n  ): string {\n    return `${ResourceRelationshipBulkOperationIdentifierPrefix[action]}${relationshipField}`;\n  }\n\n  /**\n   * Parse a generated bulk relationship operation identifier back into its\n   * semantic parts so backend dispatch can route it to the shared executor.\n   */\n  static parseRelationshipBulkOperationIdentifier(\n    operationIdentifier: string\n  ): { action: ResourceRelationshipBulkAction; relationshipField: string } | undefined {\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.SET])) {\n      return {\n        action: ResourceRelationshipBulkAction.SET,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.SET].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.CLEAR])) {\n      return {\n        action: ResourceRelationshipBulkAction.CLEAR,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.CLEAR].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.CREATE])) {\n      return {\n        action: ResourceRelationshipBulkAction.CREATE,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.CREATE].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.LINK])) {\n      return {\n        action: ResourceRelationshipBulkAction.LINK,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.LINK].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.UNLINK])) {\n      return {\n        action: ResourceRelationshipBulkAction.UNLINK,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.UNLINK].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.REPLACE])) {\n      return {\n        action: ResourceRelationshipBulkAction.REPLACE,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.REPLACE].length\n        ),\n      };\n    }\n\n    return undefined;\n  }\n\n  static buildGeneratedFileRegenerateOperationIdentifier(fieldName: string): string {\n    if (!fieldName.trim()) {\n      throw Resources_SharedUtils.createConfigurationError('Generated file regenerate operation requires a non-empty fieldName');\n    }\n    return `${Resources_SharedUtils.GENERATED_FILE_REGENERATE_OPERATION_PREFIX}${fieldName}`;\n  }\n\n  static parseGeneratedFileRegenerateOperationIdentifier(\n    operationIdentifier: string\n  ): { fieldName: string } | undefined {\n    if (!operationIdentifier.startsWith(Resources_SharedUtils.GENERATED_FILE_REGENERATE_OPERATION_PREFIX)) {\n      return undefined;\n    }\n\n    const fieldName = operationIdentifier.slice(\n      Resources_SharedUtils.GENERATED_FILE_REGENERATE_OPERATION_PREFIX.length,\n    );\n    return fieldName.trim() ? { fieldName } : undefined;\n  }\n\n  /**\n   * Identifier of the export companion of `sourceOperationIdentifier`\n   * (e.g. `collectionExport:list`, `collectionExport:mySearchVariant`).\n   */\n  static buildGeneratedCollectionExportOperationIdentifier(sourceOperationIdentifier: string): string {\n    if (!sourceOperationIdentifier.trim()) {\n      throw Resources_SharedUtils.createConfigurationError(\n        'Generated collection export operation requires a non-empty source operation identifier',\n      );\n    }\n    return `${Resources_SharedUtils.GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX}${sourceOperationIdentifier}`;\n  }\n\n  static parseGeneratedCollectionExportOperationIdentifier(\n    operationIdentifier: string\n  ): { sourceOperationIdentifier: string } | undefined {\n    if (!operationIdentifier.startsWith(Resources_SharedUtils.GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX)) {\n      return undefined;\n    }\n\n    const sourceOperationIdentifier = operationIdentifier.slice(\n      Resources_SharedUtils.GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX.length,\n    );\n    return sourceOperationIdentifier.trim() ? { sourceOperationIdentifier } : undefined;\n  }\n\n  /**\n   * Resolve the FK field identity for a relationship.\n   *\n   * Priority:\n   * 1. explicit `foreignKeyField`\n   * 2. parent resource default field identifier from `allResourceFieldIdentifiers`\n   *\n   * This keeps FK resolution semantics shared across backend and frontend\n   * consumers instead of letting each layer improvise its own fallback.\n   */\n  static resolveRelationshipForeignKeyIdentity(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>,\n    allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipForeignKeyIdentity {\n    if (relationship.foreignKeyField) {\n      return {\n        parentResourceType: relationship.resourceType1,\n        childResourceType: relationship.resourceType2,\n        fieldIdentifier: relationship.foreignKeyField,\n        isExplicit: true,\n      };\n    }\n\n    const fieldIdentifier = allResourceFieldIdentifiers[relationship.resourceType1];\n    if (!fieldIdentifier) {\n      throw new Error(\n        `Cannot resolve FK field for relationship ${relationship.resourceType1} -> ${relationship.resourceType2}. ` +\n        `No explicit foreignKeyField was provided and resource type \"${relationship.resourceType1}\" has no registered default field identifier.`\n      );\n    }\n\n    return {\n      parentResourceType: relationship.resourceType1,\n      childResourceType: relationship.resourceType2,\n      fieldIdentifier,\n      isExplicit: false,\n    };\n  }\n\n  /**\n   * Non-throwing FK resolution helper for validation and optional consumers.\n   */\n  static tryResolveRelationshipForeignKeyIdentity(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>,\n    allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipForeignKeyIdentity | undefined {\n    try {\n      return this.resolveRelationshipForeignKeyIdentity(relationship, allResourceFieldIdentifiers);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Resolve explicit bulk relationship affordances from the perspective of the\n   * currently selected resource type.\n   *\n   * This is intentionally narrower than generic nested CRUD:\n   * - child-side REFERENCE => `set` / `clear`\n   * - parent-side COMPOSITION => `create`\n   * - peer-side ASSOCIATION => `link` / `unlink` / `replace`\n   *\n   * Important for future UX documentation:\n   * - these actions express the semantic difference between pointer management\n   *   (`REFERENCE`), aggregate-owned nested creation (`COMPOSITION`), and peer\n   *   membership management (`ASSOCIATION`)\n   * - a frontend shortcut such as \"quick create\" does not add a new action kind;\n   *   it simply orchestrates \"create independent resource, then run the normal\n   *   reference/association action\"\n   */\n  static resolveAllowedBulkRelationshipActionsForResource(\n    relationship: ResourceRelationship,\n    currentResourceType: ResourceType\n  ): ResourceRelationshipBulkAction[] {\n    if (relationship.isDisabled === true) {\n      return [];\n    }\n\n    const perspective = this.getRelationshipPerspectiveForResource(relationship, currentResourceType);\n    if (!perspective) {\n      return [];\n    }\n\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    // REFERENCE: mutate the pointer from the child side.\n    if (\n      semantics.nature === RelationshipNature.REFERENCE &&\n      perspective === 'resourceType2'\n    ) {\n      return [\n        ResourceRelationshipBulkAction.SET,\n        ResourceRelationshipBulkAction.CLEAR,\n      ];\n    }\n\n    // COMPOSITION: create owned nested children from the parent side.\n    if (\n      semantics.nature === RelationshipNature.COMPOSITION &&\n      perspective === 'resourceType1' &&\n      this.resolveRelationshipNestedMutationConfig(relationship, CoreResourceOperation.CREATE)\n    ) {\n      return [ResourceRelationshipBulkAction.CREATE];\n    }\n\n    // ASSOCIATION: manage peer membership while keeping junction persistence\n    // internal to the framework.\n    if (\n      semantics.nature === RelationshipNature.ASSOCIATION &&\n      relationship.jointResourceType\n    ) {\n      return [\n        ResourceRelationshipBulkAction.LINK,\n        ResourceRelationshipBulkAction.UNLINK,\n        ResourceRelationshipBulkAction.REPLACE,\n      ];\n    }\n\n    return [];\n  }\n\n  /**\n   * Resolve the semantic nature of a relationship.\n   *\n   * Greenfield API: relationship declarations must define `nature` explicitly.\n   * The resolver refuses to derive semantic meaning from low-level fields.\n   */\n  static resolveRelationshipNature(\n    relationship: Pick<ResourceRelationshipDeclaration, 'nature'>\n  ): { nature: RelationshipNature; source: ResolvedRelationshipNatureCalculationMode } {\n    if (!relationship.nature) {\n      throw this.createConfigurationError(\n        'Relationship declarations must define nature explicitly. ' +\n        'Greenfield relationship semantics no longer infer meaning from jointResourceType or childOperations.'\n      );\n    }\n\n    return {\n      nature: relationship.nature,\n      source: 'explicit',\n    };\n  }\n\n  private static deriveLegacyRelationshipReadModel(\n    nature: RelationshipNature,\n    childOperations?: ChildOperationsConfig_Parsed\n  ): RelationshipReadModel {\n    switch (nature) {\n      case RelationshipNature.COMPOSITION:\n        return childOperations?.nested?.onRead\n          ? RelationshipReadModel.EMBEDDED\n          : RelationshipReadModel.REFERENCE_ONLY;\n      case RelationshipNature.ASSOCIATION:\n        return childOperations?.nested?.onRead\n          ? RelationshipReadModel.ASSOCIATION_EMBEDDED\n          : RelationshipReadModel.REFERENCE_ONLY;\n      case RelationshipNature.REFERENCE:\n      default:\n        return RelationshipReadModel.REFERENCE_ONLY;\n    }\n  }\n\n  private static resolveRelationshipReadCalculation(params: {\n    nature: RelationshipNature;\n    childOperations?: ChildOperationsConfig_Parsed;\n    explicitRead?: RelationshipHandlingReadSettings;\n  }): {\n    model: RelationshipReadModel;\n    source: ResolvedRelationshipReadCalculationMode;\n  } {\n    if (params.explicitRead) {\n      return {\n        model: params.explicitRead.model,\n        source: 'explicit',\n      };\n    }\n\n    if (params.childOperations?.nested?.onRead) {\n      return {\n        model: this.deriveLegacyRelationshipReadModel(params.nature, params.childOperations),\n        source: 'legacy_nested_read_fallback',\n      };\n    }\n\n    return {\n      model: RelationshipReadModel.REFERENCE_ONLY,\n      source: 'default_reference_only',\n    };\n  }\n\n  /**\n   * Resolve the internal semantic contract and the current operational\n   * projection used by DTO/backend consumers.\n   *\n   * App developers author relationship topology and `nature`. This method is\n   * where the framework derives the deeper internal handling contract and the\n   * effective low-level `childOperations` shape consumed today.\n   */\n  static resolveRelationshipSemantics(\n    relationship: Pick<\n      ResourceRelationshipDeclaration,\n      'resourceType1' | 'resourceType2' | 'nature' | 'jointResourceType' | 'childOperations' | 'read' | 'foreignKeyField' | 'parentResourceRequirement' | 'cardinality1' | 'cardinality2'\n    >,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipSemantics {\n    const resolvedNature = this.resolveRelationshipNature(relationship);\n    const parsedChildOperations = relationship.childOperations\n      ? ChildOperationsConfigSchema.parse(relationship.childOperations)\n      : undefined;\n    const explicitRead = relationship.read\n      ? RelationshipHandlingReadSettingsSchema.parse(relationship.read)\n      : undefined;\n\n    this.assertRelationshipSemanticsCoherence(\n      relationship,\n      resolvedNature.nature,\n      parsedChildOperations,\n      explicitRead\n    );\n\n    const resolvedReadCalculation = this.resolveRelationshipReadCalculation({\n      nature: resolvedNature.nature,\n      childOperations: parsedChildOperations,\n      explicitRead,\n    });\n    const handling = this.deriveRelationshipHandlingContract(\n      resolvedNature.nature,\n      parsedChildOperations,\n      resolvedReadCalculation.model\n    );\n    const persistence = this.deriveRelationshipPersistenceContract(relationship, allResourceFieldIdentifiers);\n\n    return {\n      nature: resolvedNature.nature,\n      natureCalculationMode: resolvedNature.source,\n      readCalculationMode: resolvedReadCalculation.source,\n      handling,\n      persistence,\n      childOperations: parsedChildOperations,\n    };\n  }\n\n  /**\n   * Resolve the effective nested mutation projection for the given operation.\n   *\n   * `handling` is the semantic gate; `childOperations` remains the current\n   * detailed operational projection while Step 3/4 finishes converging.\n   */\n  static resolveRelationshipNestedMutationConfig(\n    relationship: ResourceRelationship,\n    operation: CoreResourceOperation\n  ) {\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    if (\n      semantics.handling.dtoModelMode === RelationshipDtoModel.REFERENCE_HANDLE ||\n      semantics.handling.mutationModelMode === RelationshipMutationModel.NONE\n    ) {\n      return undefined;\n    }\n\n    return (\n      operation === CoreResourceOperation.CREATE ||\n      operation === CoreResourceOperation.CREATE_MANY\n    )\n      ? semantics.childOperations?.nested?.onCreate\n      : semantics.childOperations?.nested?.onUpdate;\n  }\n\n  /**\n   * Resolve the effective nested read projection.\n   *\n   * The semantic read contract is the gate. The detailed data-mode config still\n   * comes from the current operational projection.\n   */\n  static resolveRelationshipNestedReadConfig(relationship: ResourceRelationship) {\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    if (\n      semantics.handling.dtoModelMode === RelationshipDtoModel.REFERENCE_HANDLE ||\n      semantics.handling.read.model === RelationshipReadModel.REFERENCE_ONLY\n    ) {\n      return undefined;\n    }\n\n    return semantics.childOperations?.nested?.onRead;\n  }\n\n  /**\n   * Resolve the effective lifecycle-on-parent-delete projection.\n   *\n   * `lifecycleModelMode` is the semantic gate; the detailed delete policy still\n   * comes from the current operational projection.\n   */\n  static resolveRelationshipLifecycleOnParentDeleteConfig(\n    relationship: ResourceRelationship\n  ) {\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    if (semantics.handling.lifecycleModelMode === RelationshipLifecycleModel.INDEPENDENT) {\n      return undefined;\n    }\n\n    return semantics.childOperations?.lifecycle?.onParentDelete;\n  }\n\n  /**\n   * Resolve the effective lifecycle-on-parent-create projection — the eager\n   * composition-child seeding policy. Mirror of\n   * {@link resolveRelationshipLifecycleOnParentDeleteConfig}: `lifecycleModelMode`\n   * is the semantic gate (INDEPENDENT / aggregation → no eager seed), and the\n   * detailed create policy comes from the operational\n   * `childOperations.lifecycle.onParentCreate` projection.\n   */\n  static resolveRelationshipLifecycleOnParentCreateConfig(\n    relationship: ResourceRelationship\n  ) {\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    if (semantics.handling.lifecycleModelMode === RelationshipLifecycleModel.INDEPENDENT) {\n      return undefined;\n    }\n\n    return semantics.childOperations?.lifecycle?.onParentCreate;\n  }\n\n  /**\n   * Compile the developer-authored declaration into the runtime relationship\n   * shape used by the framework.\n   */\n  static compileRelationshipDeclaration(\n    relationship: ResourceRelationshipDeclaration,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResourceRelationship {\n    return {\n      ...relationship,\n      resolvedSemantics: this.resolveRelationshipSemantics(relationship, allResourceFieldIdentifiers),\n    };\n  }\n\n  /**\n   * Ensure a relationship is in the compiled runtime shape.\n   *\n   * This is the startup normalization bridge for places that aggregate\n   * relationships from multiple sources before they are stored on registries or\n   * resource configurations.\n   */\n  static ensureCompiledRelationship(\n    relationship: ResourceRelationship | ResourceRelationshipDeclaration,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResourceRelationship {\n    const compiledRelationship = this.compileRelationshipDeclaration(relationship, allResourceFieldIdentifiers);\n\n    if (\n      'resolvedSemantics' in relationship &&\n      this.hasValidResolvedRelationshipSemantics(relationship.resolvedSemantics) &&\n      this.areResolvedRelationshipSemanticsEquivalent(\n        relationship.resolvedSemantics,\n        compiledRelationship.resolvedSemantics\n      )\n    ) {\n      return relationship;\n    }\n\n    if (\n      !allResourceFieldIdentifiers &&\n      'resolvedSemantics' in relationship &&\n      this.hasValidResolvedRelationshipSemantics(relationship.resolvedSemantics) &&\n      relationship.resolvedSemantics.persistence.foreignKey &&\n      !compiledRelationship.resolvedSemantics.persistence.foreignKey\n    ) {\n      return {\n        ...compiledRelationship,\n        resolvedSemantics: {\n          ...compiledRelationship.resolvedSemantics,\n          persistence: relationship.resolvedSemantics.persistence,\n        },\n      };\n    }\n\n    return compiledRelationship;\n  }\n\n  static ensureCompiledRelationships(\n    relationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[],\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResourceRelationship[] {\n    return relationships.map((relationship) =>\n      this.ensureCompiledRelationship(relationship, allResourceFieldIdentifiers)\n    );\n  }\n\n  static ensureCompiledRelationshipBuckets<\n    TResourceRelationships extends {\n      parentRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];\n      childRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];\n      selfRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];\n    }\n  >(\n    resourceRelationships: TResourceRelationships,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): {\n    parentRelationships: ResourceRelationship[];\n    childRelationships: ResourceRelationship[];\n    selfRelationships: ResourceRelationship[];\n  } {\n    return {\n      parentRelationships: this.ensureCompiledRelationships(\n        resourceRelationships.parentRelationships ?? [],\n        allResourceFieldIdentifiers\n      ),\n      childRelationships: this.ensureCompiledRelationships(\n        resourceRelationships.childRelationships ?? [],\n        allResourceFieldIdentifiers\n      ),\n      selfRelationships: this.ensureCompiledRelationships(\n        resourceRelationships.selfRelationships ?? [],\n        allResourceFieldIdentifiers\n      ),\n    };\n  }\n\n  /**\n   * Strict runtime reader for already-compiled relationships.\n   *\n   * Use this in hot runtime/startup paths once the relationship graph has passed\n   * through the shared compilation boundary.\n   */\n  static requireResolvedRelationshipSemantics(\n    relationship: ResourceRelationship\n  ): ResolvedRelationshipSemantics {\n    if (!this.hasValidResolvedRelationshipSemantics(relationship.resolvedSemantics)) {\n      throw new Error(\n        'Expected ResourceRelationship to carry valid resolvedSemantics. ' +\n        'Make sure the relationship graph passed through the shared startup compilation step.'\n      );\n    }\n\n    return relationship.resolvedSemantics;\n  }\n\n  /**\n   * Read the stored runtime semantics when present. This keeps current call\n   * sites resilient while Step 3 finishes converging on fully compiled edges.\n   */\n  static getResolvedRelationshipSemantics(\n    relationship: Pick<\n      ResourceRelationship | ResourceRelationshipDeclaration,\n      'resourceType1' | 'resourceType2' | 'nature' | 'jointResourceType' | 'childOperations' | 'read' | 'foreignKeyField' | 'parentResourceRequirement' | 'cardinality1' | 'cardinality2'\n    > & Partial<Pick<ResourceRelationship, 'resolvedSemantics'>>\n  ): ResolvedRelationshipSemantics {\n    return this.hasValidResolvedRelationshipSemantics(relationship.resolvedSemantics)\n      ? relationship.resolvedSemantics\n      : this.resolveRelationshipSemantics(relationship);\n  }\n\n  /**\n   * Derive the engine-facing handling contract from the authored relationship\n   * semantics plus low-level nested/lifecycle settings.\n   *\n   * Keep the semantic layers distinct:\n   * - `RelationshipNature` answers what the relationship means\n   * - the explicit read contract answers the semantic read intent when authored\n   * - the returned contract answers what kind of DTO/mutation/read/lifecycle\n   *   handling the engine should expose\n   *\n   * Documentation rule:\n   * - `REFERENCE` = independent-resource pointer semantics\n   * - `ASSOCIATION` = peer membership/link semantics\n   * - `COMPOSITION` = aggregate-managed nested child semantics\n   *\n   * A frontend capability like `display.interaction.allowQuickCreate` must stay\n   * OUTSIDE this contract:\n   * - reference quick create = create independent resource, then set reference\n   * - association quick create = create independent peer, then link/replace\n   * - composition already owns native nested creation and does not need this\n   *   shortcut to explain its meaning\n   */\n  private static deriveRelationshipHandlingContract(\n    nature: RelationshipNature,\n    childOperations?: ChildOperationsConfig_Parsed,\n    resolvedReadModel?: RelationshipReadModel\n  ): RelationshipHandlingContract {\n    const baseContract: RelationshipHandlingContract = {\n      dtoModelMode: RelationshipDtoModel.REFERENCE_HANDLE,\n      mutationModelMode: RelationshipMutationModel.NONE,\n      lifecycleModelMode: RelationshipLifecycleModel.INDEPENDENT,\n      readModelMode: resolvedReadModel,\n      read: {\n        model: resolvedReadModel,\n      },\n    };\n\n    switch (nature) {\n      case RelationshipNature.COMPOSITION:\n        baseContract.dtoModelMode = RelationshipDtoModel.NESTED_RESOURCE;\n        baseContract.mutationModelMode = RelationshipMutationModel.AGGREGATE_MANAGED;\n        baseContract.lifecycleModelMode = RelationshipLifecycleModel.DEPENDENT;\n        break;\n      case RelationshipNature.ASSOCIATION:\n        baseContract.dtoModelMode = RelationshipDtoModel.ASSOCIATION_HANDLE;\n        baseContract.mutationModelMode = RelationshipMutationModel.ASSOCIATION_MANAGED;\n        baseContract.lifecycleModelMode = RelationshipLifecycleModel.LINK_ONLY;\n        break;\n      case RelationshipNature.REFERENCE:\n      default:\n        break;\n    }\n\n    const createConfig = childOperations?.nested?.onCreate;\n    const updateConfig = childOperations?.nested?.onUpdate;\n    const lifecycleOnDelete = childOperations?.lifecycle?.onParentDelete;\n\n    if (createConfig || updateConfig) {\n      baseContract.mutation = {\n        allowParentCreate: Boolean(createConfig),\n        allowParentUpdate: Boolean(updateConfig),\n        allowParentDelete: Boolean(updateConfig?.allowDelete),\n        maxDepth: Math.max(createConfig?.maxDepth ?? 0, updateConfig?.maxDepth ?? 0),\n      };\n    }\n\n    if (lifecycleOnDelete) {\n      baseContract.lifecycle = {\n        onParentDelete: {\n          enabled: lifecycleOnDelete.enabled,\n          mode: lifecycleOnDelete.mode ?? ChildLifecycleMode.IMMEDIATE,\n          // Project the teardown STRATEGY too — without it the derived semantic contract cannot\n          // distinguish a hard-delete cascade from an impersonalize-and-retain one.\n          strategy: lifecycleOnDelete.strategy ?? ChildLifecycleStrategy.DELETE,\n          maxDepth: lifecycleOnDelete.maxDepth,\n        },\n      };\n    }\n\n    return baseContract;\n  }\n\n  /**\n   * Derive runtime persistence behavior from the authored relationship topology.\n   *\n   * The declaration remains small: developers author cardinality, parent\n   * requirement, nature, and the FK field when disambiguation is needed. The\n   * framework compiles the persistence consequence here so storage adapters do\n   * not reinterpret relationship meaning independently.\n   *\n   * The contract is expressed from the HOLDER's perspective\n   * ({@link resolveForeignKeyHolderResourceType} — the side whose rows carry\n   * the FK column, resolved from cardinality, never from declaration order):\n   * - `holderResourceType` tells storage adapters WHICH resource the contract\n   *   applies to — an adapter building any other resource of the relationship\n   *   must not materialize or validate this FK there;\n   * - `required` means the holder's FK column is non-nullable (the referenced\n   *   parent is mandatory for every holder row);\n   * - `unique` means at most one holder row per referenced row, which is true\n   *   exactly when the relationship is a genuine 1:1 — BOTH sides\n   *   single-valued. Keying uniqueness off `cardinality2` alone (the previous\n   *   derivation) assumed parent-first declaration order: for child-first\n   *   N:1 references (`(TODOS, USERS, MANY, ONE)`) and self-referencing trees\n   *   (`(UNITS, UNITS, ONE, MANY)`) a single positional cardinality is ONE\n   *   while the relationship is not 1:1, which would emit a bogus unique\n   *   index on a shared FK.\n   */\n  private static deriveRelationshipPersistenceContract(\n    relationship: Pick<\n      ResourceRelationshipDeclaration,\n      'resourceType1' | 'resourceType2' | 'foreignKeyField' | 'parentResourceRequirement' | 'cardinality1' | 'cardinality2'\n    >,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): RelationshipPersistenceContract {\n    const foreignKeyIdentity = allResourceFieldIdentifiers\n      ? this.tryResolveRelationshipForeignKeyIdentity(relationship, allResourceFieldIdentifiers)\n      : relationship.foreignKeyField\n        ? {\n            fieldIdentifier: relationship.foreignKeyField,\n          }\n        : undefined;\n\n    if (!foreignKeyIdentity) {\n      return {};\n    }\n\n    const isArrayForeignKey = foreignKeyIdentity.fieldIdentifier.endsWith('Ids');\n    const holderResourceType = this.resolveForeignKeyHolderResourceType(relationship);\n    const isTrueOneToOne =\n      isOneToOneCardinality(relationship.cardinality1) &&\n      isOneToOneCardinality(relationship.cardinality2);\n\n    return {\n      foreignKey: {\n        fieldIdentifier: foreignKeyIdentity.fieldIdentifier,\n        holderResourceType,\n        isArray: isArrayForeignKey,\n        materializeField: true,\n        required: relationship.parentResourceRequirement !== ResourceParentResourceRequirement.OPTIONAL,\n        unique: !isArrayForeignKey && isTrueOneToOne,\n      },\n    };\n  }\n\n  private static assertRelationshipSemanticsCoherence(\n    relationship: Pick<ResourceRelationship, 'jointResourceType' | 'nature' | 'childOperations' | 'read'>,\n    resolvedNature: RelationshipNature,\n    childOperations?: ChildOperationsConfig_Parsed,\n    explicitRead?: RelationshipHandlingReadSettings\n  ): void {\n    const legacyReadModel = this.deriveLegacyRelationshipReadModel(\n      resolvedNature,\n      childOperations\n    );\n\n    if (resolvedNature === RelationshipNature.ASSOCIATION && !relationship.jointResourceType) {\n      throw new Error(\n        'Association semantics require jointResourceType. ' +\n        'Step 3 resolver refuses to treat non-junction relationships as ASSOCIATION.'\n      );\n    }\n\n    if (relationship.jointResourceType && relationship.nature && resolvedNature !== RelationshipNature.ASSOCIATION) {\n      throw new Error(\n        'Junction-backed relationships must resolve to ASSOCIATION semantics.'\n      );\n    }\n\n    if (resolvedNature === RelationshipNature.ASSOCIATION && childOperations) {\n      const hasAssociationNestedWrite =\n        Boolean(childOperations.nested?.onCreate || childOperations.nested?.onUpdate);\n      const hasAssociationNestedRead =\n        Boolean(childOperations.nested?.onRead);\n\n      if (hasAssociationNestedWrite || hasAssociationNestedRead) {\n        throw new Error(\n          'ASSOCIATION relationships cannot project nested read or mutation DTOs from the association declaration. ' +\n          'Declare explicit junction resource operations/views instead of using association-level childOperations.nested.'\n        );\n      }\n    }\n\n    if (resolvedNature === RelationshipNature.REFERENCE && childOperations) {\n      const hasReferenceLifecycle =\n        childOperations.lifecycle?.onParentDelete?.enabled === true;\n      const hasReferenceNestedWrite =\n        Boolean(childOperations.nested?.onCreate || childOperations.nested?.onUpdate);\n      const hasReferenceNestedRead =\n        Boolean(childOperations.nested?.onRead);\n\n      if (hasReferenceLifecycle || hasReferenceNestedWrite || hasReferenceNestedRead) {\n        throw new Error(\n          'REFERENCE relationships cannot project to nested CRUD/read embedding or dependent lifecycle. ' +\n          'Use COMPOSITION/ASSOCIATION semantics or remove the low-level childOperations settings.'\n        );\n      }\n    }\n\n    if (explicitRead) {\n      if (\n        explicitRead.model === RelationshipReadModel.EMBEDDED &&\n        resolvedNature !== RelationshipNature.COMPOSITION\n      ) {\n        throw new Error(\n          'EMBEDDED read semantics require nature=COMPOSITION.'\n        );\n      }\n\n      if (\n        explicitRead.model === RelationshipReadModel.ASSOCIATION_EMBEDDED &&\n        resolvedNature !== RelationshipNature.ASSOCIATION\n      ) {\n        throw new Error(\n          'ASSOCIATION_EMBEDDED read semantics require nature=ASSOCIATION.'\n        );\n      }\n\n      if (\n        childOperations?.nested?.onRead &&\n        explicitRead.model !== legacyReadModel\n      ) {\n        throw new Error(\n          'Explicit relationship read semantics contradict childOperations.nested.onRead. ' +\n          'Align the authored read contract with the nested read projection or remove one of them.'\n        );\n      }\n    }\n  }\n\n  /**\n   * M:N expansion is only safe when the declaration maps to one unambiguous edge\n   * per synthetic relationship. A self-referencing junction needs distinct source\n   * and target edge identities, which the current single-declaration model does\n   * not encode.\n   */\n  static assertSupportedManyToManySyntheticExpansion(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'jointResourceType'>\n  ): void {\n    if (relationship.jointResourceType && relationship.resourceType1 === relationship.resourceType2) {\n      throw new Error(\n        'Self-referencing MANY-to-MANY relationships cannot be expanded from a single declaration. ' +\n        'Declare explicit junction-resource relationships so source and target edge identity stay explicit.'\n      );\n    }\n  }\n\n  /**\n   * Returns true when a discriminator is structurally usable at runtime.\n   *\n   * A usable discriminator needs both a field name and at least one allowed\n   * value. Truthy-but-empty discriminator objects should not be treated as\n   * activation constraints.\n   */\n  static hasUsableRelationshipDiscriminator(\n    discriminator?: ResourceRelationship['discriminator']\n  ): boolean {\n    return Boolean(\n      discriminator?.discriminatorField &&\n      discriminator.values &&\n      discriminator.values.length > 0\n    );\n  }\n\n  /**\n   * Returns true when the relationship carries any runtime activation gate.\n   *\n   * Relationships without a usable discriminator (field + non-empty values) or\n   * a condition are unconditionally active.\n   */\n  static hasRelationshipActivationConstraint(\n    relationship: Pick<ResourceRelationship, 'discriminator' | 'condition'>\n  ): boolean {\n    return Boolean(\n      this.hasUsableRelationshipDiscriminator(relationship.discriminator) ||\n      relationship.condition\n    );\n  }\n\n  /**\n   * Check whether parent data matches a relationship discriminator.\n   *\n   * Discriminator values are string-based in the schema, so runtime values are\n   * coerced with `String()` before comparison. Missing/empty discriminators do\n   * not match.\n   */\n  static matchesRelationshipDiscriminator<T extends Record<string, any>>(\n    resource: T,\n    discriminator?: ResourceRelationship['discriminator']\n  ): boolean {\n    if (!this.hasUsableRelationshipDiscriminator(discriminator)) {\n      return false;\n    }\n\n    const fieldValue = resource[discriminator.discriminatorField];\n    return discriminator.values.includes(String(fieldValue));\n  }\n\n  /**\n   * Resolve whether a relationship is active for a given parent resource.\n   *\n   * Evaluation order is semantic, not caller-specific:\n   * 1. discriminator\n   * 2. condition\n   * 3. unconditional pass\n   *\n   * This keeps backend and frontend consumers aligned while still letting them\n   * choose how to handle missing parent data or thrown condition functions.\n   */\n  static isRelationshipActiveForParent(\n    relationship: Pick<ResourceRelationship, 'discriminator' | 'condition'>,\n    parentResource?: Record<string, any>,\n    options: RelationshipActivationEvaluationOptions = {}\n  ): boolean {\n    const {\n      onMissingParentResource = 'exclude',\n      onConditionError = 'throw',\n    } = options;\n\n    const hasConstraint = this.hasRelationshipActivationConstraint(relationship);\n    if (!parentResource) {\n      return hasConstraint ? onMissingParentResource === 'include' : true;\n    }\n\n    if (this.hasUsableRelationshipDiscriminator(relationship.discriminator)) {\n      if (!this.matchesRelationshipDiscriminator(parentResource, relationship.discriminator)) {\n        return false;\n      }\n    }\n\n    if (relationship.condition) {\n      try {\n        if (!relationship.condition(parentResource)) {\n          return false;\n        }\n      } catch (error) {\n        if (onConditionError === 'exclude') {\n          return false;\n        }\n        throw error;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Filter relationships to the subset that is active for a given parent.\n   */\n  static filterRelationshipsActiveForParent<T extends Pick<ResourceRelationship, 'discriminator' | 'condition'>>(\n    relationships: T[],\n    parentResource?: Record<string, any>,\n    options?: RelationshipActivationEvaluationOptions\n  ): T[] {\n    return relationships.filter((relationship) =>\n      this.isRelationshipActiveForParent(relationship, parentResource, options)\n    );\n  }\n\n}\n\n\n"]}
+{"version":3,"file":"resources.shared.utils.js","sourceRoot":"","sources":["../../../src/resources/resources.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resources Shared Utils\n *\n * Cross-layer resource helpers shared by backend, frontend, and shared-model\n * consumers. This includes ID helpers plus runtime relationship activation\n * evaluation.\n */\n\nimport {\n  ChildOperationsConfigSchema,\n  type ChildOperationsConfig_Parsed,\n  ChildLifecycleMode,\n  ChildLifecycleStrategy,\n} from './child-operations.shared.schemas';\nimport { HTTP_API_RESOURCE_ID_CHARSET } from '../http-api-binding/http-api-binding-id.shared.utils';\nimport { ResourcesConfigNamingUtils } from './utils/resources-config-naming.utils';\nimport { CoreResourceOperation, type ResourceType } from './resources.shared.core.definitions';\nimport {\n  RelationshipDtoModel,\n  RelationshipLifecycleModel,\n  RelationshipHandlingContractSchema,\n  RelationshipHandlingReadSettingsSchema,\n  RelationshipPersistenceContractSchema,\n  type RelationshipHandlingReadSettings,\n  type RelationshipHandlingContract,\n  type RelationshipPersistenceContract,\n  RelationshipMutationModel,\n  RelationshipNature,\n  ResourceRelationshipBulkAction,\n  ResourceRelationshipBulkOperationIdentifierPrefix,\n  RelationshipReadModel,\n  ResourceParentResourceRequirement,\n  type ResolvedRelationshipReadCalculationMode,\n  ResourceIdFormat,\n  isOneToOneCardinality,\n  isArrayCardinality,\n  type ResolvedRelationshipNatureCalculationMode,\n  type ResolvedRelationshipSemantics,\n  type ResourceRelationship,\n  type ResourceRelationshipDeclaration,\n  type ResourceRelationshipCardinality,\n  type ResourcePrimaryScope,\n  PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE,\n  type ManyToManyScopeJunction,\n  type ManyToManyScopeJunctionMap,\n} from './resources.shared.schemas';\nimport { ErrorType } from '../errors/errors.shared.schemas';\nimport type { PolymorphicFkVariant } from '@wildo-ai/zod-decorators';\nimport { getDiscriminatedPolymorphicForeignKey, getZodObjectShape, isForeignKeyField } from '@wildo-ai/zod-decorators';\nimport type { z } from 'zod';\n\nexport type RelationshipActivationConditionErrorMode = 'throw' | 'exclude';\nexport type RelationshipActivationMissingParentMode = 'include' | 'exclude';\n\nexport interface RelationshipActivationEvaluationOptions {\n  /**\n   * Behavior when the evaluator is asked to resolve a conditional relationship\n   * without parent data.\n   *\n   * - `exclude`: fail closed until parent data is available\n   * - `include`: treat the missing parent as non-blocking\n   */\n  onMissingParentResource?: RelationshipActivationMissingParentMode;\n\n  /**\n   * Behavior when a function-based relationship condition throws.\n   *\n   * Backend callers typically use `throw` so bugs propagate normally.\n   * Frontend callers may use `exclude` to fail safe without crashing the UI.\n   */\n  onConditionError?: RelationshipActivationConditionErrorMode;\n}\n\nexport interface ResolvedRelationshipForeignKeyIdentity {\n  parentResourceType: ResourceType;\n  childResourceType: ResourceType;\n  fieldIdentifier: string;\n  isExplicit: boolean;\n}\n\nexport interface ResolvedRelationshipObjectIdentity {\n  relatedResourceType: ResourceType;\n  relationshipIdentifierField: string;\n  objectFieldName: string;\n  isExplicit: boolean;\n}\n\nexport type RelationshipResourcePerspective = 'resourceType1' | 'resourceType2';\n\n/**\n * Database-agnostic Resource ID utilities\n *\n * Supports both MongoDB ObjectId (24-char hex) and PostgreSQL UUID formats.\n * Used across the entire stack for ID validation and format detection.\n */\nexport class Resources_SharedUtils {\n  private static readonly GENERATED_FILE_REGENERATE_OPERATION_PREFIX = 'pdfTemplates:regenerate:';\n  /**\n   * Namespace for the derived export companion of a LIST/SEARCH operation. Prefixed, like its\n   * sibling above, so a derived identifier can never collide with an authored custom operation and a\n   * reader can tell at a glance that nobody wrote it by hand.\n   */\n  private static readonly GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX = 'collectionExport:';\n\n  private static createConfigurationError(message: string): Error {\n    const error = new Error(message);\n    (error as { type?: ErrorType }).type = ErrorType.CONFIGURATION;\n    return error;\n  }\n\n  private static areResolvedRelationshipSemanticsEquivalent(\n    left: ResolvedRelationshipSemantics,\n    right: ResolvedRelationshipSemantics\n  ): boolean {\n    return JSON.stringify(left) === JSON.stringify(right);\n  }\n\n  private static hasValidResolvedRelationshipSemantics(\n    semantics: unknown\n  ): semantics is ResolvedRelationshipSemantics {\n    if (!semantics || typeof semantics !== 'object') {\n      return false;\n    }\n\n    const candidate = semantics as Partial<ResolvedRelationshipSemantics>;\n\n    return (\n      typeof candidate.natureCalculationMode === 'string' &&\n      (\n        candidate.readCalculationMode === 'explicit' ||\n        candidate.readCalculationMode === 'legacy_nested_read_fallback' ||\n        candidate.readCalculationMode === 'default_reference_only'\n      ) &&\n      Object.values(RelationshipNature).includes(candidate.nature as RelationshipNature) &&\n      candidate.natureCalculationMode === 'explicit' &&\n      RelationshipHandlingContractSchema.safeParse(candidate.handling).success &&\n      RelationshipPersistenceContractSchema.safeParse(candidate.persistence).success &&\n      (\n        candidate.childOperations === undefined ||\n        ChildOperationsConfigSchema.safeParse(candidate.childOperations).success\n      )\n    );\n  }\n\n\n  // ============================================================================\n  // Validation Patterns\n  // ============================================================================\n\n  /**\n   * MongoDB ObjectId pattern: exactly 24 hexadecimal characters\n   */\n  private static readonly OBJECT_ID_PATTERN = /^[a-fA-F0-9]{24}$/;\n\n  /**\n   * UUID pattern: 8-4-4-4-12 format with dashes\n   * Accepts any UUID version (v1, v4, etc.)\n   */\n  private static readonly UUID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;\n\n  /**\n   * UUID v4 pattern: stricter validation for version 4 UUIDs\n   * Position 13 must be '4', position 17 must be '8', '9', 'a', or 'b'\n   */\n  private static readonly UUID_V4_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$/;\n\n  // ============================================================================\n  // Validation Functions\n  // ============================================================================\n\n  /**\n   * Validates if a string is a valid MongoDB ObjectId format\n   * @param id - String to validate\n   * @returns true if the string is a valid 24-character hexadecimal ObjectId\n   * \n   * @example\n   * Resources_SharedUtils.isObjectId('507f1f77bcf86cd799439011') // true\n   * Resources_SharedUtils.isObjectId('invalid') // false\n   * Resources_SharedUtils.isObjectId('550e8400-e29b-41d4-a716-446655440000') // false (this is UUID)\n   */\n  static isObjectId(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return Resources_SharedUtils.OBJECT_ID_PATTERN.test(id);\n  }\n\n  /**\n   * Validates if a string is a valid UUID format (any version)\n   * @param id - String to validate\n   * @returns true if the string is a valid UUID with dashes\n   * \n   * @example\n   * Resources_SharedUtils.isUUID('550e8400-e29b-41d4-a716-446655440000') // true\n   * Resources_SharedUtils.isUUID('507f1f77bcf86cd799439011') // false (this is ObjectId)\n   * Resources_SharedUtils.isUUID('not-a-uuid') // false\n   */\n  static isUUID(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return Resources_SharedUtils.UUID_PATTERN.test(id);\n  }\n\n  /**\n   * Validates if a string is a valid UUID v4 format (strict)\n   * @param id - String to validate\n   * @returns true if the string is a valid UUID version 4\n   * \n   * @example\n   * Resources_SharedUtils.isUUIDv4('550e8400-e29b-41d4-a716-446655440000') // true\n   * Resources_SharedUtils.isUUIDv4('550e8400-e29b-11d4-a716-446655440000') // false (this is UUID v1)\n   */\n  static isUUIDv4(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return Resources_SharedUtils.UUID_V4_PATTERN.test(id);\n  }\n\n  /**\n   * Detects the format of a resource ID\n   * @param id - String to analyze\n   * @returns The detected format, or null if the string is not a valid resource ID\n   * \n   * @example\n   * Resources_SharedUtils.detectIdFormat('507f1f77bcf86cd799439011') // ResourceIdFormat.OBJECT_ID\n   * Resources_SharedUtils.detectIdFormat('550e8400-e29b-41d4-a716-446655440000') // ResourceIdFormat.UUID\n   * Resources_SharedUtils.detectIdFormat('invalid') // null\n   */\n  static detectIdFormat(id: string): ResourceIdFormat | null {\n    if (Resources_SharedUtils.isObjectId(id)) return ResourceIdFormat.OBJECT_ID;\n    if (Resources_SharedUtils.isUUID(id)) return ResourceIdFormat.UUID;\n    return null;\n  }\n\n  /**\n   * Validates if a string is a valid resource ID in any supported format\n   * @param id - String to validate\n   * @returns true if the string is either a valid ObjectId or UUID\n   * \n   * @example\n   * Resources_SharedUtils.isValidResourceId('507f1f77bcf86cd799439011') // true (ObjectId)\n   * Resources_SharedUtils.isValidResourceId('550e8400-e29b-41d4-a716-446655440000') // true (UUID)\n   * Resources_SharedUtils.isValidResourceId('invalid') // false\n   */\n  static isValidResourceId(id: string): boolean {\n    return Resources_SharedUtils.detectIdFormat(id) !== null;\n  }\n\n  /**\n   * Validates if a string is a valid resource ID for a specific format\n   * @param id - String to validate\n   * @param format - Expected format\n   * @returns true if the string matches the expected format\n   * \n   * @example\n   * Resources_SharedUtils.isValidResourceIdForFormat('507f1f77bcf86cd799439011', ResourceIdFormat.OBJECT_ID) // true\n   * Resources_SharedUtils.isValidResourceIdForFormat('507f1f77bcf86cd799439011', ResourceIdFormat.UUID) // false\n   */\n  static isValidResourceIdForFormat(id: string, format: ResourceIdFormat): boolean {\n    switch (format) {\n      case ResourceIdFormat.OBJECT_ID:\n        return Resources_SharedUtils.isObjectId(id);\n      case ResourceIdFormat.UUID:\n        return Resources_SharedUtils.isUUID(id);\n      case ResourceIdFormat.HTTP_API_SYNTHESIZED:\n        return Resources_SharedUtils.isHttpApiSynthesizedId(id);\n      case ResourceIdFormat.INTROSPECTION_SYNTHESIZED:\n        return Resources_SharedUtils.isIntrospectionSynthesizedId(id);\n      default:\n        return false;\n    }\n  }\n\n  /**\n   * Lexical shape of an `HTTP_API`-backed resource's synthesized id — the codec charset law.\n   *\n   * Deliberately NOT consulted by {@link detectIdFormat} / {@link isValidResourceId}: every\n   * ObjectId and UUID also matches this charset, so lexical detection cannot distinguish the\n   * formats, and widening the generic validators would silently relax id validation for every\n   * PLATFORM-backed resource. This predicate participates only where the resource is already\n   * known to be HTTP_API-backed (`ResourceIdBackendService.getFormatForResource` resolves that\n   * from the registry). Canonicality (one row, one id) is enforced by the codec's decode, not\n   * here — this is shape admission, not decode.\n   */\n  static isHttpApiSynthesizedId(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return HTTP_API_RESOURCE_ID_CHARSET.test(id);\n  }\n\n  /**\n   * Lexical shape of an `INTROSPECTION`-backed resource's id.\n   *\n   * The SAME charset law as its HTTP-API sibling — URL-unreserved characters — reused rather than\n   * restated so the two cannot drift into disagreeing about what a URL-safe key is. The predicates\n   * stay separate because the FORMATS are separate: a caller asks \"is this a valid id for THIS\n   * resource\", and answering through the sibling's name would make the next reader think an\n   * introspected row had been through the HTTP-API codec.\n   *\n   * Carries the same exclusion: not consulted by {@link isValidResourceId}, so no platform-backed\n   * row is loosened by its existence.\n   */\n  static isIntrospectionSynthesizedId(id: string): boolean {\n    if (typeof id !== 'string') return false;\n    return HTTP_API_RESOURCE_ID_CHARSET.test(id);\n  }\n\n  /**\n   * Asserts that a value is a valid resource ID, throwing an error if not\n   * @param id - Value to validate\n   * @param fieldName - Name of the field for error messages\n   * @throws Error if the value is not a valid resource ID\n   * \n   * @example\n   * Resources_SharedUtils.assertValidResourceId('507f1f77bcf86cd799439011', 'userId') // passes\n   * Resources_SharedUtils.assertValidResourceId('invalid', 'userId') // throws Error\n   */\n  static assertValidResourceId(id: unknown, fieldName: string = 'id'): asserts id is string {\n    if (typeof id !== 'string') {\n      throw new Error(`${fieldName} must be a string, got ${typeof id}`);\n    }\n    if (!Resources_SharedUtils.isValidResourceId(id)) {\n      throw new Error(`${fieldName} must be a valid resource ID (MongoDB ObjectId or UUID), got: ${id}`);\n    }\n  }\n\n  // ============================================================================\n  // Relationship Activation\n  // ============================================================================\n\n  /**\n   * Resolve the relationship identifier field used to expose nested/context\n   * object names to framework consumers.\n   *\n   * Naming follows the FK-anchor / FK-target distinction:\n   *\n   *   - `foreignKeyField` lives on `resourceType2` (the FK-anchor side) and\n   *     semantically identifies `resourceType1` (the FK-target side).\n   *     `'assignedToUserId'` on a `tasks` row identifies the assigned-to user;\n   *     `'userId'` on an `organizationMembers` row identifies the user it\n   *     belongs to.\n   *\n   *   - When the caller is naming the **FK-target side** (i.e.\n   *     `relatedResourceType === resourceType1`), the FK is the semantic name\n   *     carrier — e.g. `'assignedToUser'` falls out of `'assignedToUserId'`.\n   *     Using the FK preserves multi-edge differentiation when several FKs\n   *     point to the same parent type (createdBy / assignedTo / reviewer all\n   *     resolve to distinct field names).\n   *\n   *   - When the caller is naming the **FK-anchor side** (i.e.\n   *     `relatedResourceType === resourceType2`), the FK is *not* a name for\n   *     this side — it names the OTHER side. Using it produces a wrong\n   *     parent-flavoured name on the child field (e.g. `userId` would yield\n   *     `'users'` instead of `'organizationMembers'`). The correct name is\n   *     derived from the related resource type itself.\n   *\n   *   - Self-references (`resourceType1 === resourceType2`) always use the FK\n   *     for semantic differentiation (`parentDocumentId` → `'parentDocument'`\n   *     vs `childDocumentId` → `'childDocument'`).\n   *\n   * **This function is the ONE authority for a CONTEXT projection's field name.**\n   * `ResourcesConfigOperations_DtosBuilderUtils.addRelationshipPlaceholders` declares the\n   * placeholder with it, and `ResourcePopulationBackendService.populateForContext` writes the\n   * populated value with it. Do not re-derive a context field name anywhere else.\n   *\n   * Population used to derive its own — `singularize(resourceType2)` for 1:1, `resourceType2`\n   * verbatim for 1:many — and this comment asserted the two were \"structurally equivalent\".\n   * **They are not, and the false claim stood here while the defect it describes was live.**\n   * The FK-anchor-side branch below derives from the related resource's AUTHORED\n   * `resourceFieldIdentifier`, whose stem need not be the singular of the resource type\n   * (`userSelfPreferencesId` → `userSelfPreferences`, while `singularize('userSelfPreferences')`\n   * is `userSelfPreference`), and `toResourceName` re-pluralizes that stem for 1:many\n   * (`organizationInvoiceRef` → `organizationInvoiceReves`). Measured over the core registry on\n   * 2026-09-10: of its 111 relationships **37 carry an enabled `contextPolicy`, and the two\n   * derivations disagreed on 11 of those 37** — every one of those fields was populated by the\n   * backend and then silently Zod-stripped on the way out the controller, with no error and no log\n   * on any surface. That is what left every date in every generated application formatted at the\n   * i18n floor: the member's own regional preferences never reached the client (issue #563).\n   *\n   * Pinned by `engine/saas-models/src/resources/__tests__/context-projection-field-name-agreement.test.ts`\n   * and by `saas-backend-lib`'s `resource-population.context-field-name.test.ts`. What those pin,\n   * precisely: that the DTO declares THIS function's name, that the producer writes THIS\n   * function's name, and that the live core registry still contains a relationship where the\n   * retired local derivation would disagree. They do NOT enumerate every generated DTO.\n   *\n   * ⚠️ A THIRD derivation of the same name exists and is NOT covered — the API-reference /\n   * OpenAPI path builds its DTOs from `createResourceConfiguration_Initialization`, which passes\n   * an EMPTY registry map, so this function falls through to\n   * `toResourceFieldIdentifier(relatedResourceType)` and produces the singular fallback. The\n   * published reference therefore says `userSelfPreference` where the runtime says\n   * `userSelfPreferences`. Pre-existing (the divergence long predates #563) and tracked\n   * separately; do not assume the generated reference agrees with the runtime.\n   */\n  static resolveRelationshipObjectIdentity(\n    relationship: Pick<\n      ResourceRelationship,\n      'foreignKeyField' | 'resourceType1' | 'resourceType2'\n    >,\n    relatedResourceType: ResourceType,\n    cardinality: ResourceRelationshipCardinality,\n    allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipObjectIdentity {\n    const isSelfReference = relationship.resourceType1 === relationship.resourceType2;\n    const isNamingFkTargetSide = relatedResourceType === relationship.resourceType1;\n    const useForeignKeyForNaming = isSelfReference || isNamingFkTargetSide;\n\n    const relationshipIdentifierField = (useForeignKeyForNaming && relationship.foreignKeyField)\n      || allResourceFieldIdentifiers[relatedResourceType]\n      || ResourcesConfigNamingUtils.toResourceFieldIdentifier(relatedResourceType);\n\n    return {\n      relatedResourceType,\n      relationshipIdentifierField,\n      objectFieldName: isOneToOneCardinality(cardinality)\n        ? ResourcesConfigNamingUtils.extractBaseName(relationshipIdentifierField)\n        : ResourcesConfigNamingUtils.toResourceName(relationshipIdentifierField),\n      isExplicit: useForeignKeyForNaming && Boolean(relationship.foreignKeyField),\n    };\n  }\n\n  /**\n   * Resolve the relationship object identity from the perspective of one of the\n   * relationship's two resource types.\n   *\n   * This is the caller-facing field name the current resource would use when it\n   * refers to the relationship as an object/collection (`user`, `products`,\n   * `productConsumptions`, ...).\n   */\n  static resolveRelationshipObjectIdentityForResource(\n    relationship: Pick<\n      ResourceRelationship,\n      'resourceType1' | 'resourceType2' | 'cardinality1' | 'cardinality2' | 'foreignKeyField'\n    >,\n    currentResourceType: ResourceType,\n    allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipObjectIdentity {\n    if (relationship.resourceType1 === currentResourceType) {\n      return this.resolveRelationshipObjectIdentity(\n        relationship,\n        relationship.resourceType2,\n        relationship.cardinality2,\n        allResourceFieldIdentifiers\n      );\n    }\n\n    if (relationship.resourceType2 === currentResourceType) {\n      return this.resolveRelationshipObjectIdentity(\n        relationship,\n        relationship.resourceType1,\n        relationship.cardinality1,\n        allResourceFieldIdentifiers\n      );\n    }\n\n    throw new Error(\n      `Cannot resolve relationship object identity for resource \"${currentResourceType}\". ` +\n      `The relationship ${relationship.resourceType1} -> ${relationship.resourceType2} does not include that resource type.`\n    );\n  }\n\n  static getRelationshipPerspectiveForResource(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2'>,\n    currentResourceType: ResourceType\n  ): RelationshipResourcePerspective | undefined {\n    if (relationship.resourceType1 === currentResourceType && relationship.resourceType2 === currentResourceType) {\n      return undefined;\n    }\n    if (relationship.resourceType1 === currentResourceType) {\n      return 'resourceType1';\n    }\n    if (relationship.resourceType2 === currentResourceType) {\n      return 'resourceType2';\n    }\n    return undefined;\n  }\n\n  /**\n   * Resolve which resource a foreign-key relationship REFERENCES (the target),\n   * vs which resource HOLDS the FK column (the holder).\n   *\n   * The registry's `fieldIdentifierToResourceType` must map a foreign-key field\n   * to the resource it **references** (`assignedToUserId → users`,\n   * `createdByUserId → users`) so reference pickers, FK display links, and\n   * `resolveResourceTypeForForeignKey` all resolve the referenced resource — NOT\n   * the resource that stores the column.\n   *\n   * `resourceType1` / `resourceType2` order is author-declaration dependent and\n   * is therefore NOT a reliable target signal: a child-first declaration like\n   * `createResourcesRelationship(TODOS, USERS, MANY, ONE, { foreignKeyField:\n   * 'assignedToUserId' })` stores `rt1 = todos` (the HOLDER), `rt2 = users` (the\n   * target). Mapping the FK to `resourceType1` (the historical behavior) yields\n   * `assignedToUserId → todos`, which sends a user-reference picker to search\n   * todos and links FK values to the wrong resource.\n   *\n   * Ground truth = **schema membership**: the FK column is declared on exactly\n   * one of the two resources (the holder); the other side is the referenced\n   * target. The loop that builds the map only processes explicit\n   * `foreignKeyField`s, which are always real columns on their holder's schema,\n   * so membership resolves every real case (N:1, 1:N, 1:1) regardless of\n   * declaration order. `allResourceFieldIdentifiers` standard-id equality is a\n   * belt-and-suspenders fallback for callers that cannot introspect schemas.\n   *\n   * @param relationship the FK relationship (must carry `foreignKeyField`)\n   * @param context.allResourceFieldIdentifiers resourceType → its standard id field\n   * @param context.schemaDeclaresField `(resourceType, field) => true` iff the\n   *        resource's OWN main schema declares `field` as a column (it HOLDS the FK)\n   */\n  static resolveForeignKeyReferencedResourceType(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>,\n    context: {\n      allResourceFieldIdentifiers: Record<string, string>;\n      schemaDeclaresField: (resourceType: string, fieldName: string) => boolean;\n    },\n  ): { referencedResourceType: string; holderResourceType: string } {\n    const rt1 = relationship.resourceType1;\n    const rt2 = relationship.resourceType2;\n    const fk = relationship.foreignKeyField;\n\n    if (fk) {\n      const rt1Holds = context.schemaDeclaresField(rt1, fk);\n      const rt2Holds = context.schemaDeclaresField(rt2, fk);\n      if (rt1Holds && !rt2Holds) return { holderResourceType: rt1, referencedResourceType: rt2 };\n      if (rt2Holds && !rt1Holds) return { holderResourceType: rt2, referencedResourceType: rt1 };\n\n      // Fallback — the FK equals a side's standard id (a standard FK pointing at it).\n      if (context.allResourceFieldIdentifiers[rt2] === fk) return { holderResourceType: rt1, referencedResourceType: rt2 };\n      if (context.allResourceFieldIdentifiers[rt1] === fk) return { holderResourceType: rt2, referencedResourceType: rt1 };\n    }\n\n    // Last resort (no fk / genuinely ambiguous): preserve the legacy rt1 target.\n    return { holderResourceType: rt2, referencedResourceType: rt1 };\n  }\n\n  /**\n   * Build the registry's `fieldIdentifierToResourceType` reverse map — THE ONE\n   * implementation.\n   *\n   * This logic existed as two hand-kept copies (the backend registry service\n   * and the frontend resources repository) plus was about to grow a third for\n   * the app-creation FK-resolution verification check — exactly the\n   * security-predicate-drift shape `two-buildcontextualfilter-implementations`\n   * records. Every consumer now routes through here; a semantic change to FK\n   * resolution lands once.\n   *\n   * Semantics (unchanged from the two copies it replaces):\n   * 1. Seed from standard field identifiers (`userId → USERS`), tracking\n   *    identifiers SHARED by several resource types (USERS / USER_SELF).\n   * 2. Enrich with every relationship's explicit `foreignKeyField`, mapped to\n   *    the resource it REFERENCES (resolved structurally via schema\n   *    membership — declaration-order independent, see\n   *    {@link resolveForeignKeyReferencedResourceType}). Shared-identifier\n   *    convergence and per-record discriminated polymorphic FKs are tolerated;\n   *    a genuine same-name-different-target clash is reported through\n   *    `onForeignKeyCollision` (log, never throw — an authoring slip must not\n   *    crash registry boot) and the FIRST mapping is kept.\n   * 3. Canonical-priority pass for shared identifiers\n   *    (`coreResourceShared_FieldIdentifierPriority`), so the winner is policy,\n   *    not iteration order.\n   */\n  static buildFieldIdentifierToResourceTypeMap(input: {\n    allResourceFieldIdentifiers: Record<string, string>;\n    allResourceRelationships: ReadonlyArray<ResourceRelationship>;\n    /** resourceType → its materialized main schema (used for holder resolution + polymorphic tolerance). */\n    getMainSchema: (resourceType: string) => z.ZodTypeAny | undefined;\n    /** resourceType → canonical priority for SHARED standard identifiers. */\n    fieldIdentifierPriority: Record<string, string>;\n    onForeignKeyCollision?: (collision: { foreignKeyField: string; existingType: string; referencedResourceType: string }) => void;\n  }): Record<string, string> {\n    const fieldIdentifierToResourceType: Record<string, string> = {};\n    const sharedFieldIdentifiers = new Map<string, Set<string>>();\n    for (const [resourceType, fieldIdentifier] of Object.entries(input.allResourceFieldIdentifiers)) {\n      const existing = fieldIdentifierToResourceType[fieldIdentifier];\n      if (existing && existing !== resourceType) {\n        if (!sharedFieldIdentifiers.has(fieldIdentifier)) {\n          sharedFieldIdentifiers.set(fieldIdentifier, new Set([existing]));\n        }\n        sharedFieldIdentifiers.get(fieldIdentifier)!.add(resourceType);\n      }\n      fieldIdentifierToResourceType[fieldIdentifier] = resourceType;\n    }\n\n    const schemaDeclaresField = (resourceType: string, fieldName: string): boolean => {\n      const schema = input.getMainSchema(resourceType);\n      if (!schema) return false;\n      return Object.prototype.hasOwnProperty.call(getZodObjectShape(schema) ?? {}, fieldName);\n    };\n    for (const rel of input.allResourceRelationships) {\n      if (!rel.foreignKeyField) continue;\n      const { referencedResourceType, holderResourceType } = Resources_SharedUtils.resolveForeignKeyReferencedResourceType(\n        rel,\n        { allResourceFieldIdentifiers: input.allResourceFieldIdentifiers, schemaDeclaresField },\n      );\n      const existingType = fieldIdentifierToResourceType[rel.foreignKeyField];\n      if (existingType && existingType !== referencedResourceType) {\n        const sharedTypes = sharedFieldIdentifiers.get(rel.foreignKeyField);\n        if (sharedTypes && (sharedTypes.has(referencedResourceType) || sharedTypes.has(existingType))) {\n          continue;\n        }\n        const holderSchema = input.getMainSchema(holderResourceType);\n        const holderFkSchema = holderSchema ? (getZodObjectShape(holderSchema) ?? {})[rel.foreignKeyField] : undefined;\n        if (holderFkSchema && getDiscriminatedPolymorphicForeignKey(holderFkSchema)) {\n          continue;\n        }\n        input.onForeignKeyCollision?.({ foreignKeyField: rel.foreignKeyField, existingType, referencedResourceType });\n        continue;\n      }\n      fieldIdentifierToResourceType[rel.foreignKeyField] = referencedResourceType;\n    }\n\n    for (const [fieldId, canonicalType] of Object.entries(input.fieldIdentifierPriority)) {\n      if (sharedFieldIdentifiers.has(fieldId)) {\n        fieldIdentifierToResourceType[fieldId] = canonicalType;\n      }\n    }\n    return fieldIdentifierToResourceType;\n  }\n\n  /**\n   * The FK-resolution SWEEP: every schema field carrying `.isForeignKey()` that\n   * the map above cannot resolve to a resource type.\n   *\n   * This is the exact eager check the frontend registry runs at\n   * initialization (where an unresolved field is `frontend_fk_resolution_failed`\n   * and, in development, refuses the whole app). Exposed here so the\n   * app-creation verification lane can run the SAME sweep headless — after a\n   * compose or a coding mutation — instead of the defect surfacing in the\n   * builder's browser (wonder-crm, 2026-08-27: three composed resources carried\n   * a decorated `createdByUserId` with no relationship edge; typecheck and the\n   * backend boot were both green).\n   */\n  static collectUnresolvableForeignKeyFields(input: {\n    /** resourceType → materialized main schema. */\n    mainSchemasByResourceType: Record<string, z.ZodTypeAny | undefined>;\n    fieldIdentifierToResourceType: Record<string, string>;\n  }): Array<{ resourceType: string; fieldName: string }> {\n    const unresolved: Array<{ resourceType: string; fieldName: string }> = [];\n    for (const [resourceType, schema] of Object.entries(input.mainSchemasByResourceType)) {\n      if (!schema) continue;\n      const shape = getZodObjectShape(schema);\n      if (!shape) continue;\n      for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n        if (!isForeignKeyField(fieldSchema as z.ZodTypeAny)) continue;\n        if (!input.fieldIdentifierToResourceType[fieldName]) {\n          unresolved.push({ resourceType, fieldName });\n        }\n      }\n    }\n    return unresolved;\n  }\n\n  /**\n   * Resolve which side of a foreign-key relationship HOLDS the FK column, from\n   * cardinality topology alone — no registry / schema access required.\n   *\n   * The FK column physically lives on the collection side of a 1:N / N:1\n   * relationship: each of the \"many\" rows carries one reference to its \"one\"\n   * counterpart. Declaration order is an authoring convenience — parent-first\n   * `(ORGANIZATIONS, TODOS, ONE, MANY)` and child-first\n   * `(TODOS, USERS, MANY, ONE, { foreignKeyField: 'assignedToUserId' })` are\n   * both valid — so positional `resourceType2` reads are NOT a holder signal\n   * (see {@link resolveForeignKeyReferencedResourceType}, the schema-membership\n   * variant of the same invariant used where registry schemas are available).\n   *\n   * Resolution rules:\n   * - self-reference (`resourceType1 === resourceType2`) → the resource holds\n   *   its own FK (tree parent ids, self-referencing junction arrays);\n   * - exactly one collection side (`MANY` / `ONE_OR_MANY`) → that side holds;\n   * - 1:1 (no collection side) → `resourceType2`, per the parent-first child\n   *   convention (`resourceType1` = parent, `resourceType2` = child carrying\n   *   the unique FK — e.g. context-addressed composition singletons);\n   * - both sides collections (M:N) only carries a `foreignKeyField`\n   *   self-referentially (guarded at declaration time), which the\n   *   self-reference rule already covers; the defensive fallback stays\n   *   `resourceType2`.\n   */\n  static resolveForeignKeyHolderResourceType(\n    relationship: Pick<\n      ResourceRelationshipDeclaration,\n      'resourceType1' | 'resourceType2' | 'cardinality1' | 'cardinality2'\n    >\n  ): ResourceType {\n    if (relationship.resourceType1 === relationship.resourceType2) {\n      return relationship.resourceType1;\n    }\n\n    const side1IsCollection = isArrayCardinality(relationship.cardinality1);\n    const side2IsCollection = isArrayCardinality(relationship.cardinality2);\n\n    if (side1IsCollection && !side2IsCollection) {\n      return relationship.resourceType1;\n    }\n    if (side2IsCollection && !side1IsCollection) {\n      return relationship.resourceType2;\n    }\n\n    return relationship.resourceType2;\n  }\n\n  /**\n   * Collect the candidate referenced resource types for a SHARED foreign-key\n   * field on a given holder — every resource the holder's `foreignKeyField` can\n   * point at, gathered from the registered relationships.\n   *\n   * Used to enumerate the branches of a per-record discriminated polymorphic FK\n   * (e.g. referrals' `referrerBillingAccountId` → [`userBillingAccounts`,\n   * `organizationBillingAccounts`]). The holder DECLARES the FK column, so the\n   * referenced side of each matching relationship is the side that is NOT the\n   * holder.\n   */\n  static getForeignKeyCandidateReferencedTypes(\n    foreignKeyField: string,\n    holderResourceType: string,\n    relationships: ReadonlyArray<Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>>,\n  ): string[] {\n    const referenced: string[] = [];\n    for (const rel of relationships) {\n      if (rel.foreignKeyField !== foreignKeyField) continue;\n      if (rel.resourceType1 === holderResourceType) referenced.push(rel.resourceType2);\n      else if (rel.resourceType2 === holderResourceType) referenced.push(rel.resourceType1);\n    }\n    return referenced;\n  }\n\n  /**\n   * Resolve the concrete branch a per-record DISCRIMINATED polymorphic FK points\n   * at, for a specific holder record.\n   *\n   * A flat resource (e.g. `referrals`) may hold ONE shared FK column\n   * (`referrerBillingAccountId`) that targets a polymorphic branch GROUP\n   * (`billingAccounts` → `userBillingAccounts` | `organizationBillingAccounts`).\n   * Which branch a given record points at is decided by a sibling discriminator\n   * field on the SAME record (`referrerScopeType`).\n   *\n   * Resolution rides the scope axis the polymorphic system is already built on\n   * — there is NO bespoke value→target map:\n   *  1. Read the discriminator value off the record.\n   *  2. Find the {@link PolymorphicFkVariant} whose `discriminatorValue` matches —\n   *     this yields the variant's scope-root `parentResourceType` (e.g.\n   *     `'organizations'`).\n   *  3. Return the candidate branch whose `resourcePrimaryScope`, mapped back to\n   *     its scope root via `PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE`, equals that\n   *     `parentResourceType`.\n   *\n   * Returns `undefined` (caller degrades to the registry's non-authoritative\n   * representative) when the discriminator value is absent/unknown or no\n   * candidate branch matches the variant's scope.\n   *\n   * @param context.record the holder record (must carry the discriminator field)\n   * @param context.discriminatorField sibling field naming the branch selector\n   * @param context.variants the FK's polymorphic variants (each with `discriminatorValue`)\n   * @param context.candidateReferencedTypes branches from\n   *        {@link getForeignKeyCandidateReferencedTypes}\n   * @param context.getResourcePrimaryScope `(rt) => its primary scope` (registry lookup)\n   */\n  static resolveDiscriminatedPolymorphicForeignKeyTarget(context: {\n    record: Record<string, unknown>;\n    discriminatorField: string;\n    variants: ReadonlyArray<PolymorphicFkVariant>;\n    candidateReferencedTypes: ReadonlyArray<string>;\n    getResourcePrimaryScope: (resourceType: string) => ResourcePrimaryScope | undefined;\n  }): string | undefined {\n    const rawValue = context.record[context.discriminatorField];\n    if (rawValue === undefined || rawValue === null) return undefined;\n    const discriminatorValue = String(rawValue);\n\n    const variant = context.variants.find(v => v.discriminatorValue === discriminatorValue);\n    if (!variant) return undefined;\n\n    return context.candidateReferencedTypes.find(referencedType => {\n      const scope = context.getResourcePrimaryScope(referencedType);\n      if (scope === undefined) return false;\n      return (PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE[scope] as string) === variant.parentResourceType;\n    });\n  }\n\n  /**\n   * Stable key for {@link ManyToManyScopeJunctionMap}: a `(target, scope)` pair.\n   * Uses a `|` separator, which cannot appear in resource-type identifiers, so\n   * `(a, b|c)` and `(a|b, c)` can never collide.\n   */\n  static manyToManyScopeJunctionKey(targetResourceType: string, scopeResourceType: string): string {\n    return `${targetResourceType}|${scopeResourceType}`;\n  }\n\n  /**\n   * Derive the {@link ManyToManyScopeJunctionMap} from the registered\n   * relationships — the registry signal that powers inference-based scope-required\n   * reference search (see `.claude/plans/fk-filter-reference-search.md`).\n   *\n   * For every MANY-to-MANY relationship (one carrying a `jointResourceType` whose\n   * two sides are the PEERS, not the junction itself), both orderings are\n   * recorded: either peer may be the search TARGET with the other as the SCOPE.\n   * The junction's per-peer FK columns are resolved by convention as each peer's\n   * `resourceFieldIdentifier` (e.g. `organizationMembers` carries `userId` /\n   * `organizationId`).\n   *\n   * Robust to being called on raw OR post-expansion relationships: synthetic\n   * `peer → junction` edges (which also carry `jointResourceType`) are excluded\n   * because one of their sides IS the junction.\n   *\n   * Q4 (fail-closed): if two DISTINCT junctions relate the same `(target, scope)`\n   * pair, throws a configuration error — a scope-required search cannot\n   * deterministically choose a junction. No such case exists in core today\n   * (`organizations ↔ users via organizationMembers` is the only M:N).\n   *\n   * @param relationships the registered relationships (compiled or raw)\n   * @param allResourceFieldIdentifiers `resourceType → its standard id field`\n   */\n  static buildManyToManyScopeJunctionMap(\n    relationships: ReadonlyArray<Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'jointResourceType'>>,\n    allResourceFieldIdentifiers: Record<string, string>,\n  ): ManyToManyScopeJunctionMap {\n    const map = new Map<string, ManyToManyScopeJunction>();\n\n    const record = (target: string, scope: string, junction: string, targetFk: string, scopeFk: string): void => {\n      const key = this.manyToManyScopeJunctionKey(target, scope);\n      const existing = map.get(key);\n      if (existing && existing.junctionResourceType !== junction) {\n        throw this.createConfigurationError(\n          `Ambiguous M:N scope junction for target '${target}' scoped by '${scope}': both ` +\n          `'${existing.junctionResourceType}' and '${junction}' join them. A scope-required ` +\n          `reference search cannot deterministically choose a junction — declare a single M:N ` +\n          `between these resources.`,\n        );\n      }\n      map.set(key, { junctionResourceType: junction, targetFkField: targetFk, scopeFkField: scopeFk });\n    };\n\n    for (const rel of relationships) {\n      const junction = rel.jointResourceType;\n      if (!junction) continue;                                  // only M:N relationships carry a junction\n      const peerA = rel.resourceType1;\n      const peerB = rel.resourceType2;\n      if (peerA === junction || peerB === junction) continue;   // skip synthetic peer→junction edges\n      if (peerA === peerB) continue;                            // self-ref M:N is modeled explicitly, not here\n      const peerAFk = allResourceFieldIdentifiers[peerA];\n      const peerBFk = allResourceFieldIdentifiers[peerB];\n      if (!peerAFk || !peerBFk) continue;                       // junction FK columns unresolvable → skip defensively\n\n      record(peerA, peerB, junction, peerAFk, peerBFk);\n      record(peerB, peerA, junction, peerBFk, peerAFk);\n    }\n\n    return map;\n  }\n\n  /**\n   * Resolve the M:N scope junction to use for a **scope-required reference\n   * search** of `targetResourceType`, given the scope parameters available in\n   * the current context (e.g. a people-picker on a task filter has the caller's\n   * `organizationId` injected by the app scope).\n   *\n   * Returns the junction for the first `(target, scope)` entry whose\n   * `scopeFkField` is present in `availableContextFields` — i.e. \"search this\n   * target scoped through the junction to the scope the caller is already in\".\n   * Returns `undefined` when the target has no M:N junction reachable from the\n   * available context, meaning the picker should do a plain unscoped target\n   * search. This is the registry-inference that drives scope-required reference\n   * search on the frontend (see `.claude/plans/fk-filter-reference-search.md`) —\n   * no per-field declaration needed.\n   */\n  static findScopeJunctionForTargetInContext(\n    manyToManyScopeJunctions: ManyToManyScopeJunctionMap,\n    targetResourceType: string,\n    availableContextFields: ReadonlySet<string>,\n  ): ManyToManyScopeJunction | undefined {\n    for (const [key, junction] of manyToManyScopeJunctions) {\n      const separatorIndex = key.indexOf('|');\n      const entryTarget = separatorIndex === -1 ? key : key.slice(0, separatorIndex);\n      if (entryTarget !== targetResourceType) continue;\n      if (availableContextFields.has(junction.scopeFkField)) {\n        return junction;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Build the generated custom-operation identifier used to expose explicit bulk\n   * relationship actions at the resource-operation layer.\n   */\n  static buildRelationshipBulkOperationIdentifier(\n    action: ResourceRelationshipBulkAction,\n    relationshipField: string\n  ): string {\n    return `${ResourceRelationshipBulkOperationIdentifierPrefix[action]}${relationshipField}`;\n  }\n\n  /**\n   * Parse a generated bulk relationship operation identifier back into its\n   * semantic parts so backend dispatch can route it to the shared executor.\n   */\n  static parseRelationshipBulkOperationIdentifier(\n    operationIdentifier: string\n  ): { action: ResourceRelationshipBulkAction; relationshipField: string } | undefined {\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.SET])) {\n      return {\n        action: ResourceRelationshipBulkAction.SET,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.SET].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.CLEAR])) {\n      return {\n        action: ResourceRelationshipBulkAction.CLEAR,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.CLEAR].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.CREATE])) {\n      return {\n        action: ResourceRelationshipBulkAction.CREATE,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.CREATE].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.LINK])) {\n      return {\n        action: ResourceRelationshipBulkAction.LINK,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.LINK].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.UNLINK])) {\n      return {\n        action: ResourceRelationshipBulkAction.UNLINK,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.UNLINK].length\n        ),\n      };\n    }\n\n    if (operationIdentifier.startsWith(ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.REPLACE])) {\n      return {\n        action: ResourceRelationshipBulkAction.REPLACE,\n        relationshipField: operationIdentifier.slice(\n          ResourceRelationshipBulkOperationIdentifierPrefix[ResourceRelationshipBulkAction.REPLACE].length\n        ),\n      };\n    }\n\n    return undefined;\n  }\n\n  static buildGeneratedFileRegenerateOperationIdentifier(fieldName: string): string {\n    if (!fieldName.trim()) {\n      throw Resources_SharedUtils.createConfigurationError('Generated file regenerate operation requires a non-empty fieldName');\n    }\n    return `${Resources_SharedUtils.GENERATED_FILE_REGENERATE_OPERATION_PREFIX}${fieldName}`;\n  }\n\n  static parseGeneratedFileRegenerateOperationIdentifier(\n    operationIdentifier: string\n  ): { fieldName: string } | undefined {\n    if (!operationIdentifier.startsWith(Resources_SharedUtils.GENERATED_FILE_REGENERATE_OPERATION_PREFIX)) {\n      return undefined;\n    }\n\n    const fieldName = operationIdentifier.slice(\n      Resources_SharedUtils.GENERATED_FILE_REGENERATE_OPERATION_PREFIX.length,\n    );\n    return fieldName.trim() ? { fieldName } : undefined;\n  }\n\n  /**\n   * Identifier of the export companion of `sourceOperationIdentifier`\n   * (e.g. `collectionExport:list`, `collectionExport:mySearchVariant`).\n   */\n  static buildGeneratedCollectionExportOperationIdentifier(sourceOperationIdentifier: string): string {\n    if (!sourceOperationIdentifier.trim()) {\n      throw Resources_SharedUtils.createConfigurationError(\n        'Generated collection export operation requires a non-empty source operation identifier',\n      );\n    }\n    return `${Resources_SharedUtils.GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX}${sourceOperationIdentifier}`;\n  }\n\n  static parseGeneratedCollectionExportOperationIdentifier(\n    operationIdentifier: string\n  ): { sourceOperationIdentifier: string } | undefined {\n    if (!operationIdentifier.startsWith(Resources_SharedUtils.GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX)) {\n      return undefined;\n    }\n\n    const sourceOperationIdentifier = operationIdentifier.slice(\n      Resources_SharedUtils.GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX.length,\n    );\n    return sourceOperationIdentifier.trim() ? { sourceOperationIdentifier } : undefined;\n  }\n\n  /**\n   * Resolve the FK field identity for a relationship.\n   *\n   * Priority:\n   * 1. explicit `foreignKeyField`\n   * 2. parent resource default field identifier from `allResourceFieldIdentifiers`\n   *\n   * This keeps FK resolution semantics shared across backend and frontend\n   * consumers instead of letting each layer improvise its own fallback.\n   */\n  static resolveRelationshipForeignKeyIdentity(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>,\n    allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipForeignKeyIdentity {\n    if (relationship.foreignKeyField) {\n      return {\n        parentResourceType: relationship.resourceType1,\n        childResourceType: relationship.resourceType2,\n        fieldIdentifier: relationship.foreignKeyField,\n        isExplicit: true,\n      };\n    }\n\n    const fieldIdentifier = allResourceFieldIdentifiers[relationship.resourceType1];\n    if (!fieldIdentifier) {\n      throw new Error(\n        `Cannot resolve FK field for relationship ${relationship.resourceType1} -> ${relationship.resourceType2}. ` +\n        `No explicit foreignKeyField was provided and resource type \"${relationship.resourceType1}\" has no registered default field identifier.`\n      );\n    }\n\n    return {\n      parentResourceType: relationship.resourceType1,\n      childResourceType: relationship.resourceType2,\n      fieldIdentifier,\n      isExplicit: false,\n    };\n  }\n\n  /**\n   * Non-throwing FK resolution helper for validation and optional consumers.\n   */\n  static tryResolveRelationshipForeignKeyIdentity(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>,\n    allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipForeignKeyIdentity | undefined {\n    try {\n      return this.resolveRelationshipForeignKeyIdentity(relationship, allResourceFieldIdentifiers);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Resolve explicit bulk relationship affordances from the perspective of the\n   * currently selected resource type.\n   *\n   * This is intentionally narrower than generic nested CRUD:\n   * - child-side REFERENCE => `set` / `clear`\n   * - parent-side COMPOSITION => `create`\n   * - peer-side ASSOCIATION => `link` / `unlink` / `replace`\n   *\n   * Important for future UX documentation:\n   * - these actions express the semantic difference between pointer management\n   *   (`REFERENCE`), aggregate-owned nested creation (`COMPOSITION`), and peer\n   *   membership management (`ASSOCIATION`)\n   * - a frontend shortcut such as \"quick create\" does not add a new action kind;\n   *   it simply orchestrates \"create independent resource, then run the normal\n   *   reference/association action\"\n   */\n  static resolveAllowedBulkRelationshipActionsForResource(\n    relationship: ResourceRelationship,\n    currentResourceType: ResourceType\n  ): ResourceRelationshipBulkAction[] {\n    if (relationship.isDisabled === true) {\n      return [];\n    }\n\n    const perspective = this.getRelationshipPerspectiveForResource(relationship, currentResourceType);\n    if (!perspective) {\n      return [];\n    }\n\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    // REFERENCE: mutate the pointer from the child side.\n    if (\n      semantics.nature === RelationshipNature.REFERENCE &&\n      perspective === 'resourceType2'\n    ) {\n      return [\n        ResourceRelationshipBulkAction.SET,\n        ResourceRelationshipBulkAction.CLEAR,\n      ];\n    }\n\n    // COMPOSITION: create owned nested children from the parent side.\n    if (\n      semantics.nature === RelationshipNature.COMPOSITION &&\n      perspective === 'resourceType1' &&\n      this.resolveRelationshipNestedMutationConfig(relationship, CoreResourceOperation.CREATE)\n    ) {\n      return [ResourceRelationshipBulkAction.CREATE];\n    }\n\n    // ASSOCIATION: manage peer membership while keeping junction persistence\n    // internal to the framework.\n    if (\n      semantics.nature === RelationshipNature.ASSOCIATION &&\n      relationship.jointResourceType\n    ) {\n      return [\n        ResourceRelationshipBulkAction.LINK,\n        ResourceRelationshipBulkAction.UNLINK,\n        ResourceRelationshipBulkAction.REPLACE,\n      ];\n    }\n\n    return [];\n  }\n\n  /**\n   * Resolve the semantic nature of a relationship.\n   *\n   * Greenfield API: relationship declarations must define `nature` explicitly.\n   * The resolver refuses to derive semantic meaning from low-level fields.\n   */\n  static resolveRelationshipNature(\n    relationship: Pick<ResourceRelationshipDeclaration, 'nature'>\n  ): { nature: RelationshipNature; source: ResolvedRelationshipNatureCalculationMode } {\n    if (!relationship.nature) {\n      throw this.createConfigurationError(\n        'Relationship declarations must define nature explicitly. ' +\n        'Greenfield relationship semantics no longer infer meaning from jointResourceType or childOperations.'\n      );\n    }\n\n    return {\n      nature: relationship.nature,\n      source: 'explicit',\n    };\n  }\n\n  private static deriveLegacyRelationshipReadModel(\n    nature: RelationshipNature,\n    childOperations?: ChildOperationsConfig_Parsed\n  ): RelationshipReadModel {\n    switch (nature) {\n      case RelationshipNature.COMPOSITION:\n        return childOperations?.nested?.onRead\n          ? RelationshipReadModel.EMBEDDED\n          : RelationshipReadModel.REFERENCE_ONLY;\n      case RelationshipNature.ASSOCIATION:\n        return childOperations?.nested?.onRead\n          ? RelationshipReadModel.ASSOCIATION_EMBEDDED\n          : RelationshipReadModel.REFERENCE_ONLY;\n      case RelationshipNature.REFERENCE:\n      default:\n        return RelationshipReadModel.REFERENCE_ONLY;\n    }\n  }\n\n  private static resolveRelationshipReadCalculation(params: {\n    nature: RelationshipNature;\n    childOperations?: ChildOperationsConfig_Parsed;\n    explicitRead?: RelationshipHandlingReadSettings;\n  }): {\n    model: RelationshipReadModel;\n    source: ResolvedRelationshipReadCalculationMode;\n  } {\n    if (params.explicitRead) {\n      return {\n        model: params.explicitRead.model,\n        source: 'explicit',\n      };\n    }\n\n    if (params.childOperations?.nested?.onRead) {\n      return {\n        model: this.deriveLegacyRelationshipReadModel(params.nature, params.childOperations),\n        source: 'legacy_nested_read_fallback',\n      };\n    }\n\n    return {\n      model: RelationshipReadModel.REFERENCE_ONLY,\n      source: 'default_reference_only',\n    };\n  }\n\n  /**\n   * Resolve the internal semantic contract and the current operational\n   * projection used by DTO/backend consumers.\n   *\n   * App developers author relationship topology and `nature`. This method is\n   * where the framework derives the deeper internal handling contract and the\n   * effective low-level `childOperations` shape consumed today.\n   */\n  static resolveRelationshipSemantics(\n    relationship: Pick<\n      ResourceRelationshipDeclaration,\n      'resourceType1' | 'resourceType2' | 'nature' | 'jointResourceType' | 'childOperations' | 'read' | 'foreignKeyField' | 'parentResourceRequirement' | 'cardinality1' | 'cardinality2'\n    >,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResolvedRelationshipSemantics {\n    const resolvedNature = this.resolveRelationshipNature(relationship);\n    const parsedChildOperations = relationship.childOperations\n      ? ChildOperationsConfigSchema.parse(relationship.childOperations)\n      : undefined;\n    const explicitRead = relationship.read\n      ? RelationshipHandlingReadSettingsSchema.parse(relationship.read)\n      : undefined;\n\n    this.assertRelationshipSemanticsCoherence(\n      relationship,\n      resolvedNature.nature,\n      parsedChildOperations,\n      explicitRead\n    );\n\n    const resolvedReadCalculation = this.resolveRelationshipReadCalculation({\n      nature: resolvedNature.nature,\n      childOperations: parsedChildOperations,\n      explicitRead,\n    });\n    const handling = this.deriveRelationshipHandlingContract(\n      resolvedNature.nature,\n      parsedChildOperations,\n      resolvedReadCalculation.model\n    );\n    const persistence = this.deriveRelationshipPersistenceContract(relationship, allResourceFieldIdentifiers);\n\n    return {\n      nature: resolvedNature.nature,\n      natureCalculationMode: resolvedNature.source,\n      readCalculationMode: resolvedReadCalculation.source,\n      handling,\n      persistence,\n      childOperations: parsedChildOperations,\n    };\n  }\n\n  /**\n   * Resolve the effective nested mutation projection for the given operation.\n   *\n   * `handling` is the semantic gate; `childOperations` remains the current\n   * detailed operational projection while Step 3/4 finishes converging.\n   */\n  static resolveRelationshipNestedMutationConfig(\n    relationship: ResourceRelationship,\n    operation: CoreResourceOperation\n  ) {\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    if (\n      semantics.handling.dtoModelMode === RelationshipDtoModel.REFERENCE_HANDLE ||\n      semantics.handling.mutationModelMode === RelationshipMutationModel.NONE\n    ) {\n      return undefined;\n    }\n\n    return (\n      operation === CoreResourceOperation.CREATE ||\n      operation === CoreResourceOperation.CREATE_MANY\n    )\n      ? semantics.childOperations?.nested?.onCreate\n      : semantics.childOperations?.nested?.onUpdate;\n  }\n\n  /**\n   * Resolve the effective nested read projection.\n   *\n   * The semantic read contract is the gate. The detailed data-mode config still\n   * comes from the current operational projection.\n   */\n  static resolveRelationshipNestedReadConfig(relationship: ResourceRelationship) {\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    if (\n      semantics.handling.dtoModelMode === RelationshipDtoModel.REFERENCE_HANDLE ||\n      semantics.handling.read.model === RelationshipReadModel.REFERENCE_ONLY\n    ) {\n      return undefined;\n    }\n\n    return semantics.childOperations?.nested?.onRead;\n  }\n\n  /**\n   * Resolve the effective lifecycle-on-parent-delete projection.\n   *\n   * `lifecycleModelMode` is the semantic gate; the detailed delete policy still\n   * comes from the current operational projection.\n   */\n  static resolveRelationshipLifecycleOnParentDeleteConfig(\n    relationship: ResourceRelationship\n  ) {\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    if (semantics.handling.lifecycleModelMode === RelationshipLifecycleModel.INDEPENDENT) {\n      return undefined;\n    }\n\n    return semantics.childOperations?.lifecycle?.onParentDelete;\n  }\n\n  /**\n   * Resolve the effective lifecycle-on-parent-create projection — the eager\n   * composition-child seeding policy. Mirror of\n   * {@link resolveRelationshipLifecycleOnParentDeleteConfig}: `lifecycleModelMode`\n   * is the semantic gate (INDEPENDENT / aggregation → no eager seed), and the\n   * detailed create policy comes from the operational\n   * `childOperations.lifecycle.onParentCreate` projection.\n   */\n  static resolveRelationshipLifecycleOnParentCreateConfig(\n    relationship: ResourceRelationship\n  ) {\n    const semantics = this.requireResolvedRelationshipSemantics(relationship);\n\n    if (semantics.handling.lifecycleModelMode === RelationshipLifecycleModel.INDEPENDENT) {\n      return undefined;\n    }\n\n    return semantics.childOperations?.lifecycle?.onParentCreate;\n  }\n\n  /**\n   * Compile the developer-authored declaration into the runtime relationship\n   * shape used by the framework.\n   */\n  static compileRelationshipDeclaration(\n    relationship: ResourceRelationshipDeclaration,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResourceRelationship {\n    return {\n      ...relationship,\n      resolvedSemantics: this.resolveRelationshipSemantics(relationship, allResourceFieldIdentifiers),\n    };\n  }\n\n  /**\n   * Ensure a relationship is in the compiled runtime shape.\n   *\n   * This is the startup normalization bridge for places that aggregate\n   * relationships from multiple sources before they are stored on registries or\n   * resource configurations.\n   */\n  static ensureCompiledRelationship(\n    relationship: ResourceRelationship | ResourceRelationshipDeclaration,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResourceRelationship {\n    const compiledRelationship = this.compileRelationshipDeclaration(relationship, allResourceFieldIdentifiers);\n\n    if (\n      'resolvedSemantics' in relationship &&\n      this.hasValidResolvedRelationshipSemantics(relationship.resolvedSemantics) &&\n      this.areResolvedRelationshipSemanticsEquivalent(\n        relationship.resolvedSemantics,\n        compiledRelationship.resolvedSemantics\n      )\n    ) {\n      return relationship;\n    }\n\n    if (\n      !allResourceFieldIdentifiers &&\n      'resolvedSemantics' in relationship &&\n      this.hasValidResolvedRelationshipSemantics(relationship.resolvedSemantics) &&\n      relationship.resolvedSemantics.persistence.foreignKey &&\n      !compiledRelationship.resolvedSemantics.persistence.foreignKey\n    ) {\n      return {\n        ...compiledRelationship,\n        resolvedSemantics: {\n          ...compiledRelationship.resolvedSemantics,\n          persistence: relationship.resolvedSemantics.persistence,\n        },\n      };\n    }\n\n    return compiledRelationship;\n  }\n\n  static ensureCompiledRelationships(\n    relationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[],\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): ResourceRelationship[] {\n    return relationships.map((relationship) =>\n      this.ensureCompiledRelationship(relationship, allResourceFieldIdentifiers)\n    );\n  }\n\n  static ensureCompiledRelationshipBuckets<\n    TResourceRelationships extends {\n      parentRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];\n      childRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];\n      selfRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];\n    }\n  >(\n    resourceRelationships: TResourceRelationships,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): {\n    parentRelationships: ResourceRelationship[];\n    childRelationships: ResourceRelationship[];\n    selfRelationships: ResourceRelationship[];\n  } {\n    return {\n      parentRelationships: this.ensureCompiledRelationships(\n        resourceRelationships.parentRelationships ?? [],\n        allResourceFieldIdentifiers\n      ),\n      childRelationships: this.ensureCompiledRelationships(\n        resourceRelationships.childRelationships ?? [],\n        allResourceFieldIdentifiers\n      ),\n      selfRelationships: this.ensureCompiledRelationships(\n        resourceRelationships.selfRelationships ?? [],\n        allResourceFieldIdentifiers\n      ),\n    };\n  }\n\n  /**\n   * Strict runtime reader for already-compiled relationships.\n   *\n   * Use this in hot runtime/startup paths once the relationship graph has passed\n   * through the shared compilation boundary.\n   */\n  static requireResolvedRelationshipSemantics(\n    relationship: ResourceRelationship\n  ): ResolvedRelationshipSemantics {\n    if (!this.hasValidResolvedRelationshipSemantics(relationship.resolvedSemantics)) {\n      throw new Error(\n        'Expected ResourceRelationship to carry valid resolvedSemantics. ' +\n        'Make sure the relationship graph passed through the shared startup compilation step.'\n      );\n    }\n\n    return relationship.resolvedSemantics;\n  }\n\n  /**\n   * Read the stored runtime semantics when present. This keeps current call\n   * sites resilient while Step 3 finishes converging on fully compiled edges.\n   */\n  static getResolvedRelationshipSemantics(\n    relationship: Pick<\n      ResourceRelationship | ResourceRelationshipDeclaration,\n      'resourceType1' | 'resourceType2' | 'nature' | 'jointResourceType' | 'childOperations' | 'read' | 'foreignKeyField' | 'parentResourceRequirement' | 'cardinality1' | 'cardinality2'\n    > & Partial<Pick<ResourceRelationship, 'resolvedSemantics'>>\n  ): ResolvedRelationshipSemantics {\n    return this.hasValidResolvedRelationshipSemantics(relationship.resolvedSemantics)\n      ? relationship.resolvedSemantics\n      : this.resolveRelationshipSemantics(relationship);\n  }\n\n  /**\n   * Derive the engine-facing handling contract from the authored relationship\n   * semantics plus low-level nested/lifecycle settings.\n   *\n   * Keep the semantic layers distinct:\n   * - `RelationshipNature` answers what the relationship means\n   * - the explicit read contract answers the semantic read intent when authored\n   * - the returned contract answers what kind of DTO/mutation/read/lifecycle\n   *   handling the engine should expose\n   *\n   * Documentation rule:\n   * - `REFERENCE` = independent-resource pointer semantics\n   * - `ASSOCIATION` = peer membership/link semantics\n   * - `COMPOSITION` = aggregate-managed nested child semantics\n   *\n   * A frontend capability like `display.interaction.allowQuickCreate` must stay\n   * OUTSIDE this contract:\n   * - reference quick create = create independent resource, then set reference\n   * - association quick create = create independent peer, then link/replace\n   * - composition already owns native nested creation and does not need this\n   *   shortcut to explain its meaning\n   */\n  private static deriveRelationshipHandlingContract(\n    nature: RelationshipNature,\n    childOperations?: ChildOperationsConfig_Parsed,\n    resolvedReadModel?: RelationshipReadModel\n  ): RelationshipHandlingContract {\n    const baseContract: RelationshipHandlingContract = {\n      dtoModelMode: RelationshipDtoModel.REFERENCE_HANDLE,\n      mutationModelMode: RelationshipMutationModel.NONE,\n      lifecycleModelMode: RelationshipLifecycleModel.INDEPENDENT,\n      readModelMode: resolvedReadModel,\n      read: {\n        model: resolvedReadModel,\n      },\n    };\n\n    switch (nature) {\n      case RelationshipNature.COMPOSITION:\n        baseContract.dtoModelMode = RelationshipDtoModel.NESTED_RESOURCE;\n        baseContract.mutationModelMode = RelationshipMutationModel.AGGREGATE_MANAGED;\n        baseContract.lifecycleModelMode = RelationshipLifecycleModel.DEPENDENT;\n        break;\n      case RelationshipNature.ASSOCIATION:\n        baseContract.dtoModelMode = RelationshipDtoModel.ASSOCIATION_HANDLE;\n        baseContract.mutationModelMode = RelationshipMutationModel.ASSOCIATION_MANAGED;\n        baseContract.lifecycleModelMode = RelationshipLifecycleModel.LINK_ONLY;\n        break;\n      case RelationshipNature.REFERENCE:\n      default:\n        break;\n    }\n\n    const createConfig = childOperations?.nested?.onCreate;\n    const updateConfig = childOperations?.nested?.onUpdate;\n    const lifecycleOnDelete = childOperations?.lifecycle?.onParentDelete;\n\n    if (createConfig || updateConfig) {\n      baseContract.mutation = {\n        allowParentCreate: Boolean(createConfig),\n        allowParentUpdate: Boolean(updateConfig),\n        allowParentDelete: Boolean(updateConfig?.allowDelete),\n        maxDepth: Math.max(createConfig?.maxDepth ?? 0, updateConfig?.maxDepth ?? 0),\n      };\n    }\n\n    if (lifecycleOnDelete) {\n      baseContract.lifecycle = {\n        onParentDelete: {\n          enabled: lifecycleOnDelete.enabled,\n          mode: lifecycleOnDelete.mode ?? ChildLifecycleMode.IMMEDIATE,\n          // Project the teardown STRATEGY too — without it the derived semantic contract cannot\n          // distinguish a hard-delete cascade from an impersonalize-and-retain one.\n          strategy: lifecycleOnDelete.strategy ?? ChildLifecycleStrategy.DELETE,\n          maxDepth: lifecycleOnDelete.maxDepth,\n        },\n      };\n    }\n\n    return baseContract;\n  }\n\n  /**\n   * Derive runtime persistence behavior from the authored relationship topology.\n   *\n   * The declaration remains small: developers author cardinality, parent\n   * requirement, nature, and the FK field when disambiguation is needed. The\n   * framework compiles the persistence consequence here so storage adapters do\n   * not reinterpret relationship meaning independently.\n   *\n   * The contract is expressed from the HOLDER's perspective\n   * ({@link resolveForeignKeyHolderResourceType} — the side whose rows carry\n   * the FK column, resolved from cardinality, never from declaration order):\n   * - `holderResourceType` tells storage adapters WHICH resource the contract\n   *   applies to — an adapter building any other resource of the relationship\n   *   must not materialize or validate this FK there;\n   * - `required` means the holder's FK column is non-nullable (the referenced\n   *   parent is mandatory for every holder row);\n   * - `unique` means at most one holder row per referenced row, which is true\n   *   exactly when the relationship is a genuine 1:1 — BOTH sides\n   *   single-valued. Keying uniqueness off `cardinality2` alone (the previous\n   *   derivation) assumed parent-first declaration order: for child-first\n   *   N:1 references (`(TODOS, USERS, MANY, ONE)`) and self-referencing trees\n   *   (`(UNITS, UNITS, ONE, MANY)`) a single positional cardinality is ONE\n   *   while the relationship is not 1:1, which would emit a bogus unique\n   *   index on a shared FK.\n   */\n  private static deriveRelationshipPersistenceContract(\n    relationship: Pick<\n      ResourceRelationshipDeclaration,\n      'resourceType1' | 'resourceType2' | 'foreignKeyField' | 'parentResourceRequirement' | 'cardinality1' | 'cardinality2'\n    >,\n    allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>\n  ): RelationshipPersistenceContract {\n    const foreignKeyIdentity = allResourceFieldIdentifiers\n      ? this.tryResolveRelationshipForeignKeyIdentity(relationship, allResourceFieldIdentifiers)\n      : relationship.foreignKeyField\n        ? {\n            fieldIdentifier: relationship.foreignKeyField,\n          }\n        : undefined;\n\n    if (!foreignKeyIdentity) {\n      return {};\n    }\n\n    const isArrayForeignKey = foreignKeyIdentity.fieldIdentifier.endsWith('Ids');\n    const holderResourceType = this.resolveForeignKeyHolderResourceType(relationship);\n    const isTrueOneToOne =\n      isOneToOneCardinality(relationship.cardinality1) &&\n      isOneToOneCardinality(relationship.cardinality2);\n\n    return {\n      foreignKey: {\n        fieldIdentifier: foreignKeyIdentity.fieldIdentifier,\n        holderResourceType,\n        isArray: isArrayForeignKey,\n        materializeField: true,\n        required: relationship.parentResourceRequirement !== ResourceParentResourceRequirement.OPTIONAL,\n        unique: !isArrayForeignKey && isTrueOneToOne,\n      },\n    };\n  }\n\n  private static assertRelationshipSemanticsCoherence(\n    relationship: Pick<ResourceRelationship, 'jointResourceType' | 'nature' | 'childOperations' | 'read'>,\n    resolvedNature: RelationshipNature,\n    childOperations?: ChildOperationsConfig_Parsed,\n    explicitRead?: RelationshipHandlingReadSettings\n  ): void {\n    const legacyReadModel = this.deriveLegacyRelationshipReadModel(\n      resolvedNature,\n      childOperations\n    );\n\n    if (resolvedNature === RelationshipNature.ASSOCIATION && !relationship.jointResourceType) {\n      throw new Error(\n        'Association semantics require jointResourceType. ' +\n        'Step 3 resolver refuses to treat non-junction relationships as ASSOCIATION.'\n      );\n    }\n\n    if (relationship.jointResourceType && relationship.nature && resolvedNature !== RelationshipNature.ASSOCIATION) {\n      throw new Error(\n        'Junction-backed relationships must resolve to ASSOCIATION semantics.'\n      );\n    }\n\n    if (resolvedNature === RelationshipNature.ASSOCIATION && childOperations) {\n      const hasAssociationNestedWrite =\n        Boolean(childOperations.nested?.onCreate || childOperations.nested?.onUpdate);\n      const hasAssociationNestedRead =\n        Boolean(childOperations.nested?.onRead);\n\n      if (hasAssociationNestedWrite || hasAssociationNestedRead) {\n        throw new Error(\n          'ASSOCIATION relationships cannot project nested read or mutation DTOs from the association declaration. ' +\n          'Declare explicit junction resource operations/views instead of using association-level childOperations.nested.'\n        );\n      }\n    }\n\n    if (resolvedNature === RelationshipNature.REFERENCE && childOperations) {\n      const hasReferenceLifecycle =\n        childOperations.lifecycle?.onParentDelete?.enabled === true;\n      const hasReferenceNestedWrite =\n        Boolean(childOperations.nested?.onCreate || childOperations.nested?.onUpdate);\n      const hasReferenceNestedRead =\n        Boolean(childOperations.nested?.onRead);\n\n      if (hasReferenceLifecycle || hasReferenceNestedWrite || hasReferenceNestedRead) {\n        throw new Error(\n          'REFERENCE relationships cannot project to nested CRUD/read embedding or dependent lifecycle. ' +\n          'Use COMPOSITION/ASSOCIATION semantics or remove the low-level childOperations settings.'\n        );\n      }\n    }\n\n    if (explicitRead) {\n      if (\n        explicitRead.model === RelationshipReadModel.EMBEDDED &&\n        resolvedNature !== RelationshipNature.COMPOSITION\n      ) {\n        throw new Error(\n          'EMBEDDED read semantics require nature=COMPOSITION.'\n        );\n      }\n\n      if (\n        explicitRead.model === RelationshipReadModel.ASSOCIATION_EMBEDDED &&\n        resolvedNature !== RelationshipNature.ASSOCIATION\n      ) {\n        throw new Error(\n          'ASSOCIATION_EMBEDDED read semantics require nature=ASSOCIATION.'\n        );\n      }\n\n      if (\n        childOperations?.nested?.onRead &&\n        explicitRead.model !== legacyReadModel\n      ) {\n        throw new Error(\n          'Explicit relationship read semantics contradict childOperations.nested.onRead. ' +\n          'Align the authored read contract with the nested read projection or remove one of them.'\n        );\n      }\n    }\n  }\n\n  /**\n   * M:N expansion is only safe when the declaration maps to one unambiguous edge\n   * per synthetic relationship. A self-referencing junction needs distinct source\n   * and target edge identities, which the current single-declaration model does\n   * not encode.\n   */\n  static assertSupportedManyToManySyntheticExpansion(\n    relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'jointResourceType'>\n  ): void {\n    if (relationship.jointResourceType && relationship.resourceType1 === relationship.resourceType2) {\n      throw new Error(\n        'Self-referencing MANY-to-MANY relationships cannot be expanded from a single declaration. ' +\n        'Declare explicit junction-resource relationships so source and target edge identity stay explicit.'\n      );\n    }\n  }\n\n  /**\n   * Returns true when a discriminator is structurally usable at runtime.\n   *\n   * A usable discriminator needs both a field name and at least one allowed\n   * value. Truthy-but-empty discriminator objects should not be treated as\n   * activation constraints.\n   */\n  static hasUsableRelationshipDiscriminator(\n    discriminator?: ResourceRelationship['discriminator']\n  ): boolean {\n    return Boolean(\n      discriminator?.discriminatorField &&\n      discriminator.values &&\n      discriminator.values.length > 0\n    );\n  }\n\n  /**\n   * Returns true when the relationship carries any runtime activation gate.\n   *\n   * Relationships without a usable discriminator (field + non-empty values) or\n   * a condition are unconditionally active.\n   */\n  static hasRelationshipActivationConstraint(\n    relationship: Pick<ResourceRelationship, 'discriminator' | 'condition'>\n  ): boolean {\n    return Boolean(\n      this.hasUsableRelationshipDiscriminator(relationship.discriminator) ||\n      relationship.condition\n    );\n  }\n\n  /**\n   * Check whether parent data matches a relationship discriminator.\n   *\n   * Discriminator values are string-based in the schema, so runtime values are\n   * coerced with `String()` before comparison. Missing/empty discriminators do\n   * not match.\n   */\n  static matchesRelationshipDiscriminator<T extends Record<string, any>>(\n    resource: T,\n    discriminator?: ResourceRelationship['discriminator']\n  ): boolean {\n    if (!this.hasUsableRelationshipDiscriminator(discriminator)) {\n      return false;\n    }\n\n    const fieldValue = resource[discriminator.discriminatorField];\n    return discriminator.values.includes(String(fieldValue));\n  }\n\n  /**\n   * Resolve whether a relationship is active for a given parent resource.\n   *\n   * Evaluation order is semantic, not caller-specific:\n   * 1. discriminator\n   * 2. condition\n   * 3. unconditional pass\n   *\n   * This keeps backend and frontend consumers aligned while still letting them\n   * choose how to handle missing parent data or thrown condition functions.\n   */\n  static isRelationshipActiveForParent(\n    relationship: Pick<ResourceRelationship, 'discriminator' | 'condition'>,\n    parentResource?: Record<string, any>,\n    options: RelationshipActivationEvaluationOptions = {}\n  ): boolean {\n    const {\n      onMissingParentResource = 'exclude',\n      onConditionError = 'throw',\n    } = options;\n\n    const hasConstraint = this.hasRelationshipActivationConstraint(relationship);\n    if (!parentResource) {\n      return hasConstraint ? onMissingParentResource === 'include' : true;\n    }\n\n    if (this.hasUsableRelationshipDiscriminator(relationship.discriminator)) {\n      if (!this.matchesRelationshipDiscriminator(parentResource, relationship.discriminator)) {\n        return false;\n      }\n    }\n\n    if (relationship.condition) {\n      try {\n        if (!relationship.condition(parentResource)) {\n          return false;\n        }\n      } catch (error) {\n        if (onConditionError === 'exclude') {\n          return false;\n        }\n        throw error;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Filter relationships to the subset that is active for a given parent.\n   */\n  static filterRelationshipsActiveForParent<T extends Pick<ResourceRelationship, 'discriminator' | 'condition'>>(\n    relationships: T[],\n    parentResource?: Record<string, any>,\n    options?: RelationshipActivationEvaluationOptions\n  ): T[] {\n    return relationships.filter((relationship) =>\n      this.isRelationshipActiveForParent(relationship, parentResource, options)\n    );\n  }\n\n}\n\n\n"]}

package/dist/esm/resources/utils/collection-export.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection-export.shared.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/collection-export.shared.utils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,8BAA8B,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAEtH,wCAAwC;AACxC,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAGpG,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,MAAM,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAGtG,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,WAAW,CAAC;AAC7D,eAAO,MAAM,uCAAuC,aAAa,CAAC;AAElE,oEAAoE;AACpE,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CA4B7G;AAoCD;;;;;;GAMG;AACH,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,SAAS,8BAA8B,EAAE,GACjD,8BAA8B,GAAG,SAAS,CAM5C;AAED,iGAAiG;AACjG,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,SAAS,gCAAgC,EAAE,GACnD,gCAAgC,GAAG,SAAS,CAM9C;AAED,oFAAoF;AACpF,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,8BAA8B,CAAC;IACvC,QAAQ,EAAE,gCAAgC,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,8BAA8B,GAC3C,iCAAiC,EAAE,CAQrC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,8BAA8B,EACtC,GAAG,EAAE,IAAI,GACR,MAAM,CAGR"}
+{"version":3,"file":"collection-export.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/collection-export.shared.utils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,8BAA8B,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAEtH,wCAAwC;AACxC,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAGpG,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,MAAM,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAGtG,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,WAAW,CAAC;AAC7D,eAAO,MAAM,uCAAuC,aAAa,CAAC;AAElE,oEAAoE;AACpE,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CA4B7G;AAoCD;;;;;;GAMG;AACH,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,SAAS,8BAA8B,EAAE,GACjD,8BAA8B,GAAG,SAAS,CAM5C;AAED,iGAAiG;AACjG,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,SAAS,gCAAgC,EAAE,GACnD,gCAAgC,GAAG,SAAS,CAM9C;AAED,oFAAoF;AACpF,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,8BAA8B,CAAC;IACvC,QAAQ,EAAE,gCAAgC,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,8BAA8B,GAC3C,iCAAiC,EAAE,CAQrC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,8BAA8B,EACtC,GAAG,EAAE,IAAI,GACR,MAAM,CAGR"}

package/dist/esm/resources/utils/composition-cascade-deletability.validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composition-cascade-deletability.validation.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/composition-cascade-deletability.validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EAGrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAsB,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AAEtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEH,gFAAgF;AAChF,MAAM,WAAW,2CAA2C;IAC1D,kBAAkB,EAAE,YAAY,CAAC;IACjC;;;;;;;;;OASG;IACH,UAAU,EAAE,aAAa,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;KAC/C,CAAC,CAAC;IACH;;;;;;OAMG;IACH,eAAe,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAClD,qBAAqB,CAAC,EAAE;QACtB,mBAAmB,CAAC,EAAE,oBAAoB,EAAE,CAAC;KAC9C,CAAC;CACH;AAED,MAAM,WAAW,uCAAuC;IACtD,iBAAiB,EAAE,YAAY,CAAC;IAChC,kBAAkB,EAAE,YAAY,CAAC;IACjC,WAAW,EAAE,YAAY,GAAG,aAAa,CAAC;IAC1C,8GAA8G;IAC9G,QAAQ,EAAE,sBAAsB,CAAC;IACjC,iIAAiI;IACjI,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;IAC3C,yFAAyF;IACzF,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAoDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sCAAsC,CACpD,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,2CAA2C,CAAC,GAClF,uCAAuC,EAAE,CA6H3C"}
+{"version":3,"file":"composition-cascade-deletability.validation.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/composition-cascade-deletability.validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EAGrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAsB,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AAEtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEH,gFAAgF;AAChF,MAAM,WAAW,2CAA2C;IAC1D,kBAAkB,EAAE,YAAY,CAAC;IACjC;;;;;;;;;OASG;IACH,UAAU,EAAE,aAAa,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;KAC/C,CAAC,CAAC;IACH;;;;;;OAMG;IACH,eAAe,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAClD,qBAAqB,CAAC,EAAE;QACtB,mBAAmB,CAAC,EAAE,oBAAoB,EAAE,CAAC;KAC9C,CAAC;CACH;AAED,MAAM,WAAW,uCAAuC;IACtD,iBAAiB,EAAE,YAAY,CAAC;IAChC,kBAAkB,EAAE,YAAY,CAAC;IACjC,WAAW,EAAE,YAAY,GAAG,aAAa,CAAC;IAC1C,8GAA8G;IAC9G,QAAQ,EAAE,sBAAsB,CAAC;IACjC,iIAAiI;IACjI,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;IAC3C,yFAAyF;IACzF,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAoDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sCAAsC,CACpD,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,2CAA2C,CAAC,GAClF,uCAAuC,EAAE,CA6H3C"}

package/dist/esm/resources/utils/composition-seedability.validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composition-seedability.validation.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/composition-seedability.validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,oBAAoB,EAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAGpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,mCAAmC;IAClD,kBAAkB,EAAE,YAAY,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;IACzB,qBAAqB,EAAE;QACrB,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,WAAW,+BAA+B;IAC9C,iBAAiB,EAAE,YAAY,CAAC;IAChC,kBAAkB,EAAE,YAAY,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,mCAAmC,CAAC,GAC1E,+BAA+B,EAAE,CAoEnC"}
+{"version":3,"file":"composition-seedability.validation.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/composition-seedability.validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,oBAAoB,EAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAGpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,mCAAmC;IAClD,kBAAkB,EAAE,YAAY,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;IACzB,qBAAqB,EAAE;QACrB,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,WAAW,+BAA+B;IAC9C,iBAAiB,EAAE,YAAY,CAAC;IAChC,kBAAkB,EAAE,YAAY,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,mCAAmC,CAAC,GAC1E,+BAA+B,EAAE,CAoEnC"}

package/dist/esm/resources/utils/context-addressed-composition-singleton.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-addressed-composition-singleton.shared.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/context-addressed-composition-singleton.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2CAA2C,EAAE,MAAM,oCAAoC,CAAC;AACtG,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AAGrC,MAAM,WAAW,yDAAyD;IACxE,YAAY,EAAE,oBAAoB,CAAC;IACnC,kBAAkB,EAAE,YAAY,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kDAAkD,CAChE,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAeT;AAED,wBAAgB,6DAA6D,CAC3E,qBAAqB,EAAE,2CAA2C,GACjE,yDAAyD,EAAE,CAQ7D"}
+{"version":3,"file":"context-addressed-composition-singleton.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/context-addressed-composition-singleton.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2CAA2C,EAAE,MAAM,oCAAoC,CAAC;AACtG,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AAGrC,MAAM,WAAW,yDAAyD;IACxE,YAAY,EAAE,oBAAoB,CAAC;IACnC,kBAAkB,EAAE,YAAY,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kDAAkD,CAChE,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAeT;AAED,wBAAgB,6DAA6D,CAC3E,qBAAqB,EAAE,2CAA2C,GACjE,yDAAyD,EAAE,CAQ7D"}

package/dist/esm/resources/utils/duplicate-relationship-registration.validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duplicate-relationship-registration.validation.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/duplicate-relationship-registration.validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,iCAAiC;IAChD,kBAAkB,EAAE,YAAY,CAAC;IACjC,iBAAiB,EAAE,YAAY,CAAC;IAChC,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,YAAY,EAAE,oBAAoB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAqDD;;;;;;;;;;;GAWG;AACH,wBAAgB,sCAAsC,CACpD,aAAa,EAAE,SAAS,oBAAoB,EAAE,GAC7C,iCAAiC,EAAE,CAgErC"}
+{"version":3,"file":"duplicate-relationship-registration.validation.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/duplicate-relationship-registration.validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,iCAAiC;IAChD,kBAAkB,EAAE,YAAY,CAAC;IACjC,iBAAiB,EAAE,YAAY,CAAC;IAChC,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,YAAY,EAAE,oBAAoB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAqDD;;;;;;;;;;;GAWG;AACH,wBAAgB,sCAAsC,CACpD,aAAa,EAAE,SAAS,oBAAoB,EAAE,GAC7C,iCAAiC,EAAE,CAgErC"}