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

package/dist/esm/core/execution/useExecutionParticipationDataPrefetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionParticipationDataPrefetch.js","sourceRoot":"","sources":["../../../../src/core/execution/useExecutionParticipationDataPrefetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,kCAAkC,GACnC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qCAAqC,GACtC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,EACpC,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2CAA2C,EAAE,MAAM,+CAA+C,CAAC;AAC5G,OAAO,EACL,iCAAiC,GAElC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAoE7F;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,YAAoB,EAAE,gBAAwB;IAC7E,OAAO,0BAA0B,YAAY,IAAI,gBAAgB,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,qCAAqC,CACnD,KAAiD;IAEjD,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC5F,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,6BAA6B,EAAE,GAAG,2CAA2C,EAAE,CAAC;IAExF,sEAAsE;IACtE,qEAAqE;IACrE,mEAAmE;IACnE,6CAA6C;IAC7C,MAAM,aAAa,GAAG,gBAAgB,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9E,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,yDAAyD,KAAK,CAAC,gBAAgB,IAAI;cACjF,4BAA4B,gBAAgB,CAAC,cAAc,CAAC,GAAG,KAAK;cACpE,gEAAgE,CACnE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,qCAAqC,CAAC,aAAa,CAAC,CAAC;IAE1E,mEAAmE;IACnE,sEAAsE;IACtE,mEAAmE;IACnE,gEAAgE;IAChE,mEAAmE;IACnE,gEAAgE;IAChE,oDAAoD;IACpD,MAAM,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QAClG,MAAM,eAAe,GAAG,6BAA6B,CAAC;YACpD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,aAAa,EAAE,qBAAqB,CAAC,IAAI;YACzC,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QACH,MAAM,4BAA4B,GAAG,qBAAqB,CAAC,yBAAyB,CAClF,eAAe,CAAC,0BAA0B,EAC1C,QAAQ,CACT,CAAC;QACF,OAAO;YACL,gBAAgB,EAAE,kCAAkC,CAAC,mCAAmC,CACtF,eAAe,CAAC,SAAS,CAC1B;YACD,oBAAoB,EAAE,4BAA4B;YAClD,2BAA2B,EAAE,eAAe,CAAC,2BAA2B;YACxE,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC,EAAE;QACD,6BAA6B;QAC7B,KAAK,CAAC,KAAK;QACX,KAAK,CAAC,gBAAgB;QACtB,QAAQ;KACT,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAG,KAAK,CAAC,WAAW;WACxC,uBAAuB,CAAC,YAAY,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,KAAK,CAAC,+BAA+B;WACvD,CAAC,KAAK,CAAC,MAAM,KAAK,oCAAoC,CAAC,OAAO,CAAC,CAAC;IAErE,MAAM,cAAc,GAAG,gBAAgB,CAAC,WAAW,CAAC;IACpD,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,MAAM,EAA2B,EAAoB,EAAE;QACtF,OAAO,cAAc,CAAC,gBAAgB,EAAE;YACtC,oBAAoB;YACpB,2BAA2B;YAC3B,QAAQ,EAAE,QAAQ,CAAC,GAAG;SACvB,EAAE;YACD,MAAM;SACP,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,CAAC,CAAC;IAE1F,OAAO,iCAAiC,CAAU;QAChD,WAAW,EAAE,mBAAmB;QAChC,iBAAiB,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC3C,YAAY;QACZ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG;QACH,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,+BAA+B,EAAE,cAAc;KAChD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { useCallback, useContext, useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  DataMode,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\n\nimport {\n  getExecutionParticipationResourceType,\n} from './execution-participation.utils';\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionParticipationPrefetchIntent,\n  ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\nimport { useExecutionResourceOperationContextBuilder } from './useExecutionResourceOperationContextBuilder';\nimport {\n  useExecutionParticipationPrefetch,\n  type UseExecutionParticipationPrefetchValue,\n} from './useExecutionParticipationPrefetch';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\n\n/**\n * Input shape for the opinionated participation-data prefetch hook.\n *\n * Wraps the generic `useExecutionParticipationPrefetch` primitive for the\n * most common case: hydrate a single participation's resource data via\n * the canonical READ `doOperation()` for the resolved resource type.\n *\n * Contract anchored at\n * `saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator`\n * in `ExecutionRuntimeContext.tsx`. See the sub-anchor JSDoc for the full\n * producer contract (stable `prefetchKey`, intent-aware bridge default,\n * stale-while-revalidate, etc.).\n */\nexport interface UseExecutionParticipationDataPrefetchInput {\n  /**\n   * Participation ref to hydrate. Must already be declared in the\n   * execution view's `participations` map and resolvable to a concrete\n   * resource id at call time. Single-ref by design — multi-ref hydration\n   * is a primitive-level concern (mount the primitive directly).\n   */\n  participationRef: string;\n  /**\n   * Whether this is `INITIAL` (full-screen skeleton UX) or `REFRESH`\n   * (subtle indicator UX). Drives the default for\n   * `bridgeFailuresToShellAggregator` (INITIAL=true, REFRESH=false) so\n   * typical UX gets the right default without consumers thinking about\n   * it. See contract invariant #6 in the sub-anchor JSDoc.\n   */\n  intent: ExecutionParticipationPrefetchIntent;\n  /**\n   * Optional override for the consumer-authored stable identity. When\n   * omitted, the wrapper derives a key of the shape\n   * `participation-prefetch:${resourceType}:${participationRef}` so two\n   * hook instances over the same participation share auto-prune\n   * lifecycle (which is almost always what the consumer wants —\n   * hovering an inspector node should clear a prior failed prewarm of\n   * the same node). Provide an explicit key when the implicit one\n   * collides (e.g. two distinct UX surfaces hydrating the same\n   * participation but wanting independent failure indicators).\n   */\n  prefetchKey?: string;\n  /** Optional human-readable label (\"Loading task graph\"). Opaque to the shell. */\n  label?: string;\n  /**\n   * Override for the intent-aware default. When omitted: `true` for\n   * INITIAL (initial hydration failures are noteworthy enough to\n   * surface in the global aggregator), `false` for REFRESH (silent\n   * background revalidation should not raise a global banner).\n   *\n   * Set to `false` explicitly on a chrome banner or other surface\n   * that owns its own error UX and does not want a duplicate global\n   * indicator.\n   */\n  bridgeFailuresToShellAggregator?: boolean;\n}\n\n/**\n * Return shape for the opinionated participation-data prefetch hook.\n *\n * Identical in spirit to the primitive's return value, but `data` is\n * loosely typed because the canonical READ payload depends on the\n * resolved resource type. Consumers narrow at the call site.\n */\nexport type UseExecutionParticipationDataPrefetchValue =\n  UseExecutionParticipationPrefetchValue<unknown>;\n\n/**\n * Compute the default consumer-authored `prefetchKey` for a single\n * participation hydration. The shape is intentionally stable across\n * `intent` changes — a `REFRESH` after an `INITIAL` for the same\n * participation should clear the same auto-prune bucket — and\n * intentionally NOT including any per-call data (e.g. context\n * identifiers) because the auto-prune bucket is the participation\n * itself, not the call's parameter shape.\n */\nfunction buildDefaultPrefetchKey(resourceType: string, participationRef: string): string {\n  return `participation-prefetch:${resourceType}:${participationRef}`;\n}\n\n/**\n * Opinionated wrapper hook for the participation-prefetch tier (Slice K).\n *\n * Hydrates a single participation's resource data via the canonical READ\n * `doOperation()` for the resolved resource type, and orchestrates the\n * full prefetch lifecycle (begin/end, AbortController, latest-error\n * surfacing, intent-aware shell-aggregator bridge). See the\n * `loading-aggregation.participation-prefetch.shell-data-hydrator`\n * sub-anchor in `ExecutionRuntimeContext.tsx` for the full producer\n * contract.\n *\n * **When to reach for the primitive instead.** Drop down to\n * `useExecutionParticipationPrefetch` when the underlying fetch is not\n * a `doOperation()` READ call, when the unit hydrates multiple\n * participations from a single call, or when the consumer needs\n * fine-grained control over the request shape (e.g. a custom\n * `requestData` payload, a non-default operation, or a non-`READ`\n * semantic).\n *\n * **`doOperation()` directly, NOT `actions.operation().execute()`.** See\n * the sub-anchor JSDoc for the rationale — short version: routing through\n * `execute()` would double-count the work in the loading aggregator\n * (once via the pending-action tier, once via the prefetch tier) and\n * trigger the failure-handling-contract bridge twice. The wrapper\n * therefore reads `doOperation` off `ExecutionRuntimeContext` directly.\n */\nexport function useExecutionParticipationDataPrefetch(\n  input: UseExecutionParticipationDataPrefetchInput,\n): UseExecutionParticipationDataPrefetchValue {\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n  const { registry } = useResourceRegistry();\n  const { buildResourceOperationContext } = useExecutionResourceOperationContextBuilder();\n\n  // Resolve the participation handle eagerly so a typoed ref fails fast\n  // at hook-call time (mirrors `useExecution().requireParticipation` —\n  // the same loud-fail discipline that catches view-definition drift\n  // immediately rather than on first refetch).\n  const participation = executionRuntime.participations[input.participationRef];\n  if (!participation) {\n    throw new Error(\n      `useExecutionParticipationDataPrefetch: participation \"${input.participationRef}\" `\n      + `is not declared on view \"${executionRuntime.viewDefinition.ref}\". `\n      + 'Add it to the view\\'s `participations` map or correct the ref.',\n    );\n  }\n\n  const resourceType = getExecutionParticipationResourceType(participation);\n\n  // Build the resource-operation context for the canonical READ. The\n  // operation path key is derived from the operation, exactly mirroring\n  // the path `useExecution().actions.operation({ operationLike: READ\n  // }).execute()` would build — same correlation key, same parent\n  // requirements, same contextual parameters. The only difference is\n  // we call `doOperation()` directly so the work registers in the\n  // prefetch tier instead of the pending-action tier.\n  const { operationPathKey, contextualParameters, parentResourcesRequirements, label } = useMemo(() => {\n    const resourceContext = buildResourceOperationContext({\n      participationRef: input.participationRef,\n      operationLike: CoreResourceOperation.READ,\n      requireAddressable: true,\n    });\n    const computedContextualParameters = FrontendResourceUtils.buildContextualParameters(\n      resourceContext.contextResourceIdentifiers,\n      registry,\n    );\n    return {\n      operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(\n        resourceContext.operation,\n      ),\n      contextualParameters: computedContextualParameters,\n      parentResourcesRequirements: resourceContext.parentResourcesRequirements,\n      label: input.label,\n    };\n  }, [\n    buildResourceOperationContext,\n    input.label,\n    input.participationRef,\n    registry,\n  ]);\n\n  const resolvedPrefetchKey = input.prefetchKey\n    ?? buildDefaultPrefetchKey(resourceType, input.participationRef);\n  const resolvedBridge = input.bridgeFailuresToShellAggregator\n    ?? (input.intent === ExecutionParticipationPrefetchIntent.INITIAL);\n\n  const doOperationRef = executionRuntime.doOperation;\n  const run = useCallback(async ({ signal }: { signal: AbortSignal }): Promise<unknown> => {\n    return doOperationRef(operationPathKey, {\n      contextualParameters,\n      parentResourcesRequirements,\n      dataMode: DataMode.RAW,\n    }, {\n      signal,\n    });\n  }, [contextualParameters, doOperationRef, operationPathKey, parentResourcesRequirements]);\n\n  return useExecutionParticipationPrefetch<unknown>({\n    prefetchKey: resolvedPrefetchKey,\n    participationRefs: [input.participationRef],\n    resourceType,\n    intent: input.intent,\n    run,\n    ...(label !== undefined ? { label } : {}),\n    bridgeFailuresToShellAggregator: resolvedBridge,\n  });\n}\n"]}
+{"version":3,"file":"useExecutionParticipationDataPrefetch.js","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionParticipationDataPrefetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,kCAAkC,GACnC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qCAAqC,GACtC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,EACpC,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2CAA2C,EAAE,MAAM,+CAA+C,CAAC;AAC5G,OAAO,EACL,iCAAiC,GAElC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAoE7F;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,YAAoB,EAAE,gBAAwB;IAC7E,OAAO,0BAA0B,YAAY,IAAI,gBAAgB,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,qCAAqC,CACnD,KAAiD;IAEjD,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC5F,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,6BAA6B,EAAE,GAAG,2CAA2C,EAAE,CAAC;IAExF,sEAAsE;IACtE,qEAAqE;IACrE,mEAAmE;IACnE,6CAA6C;IAC7C,MAAM,aAAa,GAAG,gBAAgB,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9E,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,yDAAyD,KAAK,CAAC,gBAAgB,IAAI;cACjF,4BAA4B,gBAAgB,CAAC,cAAc,CAAC,GAAG,KAAK;cACpE,gEAAgE,CACnE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,qCAAqC,CAAC,aAAa,CAAC,CAAC;IAE1E,mEAAmE;IACnE,sEAAsE;IACtE,mEAAmE;IACnE,gEAAgE;IAChE,mEAAmE;IACnE,gEAAgE;IAChE,oDAAoD;IACpD,MAAM,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QAClG,MAAM,eAAe,GAAG,6BAA6B,CAAC;YACpD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,aAAa,EAAE,qBAAqB,CAAC,IAAI;YACzC,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QACH,MAAM,4BAA4B,GAAG,qBAAqB,CAAC,yBAAyB,CAClF,eAAe,CAAC,0BAA0B,EAC1C,QAAQ,CACT,CAAC;QACF,OAAO;YACL,gBAAgB,EAAE,kCAAkC,CAAC,mCAAmC,CACtF,eAAe,CAAC,SAAS,CAC1B;YACD,oBAAoB,EAAE,4BAA4B;YAClD,2BAA2B,EAAE,eAAe,CAAC,2BAA2B;YACxE,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC,EAAE;QACD,6BAA6B;QAC7B,KAAK,CAAC,KAAK;QACX,KAAK,CAAC,gBAAgB;QACtB,QAAQ;KACT,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAG,KAAK,CAAC,WAAW;WACxC,uBAAuB,CAAC,YAAY,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,KAAK,CAAC,+BAA+B;WACvD,CAAC,KAAK,CAAC,MAAM,KAAK,oCAAoC,CAAC,OAAO,CAAC,CAAC;IAErE,MAAM,cAAc,GAAG,gBAAgB,CAAC,WAAW,CAAC;IACpD,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,MAAM,EAA2B,EAAoB,EAAE;QACtF,OAAO,cAAc,CAAC,gBAAgB,EAAE;YACtC,oBAAoB;YACpB,2BAA2B;YAC3B,QAAQ,EAAE,QAAQ,CAAC,GAAG;SACvB,EAAE;YACD,MAAM;SACP,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,CAAC,CAAC;IAE1F,OAAO,iCAAiC,CAAU;QAChD,WAAW,EAAE,mBAAmB;QAChC,iBAAiB,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC3C,YAAY;QACZ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG;QACH,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,+BAA+B,EAAE,cAAc;KAChD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { useCallback, useContext, useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  DataMode,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\n\nimport {\n  getExecutionParticipationResourceType,\n} from './execution-participation.utils';\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionParticipationPrefetchIntent,\n  ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\nimport { useExecutionResourceOperationContextBuilder } from './useExecutionResourceOperationContextBuilder';\nimport {\n  useExecutionParticipationPrefetch,\n  type UseExecutionParticipationPrefetchValue,\n} from './useExecutionParticipationPrefetch';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\n\n/**\n * Input shape for the opinionated participation-data prefetch hook.\n *\n * Wraps the generic `useExecutionParticipationPrefetch` primitive for the\n * most common case: hydrate a single participation's resource data via\n * the canonical READ `doOperation()` for the resolved resource type.\n *\n * Contract anchored at\n * `saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator`\n * in `ExecutionRuntimeContext.tsx`. See the sub-anchor JSDoc for the full\n * producer contract (stable `prefetchKey`, intent-aware bridge default,\n * stale-while-revalidate, etc.).\n */\nexport interface UseExecutionParticipationDataPrefetchInput {\n  /**\n   * Participation ref to hydrate. Must already be declared in the\n   * execution view's `participations` map and resolvable to a concrete\n   * resource id at call time. Single-ref by design — multi-ref hydration\n   * is a primitive-level concern (mount the primitive directly).\n   */\n  participationRef: string;\n  /**\n   * Whether this is `INITIAL` (full-screen skeleton UX) or `REFRESH`\n   * (subtle indicator UX). Drives the default for\n   * `bridgeFailuresToShellAggregator` (INITIAL=true, REFRESH=false) so\n   * typical UX gets the right default without consumers thinking about\n   * it. See contract invariant #6 in the sub-anchor JSDoc.\n   */\n  intent: ExecutionParticipationPrefetchIntent;\n  /**\n   * Optional override for the consumer-authored stable identity. When\n   * omitted, the wrapper derives a key of the shape\n   * `participation-prefetch:${resourceType}:${participationRef}` so two\n   * hook instances over the same participation share auto-prune\n   * lifecycle (which is almost always what the consumer wants —\n   * hovering an inspector node should clear a prior failed prewarm of\n   * the same node). Provide an explicit key when the implicit one\n   * collides (e.g. two distinct UX surfaces hydrating the same\n   * participation but wanting independent failure indicators).\n   */\n  prefetchKey?: string;\n  /** Optional human-readable label (\"Loading task graph\"). Opaque to the shell. */\n  label?: string;\n  /**\n   * Override for the intent-aware default. When omitted: `true` for\n   * INITIAL (initial hydration failures are noteworthy enough to\n   * surface in the global aggregator), `false` for REFRESH (silent\n   * background revalidation should not raise a global banner).\n   *\n   * Set to `false` explicitly on a chrome banner or other surface\n   * that owns its own error UX and does not want a duplicate global\n   * indicator.\n   */\n  bridgeFailuresToShellAggregator?: boolean;\n}\n\n/**\n * Return shape for the opinionated participation-data prefetch hook.\n *\n * Identical in spirit to the primitive's return value, but `data` is\n * loosely typed because the canonical READ payload depends on the\n * resolved resource type. Consumers narrow at the call site.\n */\nexport type UseExecutionParticipationDataPrefetchValue =\n  UseExecutionParticipationPrefetchValue<unknown>;\n\n/**\n * Compute the default consumer-authored `prefetchKey` for a single\n * participation hydration. The shape is intentionally stable across\n * `intent` changes — a `REFRESH` after an `INITIAL` for the same\n * participation should clear the same auto-prune bucket — and\n * intentionally NOT including any per-call data (e.g. context\n * identifiers) because the auto-prune bucket is the participation\n * itself, not the call's parameter shape.\n */\nfunction buildDefaultPrefetchKey(resourceType: string, participationRef: string): string {\n  return `participation-prefetch:${resourceType}:${participationRef}`;\n}\n\n/**\n * Opinionated wrapper hook for the participation-prefetch tier (Slice K).\n *\n * Hydrates a single participation's resource data via the canonical READ\n * `doOperation()` for the resolved resource type, and orchestrates the\n * full prefetch lifecycle (begin/end, AbortController, latest-error\n * surfacing, intent-aware shell-aggregator bridge). See the\n * `loading-aggregation.participation-prefetch.shell-data-hydrator`\n * sub-anchor in `ExecutionRuntimeContext.tsx` for the full producer\n * contract.\n *\n * **When to reach for the primitive instead.** Drop down to\n * `useExecutionParticipationPrefetch` when the underlying fetch is not\n * a `doOperation()` READ call, when the unit hydrates multiple\n * participations from a single call, or when the consumer needs\n * fine-grained control over the request shape (e.g. a custom\n * `requestData` payload, a non-default operation, or a non-`READ`\n * semantic).\n *\n * **`doOperation()` directly, NOT `actions.operation().execute()`.** See\n * the sub-anchor JSDoc for the rationale — short version: routing through\n * `execute()` would double-count the work in the loading aggregator\n * (once via the pending-action tier, once via the prefetch tier) and\n * trigger the failure-handling-contract bridge twice. The wrapper\n * therefore reads `doOperation` off `ExecutionRuntimeContext` directly.\n */\nexport function useExecutionParticipationDataPrefetch(\n  input: UseExecutionParticipationDataPrefetchInput,\n): UseExecutionParticipationDataPrefetchValue {\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n  const { registry } = useResourceRegistry();\n  const { buildResourceOperationContext } = useExecutionResourceOperationContextBuilder();\n\n  // Resolve the participation handle eagerly so a typoed ref fails fast\n  // at hook-call time (mirrors `useExecution().requireParticipation` —\n  // the same loud-fail discipline that catches view-definition drift\n  // immediately rather than on first refetch).\n  const participation = executionRuntime.participations[input.participationRef];\n  if (!participation) {\n    throw new Error(\n      `useExecutionParticipationDataPrefetch: participation \"${input.participationRef}\" `\n      + `is not declared on view \"${executionRuntime.viewDefinition.ref}\". `\n      + 'Add it to the view\\'s `participations` map or correct the ref.',\n    );\n  }\n\n  const resourceType = getExecutionParticipationResourceType(participation);\n\n  // Build the resource-operation context for the canonical READ. The\n  // operation path key is derived from the operation, exactly mirroring\n  // the path `useExecution().actions.operation({ operationLike: READ\n  // }).execute()` would build — same correlation key, same parent\n  // requirements, same contextual parameters. The only difference is\n  // we call `doOperation()` directly so the work registers in the\n  // prefetch tier instead of the pending-action tier.\n  const { operationPathKey, contextualParameters, parentResourcesRequirements, label } = useMemo(() => {\n    const resourceContext = buildResourceOperationContext({\n      participationRef: input.participationRef,\n      operationLike: CoreResourceOperation.READ,\n      requireAddressable: true,\n    });\n    const computedContextualParameters = FrontendResourceUtils.buildContextualParameters(\n      resourceContext.contextResourceIdentifiers,\n      registry,\n    );\n    return {\n      operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(\n        resourceContext.operation,\n      ),\n      contextualParameters: computedContextualParameters,\n      parentResourcesRequirements: resourceContext.parentResourcesRequirements,\n      label: input.label,\n    };\n  }, [\n    buildResourceOperationContext,\n    input.label,\n    input.participationRef,\n    registry,\n  ]);\n\n  const resolvedPrefetchKey = input.prefetchKey\n    ?? buildDefaultPrefetchKey(resourceType, input.participationRef);\n  const resolvedBridge = input.bridgeFailuresToShellAggregator\n    ?? (input.intent === ExecutionParticipationPrefetchIntent.INITIAL);\n\n  const doOperationRef = executionRuntime.doOperation;\n  const run = useCallback(async ({ signal }: { signal: AbortSignal }): Promise<unknown> => {\n    return doOperationRef(operationPathKey, {\n      contextualParameters,\n      parentResourcesRequirements,\n      dataMode: DataMode.RAW,\n    }, {\n      signal,\n    });\n  }, [contextualParameters, doOperationRef, operationPathKey, parentResourcesRequirements]);\n\n  return useExecutionParticipationPrefetch<unknown>({\n    prefetchKey: resolvedPrefetchKey,\n    participationRefs: [input.participationRef],\n    resourceType,\n    intent: input.intent,\n    run,\n    ...(label !== undefined ? { label } : {}),\n    bridgeFailuresToShellAggregator: resolvedBridge,\n  });\n}\n"]}

package/dist/esm/core/execution/useExecutionParticipationPrefetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionParticipationPrefetch.d.ts","sourceRoot":"","sources":["../../../../src/core/execution/useExecutionParticipationPrefetch.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,oCAAoC,EAE1C,MAAM,2BAA2B,CAAC;AA8CnC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sCAAsC,CAAC,KAAK;IAC3D;;;;;;;;;;;OAWG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,MAAM,EAAE,oCAAoC,CAAC;IAC7C;;;;;;;OAOG;IACH,GAAG,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;;;;OAcG;IACH,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,sCAAsC,CAAC,KAAK;IAC3D;;;;;OAKG;IACH,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,KAAK,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC1C;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EACrD,KAAK,EAAE,sCAAsC,CAAC,KAAK,CAAC,GACnD,sCAAsC,CAAC,KAAK,CAAC,CAgL/C"}
+{"version":3,"file":"useExecutionParticipationPrefetch.d.ts","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionParticipationPrefetch.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,oCAAoC,EAE1C,MAAM,2BAA2B,CAAC;AA8CnC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sCAAsC,CAAC,KAAK;IAC3D;;;;;;;;;;;OAWG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,MAAM,EAAE,oCAAoC,CAAC;IAC7C;;;;;;;OAOG;IACH,GAAG,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;;;;OAcG;IACH,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,sCAAsC,CAAC,KAAK;IAC3D;;;;;OAKG;IACH,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,KAAK,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC1C;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EACrD,KAAK,EAAE,sCAAsC,CAAC,KAAK,CAAC,GACnD,sCAAsC,CAAC,KAAK,CAAC,CAgL/C"}

package/dist/esm/core/execution/useExecutionParticipationPrefetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionParticipationPrefetch.js","sourceRoot":"","sources":["../../../../src/core/execution/useExecutionParticipationPrefetch.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionFailedActionScope,\n  ExecutionRuntimeContext,\n  type ExecutionParticipationPrefetchIntent,\n  type ExecutionPendingPrefetch,\n} from './ExecutionRuntimeContext';\nimport { buildExecutionFailedAction } from './execution-failure-handling.utils';\n\n/**\n * Opaque, collision-resistant id minted per in-flight prefetch unit by the\n * primitive hook. Distinct namespace from `actionRuntimeId` /\n * `failureRuntimeId` so consumers reading the loading aggregator can tell\n * apart prefetch entries from execute-action entries by id-prefix alone.\n *\n * Distinct from `prefetchKey`, which is the consumer-authored stable\n * identity reused across consecutive settle cycles. See the\n * `loading-aggregation.participation-prefetch.shell-data-hydrator`\n * sub-anchor JSDoc in `ExecutionRuntimeContext.tsx` for why both ids exist.\n */\nfunction createExecutionPrefetchRuntimeId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return `execution-prefetch-${crypto.randomUUID()}`;\n  }\n  return `execution-prefetch-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction createExecutionPrefetchFailureRuntimeId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return `execution-failure-${crypto.randomUUID()}`;\n  }\n  return `execution-failure-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/**\n * Discriminator for distinguishing `AbortError` rejections (which are\n * \"settled by cancellation, not by failure\") from real errors. The\n * `AbortController` API rejects with `DOMException(name: 'AbortError')`\n * by default; matching by `name` (rather than `instanceof DOMException`)\n * keeps the check resilient across environments where the global\n * `DOMException` constructor is not present (Node test runners, some\n * SSR setups). Custom abort reasons that the consumer's `run` callback\n * may throw still surface here as long as they expose `name === 'AbortError'`.\n */\nfunction isAbortError(error: unknown): boolean {\n  if (!error || typeof error !== 'object') {\n    return false;\n  }\n  const candidate = error as { name?: unknown };\n  return candidate.name === 'AbortError';\n}\n\n/**\n * Input shape for the generic primitive participation-prefetch hook.\n *\n * Contract anchored at\n * `saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator`\n * in `ExecutionRuntimeContext.tsx`. The primitive owns lifecycle plumbing\n * (begin/end pairing, AbortController, latest-error surfacing, optional\n * shell-aggregator bridge); the consumer's `run` callback owns the actual\n * fetch — typically a `doOperation()` invocation, but the hook is\n * intentionally fetch-mechanism-agnostic so future producers (a\n * relationship-projection source-resource hydrator, a lazy-binding\n * resolver) can reuse the same lifecycle without adopting `doOperation()`\n * semantics they do not need.\n */\nexport interface UseExecutionParticipationPrefetchInput<TData> {\n  /**\n   * Stable consumer-authored identity for the prefetch unit. Reused\n   * across consecutive `refetch()` cycles so the shell's\n   * `clearFailedActionsForPrefetchKey(key)` verb can drop matching\n   * entries on the next successful settle. Distinct from the\n   * per-run `prefetchRuntimeId` minted internally by the hook on\n   * every fire — see invariant #1 in the sub-anchor JSDoc.\n   *\n   * Consumers should prefer keys that include enough context to make\n   * the unit identifiable in failure-aggregator UX (e.g.\n   * `prefetch:todoList:${listId}` rather than `'load'`).\n   */\n  prefetchKey: string;\n  /**\n   * Participation refs whose data is being hydrated by this prefetch.\n   * Threaded into the registered `ExecutionPendingPrefetch` so per-ref\n   * predicates on `loading.isParticipationPrefetching(...)` can narrow\n   * to \"is *this ref* loading?\". Must contain at least one ref —\n   * `assertExecutionPendingPrefetchShape` enforces this at the nav\n   * helper boundary.\n   */\n  participationRefs: readonly string[];\n  /**\n   * Primary resource type being hydrated. Mirrors\n   * `ExecutionPendingAction.resourceType` so per-resource UI filtering\n   * composes uniformly across the loading aggregator's two tiers.\n   */\n  resourceType: string;\n  /**\n   * Whether this is `INITIAL` (full-screen skeleton UX) or `REFRESH`\n   * (subtle indicator UX). The primitive does NOT auto-toggle the\n   * `bridgeFailuresToShellAggregator` default off intent; see the\n   * wrapper (`useExecutionParticipationDataPrefetch`) for the\n   * intent-aware bridge default policy.\n   */\n  intent: ExecutionParticipationPrefetchIntent;\n  /**\n   * Async work to perform. Receives an `AbortSignal` that the hook\n   * triggers on unmount or on a fresh `run()` while one is already in\n   * flight. Consumers SHOULD thread the signal into their underlying\n   * fetch (e.g. `doOperation(..., { signal })`) so cancellation actually\n   * stops the network call rather than just discarding the result on\n   * settle.\n   */\n  run: (params: { signal: AbortSignal }) => Promise<TData>;\n  /** Optional human-readable label (\"Loading task graph\"). Opaque to the shell. */\n  label?: string;\n  /**\n   * When `true`, captured failures are also bridged into\n   * `execution.errors.failedActions` under\n   * `ExecutionFailedActionScope.PARTICIPATION_PREFETCH` (with the same\n   * `prefetchKey`), where they participate in the cross-component\n   * failure aggregator. The hook auto-clears entries with this scope\n   * and key on the next successful settle (via\n   * `clearFailedActionsForPrefetchKey`), so a stale failure banner\n   * vanishes the moment the next attempt succeeds.\n   *\n   * Defaults to `false` on the primitive — it has no intent-aware\n   * default to lean on. The wrapper\n   * (`useExecutionParticipationDataPrefetch`) applies a default split\n   * (INITIAL=true, REFRESH=false) that matches typical UX.\n   */\n  bridgeFailuresToShellAggregator?: boolean;\n}\n\n/**\n * Return shape for the generic primitive participation-prefetch hook.\n */\nexport interface UseExecutionParticipationPrefetchValue<TData> {\n  /**\n   * Most recently settled successful payload, or `undefined` when no\n   * successful settle has happened yet. Stale-while-revalidate: stays\n   * pinned through `isLoading: true` rerun cycles so renderers can\n   * keep showing the prior data while a `REFRESH` is in flight.\n   */\n  data: TData | undefined;\n  /** `true` while a `run({ signal })` invocation is in flight. */\n  isLoading: boolean;\n  /**\n   * Latest settle's rejection (or `undefined` after a successful\n   * settle). Resets to `undefined` on every successful settle and is\n   * set to the rejection on every failed one. `AbortError` rejections\n   * are NOT surfaced here — cancellations are not failures.\n   */\n  error: unknown;\n  /** Consumer-authored stable identity (echo of input for diagnostics). */\n  prefetchKey: string;\n  /**\n   * Trigger a fresh run. Aborts any in-flight one first (and removes\n   * its `ExecutionPendingPrefetch` entry) before minting a fresh\n   * `prefetchRuntimeId` and beginning the new unit. Returns the\n   * resolved data, or `undefined` if the run was aborted or rejected\n   * (the hook's `error` state surfaces the rejection).\n   */\n  refetch: () => Promise<TData | undefined>;\n  /**\n   * Cancel the current in-flight run, if any. Does NOT trigger a\n   * follow-up — the hook's state stays at whatever it was right\n   * before the abort (data unchanged, isLoading drops to false,\n   * error unchanged). Typical use: a \"Cancel loading\" button next\n   * to a long-running prefetch.\n   */\n  abort: () => void;\n}\n\n/**\n * Generic primitive hook for the participation-prefetch tier (Slice K).\n *\n * Owns the `ExecutionPendingPrefetch` lifecycle plumbing so consumer\n * `run()` callbacks can focus on the actual async work. See the\n * `loading-aggregation.participation-prefetch.shell-data-hydrator`\n * sub-anchor in `ExecutionRuntimeContext.tsx` for the full producer\n * contract (stable `prefetchKey`, one in-flight unit per hook,\n * settle-always-clears, optional shell-aggregator bridge, latest-error\n * surfacing, etc.).\n *\n * Most consumers want the opinionated wrapper\n * `useExecutionParticipationDataPrefetch` instead — it handles the\n * common case (hydrate a single participation's resource data via\n * `doOperation()`) without the consumer having to author the\n * operation-path-key derivation or the per-intent bridge default.\n * Reach for this primitive directly when the underlying fetch is not\n * a `doOperation()` call (e.g. a `WebSocket` subscription warm-up, a\n * client-side computed projection that just needs to register as\n * \"loading\" in the aggregator) or when the unit hydrates multiple\n * participations from a single call.\n */\nexport function useExecutionParticipationPrefetch<TData>(\n  input: UseExecutionParticipationPrefetchInput<TData>,\n): UseExecutionParticipationPrefetchValue<TData> {\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n\n  // Snapshot the consumer-authored input into refs so the public\n  // `refetch` callback identity stays stable across input changes (it\n  // depends only on the navigation seam below). Identity churn on\n  // `refetch` would defeat the canonical `useEffect([refetch])`\n  // auto-run pattern consumers reach for — same identity-stability\n  // discipline `useExecution`'s `actions` value applies (Slice F/G\n  // regression notes).\n  const inputRef = useRef(input);\n  inputRef.current = input;\n\n  // Stash the live navigation seam in a ref, NOT a useCallback dep.\n  // Keeping `navigation` out of the dep arrays for `cancelInFlight` /\n  // `refetch` / the cleanup effect is load-bearing for two reasons:\n  //\n  // 1. **Identity-stability discipline.** Same shape Slice F/G dodged\n  //    a re-render loop with — depending on `navigation` here would\n  //    flip `refetch` identity whenever any nested provider reshapes\n  //    the navigation memo, breaking the canonical\n  //    `useEffect([refetch])` auto-run pattern.\n  //\n  // 2. **Cleanup-effect race avoidance.** If `cancelInFlight` depended\n  //    on `navigation`, a navigation-memo change WHILE a prefetch is\n  //    in flight would re-fire the cleanup effect and abort the\n  //    live unit — even though the consumer never re-keyed the hook.\n  //    The deps must be empty so cleanup runs ONLY on real unmount.\n  const navigationRef = useRef(executionRuntime.navigation);\n  navigationRef.current = executionRuntime.navigation;\n\n  // Per-mount controller for the latest fire. Replaced atomically on\n  // every `run()` so a stale promise settling after a fresh `run()`\n  // (or after unmount) cannot mutate hook state. Mirrors the canonical\n  // race-free fetch pattern.\n  const controllerRef = useRef<AbortController | null>(null);\n  // Per-mount tracking of the live `prefetchRuntimeId` so the cleanup\n  // / abort path knows which entry to `endParticipationPrefetch` even\n  // if the consumer's `run` callback never read the id itself.\n  const liveRuntimeIdRef = useRef<string | null>(null);\n\n  const [data, setData] = useState<TData | undefined>(undefined);\n  const [error, setError] = useState<unknown>(undefined);\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n\n  /**\n   * Internal helper used by both `abort()` and the unmount cleanup.\n   * Synchronously aborts the live controller and ends the live\n   * prefetch entry — guarantees `endParticipationPrefetch` runs even\n   * if the in-flight promise rejects later (its no-op handler in the\n   * `try`/`finally` will be a second `endParticipationPrefetch` call,\n   * which is idempotent because the runtime id is already gone — the\n   * `endParticipationPrefetch` JSDoc explicitly documents the unknown-id\n   * no-op behavior).\n   */\n  const cancelInFlight = useCallback((): void => {\n    const liveController = controllerRef.current;\n    const liveRuntimeId = liveRuntimeIdRef.current;\n    controllerRef.current = null;\n    liveRuntimeIdRef.current = null;\n    if (liveController && !liveController.signal.aborted) {\n      liveController.abort();\n    }\n    if (liveRuntimeId !== null) {\n      navigationRef.current.endParticipationPrefetch(liveRuntimeId);\n    }\n  }, []);\n\n  const refetch = useCallback(async (): Promise<TData | undefined> => {\n    // Snapshot every consumer-authored field at the start of the run so\n    // a subsequent input change mid-flight cannot retroactively shift\n    // which `prefetchKey` we clear on settle, which `participationRefs`\n    // we register, etc. The hook semantics are \"the run uses the inputs\n    // it was kicked off with\" — not \"the run uses whatever inputs are\n    // current at settle time\".\n    const snapshot = inputRef.current;\n    const fireRuntimeId = createExecutionPrefetchRuntimeId();\n    const fireController = new AbortController();\n    // Replace the live controller atomically. Any in-flight run loses\n    // ownership: its end-handler in the `try`/`finally` will see\n    // `controllerRef.current !== fireController` and will skip the\n    // state mutation (so a slow rejection cannot bring back stale\n    // `error`). The prior runtime id is ended via `cancelInFlight()`\n    // below, BEFORE we begin the new entry — so the registry never\n    // shows two entries from the same hook.\n    cancelInFlight();\n    controllerRef.current = fireController;\n    liveRuntimeIdRef.current = fireRuntimeId;\n\n    const pendingPrefetch: ExecutionPendingPrefetch = {\n      prefetchRuntimeId: fireRuntimeId,\n      participationRefs: snapshot.participationRefs,\n      resourceType: snapshot.resourceType,\n      intent: snapshot.intent,\n      startedAt: Date.now(),\n      ...(snapshot.label !== undefined ? { label: snapshot.label } : {}),\n    };\n    navigationRef.current.beginParticipationPrefetch(pendingPrefetch);\n    setIsLoading(true);\n\n    try {\n      const result = await snapshot.run({ signal: fireController.signal });\n      // If the hook was abort-cancelled or replaced mid-flight, the\n      // controller ref no longer points to ours — do not mutate state.\n      if (controllerRef.current !== fireController) {\n        return undefined;\n      }\n      setData(result);\n      setError(undefined);\n      // Stable-key auto-prune: any prior `PARTICIPATION_PREFETCH`-scoped\n      // failure for this same `prefetchKey` is implicitly resolved by a\n      // successful settle. The verb is a no-op when no entry matches,\n      // so the call is cheap on the happy path.\n      navigationRef.current.clearFailedActionsForPrefetchKey(snapshot.prefetchKey);\n      return result;\n    } catch (caughtError) {\n      if (controllerRef.current !== fireController) {\n        return undefined;\n      }\n      if (isAbortError(caughtError)) {\n        return undefined;\n      }\n      setError(caughtError);\n      if (snapshot.bridgeFailuresToShellAggregator === true) {\n        const failedAction = buildExecutionFailedAction({\n          failureRuntimeId: createExecutionPrefetchFailureRuntimeId(),\n          error: caughtError,\n          resourceType: snapshot.resourceType,\n          startedAt: pendingPrefetch.startedAt,\n          ...(snapshot.label !== undefined ? { label: snapshot.label } : {}),\n          scope: ExecutionFailedActionScope.PARTICIPATION_PREFETCH,\n          prefetchKey: snapshot.prefetchKey,\n        });\n        navigationRef.current.captureFailedAction(failedAction);\n      }\n      return undefined;\n    } finally {\n      // End the prefetch entry regardless of success / failure / abort.\n      // Race-safe: if a fresh `run()` raced ahead and replaced the\n      // controller, our `liveRuntimeIdRef` was already replaced too;\n      // guard the end call against double-clearing the new fire's id.\n      if (liveRuntimeIdRef.current === fireRuntimeId) {\n        liveRuntimeIdRef.current = null;\n        controllerRef.current = null;\n        navigationRef.current.endParticipationPrefetch(fireRuntimeId);\n        setIsLoading(false);\n      }\n    }\n  }, [cancelInFlight]);\n\n  const abort = useCallback((): void => {\n    if (controllerRef.current === null) {\n      return;\n    }\n    cancelInFlight();\n    setIsLoading(false);\n  }, [cancelInFlight]);\n\n  // Cleanup on unmount: synchronously abort + end so the prefetch\n  // registry doesn't leak entries past the hook's lifetime. The\n  // in-flight promise's `finally` will see a stale runtime id and\n  // skip the second end call (idempotent unknown-id no-op).\n  useEffect(() => {\n    return () => {\n      cancelInFlight();\n    };\n  }, [cancelInFlight]);\n\n  return useMemo<UseExecutionParticipationPrefetchValue<TData>>(() => ({\n    data,\n    isLoading,\n    error,\n    prefetchKey: input.prefetchKey,\n    refetch,\n    abort,\n  }), [abort, data, error, input.prefetchKey, isLoading, refetch]);\n}\n"]}
+{"version":3,"file":"useExecutionParticipationPrefetch.js","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionParticipationPrefetch.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionFailedActionScope,\n  ExecutionRuntimeContext,\n  type ExecutionParticipationPrefetchIntent,\n  type ExecutionPendingPrefetch,\n} from './ExecutionRuntimeContext';\nimport { buildExecutionFailedAction } from './execution-failure-handling.utils';\n\n/**\n * Opaque, collision-resistant id minted per in-flight prefetch unit by the\n * primitive hook. Distinct namespace from `actionRuntimeId` /\n * `failureRuntimeId` so consumers reading the loading aggregator can tell\n * apart prefetch entries from execute-action entries by id-prefix alone.\n *\n * Distinct from `prefetchKey`, which is the consumer-authored stable\n * identity reused across consecutive settle cycles. See the\n * `loading-aggregation.participation-prefetch.shell-data-hydrator`\n * sub-anchor JSDoc in `ExecutionRuntimeContext.tsx` for why both ids exist.\n */\nfunction createExecutionPrefetchRuntimeId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return `execution-prefetch-${crypto.randomUUID()}`;\n  }\n  return `execution-prefetch-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction createExecutionPrefetchFailureRuntimeId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return `execution-failure-${crypto.randomUUID()}`;\n  }\n  return `execution-failure-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/**\n * Discriminator for distinguishing `AbortError` rejections (which are\n * \"settled by cancellation, not by failure\") from real errors. The\n * `AbortController` API rejects with `DOMException(name: 'AbortError')`\n * by default; matching by `name` (rather than `instanceof DOMException`)\n * keeps the check resilient across environments where the global\n * `DOMException` constructor is not present (Node test runners, some\n * SSR setups). Custom abort reasons that the consumer's `run` callback\n * may throw still surface here as long as they expose `name === 'AbortError'`.\n */\nfunction isAbortError(error: unknown): boolean {\n  if (!error || typeof error !== 'object') {\n    return false;\n  }\n  const candidate = error as { name?: unknown };\n  return candidate.name === 'AbortError';\n}\n\n/**\n * Input shape for the generic primitive participation-prefetch hook.\n *\n * Contract anchored at\n * `saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator`\n * in `ExecutionRuntimeContext.tsx`. The primitive owns lifecycle plumbing\n * (begin/end pairing, AbortController, latest-error surfacing, optional\n * shell-aggregator bridge); the consumer's `run` callback owns the actual\n * fetch — typically a `doOperation()` invocation, but the hook is\n * intentionally fetch-mechanism-agnostic so future producers (a\n * relationship-projection source-resource hydrator, a lazy-binding\n * resolver) can reuse the same lifecycle without adopting `doOperation()`\n * semantics they do not need.\n */\nexport interface UseExecutionParticipationPrefetchInput<TData> {\n  /**\n   * Stable consumer-authored identity for the prefetch unit. Reused\n   * across consecutive `refetch()` cycles so the shell's\n   * `clearFailedActionsForPrefetchKey(key)` verb can drop matching\n   * entries on the next successful settle. Distinct from the\n   * per-run `prefetchRuntimeId` minted internally by the hook on\n   * every fire — see invariant #1 in the sub-anchor JSDoc.\n   *\n   * Consumers should prefer keys that include enough context to make\n   * the unit identifiable in failure-aggregator UX (e.g.\n   * `prefetch:todoList:${listId}` rather than `'load'`).\n   */\n  prefetchKey: string;\n  /**\n   * Participation refs whose data is being hydrated by this prefetch.\n   * Threaded into the registered `ExecutionPendingPrefetch` so per-ref\n   * predicates on `loading.isParticipationPrefetching(...)` can narrow\n   * to \"is *this ref* loading?\". Must contain at least one ref —\n   * `assertExecutionPendingPrefetchShape` enforces this at the nav\n   * helper boundary.\n   */\n  participationRefs: readonly string[];\n  /**\n   * Primary resource type being hydrated. Mirrors\n   * `ExecutionPendingAction.resourceType` so per-resource UI filtering\n   * composes uniformly across the loading aggregator's two tiers.\n   */\n  resourceType: string;\n  /**\n   * Whether this is `INITIAL` (full-screen skeleton UX) or `REFRESH`\n   * (subtle indicator UX). The primitive does NOT auto-toggle the\n   * `bridgeFailuresToShellAggregator` default off intent; see the\n   * wrapper (`useExecutionParticipationDataPrefetch`) for the\n   * intent-aware bridge default policy.\n   */\n  intent: ExecutionParticipationPrefetchIntent;\n  /**\n   * Async work to perform. Receives an `AbortSignal` that the hook\n   * triggers on unmount or on a fresh `run()` while one is already in\n   * flight. Consumers SHOULD thread the signal into their underlying\n   * fetch (e.g. `doOperation(..., { signal })`) so cancellation actually\n   * stops the network call rather than just discarding the result on\n   * settle.\n   */\n  run: (params: { signal: AbortSignal }) => Promise<TData>;\n  /** Optional human-readable label (\"Loading task graph\"). Opaque to the shell. */\n  label?: string;\n  /**\n   * When `true`, captured failures are also bridged into\n   * `execution.errors.failedActions` under\n   * `ExecutionFailedActionScope.PARTICIPATION_PREFETCH` (with the same\n   * `prefetchKey`), where they participate in the cross-component\n   * failure aggregator. The hook auto-clears entries with this scope\n   * and key on the next successful settle (via\n   * `clearFailedActionsForPrefetchKey`), so a stale failure banner\n   * vanishes the moment the next attempt succeeds.\n   *\n   * Defaults to `false` on the primitive — it has no intent-aware\n   * default to lean on. The wrapper\n   * (`useExecutionParticipationDataPrefetch`) applies a default split\n   * (INITIAL=true, REFRESH=false) that matches typical UX.\n   */\n  bridgeFailuresToShellAggregator?: boolean;\n}\n\n/**\n * Return shape for the generic primitive participation-prefetch hook.\n */\nexport interface UseExecutionParticipationPrefetchValue<TData> {\n  /**\n   * Most recently settled successful payload, or `undefined` when no\n   * successful settle has happened yet. Stale-while-revalidate: stays\n   * pinned through `isLoading: true` rerun cycles so renderers can\n   * keep showing the prior data while a `REFRESH` is in flight.\n   */\n  data: TData | undefined;\n  /** `true` while a `run({ signal })` invocation is in flight. */\n  isLoading: boolean;\n  /**\n   * Latest settle's rejection (or `undefined` after a successful\n   * settle). Resets to `undefined` on every successful settle and is\n   * set to the rejection on every failed one. `AbortError` rejections\n   * are NOT surfaced here — cancellations are not failures.\n   */\n  error: unknown;\n  /** Consumer-authored stable identity (echo of input for diagnostics). */\n  prefetchKey: string;\n  /**\n   * Trigger a fresh run. Aborts any in-flight one first (and removes\n   * its `ExecutionPendingPrefetch` entry) before minting a fresh\n   * `prefetchRuntimeId` and beginning the new unit. Returns the\n   * resolved data, or `undefined` if the run was aborted or rejected\n   * (the hook's `error` state surfaces the rejection).\n   */\n  refetch: () => Promise<TData | undefined>;\n  /**\n   * Cancel the current in-flight run, if any. Does NOT trigger a\n   * follow-up — the hook's state stays at whatever it was right\n   * before the abort (data unchanged, isLoading drops to false,\n   * error unchanged). Typical use: a \"Cancel loading\" button next\n   * to a long-running prefetch.\n   */\n  abort: () => void;\n}\n\n/**\n * Generic primitive hook for the participation-prefetch tier (Slice K).\n *\n * Owns the `ExecutionPendingPrefetch` lifecycle plumbing so consumer\n * `run()` callbacks can focus on the actual async work. See the\n * `loading-aggregation.participation-prefetch.shell-data-hydrator`\n * sub-anchor in `ExecutionRuntimeContext.tsx` for the full producer\n * contract (stable `prefetchKey`, one in-flight unit per hook,\n * settle-always-clears, optional shell-aggregator bridge, latest-error\n * surfacing, etc.).\n *\n * Most consumers want the opinionated wrapper\n * `useExecutionParticipationDataPrefetch` instead — it handles the\n * common case (hydrate a single participation's resource data via\n * `doOperation()`) without the consumer having to author the\n * operation-path-key derivation or the per-intent bridge default.\n * Reach for this primitive directly when the underlying fetch is not\n * a `doOperation()` call (e.g. a `WebSocket` subscription warm-up, a\n * client-side computed projection that just needs to register as\n * \"loading\" in the aggregator) or when the unit hydrates multiple\n * participations from a single call.\n */\nexport function useExecutionParticipationPrefetch<TData>(\n  input: UseExecutionParticipationPrefetchInput<TData>,\n): UseExecutionParticipationPrefetchValue<TData> {\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n\n  // Snapshot the consumer-authored input into refs so the public\n  // `refetch` callback identity stays stable across input changes (it\n  // depends only on the navigation seam below). Identity churn on\n  // `refetch` would defeat the canonical `useEffect([refetch])`\n  // auto-run pattern consumers reach for — same identity-stability\n  // discipline `useExecution`'s `actions` value applies (Slice F/G\n  // regression notes).\n  const inputRef = useRef(input);\n  inputRef.current = input;\n\n  // Stash the live navigation seam in a ref, NOT a useCallback dep.\n  // Keeping `navigation` out of the dep arrays for `cancelInFlight` /\n  // `refetch` / the cleanup effect is load-bearing for two reasons:\n  //\n  // 1. **Identity-stability discipline.** Same shape Slice F/G dodged\n  //    a re-render loop with — depending on `navigation` here would\n  //    flip `refetch` identity whenever any nested provider reshapes\n  //    the navigation memo, breaking the canonical\n  //    `useEffect([refetch])` auto-run pattern.\n  //\n  // 2. **Cleanup-effect race avoidance.** If `cancelInFlight` depended\n  //    on `navigation`, a navigation-memo change WHILE a prefetch is\n  //    in flight would re-fire the cleanup effect and abort the\n  //    live unit — even though the consumer never re-keyed the hook.\n  //    The deps must be empty so cleanup runs ONLY on real unmount.\n  const navigationRef = useRef(executionRuntime.navigation);\n  navigationRef.current = executionRuntime.navigation;\n\n  // Per-mount controller for the latest fire. Replaced atomically on\n  // every `run()` so a stale promise settling after a fresh `run()`\n  // (or after unmount) cannot mutate hook state. Mirrors the canonical\n  // race-free fetch pattern.\n  const controllerRef = useRef<AbortController | null>(null);\n  // Per-mount tracking of the live `prefetchRuntimeId` so the cleanup\n  // / abort path knows which entry to `endParticipationPrefetch` even\n  // if the consumer's `run` callback never read the id itself.\n  const liveRuntimeIdRef = useRef<string | null>(null);\n\n  const [data, setData] = useState<TData | undefined>(undefined);\n  const [error, setError] = useState<unknown>(undefined);\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n\n  /**\n   * Internal helper used by both `abort()` and the unmount cleanup.\n   * Synchronously aborts the live controller and ends the live\n   * prefetch entry — guarantees `endParticipationPrefetch` runs even\n   * if the in-flight promise rejects later (its no-op handler in the\n   * `try`/`finally` will be a second `endParticipationPrefetch` call,\n   * which is idempotent because the runtime id is already gone — the\n   * `endParticipationPrefetch` JSDoc explicitly documents the unknown-id\n   * no-op behavior).\n   */\n  const cancelInFlight = useCallback((): void => {\n    const liveController = controllerRef.current;\n    const liveRuntimeId = liveRuntimeIdRef.current;\n    controllerRef.current = null;\n    liveRuntimeIdRef.current = null;\n    if (liveController && !liveController.signal.aborted) {\n      liveController.abort();\n    }\n    if (liveRuntimeId !== null) {\n      navigationRef.current.endParticipationPrefetch(liveRuntimeId);\n    }\n  }, []);\n\n  const refetch = useCallback(async (): Promise<TData | undefined> => {\n    // Snapshot every consumer-authored field at the start of the run so\n    // a subsequent input change mid-flight cannot retroactively shift\n    // which `prefetchKey` we clear on settle, which `participationRefs`\n    // we register, etc. The hook semantics are \"the run uses the inputs\n    // it was kicked off with\" — not \"the run uses whatever inputs are\n    // current at settle time\".\n    const snapshot = inputRef.current;\n    const fireRuntimeId = createExecutionPrefetchRuntimeId();\n    const fireController = new AbortController();\n    // Replace the live controller atomically. Any in-flight run loses\n    // ownership: its end-handler in the `try`/`finally` will see\n    // `controllerRef.current !== fireController` and will skip the\n    // state mutation (so a slow rejection cannot bring back stale\n    // `error`). The prior runtime id is ended via `cancelInFlight()`\n    // below, BEFORE we begin the new entry — so the registry never\n    // shows two entries from the same hook.\n    cancelInFlight();\n    controllerRef.current = fireController;\n    liveRuntimeIdRef.current = fireRuntimeId;\n\n    const pendingPrefetch: ExecutionPendingPrefetch = {\n      prefetchRuntimeId: fireRuntimeId,\n      participationRefs: snapshot.participationRefs,\n      resourceType: snapshot.resourceType,\n      intent: snapshot.intent,\n      startedAt: Date.now(),\n      ...(snapshot.label !== undefined ? { label: snapshot.label } : {}),\n    };\n    navigationRef.current.beginParticipationPrefetch(pendingPrefetch);\n    setIsLoading(true);\n\n    try {\n      const result = await snapshot.run({ signal: fireController.signal });\n      // If the hook was abort-cancelled or replaced mid-flight, the\n      // controller ref no longer points to ours — do not mutate state.\n      if (controllerRef.current !== fireController) {\n        return undefined;\n      }\n      setData(result);\n      setError(undefined);\n      // Stable-key auto-prune: any prior `PARTICIPATION_PREFETCH`-scoped\n      // failure for this same `prefetchKey` is implicitly resolved by a\n      // successful settle. The verb is a no-op when no entry matches,\n      // so the call is cheap on the happy path.\n      navigationRef.current.clearFailedActionsForPrefetchKey(snapshot.prefetchKey);\n      return result;\n    } catch (caughtError) {\n      if (controllerRef.current !== fireController) {\n        return undefined;\n      }\n      if (isAbortError(caughtError)) {\n        return undefined;\n      }\n      setError(caughtError);\n      if (snapshot.bridgeFailuresToShellAggregator === true) {\n        const failedAction = buildExecutionFailedAction({\n          failureRuntimeId: createExecutionPrefetchFailureRuntimeId(),\n          error: caughtError,\n          resourceType: snapshot.resourceType,\n          startedAt: pendingPrefetch.startedAt,\n          ...(snapshot.label !== undefined ? { label: snapshot.label } : {}),\n          scope: ExecutionFailedActionScope.PARTICIPATION_PREFETCH,\n          prefetchKey: snapshot.prefetchKey,\n        });\n        navigationRef.current.captureFailedAction(failedAction);\n      }\n      return undefined;\n    } finally {\n      // End the prefetch entry regardless of success / failure / abort.\n      // Race-safe: if a fresh `run()` raced ahead and replaced the\n      // controller, our `liveRuntimeIdRef` was already replaced too;\n      // guard the end call against double-clearing the new fire's id.\n      if (liveRuntimeIdRef.current === fireRuntimeId) {\n        liveRuntimeIdRef.current = null;\n        controllerRef.current = null;\n        navigationRef.current.endParticipationPrefetch(fireRuntimeId);\n        setIsLoading(false);\n      }\n    }\n  }, [cancelInFlight]);\n\n  const abort = useCallback((): void => {\n    if (controllerRef.current === null) {\n      return;\n    }\n    cancelInFlight();\n    setIsLoading(false);\n  }, [cancelInFlight]);\n\n  // Cleanup on unmount: synchronously abort + end so the prefetch\n  // registry doesn't leak entries past the hook's lifetime. The\n  // in-flight promise's `finally` will see a stale runtime id and\n  // skip the second end call (idempotent unknown-id no-op).\n  useEffect(() => {\n    return () => {\n      cancelInFlight();\n    };\n  }, [cancelInFlight]);\n\n  return useMemo<UseExecutionParticipationPrefetchValue<TData>>(() => ({\n    data,\n    isLoading,\n    error,\n    prefetchKey: input.prefetchKey,\n    refetch,\n    abort,\n  }), [abort, data, error, input.prefetchKey, isLoading, refetch]);\n}\n"]}

package/dist/esm/core/execution/useExecutionParticipationRMM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionParticipationRMM.d.ts","sourceRoot":"","sources":["../../../../src/core/execution/useExecutionParticipationRMM.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM1D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAEtH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,uDAAuD,CAAC;AAW/D,oBAAY,6CAA6C;IACvD,uBAAuB,4BAA4B;IACnD,4BAA4B,iCAAiC;CAC9D;AAED,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,0BAA0B,CAAC,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kCAAmC,SAAQ,oBAAoB;IAC9E,0BAA0B,EAAE,6CAA6C,GAAG,IAAI,CAAC;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0BAA0B,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC3F,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,EAAE,gCAAgC,CAAC,6BAA6B,CAAC,CAAC;CAC9F;AAoBD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kCAAkC,GACzC,kCAAkC,CAiIpC"}
+{"version":3,"file":"useExecutionParticipationRMM.d.ts","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionParticipationRMM.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM1D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAEtH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,uDAAuD,CAAC;AAW/D,oBAAY,6CAA6C;IACvD,uBAAuB,4BAA4B;IACnD,4BAA4B,iCAAiC;CAC9D;AAED,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,0BAA0B,CAAC,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kCAAmC,SAAQ,oBAAoB;IAC9E,0BAA0B,EAAE,6CAA6C,GAAG,IAAI,CAAC;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0BAA0B,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC3F,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,EAAE,gCAAgC,CAAC,6BAA6B,CAAC,CAAC;CAC9F;AAoBD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kCAAkC,GACzC,kCAAkC,CAiIpC"}

package/dist/esm/core/execution/useExecutionParticipationRMM.js.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionParticipationRMM.js","sourceRoot":"","sources":["../../../../src/core/execution/useExecutionParticipationRMM.ts"],"names":[],"mappings":"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","sourcesContent":["import { useContext, useMemo, useRef } from 'react';\n\nimport type { ResourceType } from '@wildo-ai/saas-models';\n\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { DoOperationFn } from '~wildo-frontend-lib/core/resources/rmm/HttpTransportAdapter';\nimport type { ConflictPolicy } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  type UseResourceRMMResult,\n  useResourceRMM,\n} from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n  buildExecutionParticipationHandle,\n  type ExecutionParticipationHandle,\n} from './execution-participation.utils';\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\n\nexport enum UseExecutionParticipationRMMUnavailableReason {\n  PARTICIPATION_NOT_FOUND = 'PARTICIPATION_NOT_FOUND',\n  MISSING_CONCRETE_RESOURCE_ID = 'MISSING_CONCRETE_RESOURCE_ID',\n}\n\nexport interface UseExecutionParticipationRMMConfig {\n  participationRef: string;\n  /**\n   * Optional concrete resource id override for cases where the authored\n   * participation is non-singular (for example a relationship projection to a\n   * collection) but the execution renderer is delegating one concrete child lane\n   * to RMM.\n   */\n  resourceId?: string;\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  relationshipFieldOverrides?: Record<ResourceType, string>;\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n  resourceSchema?: unknown;\n}\n\nexport interface UseExecutionParticipationRMMResult extends UseResourceRMMResult {\n  executionUnavailableReason: UseExecutionParticipationRMMUnavailableReason | null;\n  resourceType: string | null;\n  resourceId: string | null;\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements: FrontendResourceOperationContext['parentResourcesRequirements'];\n}\n\nfunction overrideResourceContextSlot(params: {\n  currentValue: FrontendResourceOperationContext['contextResourceIdentifiers'][string] | undefined;\n  resourceId: string;\n}): FrontendResourceOperationContext['contextResourceIdentifiers'][string] {\n  const fieldIdentifier = params.currentValue\n    ? frontendResourceUtils.getFieldIdentifier(params.currentValue)\n    : undefined;\n\n  if (fieldIdentifier) {\n    return {\n      fieldIdentifier,\n      resourceId: params.resourceId,\n    };\n  }\n\n  return params.resourceId;\n}\n\n/**\n * Thin execution-to-RMM bridge for one concrete participation-backed mutation\n * lane.\n *\n * Execution remains the macro orchestrator, but when a renderer resolves one\n * editable single-resource subject, this hook hands the concrete lane back to\n * the existing RMM runtime instead of re-implementing mutation semantics.\n */\nexport function useExecutionParticipationRMM(\n  config: UseExecutionParticipationRMMConfig,\n): UseExecutionParticipationRMMResult {\n  const {\n    participationRef,\n    resourceId: resourceIdOverride,\n    contextResourceIdentifiers: contextResourceOverrides,\n    relationshipFieldOverrides,\n    enabled = true,\n    conflictPolicy,\n    resourceSchema,\n  } = config;\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n  const { registry } = useResourceRegistry();\n\n  const rawParticipation = executionRuntime.participations[participationRef];\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 doOperationRef = useRef<DoOperationFn | null>(executionRuntime.doOperation);\n  doOperationRef.current = executionRuntime.doOperation;\n\n  const resourceType = participationHandle?.resourceType ?? null;\n  const resourceId = resourceIdOverride ?? participationHandle?.resourceId ?? null;\n\n  const executionUnavailableReason = useMemo((): UseExecutionParticipationRMMUnavailableReason | null => {\n    if (!participationHandle) {\n      return UseExecutionParticipationRMMUnavailableReason.PARTICIPATION_NOT_FOUND;\n    }\n\n    if (!resourceId) {\n      return UseExecutionParticipationRMMUnavailableReason.MISSING_CONCRETE_RESOURCE_ID;\n    }\n\n    return null;\n  }, [participationHandle, resourceId]);\n\n  const mergedContextResourceIdentifiers = useMemo<FrontendResourceOperationContext['contextResourceIdentifiers']>(() => {\n    const contextResourceIdentifiers = {\n      ...(executionRuntime.contextResourceIdentifiers ?? {}),\n      ...(contextResourceOverrides ?? {}),\n    };\n\n    if (resourceType && participationHandle?.contextIdentifier) {\n      contextResourceIdentifiers[resourceType] = participationHandle.contextIdentifier;\n    }\n\n    if (resourceType && resourceId) {\n      contextResourceIdentifiers[resourceType] = overrideResourceContextSlot({\n        currentValue: contextResourceIdentifiers[resourceType],\n        resourceId,\n      });\n    }\n\n    return contextResourceIdentifiers;\n  }, [\n    contextResourceOverrides,\n    executionRuntime.contextResourceIdentifiers,\n    participationHandle?.contextIdentifier,\n    resourceId,\n    resourceType,\n  ]);\n\n  const parentResourcesRequirements = useMemo<FrontendResourceOperationContext['parentResourcesRequirements']>(() => {\n    if (!resourceType || executionUnavailableReason) {\n      return [];\n    }\n\n    return frontendResourceUtils.buildParentResourcesRequirements(\n      resourceType as ResourceType,\n      mergedContextResourceIdentifiers,\n      registry,\n      relationshipFieldOverrides,\n    );\n  }, [\n    executionUnavailableReason,\n    mergedContextResourceIdentifiers,\n    registry,\n    relationshipFieldOverrides,\n    resourceType,\n  ]);\n\n  const contextualParameters = useMemo(() => {\n    if (!resourceType || executionUnavailableReason) {\n      return {};\n    }\n\n    return FrontendResourceUtils.buildContextualParameters(\n      mergedContextResourceIdentifiers,\n      registry,\n    );\n  }, [\n    executionUnavailableReason,\n    mergedContextResourceIdentifiers,\n    registry,\n    resourceType,\n  ]);\n\n  const rmm = useResourceRMM({\n    resourceType: resourceType ?? '',\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers: mergedContextResourceIdentifiers,\n    resourceSchema: resourceSchema ?? (\n      resourceType\n        ? registry.resourceConfigurations[resourceType]?.mainSchema\n        : undefined\n    ),\n    enabled: enabled && executionUnavailableReason === null,\n    conflictPolicy,\n  });\n\n  return {\n    ...rmm,\n    executionUnavailableReason,\n    resourceType,\n    resourceId,\n    contextResourceIdentifiers: mergedContextResourceIdentifiers,\n    contextualParameters,\n    parentResourcesRequirements,\n  };\n}\n"]}
+{"version":3,"file":"useExecutionParticipationRMM.js","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionParticipationRMM.ts"],"names":[],"mappings":"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","sourcesContent":["import { useContext, useMemo, useRef } from 'react';\n\nimport type { ResourceType } from '@wildo-ai/saas-models';\n\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { DoOperationFn } from '~wildo-frontend-lib/core/resources/rmm/HttpTransportAdapter';\nimport type { ConflictPolicy } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  type UseResourceRMMResult,\n  useResourceRMM,\n} from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n  buildExecutionParticipationHandle,\n  type ExecutionParticipationHandle,\n} from './execution-participation.utils';\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\n\nexport enum UseExecutionParticipationRMMUnavailableReason {\n  PARTICIPATION_NOT_FOUND = 'PARTICIPATION_NOT_FOUND',\n  MISSING_CONCRETE_RESOURCE_ID = 'MISSING_CONCRETE_RESOURCE_ID',\n}\n\nexport interface UseExecutionParticipationRMMConfig {\n  participationRef: string;\n  /**\n   * Optional concrete resource id override for cases where the authored\n   * participation is non-singular (for example a relationship projection to a\n   * collection) but the execution renderer is delegating one concrete child lane\n   * to RMM.\n   */\n  resourceId?: string;\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  relationshipFieldOverrides?: Record<ResourceType, string>;\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n  resourceSchema?: unknown;\n}\n\nexport interface UseExecutionParticipationRMMResult extends UseResourceRMMResult {\n  executionUnavailableReason: UseExecutionParticipationRMMUnavailableReason | null;\n  resourceType: string | null;\n  resourceId: string | null;\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements: FrontendResourceOperationContext['parentResourcesRequirements'];\n}\n\nfunction overrideResourceContextSlot(params: {\n  currentValue: FrontendResourceOperationContext['contextResourceIdentifiers'][string] | undefined;\n  resourceId: string;\n}): FrontendResourceOperationContext['contextResourceIdentifiers'][string] {\n  const fieldIdentifier = params.currentValue\n    ? frontendResourceUtils.getFieldIdentifier(params.currentValue)\n    : undefined;\n\n  if (fieldIdentifier) {\n    return {\n      fieldIdentifier,\n      resourceId: params.resourceId,\n    };\n  }\n\n  return params.resourceId;\n}\n\n/**\n * Thin execution-to-RMM bridge for one concrete participation-backed mutation\n * lane.\n *\n * Execution remains the macro orchestrator, but when a renderer resolves one\n * editable single-resource subject, this hook hands the concrete lane back to\n * the existing RMM runtime instead of re-implementing mutation semantics.\n */\nexport function useExecutionParticipationRMM(\n  config: UseExecutionParticipationRMMConfig,\n): UseExecutionParticipationRMMResult {\n  const {\n    participationRef,\n    resourceId: resourceIdOverride,\n    contextResourceIdentifiers: contextResourceOverrides,\n    relationshipFieldOverrides,\n    enabled = true,\n    conflictPolicy,\n    resourceSchema,\n  } = config;\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n  const { registry } = useResourceRegistry();\n\n  const rawParticipation = executionRuntime.participations[participationRef];\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 doOperationRef = useRef<DoOperationFn | null>(executionRuntime.doOperation);\n  doOperationRef.current = executionRuntime.doOperation;\n\n  const resourceType = participationHandle?.resourceType ?? null;\n  const resourceId = resourceIdOverride ?? participationHandle?.resourceId ?? null;\n\n  const executionUnavailableReason = useMemo((): UseExecutionParticipationRMMUnavailableReason | null => {\n    if (!participationHandle) {\n      return UseExecutionParticipationRMMUnavailableReason.PARTICIPATION_NOT_FOUND;\n    }\n\n    if (!resourceId) {\n      return UseExecutionParticipationRMMUnavailableReason.MISSING_CONCRETE_RESOURCE_ID;\n    }\n\n    return null;\n  }, [participationHandle, resourceId]);\n\n  const mergedContextResourceIdentifiers = useMemo<FrontendResourceOperationContext['contextResourceIdentifiers']>(() => {\n    const contextResourceIdentifiers = {\n      ...(executionRuntime.contextResourceIdentifiers ?? {}),\n      ...(contextResourceOverrides ?? {}),\n    };\n\n    if (resourceType && participationHandle?.contextIdentifier) {\n      contextResourceIdentifiers[resourceType] = participationHandle.contextIdentifier;\n    }\n\n    if (resourceType && resourceId) {\n      contextResourceIdentifiers[resourceType] = overrideResourceContextSlot({\n        currentValue: contextResourceIdentifiers[resourceType],\n        resourceId,\n      });\n    }\n\n    return contextResourceIdentifiers;\n  }, [\n    contextResourceOverrides,\n    executionRuntime.contextResourceIdentifiers,\n    participationHandle?.contextIdentifier,\n    resourceId,\n    resourceType,\n  ]);\n\n  const parentResourcesRequirements = useMemo<FrontendResourceOperationContext['parentResourcesRequirements']>(() => {\n    if (!resourceType || executionUnavailableReason) {\n      return [];\n    }\n\n    return frontendResourceUtils.buildParentResourcesRequirements(\n      resourceType as ResourceType,\n      mergedContextResourceIdentifiers,\n      registry,\n      relationshipFieldOverrides,\n    );\n  }, [\n    executionUnavailableReason,\n    mergedContextResourceIdentifiers,\n    registry,\n    relationshipFieldOverrides,\n    resourceType,\n  ]);\n\n  const contextualParameters = useMemo(() => {\n    if (!resourceType || executionUnavailableReason) {\n      return {};\n    }\n\n    return FrontendResourceUtils.buildContextualParameters(\n      mergedContextResourceIdentifiers,\n      registry,\n    );\n  }, [\n    executionUnavailableReason,\n    mergedContextResourceIdentifiers,\n    registry,\n    resourceType,\n  ]);\n\n  const rmm = useResourceRMM({\n    resourceType: resourceType ?? '',\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers: mergedContextResourceIdentifiers,\n    resourceSchema: resourceSchema ?? (\n      resourceType\n        ? registry.resourceConfigurations[resourceType]?.mainSchema\n        : undefined\n    ),\n    enabled: enabled && executionUnavailableReason === null,\n    conflictPolicy,\n  });\n\n  return {\n    ...rmm,\n    executionUnavailableReason,\n    resourceType,\n    resourceId,\n    contextResourceIdentifiers: mergedContextResourceIdentifiers,\n    contextualParameters,\n    parentResourcesRequirements,\n  };\n}\n"]}

package/dist/esm/core/execution/useExecutionResourceOperationContextBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionResourceOperationContextBuilder.d.ts","sourceRoot":"","sources":["../../../../src/core/execution/useExecutionResourceOperationContextBuilder.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,qBAAqB,EACrB,4BAA4B,EAC5B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAsB/B,OAAO,KAAK,EAGV,gCAAgC,EAEjC,MAAM,+DAA+D,CAAC;AAGvE,KAAK,wCAAwC,GACzC;IACE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GACD;IACE,aAAa,EAAE,qBAAqB,CAAC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,gCAAgC,GAAG,wCAAwC,GAAG;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,0BAA0B,CAAC,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,WAAW,6CAA6C;IAC5D,6BAA6B,EAAE,CAC7B,MAAM,EAAE,gCAAgC,KACrC,gCAAgC,CAAC;CACvC;AAgND,wBAAgB,2CAA2C,IAAI,6CAA6C,CA0G3G"}
+{"version":3,"file":"useExecutionResourceOperationContextBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionResourceOperationContextBuilder.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,qBAAqB,EACrB,4BAA4B,EAC5B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAsB/B,OAAO,KAAK,EAGV,gCAAgC,EAEjC,MAAM,+DAA+D,CAAC;AAGvE,KAAK,wCAAwC,GACzC;IACE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GACD;IACE,aAAa,EAAE,qBAAqB,CAAC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,gCAAgC,GAAG,wCAAwC,GAAG;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,0BAA0B,CAAC,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,WAAW,6CAA6C;IAC5D,6BAA6B,EAAE,CAC7B,MAAM,EAAE,gCAAgC,KACrC,gCAAgC,CAAC;CACvC;AAgND,wBAAgB,2CAA2C,IAAI,6CAA6C,CA0G3G"}

package/dist/esm/core/execution/useExecutionResourceOperationContextBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutionResourceOperationContextBuilder.js","sourceRoot":"","sources":["../../../../src/core/execution/useExecutionResourceOperationContextBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext } from 'react';\n\nimport {\n  ErrorCustomMessageReference,\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  type ResourceType,\n} from '@wildo-ai/saas-models';\n\nimport {\n  buildExecutionParticipationContextIdentifier,\n  getExecutionParticipationResourceType,\n} from './execution-participation.utils';\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  pickPreferredOperationForCoreSemantic,\n  resolveEffectiveCoreOperationFromOperation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n  isFrontendOperationAddressableForCurrentContext,\n  pickPreferredOperationForCoreSemanticAddressability,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourceOperationContext,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\n\ntype ExecutionResourceOperationTargetSelector =\n  | {\n      operationIdentifier: string;\n      variantType?: ResourceOperationVariantType;\n      variantKey?: string;\n      isOperationDefault?: boolean;\n      isBulkOperation?: boolean;\n    }\n  | {\n      operationLike: CoreResourceOperation;\n      requireAddressable?: boolean;\n      allowBulk?: boolean;\n    };\n\nexport type ExecutionResourceOperationTarget = ExecutionResourceOperationTargetSelector & {\n  resourceType?: string;\n  resourceId?: string;\n  participationRef?: string;\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  relationshipFieldOverrides?: Record<ResourceType, string>;\n  additionalContext?: Record<string, unknown>;\n};\n\nexport interface ExecutionResourceOperationContextBuilderValue {\n  buildResourceOperationContext: (\n    target: ExecutionResourceOperationTarget,\n  ) => FrontendResourceOperationContext;\n}\n\nfunction buildExecutionResourceOperationBuilderError(\n  message: string,\n  context?: Record<string, unknown>,\n): Error {\n  return FrontendResourceUtils.buildConfigurationError(\n    ErrorCustomMessageReference.CONFIGURATION,\n    {\n      message,\n      component: 'useExecutionResourceOperationContextBuilder',\n      ...context,\n    },\n  );\n}\n\nfunction hasOperationIdentifier(\n  target: ExecutionResourceOperationTargetSelector,\n): target is Extract<ExecutionResourceOperationTargetSelector, { operationIdentifier: string }> {\n  return 'operationIdentifier' in target;\n}\n\nfunction resolveExplicitOperationForTarget(\n  resourceConfig: AnyFrontendResourceConfiguration,\n  resourceType: string,\n  target: Extract<ExecutionResourceOperationTargetSelector, { operationIdentifier: string }>,\n): FrontendResourceConfiguration_Operation {\n  const matchingOperations = (resourceConfig.operations ?? []).filter((candidate) => {\n    if (String(candidate.operationIdentifier) !== target.operationIdentifier) {\n      return false;\n    }\n    if (target.variantType !== undefined && candidate.variantType !== target.variantType) {\n      return false;\n    }\n    if (target.variantKey !== undefined && candidate.variantKey !== target.variantKey) {\n      return false;\n    }\n    if (target.isOperationDefault !== undefined && candidate.isOperationDefault !== target.isOperationDefault) {\n      return false;\n    }\n    if (target.isBulkOperation !== undefined && candidate.isBulkOperation !== target.isBulkOperation) {\n      return false;\n    }\n    return true;\n  });\n\n  if (matchingOperations.length === 1) {\n    return matchingOperations[0]!;\n  }\n\n  const defaultNonBulkOperations = matchingOperations.filter(\n    (candidate) => candidate.isOperationDefault === true && candidate.isBulkOperation !== true,\n  );\n  if (\n    target.variantKey === undefined\n    && target.variantType === undefined\n    && target.isOperationDefault === undefined\n    && target.isBulkOperation === undefined\n    && defaultNonBulkOperations.length === 1\n  ) {\n    return defaultNonBulkOperations[0]!;\n  }\n\n  throw buildExecutionResourceOperationBuilderError(\n    matchingOperations.length === 0\n      ? `Execution resource-operation builder cannot resolve operation \"${target.operationIdentifier}\" on resource \"${resourceType}\".`\n      : `Execution resource-operation builder found ambiguous operation \"${target.operationIdentifier}\" on resource \"${resourceType}\".`,\n    {\n      resourceType,\n      operationIdentifier: target.operationIdentifier,\n      variantType: target.variantType,\n      variantKey: target.variantKey,\n      isOperationDefault: target.isOperationDefault,\n      isBulkOperation: target.isBulkOperation,\n      candidates: matchingOperations.map((candidate) => ({\n        variantType: candidate.variantType,\n        variantKey: candidate.variantKey,\n        isOperationDefault: candidate.isOperationDefault,\n        isBulkOperation: candidate.isBulkOperation,\n      })),\n    },\n  );\n}\n\nfunction resolveOperationForTarget(\n  resourceConfig: AnyFrontendResourceConfiguration | undefined,\n  resourceType: string,\n  target: ExecutionResourceOperationTargetSelector,\n  registry: FrontendResourcesRegistry,\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n  contextualParameters: Record<string, string | number>,\n): FrontendResourceConfiguration_Operation {\n  if (!resourceConfig) {\n    throw buildExecutionResourceOperationBuilderError(\n      `Execution resource-operation builder cannot resolve resource \"${resourceType}\" from the registry.`,\n      { resourceType },\n    );\n  }\n\n  if (hasOperationIdentifier(target)) {\n    const operation = resolveExplicitOperationForTarget(resourceConfig, resourceType, target);\n\n    const effectiveCoreOperation = resolveEffectiveCoreOperationFromOperation(operation);\n    const requiresRuntimeAddressability = effectiveCoreOperation === CoreResourceOperation.READ\n      || effectiveCoreOperation === CoreResourceOperation.UPDATE\n      || effectiveCoreOperation === CoreResourceOperation.DELETE;\n    if (\n      requiresRuntimeAddressability\n      && operation.isBulkOperation !== true\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig,\n        operation,\n        registry,\n        hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]) !== '',\n        contextResourceIdentifiers,\n        contextualParameters,\n      })\n    ) {\n      throw buildExecutionResourceOperationBuilderError(\n        `Execution resource-operation builder resolved operation \"${target.operationIdentifier}\" on resource \"${resourceType}\", but the current context cannot address it.`,\n        {\n          resourceType,\n          operationIdentifier: target.operationIdentifier,\n        },\n      );\n    }\n\n    return operation;\n  }\n\n  const requiresRuntimeAddressability = target.operationLike === CoreResourceOperation.READ\n    || target.operationLike === CoreResourceOperation.UPDATE\n    || target.operationLike === CoreResourceOperation.DELETE;\n  const semanticOperation = target.requireAddressable || requiresRuntimeAddressability\n    ? pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation: target.operationLike,\n      registry,\n      hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]) !== '',\n      allowBulk: target.allowBulk,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers,\n      contextualParameters,\n    })\n    : pickPreferredOperationForCoreSemantic(\n      resourceConfig.operations ?? [],\n      target.operationLike,\n      {\n        requireAddressable: target.requireAddressable,\n        allowBulk: target.allowBulk,\n      },\n    );\n\n  if (!semanticOperation) {\n    throw buildExecutionResourceOperationBuilderError(\n      `Execution resource-operation builder cannot resolve a preferred ${String(target.operationLike)}-like operation on resource \"${resourceType}\".`,\n      {\n        resourceType,\n        operationLike: target.operationLike,\n        requireAddressable: target.requireAddressable,\n        allowBulk: target.allowBulk,\n      },\n    );\n  }\n\n  return semanticOperation;\n}\n\nfunction overrideResourceContextSlot(params: {\n  currentValue: FrontendResourceOperationContext['contextResourceIdentifiers'][string] | undefined;\n  resourceId: string;\n}): FrontendResourceOperationContext['contextResourceIdentifiers'][string] {\n  const fieldIdentifier = params.currentValue\n    ? frontendResourceUtils.getFieldIdentifier(params.currentValue)\n    : undefined;\n\n  if (fieldIdentifier) {\n    return {\n      fieldIdentifier,\n      resourceId: params.resourceId,\n    };\n  }\n\n  return params.resourceId;\n}\n\nfunction getAdditionalContextCurrentObject(\n  additionalContext?: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const currentObject = additionalContext?.currentObject ?? additionalContext?.resource;\n  return currentObject && typeof currentObject === 'object' && !Array.isArray(currentObject)\n    ? currentObject as Record<string, unknown>\n    : undefined;\n}\n\nfunction resolveAdditionalContextResourceId(params: {\n  additionalContext?: Record<string, unknown>;\n  resourceConfig: AnyFrontendResourceConfiguration | undefined;\n}): string | undefined {\n  const currentObject = getAdditionalContextCurrentObject(params.additionalContext);\n  const candidate = currentObject?._id\n    ?? (params.resourceConfig?.resourceFieldIdentifier\n      ? currentObject?.[params.resourceConfig.resourceFieldIdentifier]\n      : undefined);\n  return typeof candidate === 'string' && candidate.length > 0 ? candidate : undefined;\n}\n\nexport function useExecutionResourceOperationContextBuilder(): ExecutionResourceOperationContextBuilderValue {\n  const { registry } = useResourceRegistry();\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n\n  const buildResourceOperationContext = useCallback<ExecutionResourceOperationContextBuilderValue['buildResourceOperationContext']>((target) => {\n    const participation = target.participationRef\n      ? executionRuntime.participations[target.participationRef]\n      : undefined;\n\n    if (target.participationRef && !participation) {\n      throw buildExecutionResourceOperationBuilderError(\n        `Execution resource-operation builder cannot resolve participation \"${target.participationRef}\".`,\n        {\n          participationRef: target.participationRef,\n        },\n      );\n    }\n\n    const resourceType = target.resourceType ?? (\n      participation\n        ? getExecutionParticipationResourceType(participation)\n        : undefined\n    );\n\n    if (!resourceType) {\n      throw buildExecutionResourceOperationBuilderError(\n        'Execution resource-operation builder requires either `resourceType` or `participationRef`.',\n        {\n          target,\n        },\n      );\n    }\n\n    const contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'] = {\n      ...(executionRuntime.contextResourceIdentifiers ?? {}),\n      ...(target.contextResourceIdentifiers ?? {}),\n    };\n\n    if (participation) {\n      const participationContextIdentifier = buildExecutionParticipationContextIdentifier({\n        participation,\n        registry,\n      });\n      if (!participationContextIdentifier && !target.resourceId) {\n        throw buildExecutionResourceOperationBuilderError(\n          `Execution resource-operation builder cannot derive a concrete resource identifier from participation \"${target.participationRef}\".`,\n          {\n            participationRef: target.participationRef,\n            resourceType,\n          },\n        );\n      }\n      if (participationContextIdentifier) {\n        contextResourceIdentifiers[resourceType] = participationContextIdentifier;\n      }\n    }\n\n    const resourceConfig = registry.resourceConfigurations[resourceType];\n    const additionalContextResourceId = resolveAdditionalContextResourceId({\n      additionalContext: target.additionalContext,\n      resourceConfig,\n    });\n    const resolvedResourceId = target.resourceId ?? additionalContextResourceId;\n    if (resolvedResourceId) {\n      contextResourceIdentifiers[resourceType] = overrideResourceContextSlot({\n        currentValue: contextResourceIdentifiers[resourceType],\n        resourceId: resolvedResourceId,\n      });\n    }\n\n    const contextualParameters = FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiers,\n      registry,\n    );\n    const operation = resolveOperationForTarget(\n      resourceConfig,\n      resourceType,\n      target,\n      registry,\n      contextResourceIdentifiers,\n      contextualParameters,\n    );\n\n    const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(\n      resourceType as ResourceType,\n      contextResourceIdentifiers,\n      registry,\n      target.relationshipFieldOverrides,\n    );\n\n    return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType: resourceType as ResourceType,\n      operation,\n      contextResourceIdentifiers,\n      additionalContext: target.additionalContext,\n      parentResourcesRequirements,\n    });\n  }, [\n    executionRuntime.contextResourceIdentifiers,\n    executionRuntime.participations,\n    registry,\n  ]);\n\n  return {\n    buildResourceOperationContext,\n  };\n}\n"]}
+{"version":3,"file":"useExecutionResourceOperationContextBuilder.js","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionResourceOperationContextBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext } from 'react';\n\nimport {\n  ErrorCustomMessageReference,\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  type ResourceType,\n} from '@wildo-ai/saas-models';\n\nimport {\n  buildExecutionParticipationContextIdentifier,\n  getExecutionParticipationResourceType,\n} from './execution-participation.utils';\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  pickPreferredOperationForCoreSemantic,\n  resolveEffectiveCoreOperationFromOperation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n  isFrontendOperationAddressableForCurrentContext,\n  pickPreferredOperationForCoreSemanticAddressability,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourceOperationContext,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\n\ntype ExecutionResourceOperationTargetSelector =\n  | {\n      operationIdentifier: string;\n      variantType?: ResourceOperationVariantType;\n      variantKey?: string;\n      isOperationDefault?: boolean;\n      isBulkOperation?: boolean;\n    }\n  | {\n      operationLike: CoreResourceOperation;\n      requireAddressable?: boolean;\n      allowBulk?: boolean;\n    };\n\nexport type ExecutionResourceOperationTarget = ExecutionResourceOperationTargetSelector & {\n  resourceType?: string;\n  resourceId?: string;\n  participationRef?: string;\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  relationshipFieldOverrides?: Record<ResourceType, string>;\n  additionalContext?: Record<string, unknown>;\n};\n\nexport interface ExecutionResourceOperationContextBuilderValue {\n  buildResourceOperationContext: (\n    target: ExecutionResourceOperationTarget,\n  ) => FrontendResourceOperationContext;\n}\n\nfunction buildExecutionResourceOperationBuilderError(\n  message: string,\n  context?: Record<string, unknown>,\n): Error {\n  return FrontendResourceUtils.buildConfigurationError(\n    ErrorCustomMessageReference.CONFIGURATION,\n    {\n      message,\n      component: 'useExecutionResourceOperationContextBuilder',\n      ...context,\n    },\n  );\n}\n\nfunction hasOperationIdentifier(\n  target: ExecutionResourceOperationTargetSelector,\n): target is Extract<ExecutionResourceOperationTargetSelector, { operationIdentifier: string }> {\n  return 'operationIdentifier' in target;\n}\n\nfunction resolveExplicitOperationForTarget(\n  resourceConfig: AnyFrontendResourceConfiguration,\n  resourceType: string,\n  target: Extract<ExecutionResourceOperationTargetSelector, { operationIdentifier: string }>,\n): FrontendResourceConfiguration_Operation {\n  const matchingOperations = (resourceConfig.operations ?? []).filter((candidate) => {\n    if (String(candidate.operationIdentifier) !== target.operationIdentifier) {\n      return false;\n    }\n    if (target.variantType !== undefined && candidate.variantType !== target.variantType) {\n      return false;\n    }\n    if (target.variantKey !== undefined && candidate.variantKey !== target.variantKey) {\n      return false;\n    }\n    if (target.isOperationDefault !== undefined && candidate.isOperationDefault !== target.isOperationDefault) {\n      return false;\n    }\n    if (target.isBulkOperation !== undefined && candidate.isBulkOperation !== target.isBulkOperation) {\n      return false;\n    }\n    return true;\n  });\n\n  if (matchingOperations.length === 1) {\n    return matchingOperations[0]!;\n  }\n\n  const defaultNonBulkOperations = matchingOperations.filter(\n    (candidate) => candidate.isOperationDefault === true && candidate.isBulkOperation !== true,\n  );\n  if (\n    target.variantKey === undefined\n    && target.variantType === undefined\n    && target.isOperationDefault === undefined\n    && target.isBulkOperation === undefined\n    && defaultNonBulkOperations.length === 1\n  ) {\n    return defaultNonBulkOperations[0]!;\n  }\n\n  throw buildExecutionResourceOperationBuilderError(\n    matchingOperations.length === 0\n      ? `Execution resource-operation builder cannot resolve operation \"${target.operationIdentifier}\" on resource \"${resourceType}\".`\n      : `Execution resource-operation builder found ambiguous operation \"${target.operationIdentifier}\" on resource \"${resourceType}\".`,\n    {\n      resourceType,\n      operationIdentifier: target.operationIdentifier,\n      variantType: target.variantType,\n      variantKey: target.variantKey,\n      isOperationDefault: target.isOperationDefault,\n      isBulkOperation: target.isBulkOperation,\n      candidates: matchingOperations.map((candidate) => ({\n        variantType: candidate.variantType,\n        variantKey: candidate.variantKey,\n        isOperationDefault: candidate.isOperationDefault,\n        isBulkOperation: candidate.isBulkOperation,\n      })),\n    },\n  );\n}\n\nfunction resolveOperationForTarget(\n  resourceConfig: AnyFrontendResourceConfiguration | undefined,\n  resourceType: string,\n  target: ExecutionResourceOperationTargetSelector,\n  registry: FrontendResourcesRegistry,\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n  contextualParameters: Record<string, string | number>,\n): FrontendResourceConfiguration_Operation {\n  if (!resourceConfig) {\n    throw buildExecutionResourceOperationBuilderError(\n      `Execution resource-operation builder cannot resolve resource \"${resourceType}\" from the registry.`,\n      { resourceType },\n    );\n  }\n\n  if (hasOperationIdentifier(target)) {\n    const operation = resolveExplicitOperationForTarget(resourceConfig, resourceType, target);\n\n    const effectiveCoreOperation = resolveEffectiveCoreOperationFromOperation(operation);\n    const requiresRuntimeAddressability = effectiveCoreOperation === CoreResourceOperation.READ\n      || effectiveCoreOperation === CoreResourceOperation.UPDATE\n      || effectiveCoreOperation === CoreResourceOperation.DELETE;\n    if (\n      requiresRuntimeAddressability\n      && operation.isBulkOperation !== true\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig,\n        operation,\n        registry,\n        hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]) !== '',\n        contextResourceIdentifiers,\n        contextualParameters,\n      })\n    ) {\n      throw buildExecutionResourceOperationBuilderError(\n        `Execution resource-operation builder resolved operation \"${target.operationIdentifier}\" on resource \"${resourceType}\", but the current context cannot address it.`,\n        {\n          resourceType,\n          operationIdentifier: target.operationIdentifier,\n        },\n      );\n    }\n\n    return operation;\n  }\n\n  const requiresRuntimeAddressability = target.operationLike === CoreResourceOperation.READ\n    || target.operationLike === CoreResourceOperation.UPDATE\n    || target.operationLike === CoreResourceOperation.DELETE;\n  const semanticOperation = target.requireAddressable || requiresRuntimeAddressability\n    ? pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation: target.operationLike,\n      registry,\n      hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]) !== '',\n      allowBulk: target.allowBulk,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers,\n      contextualParameters,\n    })\n    : pickPreferredOperationForCoreSemantic(\n      resourceConfig.operations ?? [],\n      target.operationLike,\n      {\n        requireAddressable: target.requireAddressable,\n        allowBulk: target.allowBulk,\n      },\n    );\n\n  if (!semanticOperation) {\n    throw buildExecutionResourceOperationBuilderError(\n      `Execution resource-operation builder cannot resolve a preferred ${String(target.operationLike)}-like operation on resource \"${resourceType}\".`,\n      {\n        resourceType,\n        operationLike: target.operationLike,\n        requireAddressable: target.requireAddressable,\n        allowBulk: target.allowBulk,\n      },\n    );\n  }\n\n  return semanticOperation;\n}\n\nfunction overrideResourceContextSlot(params: {\n  currentValue: FrontendResourceOperationContext['contextResourceIdentifiers'][string] | undefined;\n  resourceId: string;\n}): FrontendResourceOperationContext['contextResourceIdentifiers'][string] {\n  const fieldIdentifier = params.currentValue\n    ? frontendResourceUtils.getFieldIdentifier(params.currentValue)\n    : undefined;\n\n  if (fieldIdentifier) {\n    return {\n      fieldIdentifier,\n      resourceId: params.resourceId,\n    };\n  }\n\n  return params.resourceId;\n}\n\nfunction getAdditionalContextCurrentObject(\n  additionalContext?: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const currentObject = additionalContext?.currentObject ?? additionalContext?.resource;\n  return currentObject && typeof currentObject === 'object' && !Array.isArray(currentObject)\n    ? currentObject as Record<string, unknown>\n    : undefined;\n}\n\nfunction resolveAdditionalContextResourceId(params: {\n  additionalContext?: Record<string, unknown>;\n  resourceConfig: AnyFrontendResourceConfiguration | undefined;\n}): string | undefined {\n  const currentObject = getAdditionalContextCurrentObject(params.additionalContext);\n  const candidate = currentObject?._id\n    ?? (params.resourceConfig?.resourceFieldIdentifier\n      ? currentObject?.[params.resourceConfig.resourceFieldIdentifier]\n      : undefined);\n  return typeof candidate === 'string' && candidate.length > 0 ? candidate : undefined;\n}\n\nexport function useExecutionResourceOperationContextBuilder(): ExecutionResourceOperationContextBuilderValue {\n  const { registry } = useResourceRegistry();\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n\n  const buildResourceOperationContext = useCallback<ExecutionResourceOperationContextBuilderValue['buildResourceOperationContext']>((target) => {\n    const participation = target.participationRef\n      ? executionRuntime.participations[target.participationRef]\n      : undefined;\n\n    if (target.participationRef && !participation) {\n      throw buildExecutionResourceOperationBuilderError(\n        `Execution resource-operation builder cannot resolve participation \"${target.participationRef}\".`,\n        {\n          participationRef: target.participationRef,\n        },\n      );\n    }\n\n    const resourceType = target.resourceType ?? (\n      participation\n        ? getExecutionParticipationResourceType(participation)\n        : undefined\n    );\n\n    if (!resourceType) {\n      throw buildExecutionResourceOperationBuilderError(\n        'Execution resource-operation builder requires either `resourceType` or `participationRef`.',\n        {\n          target,\n        },\n      );\n    }\n\n    const contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'] = {\n      ...(executionRuntime.contextResourceIdentifiers ?? {}),\n      ...(target.contextResourceIdentifiers ?? {}),\n    };\n\n    if (participation) {\n      const participationContextIdentifier = buildExecutionParticipationContextIdentifier({\n        participation,\n        registry,\n      });\n      if (!participationContextIdentifier && !target.resourceId) {\n        throw buildExecutionResourceOperationBuilderError(\n          `Execution resource-operation builder cannot derive a concrete resource identifier from participation \"${target.participationRef}\".`,\n          {\n            participationRef: target.participationRef,\n            resourceType,\n          },\n        );\n      }\n      if (participationContextIdentifier) {\n        contextResourceIdentifiers[resourceType] = participationContextIdentifier;\n      }\n    }\n\n    const resourceConfig = registry.resourceConfigurations[resourceType];\n    const additionalContextResourceId = resolveAdditionalContextResourceId({\n      additionalContext: target.additionalContext,\n      resourceConfig,\n    });\n    const resolvedResourceId = target.resourceId ?? additionalContextResourceId;\n    if (resolvedResourceId) {\n      contextResourceIdentifiers[resourceType] = overrideResourceContextSlot({\n        currentValue: contextResourceIdentifiers[resourceType],\n        resourceId: resolvedResourceId,\n      });\n    }\n\n    const contextualParameters = FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiers,\n      registry,\n    );\n    const operation = resolveOperationForTarget(\n      resourceConfig,\n      resourceType,\n      target,\n      registry,\n      contextResourceIdentifiers,\n      contextualParameters,\n    );\n\n    const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(\n      resourceType as ResourceType,\n      contextResourceIdentifiers,\n      registry,\n      target.relationshipFieldOverrides,\n    );\n\n    return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType: resourceType as ResourceType,\n      operation,\n      contextResourceIdentifiers,\n      additionalContext: target.additionalContext,\n      parentResourcesRequirements,\n    });\n  }, [\n    executionRuntime.contextResourceIdentifiers,\n    executionRuntime.participations,\n    registry,\n  ]);\n\n  return {\n    buildResourceOperationContext,\n  };\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useExecutionResourceOperationSurface.d.ts","sourceRoot":"","sources":["../../../../src/core/execution/useExecutionResourceOperationSurface.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,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,CA8RhF;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"}
+{"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"}

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

@@ -3,7 +3,7 @@ import { CoreResourceOperation, ErrorCustomMessageReference, ResourcesConfig_Ope
 import { frontendResourceUtils, FrontendResourceUtils, } from '../../core/resources/frontend-resource.utils.js';
 import { mergeBulkSelectionIntoRequestData, isSingleResourceUpdateLikeOperation, } from '../../core/resources/operation-semantics.frontend.utils.js';
 import { isFrontendOperationAddressableForCurrentContext, shouldRequireCurrentContextAddressabilityForOperation, } from '../../core/resources/resource-addressability.frontend.utils.js';
-import { MutationPriority, MutationSourceType, MutationType, } from '../../core/resources/rmm/types.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 { useResourceOperationSurface } from '../../core/resources/useResourceOperationSurface.js';
 import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
@@ -215,6 +215,13 @@ export function useExecutionResourceOperationSurface({ target, navigationInitiat
                 },
             });
             if (!mutationResult.success) {
+                // Rethrow the transport failure itself: it carries the backend reference, type and guidance that
+                // `useUserFacingErrorMessage()` turns into the application's words. An `Error` rebuilt from its message
+                // keeps only the text, which is never shown, so the failure could only read as generic (#1182).
+                // A cancellation keeps its previous shape.
+                if (mutationResult.error?.cause !== undefined && mutationResult.error.type !== MutationErrorType.ABORT) {
+                    throw mutationResult.error.cause;
+                }
                 throw new Error(mutationResult.error?.message
                     ?? `Execution resource operation "${resourceSurface.operationId}" failed.`);
             }

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

@@ -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,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,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  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        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"]}
+{"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  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"]}

package/dist/esm/core/external-providers/ProviderFilePickerHost.d.ts

@@ -34,7 +34,19 @@ import type { ProviderFilePickerConstraints, ProviderFileSelection } from '@wild
 import { type ProviderComponentChoice } from '../../core/components-registry/useProviderComponent.frontend.hooks';
 import { type ProviderFileSelectionRejection } from './provider-file-selection.frontend.utils';
 export interface ProviderFilePickerHostProps {
+    /**
+     * The FIELD's own constraints, read from its Zod metadata. The chosen
+     * provider's declared limits are laid UNDER these, here, per provider — never
+     * resolved once by the caller, which is how one vendor's limit came to govern
+     * every other vendor's picker (#380).
+     */
     readonly constraints: ProviderFilePickerConstraints;
+    /**
+     * Whether the field accepts several files. A `maxSelectionCount` a provider
+     * declares applies only to a `multiple` field; a single-file field never
+     * inherits a selection count, whatever the vendor allows.
+     */
+    readonly multiple: boolean;
     /**
      * The field's `z_file({ storageAccepted })` (#394 P5). A provider whose picker
      * fronts a storage (a `REMOTE_REFERENCE` picker — the file stays at the

package/dist/esm/core/external-providers/ProviderFilePickerHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderFilePickerHost.d.ts","sourceRoot":"","sources":["../../../../src/core/external-providers/ProviderFilePickerHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAoD,MAAM,OAAO,CAAC;AAGzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EACV,6BAA6B,EAE7B,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,kFAAkF,CAAC;AAC1F,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,0CAA0C,CAAC;AAIlD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;IACpD;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAClF,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7J;;;;OAIG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;QACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,GAAG,KAAK,CAAC,SAAS,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAwGpG"}
+{"version":3,"file":"ProviderFilePickerHost.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/ProviderFilePickerHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAGjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EACV,6BAA6B,EAE7B,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,kFAAkF,CAAC;AAC1F,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,0CAA0C,CAAC;AAIlD,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAClF,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7J;;;;OAIG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;QACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,GAAG,KAAK,CAAC,SAAS,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA4IpG"}