npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.5 → 1.1.6 - Mend

@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (777) hide show

package/dist/esm/core/execution/useExecutionResourceOperationSurface.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useExecutionResourceOperationSurface.d.ts","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionResourceOperationSurface.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,gBAAgB,EAEhB,YAAY,EACZ,KAAK,WAAW,EACjB,MAAM,8CAA8C,CAAC;AACtD,OAAO,~~EACL~~,8BAA8B,~~EAC/B~~,MAAM,+EAA+E,CAAC;AACvF,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,gEAAgE,CAAC;AAGxE,OAAO,EACL,+BAA+B,EAEhC,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,wDAAwD,CAAC;AAEhE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,uDAAuD,CAAC;AAC7G,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,gCAAgC,EAEtC,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,KAAK,6CAA6C,EAClD,4BAA4B,EAC7B,MAAM,gCAAgC,CAAC;AAMxC,MAAM,WAAW,wCAAwC;IACvD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,0CAA0C;IACzD,MAAM,EAAE,gCAAgC,CAAC;IACzC,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD,8BAA8B,CAAC,EAAE,8BAA8B,CAAC;CACjE;AAED,MAAM,WAAW,iCAAkC,SAAQ,IAAI,CAC7D,wBAAwB,EACxB,6BAA6B,GAAG,yBAAyB,CAC1D;IACC,MAAM,EAAE,gCAAgC,CAAC;IACzC,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD,sBAAsB,EAAE,+BAA+B,CAAC;IACxD,GAAG,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5D,WAAW,EAAE,WAAW,CAAC;IACzB,oBAAoB,EAAE,+BAA+B,GAAG,IAAI,CAAC;IAC7D,6BAA6B,EAAE,6CAA6C,GAAG,IAAI,CAAC;IACpF,OAAO,EAAE,CACP,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,wCAAwC,KAC/C,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,2BAA2B,EAAE,wBAAwB,CAAC,6BAA6B,CAAC,CAAC;IACrF,uBAAuB,EAAE,wBAAwB,CAAC,yBAAyB,CAAC,CAAC;CAC9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oCAAoC,CAAC,EACnD,MAAM,EACN,mBAAmB,~~EACnB~~,~~8BAA4E~~,~~GAC7E~~,EAAE,0CAA0C,GAAG,iCAAiC,~~CAqShF~~;AAED,MAAM,WAAW,+CAAgD,SAAQ,IAAI,CAC3E,0CAA0C,EAC1C,QAAQ,CACT;IACC,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC,gCAAgC,EAAE,kBAAkB,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,+CAA+C,GACtD,iCAAiC,CAWnC"}
1	+ {"version":3,"file":"useExecutionResourceOperationSurface.d.ts","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionResourceOperationSurface.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,gBAAgB,EAEhB,YAAY,EACZ,KAAK,WAAW,EACjB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAGL,KAAK,8BAA8B,EACpC,MAAM,+EAA+E,CAAC;AACvF,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,gEAAgE,CAAC;AAGxE,OAAO,EACL,+BAA+B,EAEhC,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,wDAAwD,CAAC;AAEhE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,uDAAuD,CAAC;AAC7G,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,gCAAgC,EAEtC,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,KAAK,6CAA6C,EAClD,4BAA4B,EAC7B,MAAM,gCAAgC,CAAC;AAMxC,MAAM,WAAW,wCAAwC;IACvD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,0CAA0C;IACzD,MAAM,EAAE,gCAAgC,CAAC;IACzC,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD,8BAA8B,CAAC,EAAE,8BAA8B,CAAC;CACjE;AAED,MAAM,WAAW,iCAAkC,SAAQ,IAAI,CAC7D,wBAAwB,EACxB,6BAA6B,GAAG,yBAAyB,CAC1D;IACC,MAAM,EAAE,gCAAgC,CAAC;IACzC,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD,sBAAsB,EAAE,+BAA+B,CAAC;IACxD,GAAG,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5D,WAAW,EAAE,WAAW,CAAC;IACzB,oBAAoB,EAAE,+BAA+B,GAAG,IAAI,CAAC;IAC7D,6BAA6B,EAAE,6CAA6C,GAAG,IAAI,CAAC;IACpF,OAAO,EAAE,CACP,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,wCAAwC,KAC/C,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,2BAA2B,EAAE,wBAAwB,CAAC,6BAA6B,CAAC,CAAC;IACrF,uBAAuB,EAAE,wBAAwB,CAAC,yBAAyB,CAAC,CAAC;CAC9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oCAAoC,CAAC,EACnD,MAAM,EACN,mBAAmB,EAEnB,8BAA8B,GAC/B,EAAE,0CAA0C,GAAG,iCAAiC,CAwShF;AAED,MAAM,WAAW,+CAAgD,SAAQ,IAAI,CAC3E,0CAA0C,EAC1C,QAAQ,CACT;IACC,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC,gCAAgC,EAAE,kBAAkB,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,+CAA+C,GACtD,iCAAiC,CAWnC"}

package/dist/esm/core/execution/useExecutionResourceOperationSurface.js CHANGED Viewed

@@ -4,7 +4,7 @@ import { frontendResourceUtils, FrontendResourceUtils, } from '../../core/resour
 import { mergeBulkSelectionIntoRequestData, isSingleResourceUpdateLikeOperation, } from '../../core/resources/operation-semantics.frontend.utils.js';
 import { isFrontendOperationAddressableForCurrentContext, shouldRequireCurrentContextAddressabilityForOperation, } from '../../core/resources/resource-addressability.frontend.utils.js';
 import { MutationErrorType, MutationPriority, MutationSourceType, MutationType, } from '../../core/resources/rmm/types.js';
-import { UpdateLikeMutationFallbackMode, } from '../../core/resources/rmm/update-like-mutation-fallback.frontend.js';
+import { allowsDirectOperationFallback, resolveDeclaredUpdateLikeMutationFallbackMode, } from '../../core/resources/rmm/update-like-mutation-fallback.frontend.js';
 import { useResourceOperationSurface } from '../../core/resources/useResourceOperationSurface.js';
 import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
 import { ExecutionNavigationHandlingMode, resolveExecutionNavigationHandlingMode, } from '../../core/config/execution-view.schemas.js';
@@ -27,7 +27,9 @@ import { assertExecutionRuntimeContext, ExecutionRuntimeContext, } from './Execu
  * - update-like execution only uses RMM when the target resolves to one concrete
  *   participation-backed lane
  */
-export function useExecutionResourceOperationSurface({ target, navigationInitiator, updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED, }) {
+export function useExecutionResourceOperationSurface({ target, navigationInitiator,
+/* Omitted, the resource surface applies the lane the operation declared (RMM_REQUIRED unless it said otherwise). */
+updateLikeMutationFallbackMode, }) {
     const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));
     const executionNavigation = executionRuntime.navigation;
     const { registry } = useResourceRegistry();
@@ -59,6 +61,7 @@ export function useExecutionResourceOperationSurface({ target, navigationInitiat
         contextResourceIdentifiers: target.contextResourceIdentifiers,
         relationshipFieldOverrides: target.relationshipFieldOverrides,
         enabled: Boolean(target.participationRef) && isSingleResourceUpdateLikeOperation(resourceContext.operation),
+        directFallbackAccepted: allowsDirectOperationFallback(updateLikeMutationFallbackMode ?? resolveDeclaredUpdateLikeMutationFallbackMode(resourceContext.operation)),
     });
     const navigationHandlingMode = useMemo(() => resolveExecutionNavigationHandlingMode({
         viewDefinition: executionRuntime.viewDefinition,

package/dist/esm/core/execution/useExecutionResourceOperationSurface.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useExecutionResourceOperationSurface.js","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionResourceOperationSurface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,kCAAkC,EAClC,yCAAyC,GAC1C,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACL,iCAAiC,EACjC,mCAAmC,GACpC,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EACL,+CAA+C,EAC/C,qDAAqD,GACtD,MAAM,2EAA2E,CAAC;AACnF,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GAEb,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,8BAA8B,GAC/B,MAAM,+EAA+E,CAAC;AAKvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gEAAgE,CAAC;AAC7G,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EACL,+BAA+B,EAC/B,sCAAsC,GACvC,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACL,qBAAqB,GAEtB,MAAM,wDAAwD,CAAC;AAGhE,OAAO,EACL,iCAAiC,GAElC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,2CAA2C,GAC5C,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAEL,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAkCnC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oCAAoC,CAAC,EACnD,MAAM,EACN,mBAAmB,EACnB,8BAA8B,GAAG,8BAA8B,CAAC,YAAY,GACjC;IAC3C,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC5F,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,UAAU,CAAC;IACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,6BAA6B,EAAE,GAAG,2CAA2C,EAAE,CAAC;IAExF,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB;QAC9C,CAAC,CAAC,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,gBAAgB,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,mBAAmB,GAAG,OAAO,CAA2C,GAAG,EAAE;QACjF,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,iCAAiC,CAAC;YACvC,aAAa,EAAE,gBAAgB;YAC/B,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE;QACnC,OAAO,6BAA6B,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC,EAAE,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC,CAAC;IAE5C,MAAM,eAAe,GAAG,2BAA2B,CAAC;QAClD,eAAe;QACf,cAAc,EAAE,gBAAgB,CAAC,cAAc;QAC/C,mBAAmB;QACnB,8BAA8B;KACa,CAAC,CAAC;IAE/C,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;QACpD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,EAAE;QAC/C,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,0BAA0B,EAAE,MAAM,CAAC,0BAA0B;QAC7D,0BAA0B,EAAE,MAAM,CAAC,0BAA0B;QAC7D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,mCAAmC,CAAC,eAAe,CAAC,SAAS,CAAC;KAC5G,CAAC,CAAC;IACH,MAAM,sBAAsB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,sCAAsC,CAAC;QAClF,cAAc,EAAE,gBAAgB,CAAC,cAAc;QAC/C,YAAY,EAAE,eAAe,CAAC,YAAY;QAC1C,SAAS,EAAE,eAAe,CAAC,SAAS;KACrC,CAAC,EAAE;QACF,gBAAgB,CAAC,cAAc;QAC/B,eAAe,CAAC,SAAS;QACzB,eAAe,CAAC,YAAY;KAC7B,CAAC,CAAC;IAEH,MAAM,qBAAqB,GAAG,WAAW,CAAC,CACxC,SAAkD,EAClD,0BAA0B,GAAG,eAAe,CAAC,0BAA0B,EACvE,2BAA2B,GAAG,eAAe,CAAC,2BAA2B,EACrD,EAAE;QACtB,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,yCAAyC,CAAC,gCAAgC,CAC3F,eAAe,CAAC,cAAc,EAC9B,SAAS,EACT,QAAQ,CAAC,2BAA2B,CACrC,CAAC;QAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,qBAAqB,CAAC,uBAAuB,CAClD,UAAU,EACV,0BAA0B,EAC1B,eAAe,CAAC,YAAY,EAC5B,eAAe,CAAC,cAAc,CAAC,uBAAuB,EACtD,2BAA2B,CAC5B,CAAC,GAAG,CAAC;IACR,CAAC,EAAE;QACD,QAAQ,CAAC,2BAA2B;QACpC,eAAe,CAAC,0BAA0B;QAC1C,eAAe,CAAC,2BAA2B;QAC3C,eAAe,CAAC,cAAc;QAC9B,eAAe,CAAC,YAAY;KAC7B,CAAC,CAAC;IAEH,MAAM,2BAA2B,GAAG,WAAW,CAAmE,CAAC,EACjH,SAAS,EACT,0BAA0B,GAAG,eAAe,CAAC,0BAA0B,EACvE,2BAA2B,GAAG,eAAe,CAAC,2BAA2B,EACzE,iBAAiB,GAClB,EAAE,EAAE;QACH,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,yBAAyB,CAC1E,0BAA0B,EAC1B,QAAQ,CACT,CAAC;QACF,MAAM,sBAAsB,GAAG,qDAAqD,CAAC;YACnF,SAAS;YACT,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,cAAc,EAAE,eAAe,CAAC,cAAc;SAC/C,CAAC,CAAC;QACH,IACE,sBAAsB;eACnB,SAAS,CAAC,eAAe,KAAK,IAAI;eAClC,CAAC,+CAA+C,CAAC;gBAClD,cAAc,EAAE,eAAe,CAAC,cAAc;gBAC9C,SAAS;gBACT,QAAQ;gBACR,aAAa,EAAE,qBAAqB,CAAC,aAAa,CAAC,0BAA0B,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;gBACvH,0BAA0B;gBAC1B,oBAAoB;aACrB,CAAC,EACF,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,aAAa,GAAG,qBAAqB,CAAC,mDAAmD,CAAC;YAC9F,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,SAAS;YACT,0BAA0B;YAC1B,2BAA2B;SAC5B,CAAC,CAAC;QAEH,MAAM,gBAAgB,GAAG,qBAAqB,CAC5C,SAAS,EACT,0BAA0B,EAC1B,2BAA2B,CAC5B,CAAC;QACF,IAAI,sBAAsB,KAAK,+BAA+B,CAAC,aAAa,EAAE,CAAC;YAC7E,mBAAmB,CAAC,mBAAmB,CAAC;gBACtC,OAAO,EAAE;oBACP,WAAW,EAAE,qBAAqB,CAAC,kBAAkB;oBACrD,eAAe,EAAE,aAAa;iBAC/B;gBACD,mBAAmB,EAAE,iBAAiB,IAAI,eAAe,CAAC,kBAAkB;aAC7E,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,iBAAiB,GAAG,eAAe,CAAC,kBAAkB,CAAC;QAC7D,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;QAElF,mBAAmB,CAAC,gBAAgB,CAAC;YACnC,OAAO,EAAE;gBACP,WAAW,EAAE,qBAAqB,CAAC,kBAAkB;gBACrD,eAAe,EAAE,aAAa;aAC/B;YACD,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,iBAAiB,IAAI,gBAAgB;SACjD,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC,EAAE;QACD,qBAAqB;QACrB,mBAAmB;QACnB,eAAe,CAAC,0BAA0B;QAC1C,eAAe,CAAC,2BAA2B;QAC3C,sBAAsB;QACtB,QAAQ;QACR,eAAe,CAAC,kBAAkB;QAClC,eAAe,CAAC,cAAc;QAC9B,eAAe,CAAC,YAAY;KAC7B,CAAC,CAAC;IAEH,MAAM,uBAAuB,GAAG,WAAW,CAA+D,CAAC,OAAO,EAAE,EAAE;QACpH,MAAM,aAAa,GAAG,eAAe,CAAC,yBAAyB,CAC7D,qBAAqB,CAAC,IAAI,EAC1B,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAC7B,CAAC;QAEF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,IAAI,OAAO,EAAE,gBAAgB,KAAK,KAAK,EAAE,CAAC;gBACxC,eAAe,CAAC,gBAAgB,EAAE,CAAC;YACrC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,2BAA2B,CAAC;YACjC,SAAS,EAAE,aAAa;YACxB,0BAA0B,EAAE,OAAO,EAAE,0BAA0B,IAAI,eAAe,CAAC,0BAA0B;YAC7G,2BAA2B,EAAE,OAAO,EAAE,2BAA2B,IAAI,eAAe,CAAC,2BAA2B;YAChH,iBAAiB,EAAE,OAAO,EAAE,iBAAiB;SAC9C,CAAC,CAAC;IACL,CAAC,EAAE;QACD,2BAA2B;QAC3B,eAAe,CAAC,0BAA0B;QAC1C,eAAe,CAAC,2BAA2B;QAC3C,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,WAAW,CAA+C,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;QACvG,MAAM,sBAAsB,GAAG,eAAe,CAAC,cAAc;YAC3D,CAAC,CAAC,qDAAqD,CAAC;gBACtD,SAAS,EAAE,eAAe,CAAC,SAAS;gBACpC,YAAY,EAAE,eAAe,CAAC,YAAY;gBAC1C,cAAc,EAAE,eAAe,CAAC,cAAc;aAC/C,CAAC;YACF,CAAC,CAAC,KAAK,CAAC;QACV,IACE,sBAAsB;eACnB,eAAe,CAAC,SAAS,CAAC,eAAe,KAAK,IAAI;eAClD,eAAe,CAAC,cAAc;eAC9B,CAAC,+CAA+C,CAAC;gBAClD,cAAc,EAAE,eAAe,CAAC,cAAc;gBAC9C,SAAS,EAAE,eAAe,CAAC,SAAS;gBACpC,QAAQ;gBACR,aAAa,EAAE,qBAAqB,CAAC,aAAa,CAAC,eAAe,CAAC,0BAA0B,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;gBACvI,0BAA0B,EAAE,eAAe,CAAC,0BAA0B;gBACtE,oBAAoB,EAAE,eAAe,CAAC,oBAAoB;aAC3D,CAAC,EACF,CAAC;YACD,MAAM,qBAAqB,CAAC,uBAAuB,CACjD,2BAA2B,CAAC,aAAa,EACzC;gBACE,OAAO,EAAE,iCAAiC,eAAe,CAAC,WAAW,8CAA8C;gBACnH,SAAS,EAAE,sCAAsC;gBACjD,YAAY,EAAE,eAAe,CAAC,YAAY;gBAC1C,mBAAmB,EAAE,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,mBAAmB,CAAC;aAC3E,CACF,CAAC;QACJ,CAAC;QAED,IAAI,mCAAmC,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC;YAC3F,MAAM,oBAAoB,GAAG,iCAAiC,CAAC;gBAC7D,SAAS,EAAE,eAAe,CAAC,SAAS;gBACpC,WAAW;gBACX,iBAAiB,EAAE,eAAe,CAAC,iBAAiB;aACrD,CAAC,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAC7D,oBAAoB,IAAI,EAAE,EAC1B;gBACE,IAAI,EAAE,OAAO,EAAE,YAAY,IAAI,YAAY,CAAC,MAAM;gBAClD,QAAQ,EAAE,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,CAAC,MAAM;gBAC9D,MAAM,EAAE;oBACN,IAAI,EAAE,kBAAkB,CAAC,YAAY;oBACrC,YAAY,EAAE,OAAO,EAAE,YAAY;2BAC9B,qBAAqB,eAAe,CAAC,YAAY,IAAI,eAAe,CAAC,WAAW,EAAE;iBACxF;gBACD,iBAAiB,EAAE;oBACjB,gBAAgB,EAAE,kCAAkC,CAAC,mCAAmC,CACtF,eAAe,CAAC,SAAS,CAC1B;oBACD,oBAAoB,EAAE,eAAe,CAAC,oBAAoB;oBAC1D,2BAA2B,EAAE,eAAe,CAAC,2BAA2B;oBACxE,WAAW,EAAE,oBAAoB,IAAI,EAAE;oBACvC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,IAAI,IAAI;iBACtD;aACF,CACF,CAAC;YAEF,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC5B,iGAAiG;gBACjG,wGAAwG;gBACxG,gGAAgG;gBAChG,2CAA2C;gBAC3C,IAAI,cAAc,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC,KAAK,EAAE,CAAC;oBACvG,MAAM,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC;gBACnC,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,cAAc,CAAC,KAAK,EAAE,OAAO;uBAC1B,iCAAiC,eAAe,CAAC,WAAW,WAAW,CAC3E,CAAC;YACJ,CAAC;YAED,OAAO,cAAc,CAAC,YAAY,CAAC;QACrC,CAAC;QAED,OAAO,eAAe,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC9D,CAAC,EAAE;QACD,gBAAgB,CAAC,GAAG;QACpB,eAAe,CAAC,iBAAiB;QACjC,eAAe,CAAC,SAAS;QACzB,eAAe,CAAC,2BAA2B;QAC3C,QAAQ;QACR,eAAe;KAChB,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,eAAe;QAClB,MAAM;QACN,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS;QAC9E,sBAAsB;QACtB,GAAG,EAAE,gBAAgB,CAAC,GAAG;QACzB,WAAW,EAAE,gBAAgB,CAAC,WAAW;QACzC,oBAAoB,EAAE,gBAAgB,CAAC,oBAAoB;QAC3D,6BAA6B,EAAE,MAAM,CAAC,gBAAgB;YACpD,CAAC,CAAC,gBAAgB,CAAC,0BAA0B;YAC7C,CAAC,CAAC,IAAI;QACR,OAAO;QACP,2BAA2B;QAC3B,uBAAuB;KACxB,CAAC;AACJ,CAAC;AAUD;;GAEG;AACH,MAAM,UAAU,yCAAyC,CACvD,MAAuD;IAEvD,MAAM,MAAM,GAAG,OAAO,CAAmC,GAAG,EAAE,CAAC,CAAC;QAC9D,GAAG,MAAM,CAAC,MAAM;QAChB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KACL,CAAA,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAElF,OAAO,oCAAoC,CAAC;QAC1C,MAAM;QACN,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,8BAA8B,EAAE,MAAM,CAAC,8BAA8B;KACtE,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { useCallback, useContext, useMemo } from 'react';\n\nimport {\n CoreResourceOperation,\n ErrorCustomMessageReference,\n ResourcesConfig_OperationPathUtils,\n ResourcesConfigOperationsUrlsBuilderUtils,\n} from '@wildo-ai/saas-models';\n\nimport {\n frontendResourceUtils,\n FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n mergeBulkSelectionIntoRequestData,\n isSingleResourceUpdateLikeOperation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n isFrontendOperationAddressableForCurrentContext,\n shouldRequireCurrentContextAddressabilityForOperation,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport {\n MutationErrorType,\n MutationPriority,\n MutationSourceType,\n MutationType,\n type RMMSnapshot,\n} from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport type {\n ResourceOperationSurface,\n UseResourceOperationSurfaceParams,\n} from '~wildo-frontend-lib/core/resources/useResourceOperationSurface';\nimport { useResourceOperationSurface } from '~wildo-frontend-lib/core/resources/useResourceOperationSurface';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n ExecutionNavigationHandlingMode,\n resolveExecutionNavigationHandlingMode,\n} from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport {\n NavigationContentType,\n type NavigationInitiatorContext,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { UseResourceRMMUnavailableReason } from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport {\n buildExecutionParticipationHandle,\n type ExecutionParticipationHandle,\n} from './execution-participation.utils';\nimport {\n type ExecutionResourceOperationTarget,\n useExecutionResourceOperationContextBuilder,\n} from './useExecutionResourceOperationContextBuilder';\nimport {\n type UseExecutionParticipationRMMUnavailableReason,\n useExecutionParticipationRMM,\n} from './useExecutionParticipationRMM';\nimport {\n assertExecutionRuntimeContext,\n ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\n\nexport interface ExecutionResourceOperationExecuteOptions {\n mutationType?: MutationType;\n mutationPriority?: MutationPriority;\n subscriberId?: string;\n readBackOnSuccess?: boolean;\n}\n\nexport interface UseExecutionResourceOperationSurfaceParams {\n target: ExecutionResourceOperationTarget;\n navigationInitiator?: NavigationInitiatorContext;\n updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n}\n\nexport interface ExecutionResourceOperationSurface extends Omit<\n ResourceOperationSurface,\n 'navigateToResourceOperation' \| 'navigateToPreferredRead'\n> {\n target: ExecutionResourceOperationTarget;\n participationHandle?: ExecutionParticipationHandle;\n navigationHandlingMode: ExecutionNavigationHandlingMode;\n rmm: ReturnType<typeof useExecutionParticipationRMM>['rmm'];\n rmmSnapshot: RMMSnapshot;\n rmmUnavailableReason: UseResourceRMMUnavailableReason \| null;\n executionRmmUnavailableReason: UseExecutionParticipationRMMUnavailableReason \| null;\n execute: (\n requestData?: Record<string, unknown>,\n options?: ExecutionResourceOperationExecuteOptions,\n ) => Promise<unknown>;\n navigateToResourceOperation: ResourceOperationSurface['navigateToResourceOperation'];\n navigateToPreferredRead: ResourceOperationSurface['navigateToPreferredRead'];\n}\n\n/*\n Execution-aware headless resource-operation surface.\n \n This composes three existing engine seams:\n * - participation-aware execution context building\n * - ordinary resource-operation surface semantics\n * - thin execution-to-RMM handoff for concrete single-resource update-like lanes\n \n Important boundary:\n * - routed/global navigation is still delegated back through execution\n * navigation mediation\n * - update-like execution only uses RMM when the target resolves to one concrete\n * participation-backed lane\n /\nexport function useExecutionResourceOperationSurface({\n target,\n navigationInitiator,\n updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED,\n}: UseExecutionResourceOperationSurfaceParams): ExecutionResourceOperationSurface {\n const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n const executionNavigation = executionRuntime.navigation;\n const { registry } = useResourceRegistry();\n const { buildResourceOperationContext } = useExecutionResourceOperationContextBuilder();\n\n const rawParticipation = target.participationRef\n ? executionRuntime.participations[target.participationRef]\n : undefined;\n const participationHandle = useMemo<ExecutionParticipationHandle \| undefined>(() => {\n if (!rawParticipation) {\n return undefined;\n }\n\n return buildExecutionParticipationHandle({\n participation: rawParticipation,\n registry,\n });\n }, [rawParticipation, registry]);\n\n const resourceContext = useMemo(() => {\n return buildResourceOperationContext(target);\n }, [buildResourceOperationContext, target]);\n\n const resourceSurface = useResourceOperationSurface({\n resourceContext,\n navigationZone: executionRuntime.navigationZone,\n navigationInitiator,\n updateLikeMutationFallbackMode,\n } satisfies UseResourceOperationSurfaceParams);\n\n const participationRmm = useExecutionParticipationRMM({\n participationRef: target.participationRef ?? '',\n resourceId: target.resourceId,\n contextResourceIdentifiers: target.contextResourceIdentifiers,\n relationshipFieldOverrides: target.relationshipFieldOverrides,\n enabled: Boolean(target.participationRef) && isSingleResourceUpdateLikeOperation(resourceContext.operation),\n });\n const navigationHandlingMode = useMemo(() => resolveExecutionNavigationHandlingMode({\n viewDefinition: executionRuntime.viewDefinition,\n resourceType: resourceSurface.resourceType,\n operation: resourceSurface.operation,\n }), [\n executionRuntime.viewDefinition,\n resourceSurface.operation,\n resourceSurface.resourceType,\n ]);\n\n const buildDelegatedUrlPath = useCallback((\n operation: FrontendResourceConfiguration_Operation,\n contextResourceIdentifiers = resourceContext.contextResourceIdentifiers,\n parentResourcesRequirements = resourceContext.parentResourcesRequirements,\n ): string \| undefined => {\n if (!resourceSurface.resourceConfig) {\n return undefined;\n }\n\n const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n resourceSurface.resourceConfig,\n operation,\n registry.allResourceFieldIdentifiers,\n );\n\n if (routePaths.length === 0) {\n return undefined;\n }\n\n return frontendResourceUtils.selectMatchingRoutePath(\n routePaths,\n contextResourceIdentifiers,\n resourceSurface.resourceType,\n resourceSurface.resourceConfig.resourceFieldIdentifier,\n parentResourcesRequirements,\n ).url;\n }, [\n registry.allResourceFieldIdentifiers,\n resourceContext.contextResourceIdentifiers,\n resourceContext.parentResourcesRequirements,\n resourceSurface.resourceConfig,\n resourceSurface.resourceType,\n ]);\n\n const navigateToResourceOperation = useCallback<ExecutionResourceOperationSurface['navigateToResourceOperation']>(({\n operation,\n contextResourceIdentifiers = resourceContext.contextResourceIdentifiers,\n parentResourcesRequirements = resourceContext.parentResourcesRequirements,\n initiatorOverride,\n }) => {\n if (!resourceSurface.resourceConfig) {\n return false;\n }\n\n const contextualParameters = FrontendResourceUtils.buildContextualParameters(\n contextResourceIdentifiers,\n registry,\n );\n const requiresAddressability = shouldRequireCurrentContextAddressabilityForOperation({\n operation,\n resourceType: resourceSurface.resourceType,\n resourceConfig: resourceSurface.resourceConfig,\n });\n if (\n requiresAddressability\n && operation.isBulkOperation !== true\n && !isFrontendOperationAddressableForCurrentContext({\n resourceConfig: resourceSurface.resourceConfig,\n operation,\n registry,\n hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,\n contextResourceIdentifiers,\n contextualParameters,\n })\n ) {\n return false;\n }\n\n const targetContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n resourceType: resourceSurface.resourceType,\n operation,\n contextResourceIdentifiers,\n parentResourcesRequirements,\n });\n\n const delegatedUrlPath = buildDelegatedUrlPath(\n operation,\n contextResourceIdentifiers,\n parentResourcesRequirements,\n );\n if (navigationHandlingMode === ExecutionNavigationHandlingMode.EMBED_LOCALLY) {\n executionNavigation.openEmbeddedContent({\n content: {\n contentType: NavigationContentType.RESOURCE_OPERATION,\n resourceContext: targetContext,\n },\n navigationInitiator: initiatorOverride ?? resourceSurface.operationInitiator,\n });\n\n return true;\n }\n\n const fallbackInitiator = resourceSurface.operationInitiator;\n const { sourceZone: _ignoredSourceZone, ...defaultInitiator } = fallbackInitiator;\n\n executionNavigation.delegateToParent({\n content: {\n contentType: NavigationContentType.RESOURCE_OPERATION,\n resourceContext: targetContext,\n },\n urlPath: delegatedUrlPath,\n initiator: initiatorOverride ?? defaultInitiator,\n });\n\n return true;\n }, [\n buildDelegatedUrlPath,\n executionNavigation,\n resourceContext.contextResourceIdentifiers,\n resourceContext.parentResourcesRequirements,\n navigationHandlingMode,\n registry,\n resourceSurface.operationInitiator,\n resourceSurface.resourceConfig,\n resourceSurface.resourceType,\n ]);\n\n const navigateToPreferredRead = useCallback<ExecutionResourceOperationSurface['navigateToPreferredRead']>((options) => {\n const readOperation = resourceSurface.resolvePreferredOperation(\n CoreResourceOperation.READ,\n { requireAddressable: true },\n );\n\n if (!readOperation) {\n if (options?.fallbackToGoBack !== false) {\n resourceSurface.goBackWithinZone();\n }\n return false;\n }\n\n return navigateToResourceOperation({\n operation: readOperation,\n contextResourceIdentifiers: options?.contextResourceIdentifiers ?? resourceContext.contextResourceIdentifiers,\n parentResourcesRequirements: options?.parentResourcesRequirements ?? resourceContext.parentResourcesRequirements,\n initiatorOverride: options?.initiatorOverride,\n });\n }, [\n navigateToResourceOperation,\n resourceContext.contextResourceIdentifiers,\n resourceContext.parentResourcesRequirements,\n resourceSurface,\n ]);\n\n const execute = useCallback<ExecutionResourceOperationSurface['execute']>(async (requestData, options) => {\n const requiresAddressability = resourceSurface.resourceConfig\n ? shouldRequireCurrentContextAddressabilityForOperation({\n operation: resourceContext.operation,\n resourceType: resourceSurface.resourceType,\n resourceConfig: resourceSurface.resourceConfig,\n })\n : false;\n if (\n requiresAddressability\n && resourceContext.operation.isBulkOperation !== true\n && resourceSurface.resourceConfig\n && !isFrontendOperationAddressableForCurrentContext({\n resourceConfig: resourceSurface.resourceConfig,\n operation: resourceContext.operation,\n registry,\n hasResourceId: frontendResourceUtils.getResourceId(resourceContext.contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,\n contextResourceIdentifiers: resourceContext.contextResourceIdentifiers,\n contextualParameters: resourceSurface.contextualParameters,\n })\n ) {\n throw FrontendResourceUtils.buildConfigurationError(\n ErrorCustomMessageReference.CONFIGURATION,\n {\n message: `Execution resource operation \"${resourceSurface.operationId}\" is not addressable in the current context.`,\n component: 'useExecutionResourceOperationSurface',\n resourceType: resourceSurface.resourceType,\n operationIdentifier: String(resourceContext.operation.operationIdentifier),\n },\n );\n }\n\n if (isSingleResourceUpdateLikeOperation(resourceContext.operation) && participationRmm.rmm) {\n const effectiveRequestData = mergeBulkSelectionIntoRequestData({\n operation: resourceContext.operation,\n requestData,\n additionalContext: resourceContext.additionalContext,\n });\n const mutationResult = await participationRmm.rmm.queueMutation(\n effectiveRequestData ?? {},\n {\n type: options?.mutationType ?? MutationType.CUSTOM,\n priority: options?.mutationPriority ?? MutationPriority.NORMAL,\n source: {\n type: MutationSourceType.ORCHESTRATOR,\n subscriberId: options?.subscriberId\n ?? `execution-surface:${resourceSurface.resourceType}:${resourceSurface.operationId}`,\n },\n transportOverride: {\n operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(\n resourceContext.operation,\n ),\n contextualParameters: resourceSurface.contextualParameters,\n parentResourcesRequirements: resourceContext.parentResourcesRequirements,\n requestData: effectiveRequestData ?? {},\n readBackOnSuccess: options?.readBackOnSuccess ?? true,\n },\n },\n );\n\n if (!mutationResult.success) {\n // Rethrow the transport failure itself: it carries the backend reference, type and guidance that\n // `useUserFacingErrorMessage()` turns into the application's words. An `Error` rebuilt from its message\n // keeps only the text, which is never shown, so the failure could only read as generic (#1182).\n // A cancellation keeps its previous shape.\n if (mutationResult.error?.cause !== undefined && mutationResult.error.type !== MutationErrorType.ABORT) {\n throw mutationResult.error.cause;\n }\n throw new Error(\n mutationResult.error?.message\n ?? `Execution resource operation \"${resourceSurface.operationId}\" failed.`,\n );\n }\n\n return mutationResult.responseData;\n }\n\n return resourceSurface.executeCurrentOperation(requestData);\n }, [\n participationRmm.rmm,\n resourceContext.additionalContext,\n resourceContext.operation,\n resourceContext.parentResourcesRequirements,\n registry,\n resourceSurface,\n ]);\n\n return {\n ...resourceSurface,\n target,\n participationHandle: target.participationRef ? participationHandle : undefined,\n navigationHandlingMode,\n rmm: participationRmm.rmm,\n rmmSnapshot: participationRmm.rmmSnapshot,\n rmmUnavailableReason: participationRmm.rmmUnavailableReason,\n executionRmmUnavailableReason: target.participationRef\n ? participationRmm.executionUnavailableReason\n : null,\n execute,\n navigateToResourceOperation,\n navigateToPreferredRead,\n };\n}\n\nexport interface UseExecutionParticipationOperationSurfaceParams extends Omit<\n UseExecutionResourceOperationSurfaceParams,\n 'target'\n> {\n participationRef: string;\n target: Omit<ExecutionResourceOperationTarget, 'participationRef'>;\n}\n\n/\n Participation-first convenience wrapper over `useExecutionResourceOperationSurface()`.\n */\nexport function useExecutionParticipationOperationSurface(\n params: UseExecutionParticipationOperationSurfaceParams,\n): ExecutionResourceOperationSurface {\n const target = useMemo<ExecutionResourceOperationTarget>(() => ({\n ...params.target,\n participationRef: params.participationRef,\n } as ExecutionResourceOperationTarget), [params.participationRef, params.target]);\n\n return useExecutionResourceOperationSurface({\n target,\n navigationInitiator: params.navigationInitiator,\n updateLikeMutationFallbackMode: params.updateLikeMutationFallbackMode,\n });\n}\n"]}
1	+ {"version":3,"file":"useExecutionResourceOperationSurface.js","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionResourceOperationSurface.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext, useMemo } from 'react';\n\nimport {\n CoreResourceOperation,\n ErrorCustomMessageReference,\n ResourcesConfig_OperationPathUtils,\n ResourcesConfigOperationsUrlsBuilderUtils,\n} from '@wildo-ai/saas-models';\n\nimport {\n frontendResourceUtils,\n FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n mergeBulkSelectionIntoRequestData,\n isSingleResourceUpdateLikeOperation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n isFrontendOperationAddressableForCurrentContext,\n shouldRequireCurrentContextAddressabilityForOperation,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport {\n MutationErrorType,\n MutationPriority,\n MutationSourceType,\n MutationType,\n type RMMSnapshot,\n} from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n allowsDirectOperationFallback,\n resolveDeclaredUpdateLikeMutationFallbackMode,\n type UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport type {\n ResourceOperationSurface,\n UseResourceOperationSurfaceParams,\n} from '~wildo-frontend-lib/core/resources/useResourceOperationSurface';\nimport { useResourceOperationSurface } from '~wildo-frontend-lib/core/resources/useResourceOperationSurface';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n ExecutionNavigationHandlingMode,\n resolveExecutionNavigationHandlingMode,\n} from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport {\n NavigationContentType,\n type NavigationInitiatorContext,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { UseResourceRMMUnavailableReason } from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport {\n buildExecutionParticipationHandle,\n type ExecutionParticipationHandle,\n} from './execution-participation.utils';\nimport {\n type ExecutionResourceOperationTarget,\n useExecutionResourceOperationContextBuilder,\n} from './useExecutionResourceOperationContextBuilder';\nimport {\n type UseExecutionParticipationRMMUnavailableReason,\n useExecutionParticipationRMM,\n} from './useExecutionParticipationRMM';\nimport {\n assertExecutionRuntimeContext,\n ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\n\nexport interface ExecutionResourceOperationExecuteOptions {\n mutationType?: MutationType;\n mutationPriority?: MutationPriority;\n subscriberId?: string;\n readBackOnSuccess?: boolean;\n}\n\nexport interface UseExecutionResourceOperationSurfaceParams {\n target: ExecutionResourceOperationTarget;\n navigationInitiator?: NavigationInitiatorContext;\n updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n}\n\nexport interface ExecutionResourceOperationSurface extends Omit<\n ResourceOperationSurface,\n 'navigateToResourceOperation' \| 'navigateToPreferredRead'\n> {\n target: ExecutionResourceOperationTarget;\n participationHandle?: ExecutionParticipationHandle;\n navigationHandlingMode: ExecutionNavigationHandlingMode;\n rmm: ReturnType<typeof useExecutionParticipationRMM>['rmm'];\n rmmSnapshot: RMMSnapshot;\n rmmUnavailableReason: UseResourceRMMUnavailableReason \| null;\n executionRmmUnavailableReason: UseExecutionParticipationRMMUnavailableReason \| null;\n execute: (\n requestData?: Record<string, unknown>,\n options?: ExecutionResourceOperationExecuteOptions,\n ) => Promise<unknown>;\n navigateToResourceOperation: ResourceOperationSurface['navigateToResourceOperation'];\n navigateToPreferredRead: ResourceOperationSurface['navigateToPreferredRead'];\n}\n\n/*\n Execution-aware headless resource-operation surface.\n \n This composes three existing engine seams:\n * - participation-aware execution context building\n * - ordinary resource-operation surface semantics\n * - thin execution-to-RMM handoff for concrete single-resource update-like lanes\n \n Important boundary:\n * - routed/global navigation is still delegated back through execution\n * navigation mediation\n * - update-like execution only uses RMM when the target resolves to one concrete\n * participation-backed lane\n /\nexport function useExecutionResourceOperationSurface({\n target,\n navigationInitiator,\n / Omitted, the resource surface applies the lane the operation declared (RMM_REQUIRED unless it said otherwise). /\n updateLikeMutationFallbackMode,\n}: UseExecutionResourceOperationSurfaceParams): ExecutionResourceOperationSurface {\n const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n const executionNavigation = executionRuntime.navigation;\n const { registry } = useResourceRegistry();\n const { buildResourceOperationContext } = useExecutionResourceOperationContextBuilder();\n\n const rawParticipation = target.participationRef\n ? executionRuntime.participations[target.participationRef]\n : undefined;\n const participationHandle = useMemo<ExecutionParticipationHandle \| undefined>(() => {\n if (!rawParticipation) {\n return undefined;\n }\n\n return buildExecutionParticipationHandle({\n participation: rawParticipation,\n registry,\n });\n }, [rawParticipation, registry]);\n\n const resourceContext = useMemo(() => {\n return buildResourceOperationContext(target);\n }, [buildResourceOperationContext, target]);\n\n const resourceSurface = useResourceOperationSurface({\n resourceContext,\n navigationZone: executionRuntime.navigationZone,\n navigationInitiator,\n updateLikeMutationFallbackMode,\n } satisfies UseResourceOperationSurfaceParams);\n\n const participationRmm = useExecutionParticipationRMM({\n participationRef: target.participationRef ?? '',\n resourceId: target.resourceId,\n contextResourceIdentifiers: target.contextResourceIdentifiers,\n relationshipFieldOverrides: target.relationshipFieldOverrides,\n enabled: Boolean(target.participationRef) && isSingleResourceUpdateLikeOperation(resourceContext.operation),\n directFallbackAccepted: allowsDirectOperationFallback(\n updateLikeMutationFallbackMode ?? resolveDeclaredUpdateLikeMutationFallbackMode(resourceContext.operation),\n ),\n });\n const navigationHandlingMode = useMemo(() => resolveExecutionNavigationHandlingMode({\n viewDefinition: executionRuntime.viewDefinition,\n resourceType: resourceSurface.resourceType,\n operation: resourceSurface.operation,\n }), [\n executionRuntime.viewDefinition,\n resourceSurface.operation,\n resourceSurface.resourceType,\n ]);\n\n const buildDelegatedUrlPath = useCallback((\n operation: FrontendResourceConfiguration_Operation,\n contextResourceIdentifiers = resourceContext.contextResourceIdentifiers,\n parentResourcesRequirements = resourceContext.parentResourcesRequirements,\n ): string \| undefined => {\n if (!resourceSurface.resourceConfig) {\n return undefined;\n }\n\n const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n resourceSurface.resourceConfig,\n operation,\n registry.allResourceFieldIdentifiers,\n );\n\n if (routePaths.length === 0) {\n return undefined;\n }\n\n return frontendResourceUtils.selectMatchingRoutePath(\n routePaths,\n contextResourceIdentifiers,\n resourceSurface.resourceType,\n resourceSurface.resourceConfig.resourceFieldIdentifier,\n parentResourcesRequirements,\n ).url;\n }, [\n registry.allResourceFieldIdentifiers,\n resourceContext.contextResourceIdentifiers,\n resourceContext.parentResourcesRequirements,\n resourceSurface.resourceConfig,\n resourceSurface.resourceType,\n ]);\n\n const navigateToResourceOperation = useCallback<ExecutionResourceOperationSurface['navigateToResourceOperation']>(({\n operation,\n contextResourceIdentifiers = resourceContext.contextResourceIdentifiers,\n parentResourcesRequirements = resourceContext.parentResourcesRequirements,\n initiatorOverride,\n }) => {\n if (!resourceSurface.resourceConfig) {\n return false;\n }\n\n const contextualParameters = FrontendResourceUtils.buildContextualParameters(\n contextResourceIdentifiers,\n registry,\n );\n const requiresAddressability = shouldRequireCurrentContextAddressabilityForOperation({\n operation,\n resourceType: resourceSurface.resourceType,\n resourceConfig: resourceSurface.resourceConfig,\n });\n if (\n requiresAddressability\n && operation.isBulkOperation !== true\n && !isFrontendOperationAddressableForCurrentContext({\n resourceConfig: resourceSurface.resourceConfig,\n operation,\n registry,\n hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,\n contextResourceIdentifiers,\n contextualParameters,\n })\n ) {\n return false;\n }\n\n const targetContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n resourceType: resourceSurface.resourceType,\n operation,\n contextResourceIdentifiers,\n parentResourcesRequirements,\n });\n\n const delegatedUrlPath = buildDelegatedUrlPath(\n operation,\n contextResourceIdentifiers,\n parentResourcesRequirements,\n );\n if (navigationHandlingMode === ExecutionNavigationHandlingMode.EMBED_LOCALLY) {\n executionNavigation.openEmbeddedContent({\n content: {\n contentType: NavigationContentType.RESOURCE_OPERATION,\n resourceContext: targetContext,\n },\n navigationInitiator: initiatorOverride ?? resourceSurface.operationInitiator,\n });\n\n return true;\n }\n\n const fallbackInitiator = resourceSurface.operationInitiator;\n const { sourceZone: _ignoredSourceZone, ...defaultInitiator } = fallbackInitiator;\n\n executionNavigation.delegateToParent({\n content: {\n contentType: NavigationContentType.RESOURCE_OPERATION,\n resourceContext: targetContext,\n },\n urlPath: delegatedUrlPath,\n initiator: initiatorOverride ?? defaultInitiator,\n });\n\n return true;\n }, [\n buildDelegatedUrlPath,\n executionNavigation,\n resourceContext.contextResourceIdentifiers,\n resourceContext.parentResourcesRequirements,\n navigationHandlingMode,\n registry,\n resourceSurface.operationInitiator,\n resourceSurface.resourceConfig,\n resourceSurface.resourceType,\n ]);\n\n const navigateToPreferredRead = useCallback<ExecutionResourceOperationSurface['navigateToPreferredRead']>((options) => {\n const readOperation = resourceSurface.resolvePreferredOperation(\n CoreResourceOperation.READ,\n { requireAddressable: true },\n );\n\n if (!readOperation) {\n if (options?.fallbackToGoBack !== false) {\n resourceSurface.goBackWithinZone();\n }\n return false;\n }\n\n return navigateToResourceOperation({\n operation: readOperation,\n contextResourceIdentifiers: options?.contextResourceIdentifiers ?? resourceContext.contextResourceIdentifiers,\n parentResourcesRequirements: options?.parentResourcesRequirements ?? resourceContext.parentResourcesRequirements,\n initiatorOverride: options?.initiatorOverride,\n });\n }, [\n navigateToResourceOperation,\n resourceContext.contextResourceIdentifiers,\n resourceContext.parentResourcesRequirements,\n resourceSurface,\n ]);\n\n const execute = useCallback<ExecutionResourceOperationSurface['execute']>(async (requestData, options) => {\n const requiresAddressability = resourceSurface.resourceConfig\n ? shouldRequireCurrentContextAddressabilityForOperation({\n operation: resourceContext.operation,\n resourceType: resourceSurface.resourceType,\n resourceConfig: resourceSurface.resourceConfig,\n })\n : false;\n if (\n requiresAddressability\n && resourceContext.operation.isBulkOperation !== true\n && resourceSurface.resourceConfig\n && !isFrontendOperationAddressableForCurrentContext({\n resourceConfig: resourceSurface.resourceConfig,\n operation: resourceContext.operation,\n registry,\n hasResourceId: frontendResourceUtils.getResourceId(resourceContext.contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,\n contextResourceIdentifiers: resourceContext.contextResourceIdentifiers,\n contextualParameters: resourceSurface.contextualParameters,\n })\n ) {\n throw FrontendResourceUtils.buildConfigurationError(\n ErrorCustomMessageReference.CONFIGURATION,\n {\n message: `Execution resource operation \"${resourceSurface.operationId}\" is not addressable in the current context.`,\n component: 'useExecutionResourceOperationSurface',\n resourceType: resourceSurface.resourceType,\n operationIdentifier: String(resourceContext.operation.operationIdentifier),\n },\n );\n }\n\n if (isSingleResourceUpdateLikeOperation(resourceContext.operation) && participationRmm.rmm) {\n const effectiveRequestData = mergeBulkSelectionIntoRequestData({\n operation: resourceContext.operation,\n requestData,\n additionalContext: resourceContext.additionalContext,\n });\n const mutationResult = await participationRmm.rmm.queueMutation(\n effectiveRequestData ?? {},\n {\n type: options?.mutationType ?? MutationType.CUSTOM,\n priority: options?.mutationPriority ?? MutationPriority.NORMAL,\n source: {\n type: MutationSourceType.ORCHESTRATOR,\n subscriberId: options?.subscriberId\n ?? `execution-surface:${resourceSurface.resourceType}:${resourceSurface.operationId}`,\n },\n transportOverride: {\n operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(\n resourceContext.operation,\n ),\n contextualParameters: resourceSurface.contextualParameters,\n parentResourcesRequirements: resourceContext.parentResourcesRequirements,\n requestData: effectiveRequestData ?? {},\n readBackOnSuccess: options?.readBackOnSuccess ?? true,\n },\n },\n );\n\n if (!mutationResult.success) {\n // Rethrow the transport failure itself: it carries the backend reference, type and guidance that\n // `useUserFacingErrorMessage()` turns into the application's words. An `Error` rebuilt from its message\n // keeps only the text, which is never shown, so the failure could only read as generic (#1182).\n // A cancellation keeps its previous shape.\n if (mutationResult.error?.cause !== undefined && mutationResult.error.type !== MutationErrorType.ABORT) {\n throw mutationResult.error.cause;\n }\n throw new Error(\n mutationResult.error?.message\n ?? `Execution resource operation \"${resourceSurface.operationId}\" failed.`,\n );\n }\n\n return mutationResult.responseData;\n }\n\n return resourceSurface.executeCurrentOperation(requestData);\n }, [\n participationRmm.rmm,\n resourceContext.additionalContext,\n resourceContext.operation,\n resourceContext.parentResourcesRequirements,\n registry,\n resourceSurface,\n ]);\n\n return {\n ...resourceSurface,\n target,\n participationHandle: target.participationRef ? participationHandle : undefined,\n navigationHandlingMode,\n rmm: participationRmm.rmm,\n rmmSnapshot: participationRmm.rmmSnapshot,\n rmmUnavailableReason: participationRmm.rmmUnavailableReason,\n executionRmmUnavailableReason: target.participationRef\n ? participationRmm.executionUnavailableReason\n : null,\n execute,\n navigateToResourceOperation,\n navigateToPreferredRead,\n };\n}\n\nexport interface UseExecutionParticipationOperationSurfaceParams extends Omit<\n UseExecutionResourceOperationSurfaceParams,\n 'target'\n> {\n participationRef: string;\n target: Omit<ExecutionResourceOperationTarget, 'participationRef'>;\n}\n\n/\n Participation-first convenience wrapper over `useExecutionResourceOperationSurface()`.\n */\nexport function useExecutionParticipationOperationSurface(\n params: UseExecutionParticipationOperationSurfaceParams,\n): ExecutionResourceOperationSurface {\n const target = useMemo<ExecutionResourceOperationTarget>(() => ({\n ...params.target,\n participationRef: params.participationRef,\n } as ExecutionResourceOperationTarget), [params.participationRef, params.target]);\n\n return useExecutionResourceOperationSurface({\n target,\n navigationInitiator: params.navigationInitiator,\n updateLikeMutationFallbackMode: params.updateLikeMutationFallbackMode,\n });\n}\n"]}

package/dist/esm/core/external-providers/ConsentBasedProviderSdks.d.ts ADDED Viewed

@@ -0,0 +1,63 @@
+/**
+ * The application's SECOND activation phase: providers that rest on a consent purpose (#1704).
+ *
+ * ## Why startup cannot do this
+ *
+ * `startApplication` activates provider SDKs before any person is known, so it passes no grant and starts
+ * only the providers that rest on no purpose (error monitoring, pickers). A provider that rests on
+ * `ConsentPurpose.ANALYTICS` could therefore never start on the application tier — the consent module had
+ * always said such a provider "must be activated by a consumer that holds the person's granted purposes",
+ * and no such consumer existed. This is it.
+ *
+ * ## Where the grant comes from, and what revokes it
+ *
+ * The signed-in person's `privacy.consentedPurposes`, published on `USER_PREFERENCES_CHANGED` — the same
+ * stream `AnalyticsContext` has always gated on, with the same rule: `privacy: null` (sign-out, or an
+ * identity with no preferences) REVOKES — sign-out publishes it, so a browser a person signed out of never
+ * keeps their consent running for whoever uses it next — and an empty set is a real withdrawal. Until
+ * preferences arrive nothing is granted, which is why pre-authentication pages start none.
+ *
+ * ## Start and stop
+ *
+ * The providers are (re)started when the granted subset of the purposes THEY rest on changes, so granting a
+ * purpose none of them uses restarts nothing; granting or withdrawing one they use restarts all of them.
+ * Every activation goes through `activateFrontendProviderSdks` — which refuses a consent-based provider that
+ * could not be stopped — and every withdrawal, sign-out or unmount calls `deactivateAll`, which is the only
+ * thing that stops a vendor already running in the page.
+ *
+ * Starts and stops are SERIALISED through `createFrontendProviderSdkActivationLane`, the one lane every consent-based
+ * consumer holds (the website's is the other): a new start waits until the previous one has fully stopped. A vendor SDK is
+ * usually a page-global singleton, so a stop that finished after the next start (a person who grants, withdraws
+ * and grants again while the vendor bundle is still downloading) would switch off the client that had just been
+ * published as running.
+ *
+ * ## No second audit trail
+ *
+ * The consent DECISION is the audited preference write (`consentedPurposes` on the person's preferences,
+ * read by the resource-operation audit emission). Starting or stopping an SDK here is a consequence of that
+ * decision, not a decision, so it records nothing of its own: a second trail would only be able to
+ * disagree with the first.
+ */
+import React from 'react';
+import { type ProviderFrontendSdkActivation } from '@wildo-ai/external-connectors-public/app';
+/** One running consent-based provider: its ref, the capabilities it serves, and its activation. */
+export interface ConsentBasedProviderActivation {
+    readonly providerRef: string;
+    readonly providerCapabilities: ReadonlyArray<string>;
+    readonly activation: ProviderFrontendSdkActivation;
+}
+/** @wildo_source:part:start saas.frontend.consent-based-provider-activation facet:layer:frontend facet:audience:app-developer */
+/**
+ * The consent-based providers currently RUNNING on the application, in registry order (#1704).
+ *
+ * Empty until the signed-in person grants the purposes a provider rests on, and emptied again on withdrawal or
+ * sign-out — immediately, before the providers' `deactivate` has finished. A consumer that dispatches to a
+ * provider (`AnalyticsContext` does, for `FRONTEND_PRODUCT_ANALYTICS`) reads this and never holds a handle past it.
+ */
+export declare function useConsentBasedProviderActivations(): ReadonlyArray<ConsentBasedProviderActivation>;
+/** @wildo_source:part:end saas.frontend.consent-based-provider-activation */
+export declare const ConsentBasedProviderActivationsContext: React.Context<readonly ConsentBasedProviderActivation[]>;
+export declare const ConsentBasedProviderSdksProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+//# sourceMappingURL=ConsentBasedProviderSdks.d.ts.map

package/dist/esm/core/external-providers/ConsentBasedProviderSdks.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ConsentBasedProviderSdks.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/ConsentBasedProviderSdks.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAA0E,MAAM,OAAO,CAAC;AAC/F,OAAO,EAIL,KAAK,6BAA6B,EACnC,MAAM,0CAA0C,CAAC;AAOlD,mGAAmG;AACnG,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC;CACpD;AAED,iIAAiI;AACjI;;;;;;GAMG;AACH,wBAAgB,kCAAkC,IAAI,aAAa,CAAC,8BAA8B,CAAC,CAElG;AACD,6EAA6E;AAE7E,eAAO,MAAM,sCAAsC,0DAAmE,CAAC;AAQvH,eAAO,MAAM,gCAAgC,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CA+EpF,CAAC"}

package/dist/esm/core/external-providers/ConsentBasedProviderSdks.js ADDED Viewed

@@ -0,0 +1,131 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The application's SECOND activation phase: providers that rest on a consent purpose (#1704).
+ *
+ * ## Why startup cannot do this
+ *
+ * `startApplication` activates provider SDKs before any person is known, so it passes no grant and starts
+ * only the providers that rest on no purpose (error monitoring, pickers). A provider that rests on
+ * `ConsentPurpose.ANALYTICS` could therefore never start on the application tier — the consent module had
+ * always said such a provider "must be activated by a consumer that holds the person's granted purposes",
+ * and no such consumer existed. This is it.
+ *
+ * ## Where the grant comes from, and what revokes it
+ *
+ * The signed-in person's `privacy.consentedPurposes`, published on `USER_PREFERENCES_CHANGED` — the same
+ * stream `AnalyticsContext` has always gated on, with the same rule: `privacy: null` (sign-out, or an
+ * identity with no preferences) REVOKES — sign-out publishes it, so a browser a person signed out of never
+ * keeps their consent running for whoever uses it next — and an empty set is a real withdrawal. Until
+ * preferences arrive nothing is granted, which is why pre-authentication pages start none.
+ *
+ * ## Start and stop
+ *
+ * The providers are (re)started when the granted subset of the purposes THEY rest on changes, so granting a
+ * purpose none of them uses restarts nothing; granting or withdrawing one they use restarts all of them.
+ * Every activation goes through `activateFrontendProviderSdks` — which refuses a consent-based provider that
+ * could not be stopped — and every withdrawal, sign-out or unmount calls `deactivateAll`, which is the only
+ * thing that stops a vendor already running in the page.
+ *
+ * Starts and stops are SERIALISED through `createFrontendProviderSdkActivationLane`, the one lane every consent-based
+ * consumer holds (the website's is the other): a new start waits until the previous one has fully stopped. A vendor SDK is
+ * usually a page-global singleton, so a stop that finished after the next start (a person who grants, withdraws
+ * and grants again while the vendor bundle is still downloading) would switch off the client that had just been
+ * published as running.
+ *
+ * ## No second audit trail
+ *
+ * The consent DECISION is the audited preference write (`consentedPurposes` on the person's preferences,
+ * read by the resource-operation audit emission). Starting or stopping an SDK here is a consequence of that
+ * decision, not a decision, so it records nothing of its own: a second trail would only be able to
+ * disagree with the first.
+ */
+import { createContext, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { activateFrontendProviderSdks, consentPurposesRequiredByProvider, createFrontendProviderSdkActivationLane, } from '@wildo-ai/external-connectors-public/app';
+import { AppFrontendType, BUILTIN_PROVIDER_CAPABILITY, normalizeConsentPurposes } from '@wildo-ai/saas-models/public-runtime';
+import { ApplicationContext } from '../../core/runtime/ApplicationContext.shared.js';
+import { useEventBus } from '../../core/events/useEventBus.js';
+import { FrontendEvents } from '../../core/events/events.frontend.schemas.js';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+/** @wildo_source:part:start saas.frontend.consent-based-provider-activation facet:layer:frontend facet:audience:app-developer */
+/**
+ * The consent-based providers currently RUNNING on the application, in registry order (#1704).
+ *
+ * Empty until the signed-in person grants the purposes a provider rests on, and emptied again on withdrawal or
+ * sign-out — immediately, before the providers' `deactivate` has finished. A consumer that dispatches to a
+ * provider (`AnalyticsContext` does, for `FRONTEND_PRODUCT_ANALYTICS`) reads this and never holds a handle past it.
+ */
+export function useConsentBasedProviderActivations() {
+    return useContext(ConsentBasedProviderActivationsContext);
+}
+/** @wildo_source:part:end saas.frontend.consent-based-provider-activation */
+export const ConsentBasedProviderActivationsContext = createContext([]);
+const logger = LoggerFrontendService.getLogger();
+function grantedKey(purposes) {
+    return [...purposes].sort().join(',');
+}
+export const ConsentBasedProviderSdksProvider = ({ children }) => {
+    const appContext = useContext(ApplicationContext);
+    const registry = appContext?.frontendProviderRegistry;
+    const { on } = useEventBus();
+    // `null` = nothing said yet; an empty array is a recorded withdrawal. Both start nothing.
+    const [grantedPurposes, setGrantedPurposes] = useState(null);
+    const [activations, setActivations] = useState([]);
+    // One lane for this consumer's lifetime: a start waits for the previous stop.
+    const lane = useRef(createFrontendProviderSdkActivationLane());
+    useEffect(() => on(FrontendEvents.USER_PREFERENCES_CHANGED, (payload) => {
+        if (payload.privacy === null) {
+            setGrantedPurposes([]);
+            return;
+        }
+        const purposes = payload.privacy?.consentedPurposes;
+        if (purposes !== undefined)
+            setGrantedPurposes(normalizeConsentPurposes(purposes));
+    }), [on]);
+    // `analytics.enabled` is the application's master switch for product analytics: with it off, a vendor analytics
+    // client is not even loaded on a grant — loading it would already send PostHog a flags request and write its ids,
+    // for events that would then never be dispatched to it.
+    const analyticsEnabled = appContext?.appConfig?.analytics?.enabled === true;
+    const consentBasedModules = useMemo(() => (registry?.listAll() ?? []).filter((module) => consentPurposesRequiredByProvider(module).length > 0
+        && (analyticsEnabled || !module.providerCapabilities.includes(BUILTIN_PROVIDER_CAPABILITY.FRONTEND_PRODUCT_ANALYTICS))), [registry, analyticsEnabled]);
+    // Only the purposes these providers rest on, so an unrelated grant does not restart a running client.
+    const relevantGranted = useMemo(() => {
+        const granted = grantedPurposes ?? [];
+        const required = new Set(consentBasedModules.flatMap((module) => consentPurposesRequiredByProvider(module)));
+        return granted.filter((purpose) => required.has(purpose));
+    }, [consentBasedModules, grantedPurposes]);
+    const key = grantedKey(relevantGranted);
+    useEffect(() => {
+        if (consentBasedModules.length === 0 || relevantGranted.length === 0) {
+            setActivations([]);
+            return;
+        }
+        // Serialised through the lane — see "Start and stop" above.
+        const stop = lane.current.start(() => activateFrontendProviderSdks({
+            surface: AppFrontendType.SAAS_APP,
+            modules: consentBasedModules,
+            grantedConsentPurposes: relevantGranted,
+            onDiagnostic: (diagnostic) => {
+                logger.warn('Consent-based frontend provider activation diagnostic', {
+                    kind: diagnostic.kind,
+                    providerRef: diagnostic.providerRef,
+                    message: diagnostic.message,
+                });
+            },
+        }), (result) => {
+            setActivations(consentBasedModules.flatMap((module) => {
+                const activation = result.activations.get(module.metadata.ref);
+                return activation === undefined
+                    ? []
+                    : [{ providerRef: module.metadata.ref, providerCapabilities: [...module.providerCapabilities], activation }];
+            }));
+        });
+        return () => {
+            // Withdrawn from consumers at once, so nothing dispatches to a client that is being stopped.
+            setActivations([]);
+            stop();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed by the granted SET, see grantedKey.
+    }, [consentBasedModules, key]);
+    return (_jsx(ConsentBasedProviderActivationsContext.Provider, { value: activations, children: children }));
+};
+//# sourceMappingURL=ConsentBasedProviderSdks.js.map

package/dist/esm/core/external-providers/ConsentBasedProviderSdks.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ConsentBasedProviderSdks.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/ConsentBasedProviderSdks.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The application's SECOND activation phase: providers that rest on a consent purpose (#1704).\n *\n * ## Why startup cannot do this\n *\n * `startApplication` activates provider SDKs before any person is known, so it passes no grant and starts\n * only the providers that rest on no purpose (error monitoring, pickers). A provider that rests on\n * `ConsentPurpose.ANALYTICS` could therefore never start on the application tier — the consent module had\n * always said such a provider \"must be activated by a consumer that holds the person's granted purposes\",\n * and no such consumer existed. This is it.\n *\n * ## Where the grant comes from, and what revokes it\n *\n * The signed-in person's `privacy.consentedPurposes`, published on `USER_PREFERENCES_CHANGED` — the same\n * stream `AnalyticsContext` has always gated on, with the same rule: `privacy: null` (sign-out, or an\n * identity with no preferences) REVOKES — sign-out publishes it, so a browser a person signed out of never\n * keeps their consent running for whoever uses it next — and an empty set is a real withdrawal. Until\n * preferences arrive nothing is granted, which is why pre-authentication pages start none.\n *\n * ## Start and stop\n *\n * The providers are (re)started when the granted subset of the purposes THEY rest on changes, so granting a\n * purpose none of them uses restarts nothing; granting or withdrawing one they use restarts all of them.\n * Every activation goes through `activateFrontendProviderSdks` — which refuses a consent-based provider that\n * could not be stopped — and every withdrawal, sign-out or unmount calls `deactivateAll`, which is the only\n * thing that stops a vendor already running in the page.\n *\n * Starts and stops are SERIALISED through `createFrontendProviderSdkActivationLane`, the one lane every consent-based\n * consumer holds (the website's is the other): a new start waits until the previous one has fully stopped. A vendor SDK is\n * usually a page-global singleton, so a stop that finished after the next start (a person who grants, withdraws\n * and grants again while the vendor bundle is still downloading) would switch off the client that had just been\n * published as running.\n *\n * ## No second audit trail\n *\n * The consent DECISION is the audited preference write (`consentedPurposes` on the person's preferences,\n * read by the resource-operation audit emission). Starting or stopping an SDK here is a consequence of that\n * decision, not a decision, so it records nothing of its own: a second trail would only be able to\n * disagree with the first.\n */\n\nimport React, { createContext, useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n activateFrontendProviderSdks,\n consentPurposesRequiredByProvider,\n createFrontendProviderSdkActivationLane,\n type ProviderFrontendSdkActivation,\n} from '@wildo-ai/external-connectors-public/app';\nimport { AppFrontendType, BUILTIN_PROVIDER_CAPABILITY, normalizeConsentPurposes, type ConsentPurpose } from '@wildo-ai/saas-models/public-runtime';\nimport { ApplicationContext } from '~wildo-frontend-lib/core/runtime/ApplicationContext.shared';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/** One running consent-based provider: its ref, the capabilities it serves, and its activation. */\nexport interface ConsentBasedProviderActivation {\n readonly providerRef: string;\n readonly providerCapabilities: ReadonlyArray<string>;\n readonly activation: ProviderFrontendSdkActivation;\n}\n\n/** @wildo_source:part:start saas.frontend.consent-based-provider-activation facet:layer:frontend facet:audience:app-developer */\n/**\n * The consent-based providers currently RUNNING on the application, in registry order (#1704).\n *\n * Empty until the signed-in person grants the purposes a provider rests on, and emptied again on withdrawal or\n * sign-out — immediately, before the providers' `deactivate` has finished. A consumer that dispatches to a\n * provider (`AnalyticsContext` does, for `FRONTEND_PRODUCT_ANALYTICS`) reads this and never holds a handle past it.\n */\nexport function useConsentBasedProviderActivations(): ReadonlyArray<ConsentBasedProviderActivation> {\n return useContext(ConsentBasedProviderActivationsContext);\n}\n/** @wildo_source:part:end saas.frontend.consent-based-provider-activation */\n\nexport const ConsentBasedProviderActivationsContext = createContext<ReadonlyArray<ConsentBasedProviderActivation>>([]);\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\nfunction grantedKey(purposes: readonly ConsentPurpose[]): string {\n return [...purposes].sort().join(',');\n}\n\nexport const ConsentBasedProviderSdksProvider: React.FC<{ children: React.ReactNode }> = ({ children }) => {\n const appContext = useContext(ApplicationContext);\n const registry = appContext?.frontendProviderRegistry;\n const { on } = useEventBus();\n\n // `null` = nothing said yet; an empty array is a recorded withdrawal. Both start nothing.\n const [grantedPurposes, setGrantedPurposes] = useState<readonly ConsentPurpose[] | null>(null);\n const [activations, setActivations] = useState<ReadonlyArray<ConsentBasedProviderActivation>>([]);\n // One lane for this consumer's lifetime: a start waits for the previous stop.\n const lane = useRef(createFrontendProviderSdkActivationLane());\n\n useEffect(() => on(FrontendEvents.USER_PREFERENCES_CHANGED, (payload) => {\n if (payload.privacy === null) {\n setGrantedPurposes([]);\n return;\n }\n const purposes = payload.privacy?.consentedPurposes;\n if (purposes !== undefined) setGrantedPurposes(normalizeConsentPurposes(purposes));\n }), [on]);\n\n // `analytics.enabled` is the application's master switch for product analytics: with it off, a vendor analytics\n // client is not even loaded on a grant — loading it would already send PostHog a flags request and write its ids,\n // for events that would then never be dispatched to it.\n const analyticsEnabled = appContext?.appConfig?.analytics?.enabled === true;\n const consentBasedModules = useMemo(\n () => (registry?.listAll() ?? []).filter((module) => consentPurposesRequiredByProvider(module).length > 0\n && (analyticsEnabled || !module.providerCapabilities.includes(BUILTIN_PROVIDER_CAPABILITY.FRONTEND_PRODUCT_ANALYTICS))),\n [registry, analyticsEnabled],\n );\n // Only the purposes these providers rest on, so an unrelated grant does not restart a running client.\n const relevantGranted = useMemo(() => {\n const granted = grantedPurposes ?? [];\n const required = new Set(consentBasedModules.flatMap((module) => consentPurposesRequiredByProvider(module)));\n return granted.filter((purpose) => required.has(purpose));\n }, [consentBasedModules, grantedPurposes]);\n const key = grantedKey(relevantGranted);\n\n useEffect(() => {\n if (consentBasedModules.length === 0 || relevantGranted.length === 0) {\n setActivations([]);\n return;\n }\n // Serialised through the lane — see \"Start and stop\" above.\n const stop = lane.current.start(\n () => activateFrontendProviderSdks({\n surface: AppFrontendType.SAAS_APP,\n modules: consentBasedModules,\n grantedConsentPurposes: relevantGranted,\n onDiagnostic: (diagnostic) => {\n logger.warn('Consent-based frontend provider activation diagnostic', {\n kind: diagnostic.kind,\n providerRef: diagnostic.providerRef,\n message: diagnostic.message,\n });\n },\n }),\n (result) => {\n setActivations(consentBasedModules.flatMap((module) => {\n const activation = result.activations.get(module.metadata.ref);\n return activation === undefined\n ? []\n : [{ providerRef: module.metadata.ref, providerCapabilities: [...module.providerCapabilities], activation }];\n }));\n },\n );\n\n return () => {\n // Withdrawn from consumers at once, so nothing dispatches to a client that is being stopped.\n setActivations([]);\n stop();\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed by the granted SET, see grantedKey.\n }, [consentBasedModules, key]);\n\n return (\n <ConsentBasedProviderActivationsContext.Provider value={activations}>\n {children}\n </ConsentBasedProviderActivationsContext.Provider>\n );\n};\n"]}

package/dist/esm/core/external-providers/ProviderAddressLookupCombobox.d.ts ADDED Viewed

@@ -0,0 +1,61 @@
+/**
+ * The framework's address-lookup COMPONENT, for any vendor that supplies a `ProviderAddressLookupAdapter` (#561).
+ *
+ * A vendor's lookup is four pure functions (build the suggest input, read the suggestions, build the retrieve
+ * input, read the address). Everything else a lookup must get right is the same for every vendor and is written
+ * once here:
+ *
+ * - **The keyboard and screen-reader pattern is the engine's `Combobox`**, not new markup: a trigger with
+ *   `role="combobox"` and `aria-expanded`, and inside it the command list whose text box is a WAI-ARIA combobox
+ *   over a `listbox` — arrow keys move the active option, which is announced through `aria-activedescendant`,
+ *   Enter chooses it and Escape closes the list. Server-side results, so the list is not filtered again locally.
+ * - **Suggestions start at {@link PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH} characters and are debounced**
+ *   by {@link PROVIDER_ADDRESS_LOOKUP_DEBOUNCE_MS} (#561 D5): fewer characters match half a country, and a
+ *   request per keystroke spends the person's per-operation allowance at the door.
+ * - **A slower, older answer never replaces a newer one.** Each search carries a sequence number and only the
+ *   latest may write the list — the ordinary way a typeahead shows results for text the person already changed.
+ * - **Nothing vendor-owned is kept.** The suggestion's id lives only until the retrieval; the address that comes
+ *   back is handed to `onSelect` and the field takes it as typed text.
+ * - **Every failure is reported, never thrown** (`onError`), so the host can say the lookup is unavailable while
+ *   the address parts below keep working by hand.
+ *
+ * The session token and the choice of backend operations are NOT here: the host binds `suggest` / `retrieve` to the
+ * operations the provider declared and fills the token itself (#561 D4). The vendor attribution arrives from the host
+ * as data and is shown here, inside the suggestion popup beside the results, by {@link ProviderAddressLookupAttribution}.
+ */
+import React from 'react';
+import type { ProviderAddressLookupAdapter, ProviderAddressLookupAttributionText, ProviderAddressLookupProps } from '@wildo-ai/saas-models';
+/** Characters typed before a search runs (#561 D5). */
+export declare const PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH = 3;
+/** Quiet time after the last keystroke before a search runs, in milliseconds. */
+export declare const PROVIDER_ADDRESS_LOOKUP_DEBOUNCE_MS = 300;
+export interface ProviderAddressLookupComboboxProps extends ProviderAddressLookupProps {
+    /** The vendor's four functions. */
+    readonly adapter: ProviderAddressLookupAdapter;
+}
+/**
+ * The vendor answered the retrieval, and the place it describes has no postal address the field can hold (no
+ * street line, no town or no country). Reported through `onError` like any failure, as its own class so the host
+ * can say "this place cannot be used" rather than "the lookup is unavailable" — the lookup worked.
+ */
+export declare class ProviderAddressLookupPlaceWithoutAddressError extends Error {
+    constructor();
+}
+/**
+ * A vendor's required attribution, rendered to the vendor's text rules (#561 D4).
+ *
+ * Google's rules for its "Google Maps" text, when its logo is not used: never translated (`translate="no"`), never
+ * wrapped onto two lines, weight 400, 12–16 px, normal letter spacing, and white, #1F1F1F or #5E5E5E with at least
+ * 4.5:1 contrast against its background. The mark is therefore set in #1F1F1F on its own white ground, which keeps
+ * that contrast on every theme the application ships — the one place a vendor's colours override the design
+ * system's tokens, as a logo would. The sentence around it, for assistive technology, comes from the application's
+ * labels; the mark itself is hidden from them so it is not read twice.
+ * spec-cite: https://developers.google.com/maps/documentation/places/web-service/policies — "Font color: White, black
+ * (#1F1F1F), or gray (#5E5E5E)", "Don't wrap Google Maps onto multiple lines", "Prevent browsers from translating
+ * Google Maps by using the HTML attribute translate='no'". Fetched 2026-09-29.
+ */
+export declare function ProviderAddressLookupAttribution({ attribution }: {
+    readonly attribution: ProviderAddressLookupAttributionText;
+}): React.ReactElement;
+export declare function ProviderAddressLookupCombobox(props: ProviderAddressLookupComboboxProps): React.ReactElement;
+//# sourceMappingURL=ProviderAddressLookupCombobox.d.ts.map

package/dist/esm/core/external-providers/ProviderAddressLookupCombobox.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ProviderAddressLookupCombobox.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/ProviderAddressLookupCombobox.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAGjF,OAAO,KAAK,EACV,4BAA4B,EAC5B,oCAAoC,EACpC,0BAA0B,EAE3B,MAAM,uBAAuB,CAAC;AAM/B,uDAAuD;AACvD,eAAO,MAAM,4CAA4C,IAAI,CAAC;AAE9D,iFAAiF;AACjF,eAAO,MAAM,mCAAmC,MAAM,CAAC;AAKvD,MAAM,WAAW,kCAAmC,SAAQ,0BAA0B;IACpF,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;CAChD;AAED;;;;GAIG;AACH,qBAAa,6CAA8C,SAAQ,KAAK;;CAKvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,WAAW,EAAE,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,oCAAoC,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAcpJ;AAMD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,kCAAkC,GAAG,KAAK,CAAC,YAAY,CA8I3G"}