@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

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

@@ -0,0 +1,27 @@
+import { CoreResourceOperation, ResourceOperationVariantType, type ResourceType } from '@wildo-ai/saas-models';
+import type { FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas';
+type ExecutionResourceOperationTargetSelector = {
+    operationIdentifier: string;
+    variantType?: ResourceOperationVariantType;
+    variantKey?: string;
+    isOperationDefault?: boolean;
+    isBulkOperation?: boolean;
+} | {
+    operationLike: CoreResourceOperation;
+    requireAddressable?: boolean;
+    allowBulk?: boolean;
+};
+export type ExecutionResourceOperationTarget = ExecutionResourceOperationTargetSelector & {
+    resourceType?: string;
+    resourceId?: string;
+    participationRef?: string;
+    contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];
+    relationshipFieldOverrides?: Record<ResourceType, string>;
+    additionalContext?: Record<string, unknown>;
+};
+export interface ExecutionResourceOperationContextBuilderValue {
+    buildResourceOperationContext: (target: ExecutionResourceOperationTarget) => FrontendResourceOperationContext;
+}
+export declare function useExecutionResourceOperationContextBuilder(): ExecutionResourceOperationContextBuilderValue;
+export {};
+//# sourceMappingURL=useExecutionResourceOperationContextBuilder.d.ts.map

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

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

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

@@ -0,0 +1,218 @@
+import { useCallback, useContext } from 'react';
+import { ErrorCustomMessageReference, CoreResourceOperation, } from '@wildo-ai/saas-models';
+import { buildExecutionParticipationContextIdentifier, getExecutionParticipationResourceType, } from './execution-participation.utils.js';
+import { assertExecutionRuntimeContext, ExecutionRuntimeContext, } from './ExecutionRuntimeContext.js';
+import { frontendResourceUtils, FrontendResourceUtils, } from '../../core/resources/frontend-resource.utils.js';
+import { pickPreferredOperationForCoreSemantic, resolveEffectiveCoreOperationFromOperation, } from '../../core/resources/operation-semantics.frontend.utils.js';
+import { isFrontendOperationAddressableForCurrentContext, pickPreferredOperationForCoreSemanticAddressability, } from '../../core/resources/resource-addressability.frontend.utils.js';
+import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
+function buildExecutionResourceOperationBuilderError(message, context) {
+    return FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+        message,
+        component: 'useExecutionResourceOperationContextBuilder',
+        ...context,
+    });
+}
+function hasOperationIdentifier(target) {
+    return 'operationIdentifier' in target;
+}
+function resolveExplicitOperationForTarget(resourceConfig, resourceType, target) {
+    const matchingOperations = (resourceConfig.operations ?? []).filter((candidate) => {
+        if (String(candidate.operationIdentifier) !== target.operationIdentifier) {
+            return false;
+        }
+        if (target.variantType !== undefined && candidate.variantType !== target.variantType) {
+            return false;
+        }
+        if (target.variantKey !== undefined && candidate.variantKey !== target.variantKey) {
+            return false;
+        }
+        if (target.isOperationDefault !== undefined && candidate.isOperationDefault !== target.isOperationDefault) {
+            return false;
+        }
+        if (target.isBulkOperation !== undefined && candidate.isBulkOperation !== target.isBulkOperation) {
+            return false;
+        }
+        return true;
+    });
+    if (matchingOperations.length === 1) {
+        return matchingOperations[0];
+    }
+    const defaultNonBulkOperations = matchingOperations.filter((candidate) => candidate.isOperationDefault === true && candidate.isBulkOperation !== true);
+    if (target.variantKey === undefined
+        && target.variantType === undefined
+        && target.isOperationDefault === undefined
+        && target.isBulkOperation === undefined
+        && defaultNonBulkOperations.length === 1) {
+        return defaultNonBulkOperations[0];
+    }
+    throw buildExecutionResourceOperationBuilderError(matchingOperations.length === 0
+        ? `Execution resource-operation builder cannot resolve operation "${target.operationIdentifier}" on resource "${resourceType}".`
+        : `Execution resource-operation builder found ambiguous operation "${target.operationIdentifier}" on resource "${resourceType}".`, {
+        resourceType,
+        operationIdentifier: target.operationIdentifier,
+        variantType: target.variantType,
+        variantKey: target.variantKey,
+        isOperationDefault: target.isOperationDefault,
+        isBulkOperation: target.isBulkOperation,
+        candidates: matchingOperations.map((candidate) => ({
+            variantType: candidate.variantType,
+            variantKey: candidate.variantKey,
+            isOperationDefault: candidate.isOperationDefault,
+            isBulkOperation: candidate.isBulkOperation,
+        })),
+    });
+}
+function resolveOperationForTarget(resourceConfig, resourceType, target, registry, contextResourceIdentifiers, contextualParameters) {
+    if (!resourceConfig) {
+        throw buildExecutionResourceOperationBuilderError(`Execution resource-operation builder cannot resolve resource "${resourceType}" from the registry.`, { resourceType });
+    }
+    if (hasOperationIdentifier(target)) {
+        const operation = resolveExplicitOperationForTarget(resourceConfig, resourceType, target);
+        const effectiveCoreOperation = resolveEffectiveCoreOperationFromOperation(operation);
+        const requiresRuntimeAddressability = effectiveCoreOperation === CoreResourceOperation.READ
+            || effectiveCoreOperation === CoreResourceOperation.UPDATE
+            || effectiveCoreOperation === CoreResourceOperation.DELETE;
+        if (requiresRuntimeAddressability
+            && operation.isBulkOperation !== true
+            && !isFrontendOperationAddressableForCurrentContext({
+                resourceConfig,
+                operation,
+                registry,
+                hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]) !== '',
+                contextResourceIdentifiers,
+                contextualParameters,
+            })) {
+            throw buildExecutionResourceOperationBuilderError(`Execution resource-operation builder resolved operation "${target.operationIdentifier}" on resource "${resourceType}", but the current context cannot address it.`, {
+                resourceType,
+                operationIdentifier: target.operationIdentifier,
+            });
+        }
+        return operation;
+    }
+    const requiresRuntimeAddressability = target.operationLike === CoreResourceOperation.READ
+        || target.operationLike === CoreResourceOperation.UPDATE
+        || target.operationLike === CoreResourceOperation.DELETE;
+    const semanticOperation = target.requireAddressable || requiresRuntimeAddressability
+        ? pickPreferredOperationForCoreSemanticAddressability({
+            resourceConfig,
+            operations: resourceConfig.operations ?? [],
+            coreOperation: target.operationLike,
+            registry,
+            hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]) !== '',
+            allowBulk: target.allowBulk,
+            requireFrontendAddressable: true,
+            contextResourceIdentifiers,
+            contextualParameters,
+        })
+        : pickPreferredOperationForCoreSemantic(resourceConfig.operations ?? [], target.operationLike, {
+            requireAddressable: target.requireAddressable,
+            allowBulk: target.allowBulk,
+        });
+    if (!semanticOperation) {
+        throw buildExecutionResourceOperationBuilderError(`Execution resource-operation builder cannot resolve a preferred ${String(target.operationLike)}-like operation on resource "${resourceType}".`, {
+            resourceType,
+            operationLike: target.operationLike,
+            requireAddressable: target.requireAddressable,
+            allowBulk: target.allowBulk,
+        });
+    }
+    return semanticOperation;
+}
+function overrideResourceContextSlot(params) {
+    const fieldIdentifier = params.currentValue
+        ? frontendResourceUtils.getFieldIdentifier(params.currentValue)
+        : undefined;
+    if (fieldIdentifier) {
+        return {
+            fieldIdentifier,
+            resourceId: params.resourceId,
+        };
+    }
+    return params.resourceId;
+}
+function getAdditionalContextCurrentObject(additionalContext) {
+    const currentObject = additionalContext?.currentObject ?? additionalContext?.resource;
+    return currentObject && typeof currentObject === 'object' && !Array.isArray(currentObject)
+        ? currentObject
+        : undefined;
+}
+function resolveAdditionalContextResourceId(params) {
+    const currentObject = getAdditionalContextCurrentObject(params.additionalContext);
+    const candidate = currentObject?._id
+        ?? (params.resourceConfig?.resourceFieldIdentifier
+            ? currentObject?.[params.resourceConfig.resourceFieldIdentifier]
+            : undefined);
+    return typeof candidate === 'string' && candidate.length > 0 ? candidate : undefined;
+}
+export function useExecutionResourceOperationContextBuilder() {
+    const { registry } = useResourceRegistry();
+    const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));
+    const buildResourceOperationContext = useCallback((target) => {
+        const participation = target.participationRef
+            ? executionRuntime.participations[target.participationRef]
+            : undefined;
+        if (target.participationRef && !participation) {
+            throw buildExecutionResourceOperationBuilderError(`Execution resource-operation builder cannot resolve participation "${target.participationRef}".`, {
+                participationRef: target.participationRef,
+            });
+        }
+        const resourceType = target.resourceType ?? (participation
+            ? getExecutionParticipationResourceType(participation)
+            : undefined);
+        if (!resourceType) {
+            throw buildExecutionResourceOperationBuilderError('Execution resource-operation builder requires either `resourceType` or `participationRef`.', {
+                target,
+            });
+        }
+        const contextResourceIdentifiers = {
+            ...(executionRuntime.contextResourceIdentifiers ?? {}),
+            ...(target.contextResourceIdentifiers ?? {}),
+        };
+        if (participation) {
+            const participationContextIdentifier = buildExecutionParticipationContextIdentifier({
+                participation,
+                registry,
+            });
+            if (!participationContextIdentifier && !target.resourceId) {
+                throw buildExecutionResourceOperationBuilderError(`Execution resource-operation builder cannot derive a concrete resource identifier from participation "${target.participationRef}".`, {
+                    participationRef: target.participationRef,
+                    resourceType,
+                });
+            }
+            if (participationContextIdentifier) {
+                contextResourceIdentifiers[resourceType] = participationContextIdentifier;
+            }
+        }
+        const resourceConfig = registry.resourceConfigurations[resourceType];
+        const additionalContextResourceId = resolveAdditionalContextResourceId({
+            additionalContext: target.additionalContext,
+            resourceConfig,
+        });
+        const resolvedResourceId = target.resourceId ?? additionalContextResourceId;
+        if (resolvedResourceId) {
+            contextResourceIdentifiers[resourceType] = overrideResourceContextSlot({
+                currentValue: contextResourceIdentifiers[resourceType],
+                resourceId: resolvedResourceId,
+            });
+        }
+        const contextualParameters = FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry);
+        const operation = resolveOperationForTarget(resourceConfig, resourceType, target, registry, contextResourceIdentifiers, contextualParameters);
+        const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(resourceType, contextResourceIdentifiers, registry, target.relationshipFieldOverrides);
+        return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+            resourceType: resourceType,
+            operation,
+            contextResourceIdentifiers,
+            additionalContext: target.additionalContext,
+            parentResourcesRequirements,
+        });
+    }, [
+        executionRuntime.contextResourceIdentifiers,
+        executionRuntime.participations,
+        registry,
+    ]);
+    return {
+        buildResourceOperationContext,
+    };
+}
+//# sourceMappingURL=useExecutionResourceOperationContextBuilder.js.map

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

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

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

@@ -0,0 +1,56 @@
+import { MutationPriority, MutationType, type RMMSnapshot } from '../../core/resources/rmm/types';
+import { UpdateLikeMutationFallbackMode } from '../../core/resources/rmm/update-like-mutation-fallback.frontend';
+import type { ResourceOperationSurface } from '../../core/resources/useResourceOperationSurface';
+import { ExecutionNavigationHandlingMode } from '../../core/config/execution-view.schemas';
+import { type NavigationInitiatorContext } from '../../core/navigation/navigation.schemas';
+import type { UseResourceRMMUnavailableReason } from '../../core/resources/rmm/useResourceRMM';
+import { type ExecutionParticipationHandle } from './execution-participation.utils';
+import { type ExecutionResourceOperationTarget } from './useExecutionResourceOperationContextBuilder';
+import { type UseExecutionParticipationRMMUnavailableReason, useExecutionParticipationRMM } from './useExecutionParticipationRMM';
+export interface ExecutionResourceOperationExecuteOptions {
+    mutationType?: MutationType;
+    mutationPriority?: MutationPriority;
+    subscriberId?: string;
+    readBackOnSuccess?: boolean;
+}
+export interface UseExecutionResourceOperationSurfaceParams {
+    target: ExecutionResourceOperationTarget;
+    navigationInitiator?: NavigationInitiatorContext;
+    updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;
+}
+export interface ExecutionResourceOperationSurface extends Omit<ResourceOperationSurface, 'navigateToResourceOperation' | 'navigateToPreferredRead'> {
+    target: ExecutionResourceOperationTarget;
+    participationHandle?: ExecutionParticipationHandle;
+    navigationHandlingMode: ExecutionNavigationHandlingMode;
+    rmm: ReturnType<typeof useExecutionParticipationRMM>['rmm'];
+    rmmSnapshot: RMMSnapshot;
+    rmmUnavailableReason: UseResourceRMMUnavailableReason | null;
+    executionRmmUnavailableReason: UseExecutionParticipationRMMUnavailableReason | null;
+    execute: (requestData?: Record<string, unknown>, options?: ExecutionResourceOperationExecuteOptions) => Promise<unknown>;
+    navigateToResourceOperation: ResourceOperationSurface['navigateToResourceOperation'];
+    navigateToPreferredRead: ResourceOperationSurface['navigateToPreferredRead'];
+}
+/**
+ * Execution-aware headless resource-operation surface.
+ *
+ * This composes three existing engine seams:
+ * - participation-aware execution context building
+ * - ordinary resource-operation surface semantics
+ * - thin execution-to-RMM handoff for concrete single-resource update-like lanes
+ *
+ * Important boundary:
+ * - routed/global navigation is still delegated back through execution
+ *   navigation mediation
+ * - update-like execution only uses RMM when the target resolves to one concrete
+ *   participation-backed lane
+ */
+export declare function useExecutionResourceOperationSurface({ target, navigationInitiator, updateLikeMutationFallbackMode, }: UseExecutionResourceOperationSurfaceParams): ExecutionResourceOperationSurface;
+export interface UseExecutionParticipationOperationSurfaceParams extends Omit<UseExecutionResourceOperationSurfaceParams, 'target'> {
+    participationRef: string;
+    target: Omit<ExecutionResourceOperationTarget, 'participationRef'>;
+}
+/**
+ * Participation-first convenience wrapper over `useExecutionResourceOperationSurface()`.
+ */
+export declare function useExecutionParticipationOperationSurface(params: UseExecutionParticipationOperationSurfaceParams): ExecutionResourceOperationSurface;
+//# sourceMappingURL=useExecutionResourceOperationSurface.d.ts.map

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

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

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

@@ -0,0 +1,262 @@
+import { useCallback, useContext, useMemo } from 'react';
+import { CoreResourceOperation, ErrorCustomMessageReference, ResourcesConfig_OperationPathUtils, ResourcesConfigOperationsUrlsBuilderUtils, } from '@wildo-ai/saas-models';
+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 { 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';
+import { ExecutionNavigationHandlingMode, resolveExecutionNavigationHandlingMode, } from '../../core/config/execution-view.schemas.js';
+import { NavigationContentType, } from '../../core/navigation/navigation.schemas.js';
+import { buildExecutionParticipationHandle, } from './execution-participation.utils.js';
+import { useExecutionResourceOperationContextBuilder, } from './useExecutionResourceOperationContextBuilder.js';
+import { useExecutionParticipationRMM, } from './useExecutionParticipationRMM.js';
+import { assertExecutionRuntimeContext, ExecutionRuntimeContext, } from './ExecutionRuntimeContext.js';
+/**
+ * Execution-aware headless resource-operation surface.
+ *
+ * This composes three existing engine seams:
+ * - participation-aware execution context building
+ * - ordinary resource-operation surface semantics
+ * - thin execution-to-RMM handoff for concrete single-resource update-like lanes
+ *
+ * Important boundary:
+ * - routed/global navigation is still delegated back through execution
+ *   navigation mediation
+ * - update-like execution only uses RMM when the target resolves to one concrete
+ *   participation-backed lane
+ */
+export function useExecutionResourceOperationSurface({ target, navigationInitiator, updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED, }) {
+    const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));
+    const executionNavigation = executionRuntime.navigation;
+    const { registry } = useResourceRegistry();
+    const { buildResourceOperationContext } = useExecutionResourceOperationContextBuilder();
+    const rawParticipation = target.participationRef
+        ? executionRuntime.participations[target.participationRef]
+        : undefined;
+    const participationHandle = useMemo(() => {
+        if (!rawParticipation) {
+            return undefined;
+        }
+        return buildExecutionParticipationHandle({
+            participation: rawParticipation,
+            registry,
+        });
+    }, [rawParticipation, registry]);
+    const resourceContext = useMemo(() => {
+        return buildResourceOperationContext(target);
+    }, [buildResourceOperationContext, target]);
+    const resourceSurface = useResourceOperationSurface({
+        resourceContext,
+        navigationZone: executionRuntime.navigationZone,
+        navigationInitiator,
+        updateLikeMutationFallbackMode,
+    });
+    const participationRmm = useExecutionParticipationRMM({
+        participationRef: target.participationRef ?? '',
+        resourceId: target.resourceId,
+        contextResourceIdentifiers: target.contextResourceIdentifiers,
+        relationshipFieldOverrides: target.relationshipFieldOverrides,
+        enabled: Boolean(target.participationRef) && isSingleResourceUpdateLikeOperation(resourceContext.operation),
+    });
+    const navigationHandlingMode = useMemo(() => resolveExecutionNavigationHandlingMode({
+        viewDefinition: executionRuntime.viewDefinition,
+        resourceType: resourceSurface.resourceType,
+        operation: resourceSurface.operation,
+    }), [
+        executionRuntime.viewDefinition,
+        resourceSurface.operation,
+        resourceSurface.resourceType,
+    ]);
+    const buildDelegatedUrlPath = useCallback((operation, contextResourceIdentifiers = resourceContext.contextResourceIdentifiers, parentResourcesRequirements = resourceContext.parentResourcesRequirements) => {
+        if (!resourceSurface.resourceConfig) {
+            return undefined;
+        }
+        const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(resourceSurface.resourceConfig, operation, registry.allResourceFieldIdentifiers);
+        if (routePaths.length === 0) {
+            return undefined;
+        }
+        return frontendResourceUtils.selectMatchingRoutePath(routePaths, contextResourceIdentifiers, resourceSurface.resourceType, resourceSurface.resourceConfig.resourceFieldIdentifier, parentResourcesRequirements).url;
+    }, [
+        registry.allResourceFieldIdentifiers,
+        resourceContext.contextResourceIdentifiers,
+        resourceContext.parentResourcesRequirements,
+        resourceSurface.resourceConfig,
+        resourceSurface.resourceType,
+    ]);
+    const navigateToResourceOperation = useCallback(({ operation, contextResourceIdentifiers = resourceContext.contextResourceIdentifiers, parentResourcesRequirements = resourceContext.parentResourcesRequirements, initiatorOverride, }) => {
+        if (!resourceSurface.resourceConfig) {
+            return false;
+        }
+        const contextualParameters = FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry);
+        const requiresAddressability = shouldRequireCurrentContextAddressabilityForOperation({
+            operation,
+            resourceType: resourceSurface.resourceType,
+            resourceConfig: resourceSurface.resourceConfig,
+        });
+        if (requiresAddressability
+            && operation.isBulkOperation !== true
+            && !isFrontendOperationAddressableForCurrentContext({
+                resourceConfig: resourceSurface.resourceConfig,
+                operation,
+                registry,
+                hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,
+                contextResourceIdentifiers,
+                contextualParameters,
+            })) {
+            return false;
+        }
+        const targetContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+            resourceType: resourceSurface.resourceType,
+            operation,
+            contextResourceIdentifiers,
+            parentResourcesRequirements,
+        });
+        const delegatedUrlPath = buildDelegatedUrlPath(operation, contextResourceIdentifiers, parentResourcesRequirements);
+        if (navigationHandlingMode === ExecutionNavigationHandlingMode.EMBED_LOCALLY) {
+            executionNavigation.openEmbeddedContent({
+                content: {
+                    contentType: NavigationContentType.RESOURCE_OPERATION,
+                    resourceContext: targetContext,
+                },
+                navigationInitiator: initiatorOverride ?? resourceSurface.operationInitiator,
+            });
+            return true;
+        }
+        const fallbackInitiator = resourceSurface.operationInitiator;
+        const { sourceZone: _ignoredSourceZone, ...defaultInitiator } = fallbackInitiator;
+        executionNavigation.delegateToParent({
+            content: {
+                contentType: NavigationContentType.RESOURCE_OPERATION,
+                resourceContext: targetContext,
+            },
+            urlPath: delegatedUrlPath,
+            initiator: initiatorOverride ?? defaultInitiator,
+        });
+        return true;
+    }, [
+        buildDelegatedUrlPath,
+        executionNavigation,
+        resourceContext.contextResourceIdentifiers,
+        resourceContext.parentResourcesRequirements,
+        navigationHandlingMode,
+        registry,
+        resourceSurface.operationInitiator,
+        resourceSurface.resourceConfig,
+        resourceSurface.resourceType,
+    ]);
+    const navigateToPreferredRead = useCallback((options) => {
+        const readOperation = resourceSurface.resolvePreferredOperation(CoreResourceOperation.READ, { requireAddressable: true });
+        if (!readOperation) {
+            if (options?.fallbackToGoBack !== false) {
+                resourceSurface.goBackWithinZone();
+            }
+            return false;
+        }
+        return navigateToResourceOperation({
+            operation: readOperation,
+            contextResourceIdentifiers: options?.contextResourceIdentifiers ?? resourceContext.contextResourceIdentifiers,
+            parentResourcesRequirements: options?.parentResourcesRequirements ?? resourceContext.parentResourcesRequirements,
+            initiatorOverride: options?.initiatorOverride,
+        });
+    }, [
+        navigateToResourceOperation,
+        resourceContext.contextResourceIdentifiers,
+        resourceContext.parentResourcesRequirements,
+        resourceSurface,
+    ]);
+    const execute = useCallback(async (requestData, options) => {
+        const requiresAddressability = resourceSurface.resourceConfig
+            ? shouldRequireCurrentContextAddressabilityForOperation({
+                operation: resourceContext.operation,
+                resourceType: resourceSurface.resourceType,
+                resourceConfig: resourceSurface.resourceConfig,
+            })
+            : false;
+        if (requiresAddressability
+            && resourceContext.operation.isBulkOperation !== true
+            && resourceSurface.resourceConfig
+            && !isFrontendOperationAddressableForCurrentContext({
+                resourceConfig: resourceSurface.resourceConfig,
+                operation: resourceContext.operation,
+                registry,
+                hasResourceId: frontendResourceUtils.getResourceId(resourceContext.contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,
+                contextResourceIdentifiers: resourceContext.contextResourceIdentifiers,
+                contextualParameters: resourceSurface.contextualParameters,
+            })) {
+            throw FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+                message: `Execution resource operation "${resourceSurface.operationId}" is not addressable in the current context.`,
+                component: 'useExecutionResourceOperationSurface',
+                resourceType: resourceSurface.resourceType,
+                operationIdentifier: String(resourceContext.operation.operationIdentifier),
+            });
+        }
+        if (isSingleResourceUpdateLikeOperation(resourceContext.operation) && participationRmm.rmm) {
+            const effectiveRequestData = mergeBulkSelectionIntoRequestData({
+                operation: resourceContext.operation,
+                requestData,
+                additionalContext: resourceContext.additionalContext,
+            });
+            const mutationResult = await participationRmm.rmm.queueMutation(effectiveRequestData ?? {}, {
+                type: options?.mutationType ?? MutationType.CUSTOM,
+                priority: options?.mutationPriority ?? MutationPriority.NORMAL,
+                source: {
+                    type: MutationSourceType.ORCHESTRATOR,
+                    subscriberId: options?.subscriberId
+                        ?? `execution-surface:${resourceSurface.resourceType}:${resourceSurface.operationId}`,
+                },
+                transportOverride: {
+                    operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(resourceContext.operation),
+                    contextualParameters: resourceSurface.contextualParameters,
+                    parentResourcesRequirements: resourceContext.parentResourcesRequirements,
+                    requestData: effectiveRequestData ?? {},
+                    readBackOnSuccess: options?.readBackOnSuccess ?? true,
+                },
+            });
+            if (!mutationResult.success) {
+                throw new Error(mutationResult.error?.message
+                    ?? `Execution resource operation "${resourceSurface.operationId}" failed.`);
+            }
+            return mutationResult.responseData;
+        }
+        return resourceSurface.executeCurrentOperation(requestData);
+    }, [
+        participationRmm.rmm,
+        resourceContext.additionalContext,
+        resourceContext.operation,
+        resourceContext.parentResourcesRequirements,
+        registry,
+        resourceSurface,
+    ]);
+    return {
+        ...resourceSurface,
+        target,
+        participationHandle: target.participationRef ? participationHandle : undefined,
+        navigationHandlingMode,
+        rmm: participationRmm.rmm,
+        rmmSnapshot: participationRmm.rmmSnapshot,
+        rmmUnavailableReason: participationRmm.rmmUnavailableReason,
+        executionRmmUnavailableReason: target.participationRef
+            ? participationRmm.executionUnavailableReason
+            : null,
+        execute,
+        navigateToResourceOperation,
+        navigateToPreferredRead,
+    };
+}
+/**
+ * Participation-first convenience wrapper over `useExecutionResourceOperationSurface()`.
+ */
+export function useExecutionParticipationOperationSurface(params) {
+    const target = useMemo(() => ({
+        ...params.target,
+        participationRef: params.participationRef,
+    }), [params.participationRef, params.target]);
+    return useExecutionResourceOperationSurface({
+        target,
+        navigationInitiator: params.navigationInitiator,
+        updateLikeMutationFallbackMode: params.updateLikeMutationFallbackMode,
+    });
+}
+//# sourceMappingURL=useExecutionResourceOperationSurface.js.map