@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

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

@@ -1 +1 @@
-{"version":3,"file":"useExecutionResourceOperationSurface.js","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionResourceOperationSurface.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext, useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  ErrorCustomMessageReference,\n  ResourcesConfig_OperationPathUtils,\n  ResourcesConfigOperationsUrlsBuilderUtils,\n} from '@wildo-ai/saas-models';\n\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  mergeBulkSelectionIntoRequestData,\n  isSingleResourceUpdateLikeOperation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n  isFrontendOperationAddressableForCurrentContext,\n  shouldRequireCurrentContextAddressabilityForOperation,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport {\n  MutationErrorType,\n  MutationPriority,\n  MutationSourceType,\n  MutationType,\n  type RMMSnapshot,\n} from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  allowsDirectOperationFallback,\n  resolveDeclaredUpdateLikeMutationFallbackMode,\n  type UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport type {\n  ResourceOperationSurface,\n  UseResourceOperationSurfaceParams,\n} from '~wildo-frontend-lib/core/resources/useResourceOperationSurface';\nimport { useResourceOperationSurface } from '~wildo-frontend-lib/core/resources/useResourceOperationSurface';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n  ExecutionNavigationHandlingMode,\n  resolveExecutionNavigationHandlingMode,\n} from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport {\n  NavigationContentType,\n  type NavigationInitiatorContext,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { UseResourceRMMUnavailableReason } from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport {\n  buildExecutionParticipationHandle,\n  type ExecutionParticipationHandle,\n} from './execution-participation.utils';\nimport {\n  type ExecutionResourceOperationTarget,\n  useExecutionResourceOperationContextBuilder,\n} from './useExecutionResourceOperationContextBuilder';\nimport {\n  type UseExecutionParticipationRMMUnavailableReason,\n  useExecutionParticipationRMM,\n} from './useExecutionParticipationRMM';\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\n\nexport interface ExecutionResourceOperationExecuteOptions {\n  mutationType?: MutationType;\n  mutationPriority?: MutationPriority;\n  subscriberId?: string;\n  readBackOnSuccess?: boolean;\n}\n\nexport interface UseExecutionResourceOperationSurfaceParams {\n  target: ExecutionResourceOperationTarget;\n  navigationInitiator?: NavigationInitiatorContext;\n  updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n}\n\nexport interface ExecutionResourceOperationSurface extends Omit<\n  ResourceOperationSurface,\n  'navigateToResourceOperation' | 'navigateToPreferredRead'\n> {\n  target: ExecutionResourceOperationTarget;\n  participationHandle?: ExecutionParticipationHandle;\n  navigationHandlingMode: ExecutionNavigationHandlingMode;\n  rmm: ReturnType<typeof useExecutionParticipationRMM>['rmm'];\n  rmmSnapshot: RMMSnapshot;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  executionRmmUnavailableReason: UseExecutionParticipationRMMUnavailableReason | null;\n  execute: (\n    requestData?: Record<string, unknown>,\n    options?: ExecutionResourceOperationExecuteOptions,\n  ) => Promise<unknown>;\n  navigateToResourceOperation: ResourceOperationSurface['navigateToResourceOperation'];\n  navigateToPreferredRead: ResourceOperationSurface['navigateToPreferredRead'];\n}\n\n/**\n * Execution-aware headless resource-operation surface.\n *\n * This composes three existing engine seams:\n * - participation-aware execution context building\n * - ordinary resource-operation surface semantics\n * - thin execution-to-RMM handoff for concrete single-resource update-like lanes\n *\n * Important boundary:\n * - routed/global navigation is still delegated back through execution\n *   navigation mediation\n * - update-like execution only uses RMM when the target resolves to one concrete\n *   participation-backed lane\n */\nexport function useExecutionResourceOperationSurface({\n  target,\n  navigationInitiator,\n  /* Omitted, the resource surface applies the lane the operation declared (RMM_REQUIRED unless it said otherwise). */\n  updateLikeMutationFallbackMode,\n}: UseExecutionResourceOperationSurfaceParams): ExecutionResourceOperationSurface {\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n  const executionNavigation = executionRuntime.navigation;\n  const { registry } = useResourceRegistry();\n  const { buildResourceOperationContext } = useExecutionResourceOperationContextBuilder();\n\n  const rawParticipation = target.participationRef\n    ? executionRuntime.participations[target.participationRef]\n    : undefined;\n  const participationHandle = useMemo<ExecutionParticipationHandle | undefined>(() => {\n    if (!rawParticipation) {\n      return undefined;\n    }\n\n    return buildExecutionParticipationHandle({\n      participation: rawParticipation,\n      registry,\n    });\n  }, [rawParticipation, registry]);\n\n  const resourceContext = useMemo(() => {\n    return buildResourceOperationContext(target);\n  }, [buildResourceOperationContext, target]);\n\n  const resourceSurface = useResourceOperationSurface({\n    resourceContext,\n    navigationZone: executionRuntime.navigationZone,\n    navigationInitiator,\n    updateLikeMutationFallbackMode,\n  } satisfies UseResourceOperationSurfaceParams);\n\n  const participationRmm = useExecutionParticipationRMM({\n    participationRef: target.participationRef ?? '',\n    resourceId: target.resourceId,\n    contextResourceIdentifiers: target.contextResourceIdentifiers,\n    relationshipFieldOverrides: target.relationshipFieldOverrides,\n    enabled: Boolean(target.participationRef) && isSingleResourceUpdateLikeOperation(resourceContext.operation),\n    directFallbackAccepted: allowsDirectOperationFallback(\n      updateLikeMutationFallbackMode ?? resolveDeclaredUpdateLikeMutationFallbackMode(resourceContext.operation),\n    ),\n  });\n  const navigationHandlingMode = useMemo(() => resolveExecutionNavigationHandlingMode({\n    viewDefinition: executionRuntime.viewDefinition,\n    resourceType: resourceSurface.resourceType,\n    operation: resourceSurface.operation,\n  }), [\n    executionRuntime.viewDefinition,\n    resourceSurface.operation,\n    resourceSurface.resourceType,\n  ]);\n\n  const buildDelegatedUrlPath = useCallback((\n    operation: FrontendResourceConfiguration_Operation,\n    contextResourceIdentifiers = resourceContext.contextResourceIdentifiers,\n    parentResourcesRequirements = resourceContext.parentResourcesRequirements,\n  ): string | undefined => {\n    if (!resourceSurface.resourceConfig) {\n      return undefined;\n    }\n\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceSurface.resourceConfig,\n      operation,\n      registry.allResourceFieldIdentifiers,\n    );\n\n    if (routePaths.length === 0) {\n      return undefined;\n    }\n\n    return frontendResourceUtils.selectMatchingRoutePath(\n      routePaths,\n      contextResourceIdentifiers,\n      resourceSurface.resourceType,\n      resourceSurface.resourceConfig.resourceFieldIdentifier,\n      parentResourcesRequirements,\n    ).url;\n  }, [\n    registry.allResourceFieldIdentifiers,\n    resourceContext.contextResourceIdentifiers,\n    resourceContext.parentResourcesRequirements,\n    resourceSurface.resourceConfig,\n    resourceSurface.resourceType,\n  ]);\n\n  const navigateToResourceOperation = useCallback<ExecutionResourceOperationSurface['navigateToResourceOperation']>(({\n    operation,\n    contextResourceIdentifiers = resourceContext.contextResourceIdentifiers,\n    parentResourcesRequirements = resourceContext.parentResourcesRequirements,\n    initiatorOverride,\n  }) => {\n    if (!resourceSurface.resourceConfig) {\n      return false;\n    }\n\n    const contextualParameters = FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiers,\n      registry,\n    );\n    const requiresAddressability = shouldRequireCurrentContextAddressabilityForOperation({\n      operation,\n      resourceType: resourceSurface.resourceType,\n      resourceConfig: resourceSurface.resourceConfig,\n    });\n    if (\n      requiresAddressability\n      && operation.isBulkOperation !== true\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig: resourceSurface.resourceConfig,\n        operation,\n        registry,\n        hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,\n        contextResourceIdentifiers,\n        contextualParameters,\n      })\n    ) {\n      return false;\n    }\n\n    const targetContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType: resourceSurface.resourceType,\n      operation,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n    });\n\n    const delegatedUrlPath = buildDelegatedUrlPath(\n      operation,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n    );\n    if (navigationHandlingMode === ExecutionNavigationHandlingMode.EMBED_LOCALLY) {\n      executionNavigation.openEmbeddedContent({\n        content: {\n          contentType: NavigationContentType.RESOURCE_OPERATION,\n          resourceContext: targetContext,\n        },\n        navigationInitiator: initiatorOverride ?? resourceSurface.operationInitiator,\n      });\n\n      return true;\n    }\n\n    const fallbackInitiator = resourceSurface.operationInitiator;\n    const { sourceZone: _ignoredSourceZone, ...defaultInitiator } = fallbackInitiator;\n\n    executionNavigation.delegateToParent({\n      content: {\n        contentType: NavigationContentType.RESOURCE_OPERATION,\n        resourceContext: targetContext,\n      },\n      urlPath: delegatedUrlPath,\n      initiator: initiatorOverride ?? defaultInitiator,\n    });\n\n    return true;\n  }, [\n    buildDelegatedUrlPath,\n    executionNavigation,\n    resourceContext.contextResourceIdentifiers,\n    resourceContext.parentResourcesRequirements,\n    navigationHandlingMode,\n    registry,\n    resourceSurface.operationInitiator,\n    resourceSurface.resourceConfig,\n    resourceSurface.resourceType,\n  ]);\n\n  const navigateToPreferredRead = useCallback<ExecutionResourceOperationSurface['navigateToPreferredRead']>((options) => {\n    const readOperation = resourceSurface.resolvePreferredOperation(\n      CoreResourceOperation.READ,\n      { requireAddressable: true },\n    );\n\n    if (!readOperation) {\n      if (options?.fallbackToGoBack !== false) {\n        resourceSurface.goBackWithinZone();\n      }\n      return false;\n    }\n\n    return navigateToResourceOperation({\n      operation: readOperation,\n      contextResourceIdentifiers: options?.contextResourceIdentifiers ?? resourceContext.contextResourceIdentifiers,\n      parentResourcesRequirements: options?.parentResourcesRequirements ?? resourceContext.parentResourcesRequirements,\n      initiatorOverride: options?.initiatorOverride,\n    });\n  }, [\n    navigateToResourceOperation,\n    resourceContext.contextResourceIdentifiers,\n    resourceContext.parentResourcesRequirements,\n    resourceSurface,\n  ]);\n\n  const execute = useCallback<ExecutionResourceOperationSurface['execute']>(async (requestData, options) => {\n    const requiresAddressability = resourceSurface.resourceConfig\n      ? shouldRequireCurrentContextAddressabilityForOperation({\n        operation: resourceContext.operation,\n        resourceType: resourceSurface.resourceType,\n        resourceConfig: resourceSurface.resourceConfig,\n      })\n      : false;\n    if (\n      requiresAddressability\n      && resourceContext.operation.isBulkOperation !== true\n      && resourceSurface.resourceConfig\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig: resourceSurface.resourceConfig,\n        operation: resourceContext.operation,\n        registry,\n        hasResourceId: frontendResourceUtils.getResourceId(resourceContext.contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,\n        contextResourceIdentifiers: resourceContext.contextResourceIdentifiers,\n        contextualParameters: resourceSurface.contextualParameters,\n      })\n    ) {\n      throw FrontendResourceUtils.buildConfigurationError(\n        ErrorCustomMessageReference.CONFIGURATION,\n        {\n          message: `Execution resource operation \"${resourceSurface.operationId}\" is not addressable in the current context.`,\n          component: 'useExecutionResourceOperationSurface',\n          resourceType: resourceSurface.resourceType,\n          operationIdentifier: String(resourceContext.operation.operationIdentifier),\n        },\n      );\n    }\n\n    if (isSingleResourceUpdateLikeOperation(resourceContext.operation) && participationRmm.rmm) {\n      const effectiveRequestData = mergeBulkSelectionIntoRequestData({\n        operation: resourceContext.operation,\n        requestData,\n        additionalContext: resourceContext.additionalContext,\n      });\n      const mutationResult = await participationRmm.rmm.queueMutation(\n        effectiveRequestData ?? {},\n        {\n          type: options?.mutationType ?? MutationType.CUSTOM,\n          priority: options?.mutationPriority ?? MutationPriority.NORMAL,\n          source: {\n            type: MutationSourceType.ORCHESTRATOR,\n            subscriberId: options?.subscriberId\n              ?? `execution-surface:${resourceSurface.resourceType}:${resourceSurface.operationId}`,\n          },\n          transportOverride: {\n            operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(\n              resourceContext.operation,\n            ),\n            contextualParameters: resourceSurface.contextualParameters,\n            parentResourcesRequirements: resourceContext.parentResourcesRequirements,\n            requestData: effectiveRequestData ?? {},\n            readBackOnSuccess: options?.readBackOnSuccess ?? true,\n          },\n        },\n      );\n\n      if (!mutationResult.success) {\n        // Rethrow the transport failure itself: it carries the backend reference, type and guidance that\n        // `useUserFacingErrorMessage()` turns into the application's words. An `Error` rebuilt from its message\n        // keeps only the text, which is never shown, so the failure could only read as generic (#1182).\n        // A cancellation keeps its previous shape.\n        if (mutationResult.error?.cause !== undefined && mutationResult.error.type !== MutationErrorType.ABORT) {\n          throw mutationResult.error.cause;\n        }\n        throw new Error(\n          mutationResult.error?.message\n          ?? `Execution resource operation \"${resourceSurface.operationId}\" failed.`,\n        );\n      }\n\n      return mutationResult.responseData;\n    }\n\n    return resourceSurface.executeCurrentOperation(requestData);\n  }, [\n    participationRmm.rmm,\n    resourceContext.additionalContext,\n    resourceContext.operation,\n    resourceContext.parentResourcesRequirements,\n    registry,\n    resourceSurface,\n  ]);\n\n  return {\n    ...resourceSurface,\n    target,\n    participationHandle: target.participationRef ? participationHandle : undefined,\n    navigationHandlingMode,\n    rmm: participationRmm.rmm,\n    rmmSnapshot: participationRmm.rmmSnapshot,\n    rmmUnavailableReason: participationRmm.rmmUnavailableReason,\n    executionRmmUnavailableReason: target.participationRef\n      ? participationRmm.executionUnavailableReason\n      : null,\n    execute,\n    navigateToResourceOperation,\n    navigateToPreferredRead,\n  };\n}\n\nexport interface UseExecutionParticipationOperationSurfaceParams extends Omit<\n  UseExecutionResourceOperationSurfaceParams,\n  'target'\n> {\n  participationRef: string;\n  target: Omit<ExecutionResourceOperationTarget, 'participationRef'>;\n}\n\n/**\n * Participation-first convenience wrapper over `useExecutionResourceOperationSurface()`.\n */\nexport function useExecutionParticipationOperationSurface(\n  params: UseExecutionParticipationOperationSurfaceParams,\n): ExecutionResourceOperationSurface {\n  const target = useMemo<ExecutionResourceOperationTarget>(() => ({\n    ...params.target,\n    participationRef: params.participationRef,\n  } as ExecutionResourceOperationTarget), [params.participationRef, params.target]);\n\n  return useExecutionResourceOperationSurface({\n    target,\n    navigationInitiator: params.navigationInitiator,\n    updateLikeMutationFallbackMode: params.updateLikeMutationFallbackMode,\n  });\n}\n"]}
+{"version":3,"file":"useExecutionResourceOperationSurface.js","sourceRoot":"","sources":["../../../../../src/core/execution/useExecutionResourceOperationSurface.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext, useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  ErrorCustomMessageReference,\n  ResourcesConfig_OperationPathUtils,\n  ResourcesConfigOperationsUrlsBuilderUtils,\n} from '@wildo-ai/saas-models';\n\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  mergeBulkSelectionIntoRequestData,\n  isSingleResourceUpdateLikeOperation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n  isFrontendOperationAddressableForCurrentContext,\n  shouldRequireCurrentContextAddressabilityForOperation,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport {\n  MutationErrorType,\n  MutationPriority,\n  MutationSourceType,\n  MutationType,\n  type RMMSnapshot,\n} from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  allowsDirectOperationFallback,\n  resolveUpdateLikeMutationFallbackMode,\n  type UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport type {\n  ResourceOperationSurface,\n  UseResourceOperationSurfaceParams,\n} from '~wildo-frontend-lib/core/resources/useResourceOperationSurface';\nimport { useResourceOperationSurface } from '~wildo-frontend-lib/core/resources/useResourceOperationSurface';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n  ExecutionNavigationHandlingMode,\n  resolveExecutionNavigationHandlingMode,\n} from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport {\n  NavigationContentType,\n  type NavigationInitiatorContext,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { UseResourceRMMUnavailableReason } from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport {\n  buildExecutionParticipationHandle,\n  type ExecutionParticipationHandle,\n} from './execution-participation.utils';\nimport {\n  type ExecutionResourceOperationTarget,\n  useExecutionResourceOperationContextBuilder,\n} from './useExecutionResourceOperationContextBuilder';\nimport {\n  type UseExecutionParticipationRMMUnavailableReason,\n  useExecutionParticipationRMM,\n} from './useExecutionParticipationRMM';\nimport {\n  assertExecutionRuntimeContext,\n  ExecutionRuntimeContext,\n} from './ExecutionRuntimeContext';\n\nexport interface ExecutionResourceOperationExecuteOptions {\n  mutationType?: MutationType;\n  mutationPriority?: MutationPriority;\n  subscriberId?: string;\n  readBackOnSuccess?: boolean;\n}\n\nexport interface UseExecutionResourceOperationSurfaceParams {\n  target: ExecutionResourceOperationTarget;\n  navigationInitiator?: NavigationInitiatorContext;\n  updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n}\n\nexport interface ExecutionResourceOperationSurface extends Omit<\n  ResourceOperationSurface,\n  'navigateToResourceOperation' | 'navigateToPreferredRead'\n> {\n  target: ExecutionResourceOperationTarget;\n  participationHandle?: ExecutionParticipationHandle;\n  navigationHandlingMode: ExecutionNavigationHandlingMode;\n  rmm: ReturnType<typeof useExecutionParticipationRMM>['rmm'];\n  rmmSnapshot: RMMSnapshot;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  executionRmmUnavailableReason: UseExecutionParticipationRMMUnavailableReason | null;\n  execute: (\n    requestData?: Record<string, unknown>,\n    options?: ExecutionResourceOperationExecuteOptions,\n  ) => Promise<unknown>;\n  navigateToResourceOperation: ResourceOperationSurface['navigateToResourceOperation'];\n  navigateToPreferredRead: ResourceOperationSurface['navigateToPreferredRead'];\n}\n\n/**\n * Execution-aware headless resource-operation surface.\n *\n * This composes three existing engine seams:\n * - participation-aware execution context building\n * - ordinary resource-operation surface semantics\n * - thin execution-to-RMM handoff for concrete single-resource update-like lanes\n *\n * Important boundary:\n * - routed/global navigation is still delegated back through execution\n *   navigation mediation\n * - update-like execution only uses RMM when the target resolves to one concrete\n *   participation-backed lane\n */\nexport function useExecutionResourceOperationSurface({\n  target,\n  navigationInitiator,\n  /* Omitted, the resource surface applies `resolveUpdateLikeMutationFallbackMode`'s lane (declared, else derived from the resource). */\n  updateLikeMutationFallbackMode,\n}: UseExecutionResourceOperationSurfaceParams): ExecutionResourceOperationSurface {\n  const executionRuntime = assertExecutionRuntimeContext(useContext(ExecutionRuntimeContext));\n  const executionNavigation = executionRuntime.navigation;\n  const { registry } = useResourceRegistry();\n  const { buildResourceOperationContext } = useExecutionResourceOperationContextBuilder();\n\n  const rawParticipation = target.participationRef\n    ? executionRuntime.participations[target.participationRef]\n    : undefined;\n  const participationHandle = useMemo<ExecutionParticipationHandle | undefined>(() => {\n    if (!rawParticipation) {\n      return undefined;\n    }\n\n    return buildExecutionParticipationHandle({\n      participation: rawParticipation,\n      registry,\n    });\n  }, [rawParticipation, registry]);\n\n  const resourceContext = useMemo(() => {\n    return buildResourceOperationContext(target);\n  }, [buildResourceOperationContext, target]);\n\n  const resourceSurface = useResourceOperationSurface({\n    resourceContext,\n    navigationZone: executionRuntime.navigationZone,\n    navigationInitiator,\n    updateLikeMutationFallbackMode,\n  } satisfies UseResourceOperationSurfaceParams);\n\n  const participationRmm = useExecutionParticipationRMM({\n    participationRef: target.participationRef ?? '',\n    resourceId: target.resourceId,\n    contextResourceIdentifiers: target.contextResourceIdentifiers,\n    relationshipFieldOverrides: target.relationshipFieldOverrides,\n    enabled: Boolean(target.participationRef) && isSingleResourceUpdateLikeOperation(resourceContext.operation),\n    directFallbackAccepted: allowsDirectOperationFallback(\n      updateLikeMutationFallbackMode ?? resolveUpdateLikeMutationFallbackMode(\n        resourceContext.operation,\n        registry.resourceConfigurations[resourceContext.resourceType]?.operations,\n      ),\n    ),\n  });\n  const navigationHandlingMode = useMemo(() => resolveExecutionNavigationHandlingMode({\n    viewDefinition: executionRuntime.viewDefinition,\n    resourceType: resourceSurface.resourceType,\n    operation: resourceSurface.operation,\n  }), [\n    executionRuntime.viewDefinition,\n    resourceSurface.operation,\n    resourceSurface.resourceType,\n  ]);\n\n  const buildDelegatedUrlPath = useCallback((\n    operation: FrontendResourceConfiguration_Operation,\n    contextResourceIdentifiers = resourceContext.contextResourceIdentifiers,\n    parentResourcesRequirements = resourceContext.parentResourcesRequirements,\n  ): string | undefined => {\n    if (!resourceSurface.resourceConfig) {\n      return undefined;\n    }\n\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceSurface.resourceConfig,\n      operation,\n      registry.allResourceFieldIdentifiers,\n    );\n\n    if (routePaths.length === 0) {\n      return undefined;\n    }\n\n    return frontendResourceUtils.selectMatchingRoutePath(\n      routePaths,\n      contextResourceIdentifiers,\n      resourceSurface.resourceType,\n      resourceSurface.resourceConfig.resourceFieldIdentifier,\n      parentResourcesRequirements,\n    ).url;\n  }, [\n    registry.allResourceFieldIdentifiers,\n    resourceContext.contextResourceIdentifiers,\n    resourceContext.parentResourcesRequirements,\n    resourceSurface.resourceConfig,\n    resourceSurface.resourceType,\n  ]);\n\n  const navigateToResourceOperation = useCallback<ExecutionResourceOperationSurface['navigateToResourceOperation']>(({\n    operation,\n    contextResourceIdentifiers = resourceContext.contextResourceIdentifiers,\n    parentResourcesRequirements = resourceContext.parentResourcesRequirements,\n    initiatorOverride,\n  }) => {\n    if (!resourceSurface.resourceConfig) {\n      return false;\n    }\n\n    const contextualParameters = FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiers,\n      registry,\n    );\n    const requiresAddressability = shouldRequireCurrentContextAddressabilityForOperation({\n      operation,\n      resourceType: resourceSurface.resourceType,\n      resourceConfig: resourceSurface.resourceConfig,\n    });\n    if (\n      requiresAddressability\n      && operation.isBulkOperation !== true\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig: resourceSurface.resourceConfig,\n        operation,\n        registry,\n        hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,\n        contextResourceIdentifiers,\n        contextualParameters,\n      })\n    ) {\n      return false;\n    }\n\n    const targetContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType: resourceSurface.resourceType,\n      operation,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n    });\n\n    const delegatedUrlPath = buildDelegatedUrlPath(\n      operation,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n    );\n    if (navigationHandlingMode === ExecutionNavigationHandlingMode.EMBED_LOCALLY) {\n      executionNavigation.openEmbeddedContent({\n        content: {\n          contentType: NavigationContentType.RESOURCE_OPERATION,\n          resourceContext: targetContext,\n        },\n        navigationInitiator: initiatorOverride ?? resourceSurface.operationInitiator,\n      });\n\n      return true;\n    }\n\n    const fallbackInitiator = resourceSurface.operationInitiator;\n    const { sourceZone: _ignoredSourceZone, ...defaultInitiator } = fallbackInitiator;\n\n    executionNavigation.delegateToParent({\n      content: {\n        contentType: NavigationContentType.RESOURCE_OPERATION,\n        resourceContext: targetContext,\n      },\n      urlPath: delegatedUrlPath,\n      initiator: initiatorOverride ?? defaultInitiator,\n    });\n\n    return true;\n  }, [\n    buildDelegatedUrlPath,\n    executionNavigation,\n    resourceContext.contextResourceIdentifiers,\n    resourceContext.parentResourcesRequirements,\n    navigationHandlingMode,\n    registry,\n    resourceSurface.operationInitiator,\n    resourceSurface.resourceConfig,\n    resourceSurface.resourceType,\n  ]);\n\n  const navigateToPreferredRead = useCallback<ExecutionResourceOperationSurface['navigateToPreferredRead']>((options) => {\n    const readOperation = resourceSurface.resolvePreferredOperation(\n      CoreResourceOperation.READ,\n      { requireAddressable: true },\n    );\n\n    if (!readOperation) {\n      if (options?.fallbackToGoBack !== false) {\n        resourceSurface.goBackWithinZone();\n      }\n      return false;\n    }\n\n    return navigateToResourceOperation({\n      operation: readOperation,\n      contextResourceIdentifiers: options?.contextResourceIdentifiers ?? resourceContext.contextResourceIdentifiers,\n      parentResourcesRequirements: options?.parentResourcesRequirements ?? resourceContext.parentResourcesRequirements,\n      initiatorOverride: options?.initiatorOverride,\n    });\n  }, [\n    navigateToResourceOperation,\n    resourceContext.contextResourceIdentifiers,\n    resourceContext.parentResourcesRequirements,\n    resourceSurface,\n  ]);\n\n  const execute = useCallback<ExecutionResourceOperationSurface['execute']>(async (requestData, options) => {\n    const requiresAddressability = resourceSurface.resourceConfig\n      ? shouldRequireCurrentContextAddressabilityForOperation({\n        operation: resourceContext.operation,\n        resourceType: resourceSurface.resourceType,\n        resourceConfig: resourceSurface.resourceConfig,\n      })\n      : false;\n    if (\n      requiresAddressability\n      && resourceContext.operation.isBulkOperation !== true\n      && resourceSurface.resourceConfig\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig: resourceSurface.resourceConfig,\n        operation: resourceContext.operation,\n        registry,\n        hasResourceId: frontendResourceUtils.getResourceId(resourceContext.contextResourceIdentifiers[resourceSurface.resourceType]).length > 0,\n        contextResourceIdentifiers: resourceContext.contextResourceIdentifiers,\n        contextualParameters: resourceSurface.contextualParameters,\n      })\n    ) {\n      throw FrontendResourceUtils.buildConfigurationError(\n        ErrorCustomMessageReference.CONFIGURATION,\n        {\n          message: `Execution resource operation \"${resourceSurface.operationId}\" is not addressable in the current context.`,\n          component: 'useExecutionResourceOperationSurface',\n          resourceType: resourceSurface.resourceType,\n          operationIdentifier: String(resourceContext.operation.operationIdentifier),\n        },\n      );\n    }\n\n    if (isSingleResourceUpdateLikeOperation(resourceContext.operation) && participationRmm.rmm) {\n      const effectiveRequestData = mergeBulkSelectionIntoRequestData({\n        operation: resourceContext.operation,\n        requestData,\n        additionalContext: resourceContext.additionalContext,\n      });\n      const mutationResult = await participationRmm.rmm.queueMutation(\n        effectiveRequestData ?? {},\n        {\n          type: options?.mutationType ?? MutationType.CUSTOM,\n          priority: options?.mutationPriority ?? MutationPriority.NORMAL,\n          source: {\n            type: MutationSourceType.ORCHESTRATOR,\n            subscriberId: options?.subscriberId\n              ?? `execution-surface:${resourceSurface.resourceType}:${resourceSurface.operationId}`,\n          },\n          transportOverride: {\n            operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(\n              resourceContext.operation,\n            ),\n            contextualParameters: resourceSurface.contextualParameters,\n            parentResourcesRequirements: resourceContext.parentResourcesRequirements,\n            requestData: effectiveRequestData ?? {},\n            readBackOnSuccess: options?.readBackOnSuccess ?? true,\n          },\n        },\n      );\n\n      if (!mutationResult.success) {\n        // Rethrow the transport failure itself: it carries the backend reference, type and guidance that\n        // `useUserFacingErrorMessage()` turns into the application's words. An `Error` rebuilt from its message\n        // keeps only the text, which is never shown, so the failure could only read as generic (#1182).\n        // A cancellation keeps its previous shape.\n        if (mutationResult.error?.cause !== undefined && mutationResult.error.type !== MutationErrorType.ABORT) {\n          throw mutationResult.error.cause;\n        }\n        throw new Error(\n          mutationResult.error?.message\n          ?? `Execution resource operation \"${resourceSurface.operationId}\" failed.`,\n        );\n      }\n\n      return mutationResult.responseData;\n    }\n\n    return resourceSurface.executeCurrentOperation(requestData);\n  }, [\n    participationRmm.rmm,\n    resourceContext.additionalContext,\n    resourceContext.operation,\n    resourceContext.parentResourcesRequirements,\n    registry,\n    resourceSurface,\n  ]);\n\n  return {\n    ...resourceSurface,\n    target,\n    participationHandle: target.participationRef ? participationHandle : undefined,\n    navigationHandlingMode,\n    rmm: participationRmm.rmm,\n    rmmSnapshot: participationRmm.rmmSnapshot,\n    rmmUnavailableReason: participationRmm.rmmUnavailableReason,\n    executionRmmUnavailableReason: target.participationRef\n      ? participationRmm.executionUnavailableReason\n      : null,\n    execute,\n    navigateToResourceOperation,\n    navigateToPreferredRead,\n  };\n}\n\nexport interface UseExecutionParticipationOperationSurfaceParams extends Omit<\n  UseExecutionResourceOperationSurfaceParams,\n  'target'\n> {\n  participationRef: string;\n  target: Omit<ExecutionResourceOperationTarget, 'participationRef'>;\n}\n\n/**\n * Participation-first convenience wrapper over `useExecutionResourceOperationSurface()`.\n */\nexport function useExecutionParticipationOperationSurface(\n  params: UseExecutionParticipationOperationSurfaceParams,\n): ExecutionResourceOperationSurface {\n  const target = useMemo<ExecutionResourceOperationTarget>(() => ({\n    ...params.target,\n    participationRef: params.participationRef,\n  } as ExecutionResourceOperationTarget), [params.participationRef, params.target]);\n\n  return useExecutionResourceOperationSurface({\n    target,\n    navigationInitiator: params.navigationInitiator,\n    updateLikeMutationFallbackMode: params.updateLikeMutationFallbackMode,\n  });\n}\n"]}

package/dist/esm/core/external-providers/chat-sign-in-completion.frontend.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Telling the chat host that opened the chat-link page how the sign-in ended (#2790), without the page knowing which
+ * host it is.
+ *
+ * The page reads the host marker from its own link once (`ChatIdentityLinkPageQueryParam.HOST`) and calls this with it.
+ * The frontend provider registry loads only the providers serving `FRONTEND_CHAT_SIGN_IN_COMPLETION` whose own predicate
+ * accepts that host (#2772: the Microsoft Teams bot module, for its authentication window), and each one's handle is
+ * told through the capability's sink. With no marker, or no provider serving it, nothing is loaded and the page behaves
+ * as it always did.
+ */
+import { type ChatIdentityLinkHost } from '@wildo-ai/saas-models/public-runtime';
+import type { ActivatedFrontendProviderSdks } from '@wildo-ai/external-connectors-public/app';
+/** @wildo_source:part:start saas.frontend.chat-sign-in-completion facet:layer:frontend facet:audience:app-developer */
+/** How the sign-in ended, as the page tells the host. */
+export declare enum ChatSignInCompletionOutcome {
+    /** The chat account acts as the signed-in member: linked now, or already linked to them. */
+    SUCCEEDED = "succeeded",
+    /** The member left without a working link: refused, linked to someone else, or cancelled. */
+    FAILED = "failed"
+}
+/**
+ * Tell every handle of an on-demand activation `outcome`. Returns how many were told. Never throws: a handle that is
+ * not a sink, or one that throws, is logged and skipped, because the page has already done its own work.
+ */
+export declare function tellChatSignInCompletionSinks(result: ActivatedFrontendProviderSdks, outcome: ChatSignInCompletionOutcome): number;
+/** What the chat-link page holds for a host marker: whether any provider serves it, and how to tell it. */
+export interface ChatSignInCompletion {
+    /**
+     * Whether a provider serves this host, answered synchronously from the registry (nothing is loaded). The page offers
+     * the host's Close only when this is true; otherwise it keeps its ordinary way home, so a marker no provider serves
+     * changes nothing.
+     */
+    readonly hostServed: boolean;
+    /**
+     * Tell the host `outcome`, resolving to how many providers were told (0 when none could be: nothing serves the host,
+     * the provider failed to load, or its vendor refused because the page is not in its window after all). Automatic calls
+     * (`repeat` absent) send each outcome once, and never a failure after a success. A person's explicit Close passes
+     * `repeat`, so a host whose window stayed open is told again; a failure still never follows a success. A call that told
+     * nobody leaves no cached activation behind, so the next one tries again.
+     */
+    tell(outcome: ChatSignInCompletionOutcome, options?: {
+        readonly repeat?: boolean;
+    }): Promise<number>;
+}
+/**
+ * The chat-link page's door to the capability. The providers are activated ONCE per page and their handles reused, so
+ * telling twice never loads or initializes a vendor SDK twice. `undefined` host means an ordinary tab: nothing served,
+ * nothing told.
+ */
+export declare function useChatSignInCompletion(host: ChatIdentityLinkHost | undefined): ChatSignInCompletion;
+/** @wildo_source:part:end saas.frontend.chat-sign-in-completion */
+//# sourceMappingURL=chat-sign-in-completion.frontend.d.ts.map

package/dist/esm/core/external-providers/chat-sign-in-completion.frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-sign-in-completion.frontend.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/chat-sign-in-completion.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AAO9F,uHAAuH;AACvH,yDAAyD;AACzD,oBAAY,2BAA2B;IACrC,4FAA4F;IAC5F,SAAS,cAAc;IACvB,6FAA6F;IAC7F,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,6BAA6B,EAAE,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAgBjI;AAED,2GAA2G;AAC3G,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,2BAA2B,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,SAAS,GAAG,oBAAoB,CAiCpG;AACD,mEAAmE"}

package/dist/esm/core/external-providers/chat-sign-in-completion.frontend.js

@@ -0,0 +1,88 @@
+/**
+ * Telling the chat host that opened the chat-link page how the sign-in ended (#2790), without the page knowing which
+ * host it is.
+ *
+ * The page reads the host marker from its own link once (`ChatIdentityLinkPageQueryParam.HOST`) and calls this with it.
+ * The frontend provider registry loads only the providers serving `FRONTEND_CHAT_SIGN_IN_COMPLETION` whose own predicate
+ * accepts that host (#2772: the Microsoft Teams bot module, for its authentication window), and each one's handle is
+ * told through the capability's sink. With no marker, or no provider serving it, nothing is loaded and the page behaves
+ * as it always did.
+ */
+import { useCallback, useContext, useMemo, useRef } from 'react';
+import { BUILTIN_PROVIDER_CAPABILITY, isFrontendChatSignInCompletionSink, } from '@wildo-ai/saas-models/public-runtime';
+import { ApplicationContext } from '../../core/runtime/ApplicationContext.shared.js';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+const logger = LoggerFrontendService.getLogger();
+/** @wildo_source:part:start saas.frontend.chat-sign-in-completion facet:layer:frontend facet:audience:app-developer */
+/** How the sign-in ended, as the page tells the host. */
+export var ChatSignInCompletionOutcome;
+(function (ChatSignInCompletionOutcome) {
+    /** The chat account acts as the signed-in member: linked now, or already linked to them. */
+    ChatSignInCompletionOutcome["SUCCEEDED"] = "succeeded";
+    /** The member left without a working link: refused, linked to someone else, or cancelled. */
+    ChatSignInCompletionOutcome["FAILED"] = "failed";
+})(ChatSignInCompletionOutcome || (ChatSignInCompletionOutcome = {}));
+/**
+ * Tell every handle of an on-demand activation `outcome`. Returns how many were told. Never throws: a handle that is
+ * not a sink, or one that throws, is logged and skipped, because the page has already done its own work.
+ */
+export function tellChatSignInCompletionSinks(result, outcome) {
+    let told = 0;
+    for (const [providerRef, activation] of result.activations) {
+        if (!isFrontendChatSignInCompletionSink(activation.handle)) {
+            logger.warn('A chat sign-in completion provider returned a handle that is not a FrontendChatSignInCompletionSink', { providerRef });
+            continue;
+        }
+        try {
+            if (outcome === ChatSignInCompletionOutcome.SUCCEEDED)
+                activation.handle.signInSucceeded();
+            else
+                activation.handle.signInFailed();
+            told += 1;
+        }
+        catch (error) {
+            logger.warn('A chat sign-in completion provider failed to tell its host', { providerRef, error });
+        }
+    }
+    return told;
+}
+/**
+ * The chat-link page's door to the capability. The providers are activated ONCE per page and their handles reused, so
+ * telling twice never loads or initializes a vendor SDK twice. `undefined` host means an ordinary tab: nothing served,
+ * nothing told.
+ */
+export function useChatSignInCompletion(host) {
+    const registry = useContext(ApplicationContext)?.frontendProviderRegistry;
+    const context = useMemo(() => (host === undefined ? undefined : { capability: BUILTIN_PROVIDER_CAPABILITY.FRONTEND_CHAT_SIGN_IN_COMPLETION, host }), [host]);
+    const hostServed = useMemo(() => context !== undefined && registry !== undefined && registry.providersServingOnDemand(context).length > 0, [context, registry]);
+    const sent = useRef(null);
+    const activation = useRef(null);
+    const tell = useCallback(async (outcome, options) => {
+        if (context === undefined || registry === undefined || !hostServed)
+            return 0;
+        if (sent.current === ChatSignInCompletionOutcome.SUCCEEDED && outcome === ChatSignInCompletionOutcome.FAILED)
+            return 0;
+        if (sent.current === outcome && options?.repeat !== true)
+            return 0;
+        sent.current = outcome;
+        activation.current ??= registry.activateOnDemand(context, (diagnostic) => logger.warn('Chat sign-in completion provider diagnostic', {
+            kind: diagnostic.kind,
+            providerRef: diagnostic.providerRef,
+            message: diagnostic.message,
+        }));
+        try {
+            const told = tellChatSignInCompletionSinks(await activation.current, outcome);
+            if (told === 0)
+                activation.current = null;
+            return told;
+        }
+        catch (error) {
+            logger.warn('Chat sign-in completion could not be called', { error });
+            activation.current = null;
+            return 0;
+        }
+    }, [context, registry, hostServed]);
+    return useMemo(() => ({ hostServed, tell }), [hostServed, tell]);
+}
+/** @wildo_source:part:end saas.frontend.chat-sign-in-completion */
+//# sourceMappingURL=chat-sign-in-completion.frontend.js.map

package/dist/esm/core/external-providers/chat-sign-in-completion.frontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-sign-in-completion.frontend.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/chat-sign-in-completion.frontend.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Telling the chat host that opened the chat-link page how the sign-in ended (#2790), without the page knowing which\n * host it is.\n *\n * The page reads the host marker from its own link once (`ChatIdentityLinkPageQueryParam.HOST`) and calls this with it.\n * The frontend provider registry loads only the providers serving `FRONTEND_CHAT_SIGN_IN_COMPLETION` whose own predicate\n * accepts that host (#2772: the Microsoft Teams bot module, for its authentication window), and each one's handle is\n * told through the capability's sink. With no marker, or no provider serving it, nothing is loaded and the page behaves\n * as it always did.\n */\n\nimport { useCallback, useContext, useMemo, useRef } from 'react';\nimport {\n  BUILTIN_PROVIDER_CAPABILITY,\n  isFrontendChatSignInCompletionSink,\n  type ChatIdentityLinkHost,\n  type FrontendChatSignInCompletionContext,\n} from '@wildo-ai/saas-models/public-runtime';\nimport type { ActivatedFrontendProviderSdks } from '@wildo-ai/external-connectors-public/app';\nimport { ApplicationContext } from '~wildo-frontend-lib/core/runtime/ApplicationContext.shared';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { FrontendProviderRegistryFrontendService } from '~wildo-frontend-lib/core/external-providers/frontend-provider-registry.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\n/** @wildo_source:part:start saas.frontend.chat-sign-in-completion facet:layer:frontend facet:audience:app-developer */\n/** How the sign-in ended, as the page tells the host. */\nexport enum ChatSignInCompletionOutcome {\n  /** The chat account acts as the signed-in member: linked now, or already linked to them. */\n  SUCCEEDED = 'succeeded',\n  /** The member left without a working link: refused, linked to someone else, or cancelled. */\n  FAILED = 'failed',\n}\n\n/**\n * Tell every handle of an on-demand activation `outcome`. Returns how many were told. Never throws: a handle that is\n * not a sink, or one that throws, is logged and skipped, because the page has already done its own work.\n */\nexport function tellChatSignInCompletionSinks(result: ActivatedFrontendProviderSdks, outcome: ChatSignInCompletionOutcome): number {\n  let told = 0;\n  for (const [providerRef, activation] of result.activations) {\n    if (!isFrontendChatSignInCompletionSink(activation.handle)) {\n      logger.warn('A chat sign-in completion provider returned a handle that is not a FrontendChatSignInCompletionSink', { providerRef });\n      continue;\n    }\n    try {\n      if (outcome === ChatSignInCompletionOutcome.SUCCEEDED) activation.handle.signInSucceeded();\n      else activation.handle.signInFailed();\n      told += 1;\n    } catch (error) {\n      logger.warn('A chat sign-in completion provider failed to tell its host', { providerRef, error });\n    }\n  }\n  return told;\n}\n\n/** What the chat-link page holds for a host marker: whether any provider serves it, and how to tell it. */\nexport interface ChatSignInCompletion {\n  /**\n   * Whether a provider serves this host, answered synchronously from the registry (nothing is loaded). The page offers\n   * the host's Close only when this is true; otherwise it keeps its ordinary way home, so a marker no provider serves\n   * changes nothing.\n   */\n  readonly hostServed: boolean;\n  /**\n   * Tell the host `outcome`, resolving to how many providers were told (0 when none could be: nothing serves the host,\n   * the provider failed to load, or its vendor refused because the page is not in its window after all). Automatic calls\n   * (`repeat` absent) send each outcome once, and never a failure after a success. A person's explicit Close passes\n   * `repeat`, so a host whose window stayed open is told again; a failure still never follows a success. A call that told\n   * nobody leaves no cached activation behind, so the next one tries again.\n   */\n  tell(outcome: ChatSignInCompletionOutcome, options?: { readonly repeat?: boolean }): Promise<number>;\n}\n\n/**\n * The chat-link page's door to the capability. The providers are activated ONCE per page and their handles reused, so\n * telling twice never loads or initializes a vendor SDK twice. `undefined` host means an ordinary tab: nothing served,\n * nothing told.\n */\nexport function useChatSignInCompletion(host: ChatIdentityLinkHost | undefined): ChatSignInCompletion {\n  const registry: FrontendProviderRegistryFrontendService | undefined = useContext(ApplicationContext)?.frontendProviderRegistry;\n  const context = useMemo<FrontendChatSignInCompletionContext | undefined>(\n    () => (host === undefined ? undefined : { capability: BUILTIN_PROVIDER_CAPABILITY.FRONTEND_CHAT_SIGN_IN_COMPLETION, host }),\n    [host],\n  );\n  const hostServed = useMemo(\n    () => context !== undefined && registry !== undefined && registry.providersServingOnDemand(context).length > 0,\n    [context, registry],\n  );\n  const sent = useRef<ChatSignInCompletionOutcome | null>(null);\n  const activation = useRef<Promise<ActivatedFrontendProviderSdks> | null>(null);\n  const tell = useCallback(async (outcome: ChatSignInCompletionOutcome, options?: { readonly repeat?: boolean }): Promise<number> => {\n    if (context === undefined || registry === undefined || !hostServed) return 0;\n    if (sent.current === ChatSignInCompletionOutcome.SUCCEEDED && outcome === ChatSignInCompletionOutcome.FAILED) return 0;\n    if (sent.current === outcome && options?.repeat !== true) return 0;\n    sent.current = outcome;\n    activation.current ??= registry.activateOnDemand(context, (diagnostic) => logger.warn('Chat sign-in completion provider diagnostic', {\n      kind: diagnostic.kind,\n      providerRef: diagnostic.providerRef,\n      message: diagnostic.message,\n    }));\n    try {\n      const told = tellChatSignInCompletionSinks(await activation.current, outcome);\n      if (told === 0) activation.current = null;\n      return told;\n    } catch (error) {\n      logger.warn('Chat sign-in completion could not be called', { error });\n      activation.current = null;\n      return 0;\n    }\n  }, [context, registry, hostServed]);\n  return useMemo(() => ({ hostServed, tell }), [hostServed, tell]);\n}\n/** @wildo_source:part:end saas.frontend.chat-sign-in-completion */\n"]}

package/dist/esm/core/external-providers/frontend-provider-registry.frontend.service.d.ts

@@ -22,8 +22,8 @@
  * frontend bundle does not depend on that package.
  */
 import type { FrontendProvidersBlock, ProviderCapability } from '@wildo-ai/saas-models';
-import type { ProviderProtocol } from '@wildo-ai/saas-models/public-runtime';
-import type { FrontendAppProviderModule, FrontendAppProviderRef, FrontendProviderHydrationDiagnostic, GeneratedAppProviderModules } from '@wildo-ai/external-connectors-public/app';
+import { type FrontendOnDemandCapabilityContext, type ProviderProtocol } from '@wildo-ai/saas-models/public-runtime';
+import type { ActivatedFrontendProviderSdks, FrontendAppProviderModule, FrontendAppProviderRef, FrontendProviderHydrationDiagnostic, FrontendProviderSdkActivationDiagnostic, GeneratedAppProviderModules } from '@wildo-ai/external-connectors-public/app';
 /**
  * Everything the registry needs to join the two channels.
  *
@@ -43,6 +43,22 @@ export interface FrontendProviderRegistryFrontendService {
     findByProviderCapabilityAndProtocol(providerCapability: ProviderCapability, providerProtocol: ProviderProtocol | string): FrontendAppProviderModule | undefined;
     /** All providers (read-only). For debug / introspection only. */
     listAll(): ReadonlyArray<FrontendAppProviderModule>;
+    /**
+     * Call an ON-DEMAND capability (#2790): load and start the providers serving `context.capability` whose own
+     * `servesOnDemandContext` accepts `context`, and hand back their handles, which the caller narrows with the
+     * capability's sink guard (`isFrontendChatSignInCompletionSink`, …).
+     *
+     * The flow builds `context` from what it knows at the moment of the call. No provider serving it is the ordinary
+     * answer, not an error: the result is then empty and the flow carries on as it would without one. A provider that
+     * fails to load is reported through `onDiagnostic` and left out, never thrown.
+     */
+    activateOnDemand(context: FrontendOnDemandCapabilityContext, onDiagnostic?: (diagnostic: FrontendProviderSdkActivationDiagnostic) => void): Promise<ActivatedFrontendProviderSdks>;
+    /**
+     * The refs of the providers that WOULD serve `context` if called (#2790), answered synchronously and without loading
+     * anything, by the same decision `activateOnDemand` takes. A flow asks this before offering anything that depends on
+     * a provider (the chat-link page's Close), so it never offers a door nothing would open.
+     */
+    providersServingOnDemand(context: FrontendOnDemandCapabilityContext): ReadonlyArray<string>;
 }
 export declare class InMemoryFrontendProviderRegistryFrontendService implements FrontendProviderRegistryFrontendService {
     private registry;
@@ -52,6 +68,8 @@ export declare class InMemoryFrontendProviderRegistryFrontendService implements
     findByProviderCapability(providerCapability: ProviderCapability): FrontendAppProviderModule | undefined;
     findByProviderCapabilityAndProtocol(providerCapability: ProviderCapability, providerProtocol: ProviderProtocol | string): FrontendAppProviderModule | undefined;
     listAll(): ReadonlyArray<FrontendAppProviderModule>;
+    activateOnDemand(context: FrontendOnDemandCapabilityContext, onDiagnostic?: (diagnostic: FrontendProviderSdkActivationDiagnostic) => void): Promise<ActivatedFrontendProviderSdks>;
+    providersServingOnDemand(context: FrontendOnDemandCapabilityContext): ReadonlyArray<string>;
 }
 export declare function createFrontendProviderRegistryFrontendService(input?: FrontendProviderRegistryHydrationInput): FrontendProviderRegistryFrontendService;
 //# sourceMappingURL=frontend-provider-registry.frontend.service.d.ts.map

package/dist/esm/core/external-providers/frontend-provider-registry.frontend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-registry.frontend.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAK7E,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,mCAAmC,EACnC,2BAA2B,EAC5B,MAAM,0CAA0C,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mCAAmC,KAAK,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,uCAAuC;IACtD,gEAAgE;IAChE,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,yBAAyB,GAAG,SAAS,CAAC;IAErF,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS,CAAC;IAEzC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS,CAAC;IAEzC,iEAAiE;IACjE,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC,CAAC;CACrD;AAED,qBAAa,+CACX,YAAW,uCAAuC;IAElD,OAAO,CAAC,QAAQ,CAEb;IAEH,UAAU,CAAC,KAAK,CAAC,EAAE,sCAAsC,GAAG,IAAI;IAQhE,gBAAgB,CACd,GAAG,EAAE,sBAAsB,GAC1B,yBAAyB,GAAG,SAAS;IAIxC,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC;IAI3C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS;IAIxC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS;IAQxC,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC;CAGpD;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,CAAC,EAAE,sCAAsC,GAC7C,uCAAuC,CAIzC"}
+{"version":3,"file":"frontend-provider-registry.frontend.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAmB,KAAK,iCAAiC,EAAE,KAAK,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAQtI,OAAO,KAAK,EACV,6BAA6B,EAC7B,yBAAyB,EACzB,sBAAsB,EACtB,mCAAmC,EACnC,uCAAuC,EACvC,2BAA2B,EAC5B,MAAM,0CAA0C,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mCAAmC,KAAK,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,uCAAuC;IACtD,gEAAgE;IAChE,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,yBAAyB,GAAG,SAAS,CAAC;IAErF,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS,CAAC;IAEzC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS,CAAC;IAEzC,iEAAiE;IACjE,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAEpD;;;;;;;;OAQG;IACH,gBAAgB,CACd,OAAO,EAAE,iCAAiC,EAC1C,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,uCAAuC,KAAK,IAAI,GAC3E,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAE1C;;;;OAIG;IACH,wBAAwB,CAAC,OAAO,EAAE,iCAAiC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;CAC7F;AAED,qBAAa,+CACX,YAAW,uCAAuC;IAElD,OAAO,CAAC,QAAQ,CAEb;IAEH,UAAU,CAAC,KAAK,CAAC,EAAE,sCAAsC,GAAG,IAAI;IAQhE,gBAAgB,CACd,GAAG,EAAE,sBAAsB,GAC1B,yBAAyB,GAAG,SAAS;IAIxC,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC;IAI3C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS;IAIxC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS;IAQxC,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC;IAInD,gBAAgB,CACd,OAAO,EAAE,iCAAiC,EAC1C,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,uCAAuC,KAAK,IAAI,GAC3E,OAAO,CAAC,6BAA6B,CAAC;IAWzC,wBAAwB,CAAC,OAAO,EAAE,iCAAiC,GAAG,aAAa,CAAC,MAAM,CAAC;CAM5F;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,CAAC,EAAE,sCAAsC,GAC7C,uCAAuC,CAIzC"}

package/dist/esm/core/external-providers/frontend-provider-registry.frontend.service.js

@@ -21,7 +21,8 @@
  * `@wildo-ai/external-connectors-private/*` are a TypeScript error because the
  * frontend bundle does not depend on that package.
  */
-import { composeFrontendAppProviders, composeHydratedFrontendAppProviders, } from '@wildo-ai/external-connectors-public/app';
+import { AppFrontendType } from '@wildo-ai/saas-models/public-runtime';
+import { OnDemandServingVerdict, activateFrontendProviderSdks, composeFrontendAppProviders, composeHydratedFrontendAppProviders, onDemandServingVerdict, } from '@wildo-ai/external-connectors-public/app';
 export class InMemoryFrontendProviderRegistryFrontendService {
     registry = composeFrontendAppProviders({
         modules: new Map(),
@@ -50,6 +51,22 @@ export class InMemoryFrontendProviderRegistryFrontendService {
     listAll() {
         return [...this.registry.modules.values()];
     }
+    activateOnDemand(context, onDiagnostic) {
+        // The runner owns the on-demand rule (an ON_DEMAND sdk, the capability, the predicate at the call), so this only
+        // narrows to the capability's providers and names the surface.
+        return activateFrontendProviderSdks({
+            surface: AppFrontendType.SAAS_APP,
+            modules: this.registry.getProvidersByProviderCapability(context.capability),
+            onDemand: context,
+            onDiagnostic,
+        });
+    }
+    providersServingOnDemand(context) {
+        return this.registry
+            .getProvidersByProviderCapability(context.capability)
+            .filter((module) => onDemandServingVerdict(module, context).verdict === OnDemandServingVerdict.SERVES)
+            .map((module) => module.metadata.ref);
+    }
 }
 export function createFrontendProviderRegistryFrontendService(input) {
     const service = new InMemoryFrontendProviderRegistryFrontendService();

package/dist/esm/core/external-providers/frontend-provider-registry.frontend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-registry.frontend.service.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,0CAA0C,CAAC;AAyClD,MAAM,OAAO,+CAA+C;IAGlD,QAAQ,GAAG,2BAA2B,CAAC;QAC7C,OAAO,EAAE,IAAI,GAAG,EAAqD;KACtE,CAAC,CAAC;IAEH,UAAU,CAAC,KAA8C;QACvD,IAAI,CAAC,QAAQ,GAAG,mCAAmC,CAAC;YAClD,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,YAAY,EAAE,KAAK,EAAE,YAAY;SAClC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CACd,GAA2B;QAE3B,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,mCAAmC,CACjC,kBAAsC,EACtC,gBAA2C;QAE3C,OAAO,IAAI,CAAC,QAAQ;aACjB,gCAAgC,CAAC,kBAAkB,CAAC;aACpD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACjB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,gBAAgB,CAAC,CACrE,CAAC;IACN,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,UAAU,6CAA6C,CAC3D,KAA8C;IAE9C,MAAM,OAAO,GAAG,IAAI,+CAA+C,EAAE,CAAC;IACtE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * `FrontendProviderRegistryFrontendService` — frontend-side API for\n * reading the per-app provider catalog.\n *\n * The registry is built from TWO channels and no longer from a cast (#332):\n *\n *   - **DATA** — `FrontendAppBootstrapPayload.frontendProviders`, hydrated\n *     once at app start from `/application-config`. Built by\n *     `FrontendBootstrapBackendService.buildPayload()`, which is the SOLE\n *     cross-facet seam where backend code projects a `BackendProviderModule`\n *     into a `FrontendProviderEntry`. It is the authority on WHICH providers\n *     this frontend service has turned on, in this environment.\n *   - **CODE** — `generatedFrontendProviderModules` from the app's own\n *     `src/generated/frontend-providers.generated.ts`, written by\n *     `wildo config sync` and passed in through `StartApplicationOptions`. It\n *     is the authority on what code this bundle contains — an SDK loader, a\n *     public-config validator — none of which JSON could ever carry.\n *\n * From the frontend's perspective this service is still the only legal way to\n * read provider information — direct imports from\n * `@wildo-ai/external-connectors-private/*` are a TypeScript error because the\n * frontend bundle does not depend on that package.\n */\n\nimport type {\n  FrontendProvidersBlock,\n  ProviderCapability,\n} from '@wildo-ai/saas-models';\nimport type { ProviderProtocol } from '@wildo-ai/saas-models/public-runtime';\nimport {\n  composeFrontendAppProviders,\n  composeHydratedFrontendAppProviders,\n} from '@wildo-ai/external-connectors-public/app';\nimport type {\n  FrontendAppProviderModule,\n  FrontendAppProviderRef,\n  FrontendProviderHydrationDiagnostic,\n  GeneratedAppProviderModules,\n} from '@wildo-ai/external-connectors-public/app';\n\n/**\n * Everything the registry needs to join the two channels.\n *\n * `modules` absent is the ordinary case for an application that declares no\n * frontend provider. Config sync emits an empty map so startup imports remain stable.\n */\nexport interface FrontendProviderRegistryHydrationInput {\n  readonly entries?: FrontendProvidersBlock;\n  readonly modules?: GeneratedAppProviderModules;\n  readonly onDiagnostic?: (diagnostic: FrontendProviderHydrationDiagnostic) => void;\n}\n\nexport interface FrontendProviderRegistryFrontendService {\n  /** Hydrated from `FrontendAppBootstrapPayload` at app start. */\n  getProviderByRef(ref: FrontendAppProviderRef): FrontendAppProviderModule | undefined;\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule>;\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined;\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined;\n\n  /** All providers (read-only). For debug / introspection only. */\n  listAll(): ReadonlyArray<FrontendAppProviderModule>;\n}\n\nexport class InMemoryFrontendProviderRegistryFrontendService\n  implements FrontendProviderRegistryFrontendService\n{\n  private registry = composeFrontendAppProviders({\n    modules: new Map<FrontendAppProviderRef, FrontendAppProviderModule>(),\n  });\n\n  initialize(input?: FrontendProviderRegistryHydrationInput): void {\n    this.registry = composeHydratedFrontendAppProviders({\n      entries: input?.entries,\n      modules: input?.modules,\n      onDiagnostic: input?.onDiagnostic,\n    });\n  }\n\n  getProviderByRef(\n    ref: FrontendAppProviderRef,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.getProviderByRef(ref);\n  }\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule> {\n    return this.registry.getProvidersByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.findProviderByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry\n      .getProvidersByProviderCapability(providerCapability)\n      .find((provider) =>\n        provider.protocols.some((protocol) => protocol === providerProtocol),\n      );\n  }\n\n  listAll(): ReadonlyArray<FrontendAppProviderModule> {\n    return [...this.registry.modules.values()];\n  }\n}\n\nexport function createFrontendProviderRegistryFrontendService(\n  input?: FrontendProviderRegistryHydrationInput,\n): FrontendProviderRegistryFrontendService {\n  const service = new InMemoryFrontendProviderRegistryFrontendService();\n  service.initialize(input);\n  return service;\n}\n"]}
+{"version":3,"file":"frontend-provider-registry.frontend.service.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,EAAE,eAAe,EAAiE,MAAM,sCAAsC,CAAC;AACtI,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,mCAAmC,EACnC,sBAAsB,GACvB,MAAM,0CAA0C,CAAC;AAgElD,MAAM,OAAO,+CAA+C;IAGlD,QAAQ,GAAG,2BAA2B,CAAC;QAC7C,OAAO,EAAE,IAAI,GAAG,EAAqD;KACtE,CAAC,CAAC;IAEH,UAAU,CAAC,KAA8C;QACvD,IAAI,CAAC,QAAQ,GAAG,mCAAmC,CAAC;YAClD,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,YAAY,EAAE,KAAK,EAAE,YAAY;SAClC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CACd,GAA2B;QAE3B,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,mCAAmC,CACjC,kBAAsC,EACtC,gBAA2C;QAE3C,OAAO,IAAI,CAAC,QAAQ;aACjB,gCAAgC,CAAC,kBAAkB,CAAC;aACpD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACjB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,gBAAgB,CAAC,CACrE,CAAC;IACN,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,gBAAgB,CACd,OAA0C,EAC1C,YAA4E;QAE5E,iHAAiH;QACjH,+DAA+D;QAC/D,OAAO,4BAA4B,CAAC;YAClC,OAAO,EAAE,eAAe,CAAC,QAAQ;YACjC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,OAAO,CAAC,UAAU,CAAC;YAC3E,QAAQ,EAAE,OAAO;YACjB,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB,CAAC,OAA0C;QACjE,OAAO,IAAI,CAAC,QAAQ;aACjB,gCAAgC,CAAC,OAAO,CAAC,UAAU,CAAC;aACpD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,OAAO,KAAK,sBAAsB,CAAC,MAAM,CAAC;aACrG,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,UAAU,6CAA6C,CAC3D,KAA8C;IAE9C,MAAM,OAAO,GAAG,IAAI,+CAA+C,EAAE,CAAC;IACtE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * `FrontendProviderRegistryFrontendService` — frontend-side API for\n * reading the per-app provider catalog.\n *\n * The registry is built from TWO channels and no longer from a cast (#332):\n *\n *   - **DATA** — `FrontendAppBootstrapPayload.frontendProviders`, hydrated\n *     once at app start from `/application-config`. Built by\n *     `FrontendBootstrapBackendService.buildPayload()`, which is the SOLE\n *     cross-facet seam where backend code projects a `BackendProviderModule`\n *     into a `FrontendProviderEntry`. It is the authority on WHICH providers\n *     this frontend service has turned on, in this environment.\n *   - **CODE** — `generatedFrontendProviderModules` from the app's own\n *     `src/generated/frontend-providers.generated.ts`, written by\n *     `wildo config sync` and passed in through `StartApplicationOptions`. It\n *     is the authority on what code this bundle contains — an SDK loader, a\n *     public-config validator — none of which JSON could ever carry.\n *\n * From the frontend's perspective this service is still the only legal way to\n * read provider information — direct imports from\n * `@wildo-ai/external-connectors-private/*` are a TypeScript error because the\n * frontend bundle does not depend on that package.\n */\n\nimport type {\n  FrontendProvidersBlock,\n  ProviderCapability,\n} from '@wildo-ai/saas-models';\nimport { AppFrontendType, type FrontendOnDemandCapabilityContext, type ProviderProtocol } from '@wildo-ai/saas-models/public-runtime';\nimport {\n  OnDemandServingVerdict,\n  activateFrontendProviderSdks,\n  composeFrontendAppProviders,\n  composeHydratedFrontendAppProviders,\n  onDemandServingVerdict,\n} from '@wildo-ai/external-connectors-public/app';\nimport type {\n  ActivatedFrontendProviderSdks,\n  FrontendAppProviderModule,\n  FrontendAppProviderRef,\n  FrontendProviderHydrationDiagnostic,\n  FrontendProviderSdkActivationDiagnostic,\n  GeneratedAppProviderModules,\n} from '@wildo-ai/external-connectors-public/app';\n\n/**\n * Everything the registry needs to join the two channels.\n *\n * `modules` absent is the ordinary case for an application that declares no\n * frontend provider. Config sync emits an empty map so startup imports remain stable.\n */\nexport interface FrontendProviderRegistryHydrationInput {\n  readonly entries?: FrontendProvidersBlock;\n  readonly modules?: GeneratedAppProviderModules;\n  readonly onDiagnostic?: (diagnostic: FrontendProviderHydrationDiagnostic) => void;\n}\n\nexport interface FrontendProviderRegistryFrontendService {\n  /** Hydrated from `FrontendAppBootstrapPayload` at app start. */\n  getProviderByRef(ref: FrontendAppProviderRef): FrontendAppProviderModule | undefined;\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule>;\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined;\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined;\n\n  /** All providers (read-only). For debug / introspection only. */\n  listAll(): ReadonlyArray<FrontendAppProviderModule>;\n\n  /**\n   * Call an ON-DEMAND capability (#2790): load and start the providers serving `context.capability` whose own\n   * `servesOnDemandContext` accepts `context`, and hand back their handles, which the caller narrows with the\n   * capability's sink guard (`isFrontendChatSignInCompletionSink`, …).\n   *\n   * The flow builds `context` from what it knows at the moment of the call. No provider serving it is the ordinary\n   * answer, not an error: the result is then empty and the flow carries on as it would without one. A provider that\n   * fails to load is reported through `onDiagnostic` and left out, never thrown.\n   */\n  activateOnDemand(\n    context: FrontendOnDemandCapabilityContext,\n    onDiagnostic?: (diagnostic: FrontendProviderSdkActivationDiagnostic) => void,\n  ): Promise<ActivatedFrontendProviderSdks>;\n\n  /**\n   * The refs of the providers that WOULD serve `context` if called (#2790), answered synchronously and without loading\n   * anything, by the same decision `activateOnDemand` takes. A flow asks this before offering anything that depends on\n   * a provider (the chat-link page's Close), so it never offers a door nothing would open.\n   */\n  providersServingOnDemand(context: FrontendOnDemandCapabilityContext): ReadonlyArray<string>;\n}\n\nexport class InMemoryFrontendProviderRegistryFrontendService\n  implements FrontendProviderRegistryFrontendService\n{\n  private registry = composeFrontendAppProviders({\n    modules: new Map<FrontendAppProviderRef, FrontendAppProviderModule>(),\n  });\n\n  initialize(input?: FrontendProviderRegistryHydrationInput): void {\n    this.registry = composeHydratedFrontendAppProviders({\n      entries: input?.entries,\n      modules: input?.modules,\n      onDiagnostic: input?.onDiagnostic,\n    });\n  }\n\n  getProviderByRef(\n    ref: FrontendAppProviderRef,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.getProviderByRef(ref);\n  }\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule> {\n    return this.registry.getProvidersByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.findProviderByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry\n      .getProvidersByProviderCapability(providerCapability)\n      .find((provider) =>\n        provider.protocols.some((protocol) => protocol === providerProtocol),\n      );\n  }\n\n  listAll(): ReadonlyArray<FrontendAppProviderModule> {\n    return [...this.registry.modules.values()];\n  }\n\n  activateOnDemand(\n    context: FrontendOnDemandCapabilityContext,\n    onDiagnostic?: (diagnostic: FrontendProviderSdkActivationDiagnostic) => void,\n  ): Promise<ActivatedFrontendProviderSdks> {\n    // The runner owns the on-demand rule (an ON_DEMAND sdk, the capability, the predicate at the call), so this only\n    // narrows to the capability's providers and names the surface.\n    return activateFrontendProviderSdks({\n      surface: AppFrontendType.SAAS_APP,\n      modules: this.registry.getProvidersByProviderCapability(context.capability),\n      onDemand: context,\n      onDiagnostic,\n    });\n  }\n\n  providersServingOnDemand(context: FrontendOnDemandCapabilityContext): ReadonlyArray<string> {\n    return this.registry\n      .getProvidersByProviderCapability(context.capability)\n      .filter((module) => onDemandServingVerdict(module, context).verdict === OnDemandServingVerdict.SERVES)\n      .map((module) => module.metadata.ref);\n  }\n}\n\nexport function createFrontendProviderRegistryFrontendService(\n  input?: FrontendProviderRegistryHydrationInput,\n): FrontendProviderRegistryFrontendService {\n  const service = new InMemoryFrontendProviderRegistryFrontendService();\n  service.initialize(input);\n  return service;\n}\n"]}

package/dist/esm/core/external-providers/provider-scope-reauthorization-offers.frontend.d.ts

@@ -3,8 +3,9 @@
  *
  * ## Why a store, and why it lives here
  *
- * A provider operation refused for a missing scope answers `409 PROVIDER_OPERATION_SCOPE_NOT_GRANTED` carrying a
- * `reauthorization` offer: which scopes a person may add by re-authorizing the connection, for which operation. The
+ * A provider operation refused for a missing scope answers `409` with `error.code` `PROVIDER_OPERATION_SCOPE_NOT_GRANTED`
+ * in the framework error body, carrying a `reauthorization` offer in `error.details`: which scopes a person may add by
+ * re-authorizing the connection, for which operation. The
  * refusal happens wherever the operation was called — a feature's own screen, a picker loading its options — while
  * growing the grant is an act on the CONNECTION, which the connected-accounts screen owns. Something has to carry the
  * offer from the one to the other, or the person meets a dead end at the feature and a screen that knows nothing
@@ -43,9 +44,10 @@ export interface ProviderScopeReauthorizationOfferOwner {
  */
 export declare function providerScopeReauthorizationOfferKey(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): string;
 /**
- * Whether a refused call's body carries a re-authorization offer — read by SHAPE, so the frontend holds no copy of the
- * backend's door error code. An offer names its connection, the ref to start through, the operation and the scope
- * lists; anything missing one of them is not an offer and is ignored rather than half-recorded.
+ * Whether a refused call's body carries a re-authorization offer — read by SHAPE from the framework error body's
+ * `error.details` (#2952), so the frontend does not have to branch on the door's error code. An offer names its
+ * connection, the ref to start through, the operation and the scope lists; anything missing one of them is not an offer
+ * and is ignored rather than half-recorded.
  */
 export declare function readProviderScopeReauthorizationOffer(body: unknown): ProviderScopeReauthorizationOffer | undefined;
 /** Record an offer for the owner whose grant the refused call spent, replacing an earlier one for that connection. */

package/dist/esm/core/external-providers/provider-scope-reauthorization-offers.frontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-scope-reauthorization-offers.frontend.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-scope-reauthorization-offers.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,sCAAsC,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjI;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,OAAO,GAAG,iCAAiC,GAAG,SAAS,CAMlH;AAED,sHAAsH;AACtH,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,sCAAsC,EAAE,KAAK,EAAE,iCAAiC,GAAG,IAAI,CAIrJ;AAED,2GAA2G;AAC3G,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,sCAAsC,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAMjI;AAED,qDAAqD;AACrD,wBAAgB,0CAA0C,IAAI,IAAI,CAGjE;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,IAAI,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAE9G;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,EAC9D,KAAK,EAAE,sCAAsC,EAC7C,aAAa,EAAE,MAAM,GACpB,iCAAiC,GAAG,SAAS,CAE/C;AAOD,mFAAmF;AACnF,wBAAgB,qCAAqC,IAAI,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAE9G"}
+{"version":3,"file":"provider-scope-reauthorization-offers.frontend.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-scope-reauthorization-offers.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,sCAAsC,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjI;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,OAAO,GAAG,iCAAiC,GAAG,SAAS,CAOlH;AAED,sHAAsH;AACtH,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,sCAAsC,EAAE,KAAK,EAAE,iCAAiC,GAAG,IAAI,CAIrJ;AAED,2GAA2G;AAC3G,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,sCAAsC,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAMjI;AAED,qDAAqD;AACrD,wBAAgB,0CAA0C,IAAI,IAAI,CAGjE;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,IAAI,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAE9G;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,EAC9D,KAAK,EAAE,sCAAsC,EAC7C,aAAa,EAAE,MAAM,GACpB,iCAAiC,GAAG,SAAS,CAE/C;AAOD,mFAAmF;AACnF,wBAAgB,qCAAqC,IAAI,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAE9G"}

package/dist/esm/core/external-providers/provider-scope-reauthorization-offers.frontend.js

@@ -3,8 +3,9 @@
  *
  * ## Why a store, and why it lives here
  *
- * A provider operation refused for a missing scope answers `409 PROVIDER_OPERATION_SCOPE_NOT_GRANTED` carrying a
- * `reauthorization` offer: which scopes a person may add by re-authorizing the connection, for which operation. The
+ * A provider operation refused for a missing scope answers `409` with `error.code` `PROVIDER_OPERATION_SCOPE_NOT_GRANTED`
+ * in the framework error body, carrying a `reauthorization` offer in `error.details`: which scopes a person may add by
+ * re-authorizing the connection, for which operation. The
  * refusal happens wherever the operation was called — a feature's own screen, a picker loading its options — while
  * growing the grant is an act on the CONNECTION, which the connected-accounts screen owns. Something has to carry the
  * offer from the one to the other, or the person meets a dead end at the feature and a screen that knows nothing
@@ -46,12 +47,14 @@ export function providerScopeReauthorizationOfferKey(owner, connectionRef) {
     return JSON.stringify([owner.ownerScope, owner.ownerId ?? null, connectionRef]);
 }
 /**
- * Whether a refused call's body carries a re-authorization offer — read by SHAPE, so the frontend holds no copy of the
- * backend's door error code. An offer names its connection, the ref to start through, the operation and the scope
- * lists; anything missing one of them is not an offer and is ignored rather than half-recorded.
+ * Whether a refused call's body carries a re-authorization offer — read by SHAPE from the framework error body's
+ * `error.details` (#2952), so the frontend does not have to branch on the door's error code. An offer names its
+ * connection, the ref to start through, the operation and the scope lists; anything missing one of them is not an offer
+ * and is ignored rather than half-recorded.
  */
 export function readProviderScopeReauthorizationOffer(body) {
-    const offer = body?.reauthorization;
+    const details = body?.error?.details;
+    const offer = details?.reauthorization;
     if (offer === undefined || offer === null || typeof offer !== 'object')
         return undefined;
     if (typeof offer.connectionRef !== 'string' || typeof offer.providerRef !== 'string' || typeof offer.operationId !== 'string')

package/dist/esm/core/external-providers/provider-scope-reauthorization-offers.frontend.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-scope-reauthorization-offers.frontend.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-scope-reauthorization-offers.frontend.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The re-authorization OFFERS a browser has been handed and not yet acted on (#1671, #1727).\n *\n * ## Why a store, and why it lives here\n *\n * A provider operation refused for a missing scope answers `409 PROVIDER_OPERATION_SCOPE_NOT_GRANTED` carrying a\n * `reauthorization` offer: which scopes a person may add by re-authorizing the connection, for which operation. The\n * refusal happens wherever the operation was called — a feature's own screen, a picker loading its options — while\n * growing the grant is an act on the CONNECTION, which the connected-accounts screen owns. Something has to carry the\n * offer from the one to the other, or the person meets a dead end at the feature and a screen that knows nothing\n * about it.\n *\n * The manual-calls client records every offer it sees (`executeProviderOperation`, `loadProviderOperationInputOptions`),\n * so no feature has to remember to; the connected-accounts screen reads them and shows \"grant more access\" on the\n * connection they belong to.\n *\n * ## Keyed on the OWNER as well as the connection\n *\n * One vendor connection exists per owner: a person's own Microsoft grant and their organization's Microsoft grant are\n * two grants with one `connectionRef`. An offer keyed on the connection alone would appear on whichever owner's screen\n * was opened next — and pressing it would grow a DIFFERENT owner's grant while its audit row named an operation that\n * was refused on the first. So an offer is recorded under the owner the refused call spent (`ownerScope`, `ownerId`),\n * and a screen reads only its own owner's.\n *\n * ## Deliberately in-memory, one per owner and connection\n *\n * An offer is a statement about ONE refused call in this browser session. It is not persisted: a reload loses it, and\n * the next refused call records it again — the backend recomputes the offer on every refusal, so nothing durable is\n * lost and nothing stale can outlive the page. Growing the grant leaves the page for the vendor, which also ends it.\n * The latest refusal replaces an earlier one for the same owner and connection; scopes the connection has since been\n * granted are filtered by the screen, not here.\n */\n\nimport { useSyncExternalStore } from 'react';\nimport type { ProviderScopeReauthorizationOffer } from '@wildo-ai/saas-models';\n\n/** Whose grant a refused call spent — the connection target's owner half. */\nexport interface ProviderScopeReauthorizationOfferOwner {\n  readonly ownerScope: string;\n  /** Absent for the application's own connection, which no settings screen grows. */\n  readonly ownerId?: string;\n}\n\ntype Listener = () => void;\n\nlet offersByKey: ReadonlyMap<string, ProviderScopeReauthorizationOffer> = new Map();\nconst listeners = new Set<Listener>();\n\nfunction publish(next: ReadonlyMap<string, ProviderScopeReauthorizationOffer>): void {\n  offersByKey = next;\n  for (const listener of listeners) listener();\n}\n\n/**\n * The store key of one owner's offer for one connection. JSON of a fixed-order tuple rather than a joined string, so\n * no separator a ref or an id could contain can make two different owners collide.\n */\nexport function providerScopeReauthorizationOfferKey(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): string {\n  return JSON.stringify([owner.ownerScope, owner.ownerId ?? null, connectionRef]);\n}\n\n/**\n * Whether a refused call's body carries a re-authorization offer — read by SHAPE, so the frontend holds no copy of the\n * backend's door error code. An offer names its connection, the ref to start through, the operation and the scope\n * lists; anything missing one of them is not an offer and is ignored rather than half-recorded.\n */\nexport function readProviderScopeReauthorizationOffer(body: unknown): ProviderScopeReauthorizationOffer | undefined {\n  const offer = (body as { reauthorization?: unknown } | null | undefined)?.reauthorization as Partial<ProviderScopeReauthorizationOffer> | undefined;\n  if (offer === undefined || offer === null || typeof offer !== 'object') return undefined;\n  if (typeof offer.connectionRef !== 'string' || typeof offer.providerRef !== 'string' || typeof offer.operationId !== 'string') return undefined;\n  if (!Array.isArray(offer.requestableScopes) || !Array.isArray(offer.administratorConsentScopes) || !Array.isArray(offer.unrequestableScopes)) return undefined;\n  return offer as ProviderScopeReauthorizationOffer;\n}\n\n/** Record an offer for the owner whose grant the refused call spent, replacing an earlier one for that connection. */\nexport function recordProviderScopeReauthorizationOffer(owner: ProviderScopeReauthorizationOfferOwner, offer: ProviderScopeReauthorizationOffer): void {\n  const next = new Map(offersByKey);\n  next.set(providerScopeReauthorizationOfferKey(owner, offer.connectionRef), offer);\n  publish(next);\n}\n\n/** Forget one owner's offer for one connection — after it was acted on, or when the connection is gone. */\nexport function clearProviderScopeReauthorizationOffer(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): void {\n  const key = providerScopeReauthorizationOfferKey(owner, connectionRef);\n  if (!offersByKey.has(key)) return;\n  const next = new Map(offersByKey);\n  next.delete(key);\n  publish(next);\n}\n\n/** Forget every offer. For a test's `beforeEach`. */\nexport function clearAllProviderScopeReauthorizationOffers(): void {\n  if (offersByKey.size === 0) return;\n  publish(new Map());\n}\n\n/** Every pending offer, keyed by {@link providerScopeReauthorizationOfferKey}. */\nexport function getProviderScopeReauthorizationOffers(): ReadonlyMap<string, ProviderScopeReauthorizationOffer> {\n  return offersByKey;\n}\n\n/** One owner's pending offer for one connection, from a snapshot of the store. */\nexport function findProviderScopeReauthorizationOffer(\n  offers: ReadonlyMap<string, ProviderScopeReauthorizationOffer>,\n  owner: ProviderScopeReauthorizationOfferOwner,\n  connectionRef: string,\n): ProviderScopeReauthorizationOffer | undefined {\n  return offers.get(providerScopeReauthorizationOfferKey(owner, connectionRef));\n}\n\nfunction subscribe(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => { listeners.delete(listener); };\n}\n\n/** The pending offers, re-rendering the caller when one is recorded or cleared. */\nexport function useProviderScopeReauthorizationOffers(): ReadonlyMap<string, ProviderScopeReauthorizationOffer> {\n  return useSyncExternalStore(subscribe, getProviderScopeReauthorizationOffers, getProviderScopeReauthorizationOffers);\n}\n"]}
+{"version":3,"file":"provider-scope-reauthorization-offers.frontend.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-scope-reauthorization-offers.frontend.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The re-authorization OFFERS a browser has been handed and not yet acted on (#1671, #1727).\n *\n * ## Why a store, and why it lives here\n *\n * A provider operation refused for a missing scope answers `409` with `error.code` `PROVIDER_OPERATION_SCOPE_NOT_GRANTED`\n * in the framework error body, carrying a `reauthorization` offer in `error.details`: which scopes a person may add by\n * re-authorizing the connection, for which operation. The\n * refusal happens wherever the operation was called — a feature's own screen, a picker loading its options — while\n * growing the grant is an act on the CONNECTION, which the connected-accounts screen owns. Something has to carry the\n * offer from the one to the other, or the person meets a dead end at the feature and a screen that knows nothing\n * about it.\n *\n * The manual-calls client records every offer it sees (`executeProviderOperation`, `loadProviderOperationInputOptions`),\n * so no feature has to remember to; the connected-accounts screen reads them and shows \"grant more access\" on the\n * connection they belong to.\n *\n * ## Keyed on the OWNER as well as the connection\n *\n * One vendor connection exists per owner: a person's own Microsoft grant and their organization's Microsoft grant are\n * two grants with one `connectionRef`. An offer keyed on the connection alone would appear on whichever owner's screen\n * was opened next — and pressing it would grow a DIFFERENT owner's grant while its audit row named an operation that\n * was refused on the first. So an offer is recorded under the owner the refused call spent (`ownerScope`, `ownerId`),\n * and a screen reads only its own owner's.\n *\n * ## Deliberately in-memory, one per owner and connection\n *\n * An offer is a statement about ONE refused call in this browser session. It is not persisted: a reload loses it, and\n * the next refused call records it again — the backend recomputes the offer on every refusal, so nothing durable is\n * lost and nothing stale can outlive the page. Growing the grant leaves the page for the vendor, which also ends it.\n * The latest refusal replaces an earlier one for the same owner and connection; scopes the connection has since been\n * granted are filtered by the screen, not here.\n */\n\nimport { useSyncExternalStore } from 'react';\nimport type { ProviderScopeReauthorizationOffer } from '@wildo-ai/saas-models';\n\n/** Whose grant a refused call spent — the connection target's owner half. */\nexport interface ProviderScopeReauthorizationOfferOwner {\n  readonly ownerScope: string;\n  /** Absent for the application's own connection, which no settings screen grows. */\n  readonly ownerId?: string;\n}\n\ntype Listener = () => void;\n\nlet offersByKey: ReadonlyMap<string, ProviderScopeReauthorizationOffer> = new Map();\nconst listeners = new Set<Listener>();\n\nfunction publish(next: ReadonlyMap<string, ProviderScopeReauthorizationOffer>): void {\n  offersByKey = next;\n  for (const listener of listeners) listener();\n}\n\n/**\n * The store key of one owner's offer for one connection. JSON of a fixed-order tuple rather than a joined string, so\n * no separator a ref or an id could contain can make two different owners collide.\n */\nexport function providerScopeReauthorizationOfferKey(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): string {\n  return JSON.stringify([owner.ownerScope, owner.ownerId ?? null, connectionRef]);\n}\n\n/**\n * Whether a refused call's body carries a re-authorization offer — read by SHAPE from the framework error body's\n * `error.details` (#2952), so the frontend does not have to branch on the door's error code. An offer names its\n * connection, the ref to start through, the operation and the scope lists; anything missing one of them is not an offer\n * and is ignored rather than half-recorded.\n */\nexport function readProviderScopeReauthorizationOffer(body: unknown): ProviderScopeReauthorizationOffer | undefined {\n  const details = (body as { error?: { details?: unknown } } | null | undefined)?.error?.details;\n  const offer = (details as { reauthorization?: unknown } | null | undefined)?.reauthorization as Partial<ProviderScopeReauthorizationOffer> | undefined;\n  if (offer === undefined || offer === null || typeof offer !== 'object') return undefined;\n  if (typeof offer.connectionRef !== 'string' || typeof offer.providerRef !== 'string' || typeof offer.operationId !== 'string') return undefined;\n  if (!Array.isArray(offer.requestableScopes) || !Array.isArray(offer.administratorConsentScopes) || !Array.isArray(offer.unrequestableScopes)) return undefined;\n  return offer as ProviderScopeReauthorizationOffer;\n}\n\n/** Record an offer for the owner whose grant the refused call spent, replacing an earlier one for that connection. */\nexport function recordProviderScopeReauthorizationOffer(owner: ProviderScopeReauthorizationOfferOwner, offer: ProviderScopeReauthorizationOffer): void {\n  const next = new Map(offersByKey);\n  next.set(providerScopeReauthorizationOfferKey(owner, offer.connectionRef), offer);\n  publish(next);\n}\n\n/** Forget one owner's offer for one connection — after it was acted on, or when the connection is gone. */\nexport function clearProviderScopeReauthorizationOffer(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): void {\n  const key = providerScopeReauthorizationOfferKey(owner, connectionRef);\n  if (!offersByKey.has(key)) return;\n  const next = new Map(offersByKey);\n  next.delete(key);\n  publish(next);\n}\n\n/** Forget every offer. For a test's `beforeEach`. */\nexport function clearAllProviderScopeReauthorizationOffers(): void {\n  if (offersByKey.size === 0) return;\n  publish(new Map());\n}\n\n/** Every pending offer, keyed by {@link providerScopeReauthorizationOfferKey}. */\nexport function getProviderScopeReauthorizationOffers(): ReadonlyMap<string, ProviderScopeReauthorizationOffer> {\n  return offersByKey;\n}\n\n/** One owner's pending offer for one connection, from a snapshot of the store. */\nexport function findProviderScopeReauthorizationOffer(\n  offers: ReadonlyMap<string, ProviderScopeReauthorizationOffer>,\n  owner: ProviderScopeReauthorizationOfferOwner,\n  connectionRef: string,\n): ProviderScopeReauthorizationOffer | undefined {\n  return offers.get(providerScopeReauthorizationOfferKey(owner, connectionRef));\n}\n\nfunction subscribe(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => { listeners.delete(listener); };\n}\n\n/** The pending offers, re-rendering the caller when one is recorded or cleared. */\nexport function useProviderScopeReauthorizationOffers(): ReadonlyMap<string, ProviderScopeReauthorizationOffer> {\n  return useSyncExternalStore(subscribe, getProviderScopeReauthorizationOffers, getProviderScopeReauthorizationOffers);\n}\n"]}

package/dist/esm/core/features/FeaturesContext.d.ts

@@ -6,7 +6,8 @@
  * Responsibilities:
  * - Receives the merged FeatureConfiguration (core + custom) from app initialization
  * - Builds a definitions map for fast lookup
- * - Fetches resolved features from backend API: GET /api/v1/features/resolved
+ * - Fetches resolved features from backend API: GET /api/v1/features/resolved, FOR the organization the
+ *   person is currently in (`?organizationId=`, see `fetchResolvedFeatures`)
  * - Caches resolved features in context state
  * - Invalidates on WebSocket events (FEATURES_CHANGED, BILLING_STATUS_CHANGED, etc.)
  * - Exposes raw resolved features + definitions + unavailability policy
@@ -22,6 +23,13 @@ export interface FeaturesContextType {
     resolvedFeatures: ResolvedFeaturesWithUsage;
     /** Full response including upgrade options */
     resolvedFeaturesResponse: ResolvedFeaturesResponse | null;
+    /**
+     * The organization the CURRENT response was resolved for, `null` for one resolved at application scope or none yet
+     * (#2464 review L1). The response is kept across an organization switch until the next one lands, so features do not
+     * flicker; a surface showing a number ABOUT one organization (usage beside a limit) compares this, not the current
+     * organization, or it shows the previous organization's numbers for one fetch.
+     */
+    resolvedForOrganizationId: string | null;
     /** Feature definitions map (built from featureConfiguration.definitions) */
     featureDefinitions: Map<string, FeatureDefinition>;
     /** The unavailability policy (from featureConfiguration.unavailabilityPolicy) */

package/dist/esm/core/features/FeaturesContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeaturesContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/FeaturesContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAuF,MAAM,OAAO,CAAC;AAC5G,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAoC/B,MAAM,WAAW,mBAAmB;IAElC,+DAA+D;IAC/D,gBAAgB,EAAE,yBAAyB,CAAC;IAC5C,8CAA8C;IAC9C,wBAAwB,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAG1D,4EAA4E;IAC5E,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAGnD,iFAAiF;IACjF,oBAAoB,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IAGnE,mFAAmF;IACnF,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,kGAAkG;IAClG,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACpD,yEAAyE;IACzE,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,uFAAuF;IACvF,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAGhE,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAGpB,wFAAwF;IACxF,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AASD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAA6D,CAAC;AAMzI,UAAU,qBAAqB;IAC7B,mFAAmF;IACnF,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,oBAAoB,EAAE,QAAQ,EAAE,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CA6P9G"}
+{"version":3,"file":"FeaturesContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/FeaturesContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAuF,MAAM,OAAO,CAAC;AAC5G,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAoC/B,MAAM,WAAW,mBAAmB;IAElC,+DAA+D;IAC/D,gBAAgB,EAAE,yBAAyB,CAAC;IAC5C,8CAA8C;IAC9C,wBAAwB,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC1D;;;;;OAKG;IACH,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IAGzC,4EAA4E;IAC5E,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAGnD,iFAAiF;IACjF,oBAAoB,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IAGnE,mFAAmF;IACnF,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,kGAAkG;IAClG,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACpD,yEAAyE;IACzE,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,uFAAuF;IACvF,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAGhE,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAGpB,wFAAwF;IACxF,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AASD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAA6D,CAAC;AAMzI,UAAU,qBAAqB;IAC7B,mFAAmF;IACnF,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,oBAAoB,EAAE,QAAQ,EAAE,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CA0R9G"}