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

package/dist/esm/core/features/FeatureGate.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureGate.js","sourceRoot":"","sources":["../../../../../src/core/features/FeatureGate.tsx"],"names":[],"mappings":";AAsBA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,6EAA6E,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAgBrF,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,iBAAiB,GACA;IACjB,MAAM,YAAY,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IAEzC,yCAAyC;IACzC,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,iCAAiC;IACjC,IAAI,YAAY,CAAC,QAAQ,KAAK,6BAA6B,CAAC,IAAI,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IACtC,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,4BAAG,iBAAiB,CAAC,YAAY,CAAC,GAAI,CAAC;IAChD,CAAC;IAED,6EAA6E;IAC7E,4EAA4E;IAC5E,OAAO,CACL,KAAC,wBAAwB,IACvB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAC/B,eAAe,EAAE,YAAY,CAAC,eAAe,EAC7C,SAAS,EAAE,YAAY,CAAC,SAAS,EACjC,mBAAmB,EAAE,YAAY,CAAC,cAAc,EAAE,MAAM,EACxD,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAC3C,CACH,CAAC;AACJ,CAAC","sourcesContent":["/**\n * FeatureGate — Declarative feature gating component\n * \n * Wraps children with a feature availability check. If the feature is available,\n * renders children. If not, automatically renders the policy-driven prompt.\n * \n * Usage:\n *   const analyticsFeatureId = APP_FEATURE_IDS.ADVANCED_ANALYTICS;\n *\n *   <FeatureGate featureId={analyticsFeatureId}>\n *     <AnalyticsDashboard />\n *   </FeatureGate>\n * \n *   // Custom rendering when unavailable:\n *   <FeatureGate featureId={analyticsFeatureId} renderUnavailable={(availability) => (\n *     <MyCustomUpsell availability={availability} />\n *   )}>\n *     <AnalyticsDashboard />\n *   </FeatureGate>\n */\n\nimport React from 'react';\nimport { FeatureUnavailabilityBehavior } from '@wildo-ai/saas-models';\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\nimport { FeatureUnavailablePrompt } from '~wildo-frontend-lib/components/feedback/features/feature-unavailable-prompt';\nimport { useBillingAction } from '~wildo-frontend-lib/core/billing/useBillingAction';\n\n// Note: useFeatureGate hook is in a separate file (useFeatureGate.ts) for React Fast Refresh compatibility.\n\nexport interface FeatureGateProps {\n  /** Feature identifier to check */\n  featureId: string;\n  /** Content to render when the feature is available */\n  children: React.ReactNode;\n  /** \n   * Optional custom renderer when the feature is unavailable.\n   * If omitted, renders the policy-driven FeatureUnavailablePrompt automatically.\n   */\n  renderUnavailable?: (availability: FeatureAvailability) => React.ReactNode;\n}\n\nexport function FeatureGate({\n  featureId,\n  children,\n  renderUnavailable,\n}: FeatureGateProps): React.JSX.Element | null {\n  const availability = useFeatureAvailability(featureId);\n  const billingAction = useBillingAction();\n\n  // Feature is available → render children\n  if (availability.isAvailable) {\n    return <>{children}</>;\n  }\n\n  // HIDE behavior → render nothing\n  if (availability.behavior === FeatureUnavailabilityBehavior.HIDE) {\n    return null;\n  }\n\n  // Custom renderer provided → delegate\n  if (renderUnavailable) {\n    return <>{renderUnavailable(availability)}</>;\n  }\n\n  // Default: policy-driven prompt. Inline FeatureGate surfaces do not expose a\n  // generic \"go back\" action because they are embedded into the current page.\n  return (\n    <FeatureUnavailablePrompt\n      behavior={availability.behavior}\n      missingFeatures={availability.missingFeatures}\n      limitInfo={availability.limitInfo}\n      upgradeOptionsCount={availability.upgradeOptions?.length}\n      onDismiss={undefined}\n      onAction={() => billingAction(availability)}\n    />\n  );\n}\n"]}
+{"version":3,"file":"FeatureGate.js","sourceRoot":"","sources":["../../../../src/core/features/FeatureGate.tsx"],"names":[],"mappings":";AAsBA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,6EAA6E,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAgBrF,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,iBAAiB,GACA;IACjB,MAAM,YAAY,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IAEzC,yCAAyC;IACzC,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,iCAAiC;IACjC,IAAI,YAAY,CAAC,QAAQ,KAAK,6BAA6B,CAAC,IAAI,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IACtC,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,4BAAG,iBAAiB,CAAC,YAAY,CAAC,GAAI,CAAC;IAChD,CAAC;IAED,6EAA6E;IAC7E,4EAA4E;IAC5E,OAAO,CACL,KAAC,wBAAwB,IACvB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAC/B,eAAe,EAAE,YAAY,CAAC,eAAe,EAC7C,SAAS,EAAE,YAAY,CAAC,SAAS,EACjC,mBAAmB,EAAE,YAAY,CAAC,cAAc,EAAE,MAAM,EACxD,kBAAkB,EAAE,YAAY,CAAC,kBAAkB,EACnD,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAC3C,CACH,CAAC;AACJ,CAAC","sourcesContent":["/**\n * FeatureGate — Declarative feature gating component\n * \n * Wraps children with a feature availability check. If the feature is available,\n * renders children. If not, automatically renders the policy-driven prompt.\n * \n * Usage:\n *   const analyticsFeatureId = APP_FEATURE_IDS.ADVANCED_ANALYTICS;\n *\n *   <FeatureGate featureId={analyticsFeatureId}>\n *     <AnalyticsDashboard />\n *   </FeatureGate>\n * \n *   // Custom rendering when unavailable:\n *   <FeatureGate featureId={analyticsFeatureId} renderUnavailable={(availability) => (\n *     <MyCustomUpsell availability={availability} />\n *   )}>\n *     <AnalyticsDashboard />\n *   </FeatureGate>\n */\n\nimport React from 'react';\nimport { FeatureUnavailabilityBehavior } from '@wildo-ai/saas-models';\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\nimport { FeatureUnavailablePrompt } from '~wildo-frontend-lib/components/feedback/features/feature-unavailable-prompt';\nimport { useBillingAction } from '~wildo-frontend-lib/core/billing/useBillingAction';\n\n// Note: useFeatureGate hook is in a separate file (useFeatureGate.ts) for React Fast Refresh compatibility.\n\nexport interface FeatureGateProps {\n  /** Feature identifier to check */\n  featureId: string;\n  /** Content to render when the feature is available */\n  children: React.ReactNode;\n  /** \n   * Optional custom renderer when the feature is unavailable.\n   * If omitted, renders the policy-driven FeatureUnavailablePrompt automatically.\n   */\n  renderUnavailable?: (availability: FeatureAvailability) => React.ReactNode;\n}\n\nexport function FeatureGate({\n  featureId,\n  children,\n  renderUnavailable,\n}: FeatureGateProps): React.JSX.Element | null {\n  const availability = useFeatureAvailability(featureId);\n  const billingAction = useBillingAction();\n\n  // Feature is available → render children\n  if (availability.isAvailable) {\n    return <>{children}</>;\n  }\n\n  // HIDE behavior → render nothing\n  if (availability.behavior === FeatureUnavailabilityBehavior.HIDE) {\n    return null;\n  }\n\n  // Custom renderer provided → delegate\n  if (renderUnavailable) {\n    return <>{renderUnavailable(availability)}</>;\n  }\n\n  // Default: policy-driven prompt. Inline FeatureGate surfaces do not expose a\n  // generic \"go back\" action because they are embedded into the current page.\n  return (\n    <FeatureUnavailablePrompt\n      behavior={availability.behavior}\n      missingFeatures={availability.missingFeatures}\n      limitInfo={availability.limitInfo}\n      upgradeOptionsCount={availability.upgradeOptions?.length}\n      customComponentRef={availability.customComponentRef}\n      onDismiss={undefined}\n      onAction={() => billingAction(availability)}\n    />\n  );\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"FeatureRouteGuard.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/FeatureRouteGuard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAc7H,UAAU,sBAAsB;IAC9B,mDAAmD;IACnD,SAAS,CAAC,EAAE,uCAAuC,CAAC;IACpD,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAMD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAqF9D,CAAC"}
+{"version":3,"file":"FeatureRouteGuard.d.ts","sourceRoot":"","sources":["../../../../src/core/features/FeatureRouteGuard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAc7H,UAAU,sBAAsB;IAC9B,mDAAmD;IACnD,SAAS,CAAC,EAAE,uCAAuC,CAAC;IACpD,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAMD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAsF9D,CAAC"}

package/dist/esm/core/features/FeatureRouteGuard.js

@@ -88,6 +88,6 @@ export const FeatureRouteGuard = ({ operation, requiredFeatures, children, }) =>
         return null;
     }
     // All other behaviors → single reusable prompt (adapts per behavior)
-    return (_jsx(FeatureUnavailablePrompt, { behavior: availability.behavior, missingFeatures: availability.missingFeatures, limitInfo: availability.limitInfo, upgradeOptionsCount: availability.upgradeOptions?.length, onDismiss: handleDismiss, onAction: () => billingAction(availability) }));
+    return (_jsx(FeatureUnavailablePrompt, { behavior: availability.behavior, missingFeatures: availability.missingFeatures, limitInfo: availability.limitInfo, upgradeOptionsCount: availability.upgradeOptions?.length, customComponentRef: availability.customComponentRef, onDismiss: handleDismiss, onAction: () => billingAction(availability) }));
 };
 //# sourceMappingURL=FeatureRouteGuard.js.map

package/dist/esm/core/features/FeatureRouteGuard.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureRouteGuard.js","sourceRoot":"","sources":["../../../../../src/core/features/FeatureRouteGuard.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,6BAA6B,GAG9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,+BAA+B,EAAkC,MAAM,mCAAmC,CAAC;AACpH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6EAA6E,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,2EAA2E,CAAC;AAevH,mCAAmC;AACnC,YAAY;AACZ,mCAAmC;AAEnC,MAAM,CAAC,MAAM,iBAAiB,GAAqC,CAAC,EAClE,SAAS,EACT,gBAAgB,EAChB,QAAQ,GACT,EAAE,EAAE;IACH,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,iBAAiB,GAAG,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE9D,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAC5C,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAChC,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAA0E,CAAC;QAC1I,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAElC,MAAM,YAAY,GAAG,+BAA+B,CAAC,kBAAkB,CAAC,CAAC;IAEzE,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QAC1C,0BAA0B,CAAC;YACzB,IAAI;YACJ,cAAc,EAAE,QAAQ;SACzB,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErB,+EAA+E;IAC/E,oCAAoC;IACpC,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QAC3C,IAAI,iBAAiB,EAAE,CAAC;YACtB,+FAA+F;YAC/F,iFAAiF;YACjF,MAAM,MAAM,GAAG,eAAe,CAAC,mBAAmB,CAAC;gBACjD,iBAAiB,EAAE,eAAe,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACpG,YAAY,EAAE,iBAAiB,CAAC,YAAY;aAC7C,CAAC,CAAC;YACH,IAAI,MAAM,EAAE,UAAU,EAAE,CAAC;gBACvB,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3D,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/C,OAAO;YACT,CAAC;QACH,CAAC;QAED,YAAY,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEtD,uEAAuE;IACvE,0EAA0E;IAC1E,qEAAqE;IACrE,MAAM,UAAU,GACd,YAAY,KAAK,SAAS;QAC1B,CAAC,YAAY,CAAC,WAAW;QACzB,YAAY,CAAC,QAAQ,KAAK,6BAA6B,CAAC,IAAI,CAAC;IAE/D,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,YAAY,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAE/B,kCAAkC;IAClC,IAAI,CAAC,YAAY;QAAE,OAAO,4BAAG,QAAQ,GAAI,CAAC;IAE1C,2CAA2C;IAC3C,IAAI,YAAY,CAAC,WAAW;QAAE,OAAO,4BAAG,QAAQ,GAAI,CAAC;IAErD,gCAAgC;IAChC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qEAAqE;IACrE,OAAO,CACL,KAAC,wBAAwB,IACvB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAC/B,eAAe,EAAE,YAAY,CAAC,eAAe,EAC7C,SAAS,EAAE,YAAY,CAAC,SAAS,EACjC,mBAAmB,EAAE,YAAY,CAAC,cAAc,EAAE,MAAM,EACxD,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAC3C,CACH,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * FeatureRouteGuard\n * \n * Route-level guard that checks feature availability before rendering page content.\n * Routes are always registered (so deep links and bookmarks work), but the guard\n * intercepts rendering when a feature is unavailable.\n * \n * Behavior is determined by the feature unavailability policy:\n * - HIDE → Navigate to home\n * - All other behaviors → FeatureUnavailablePrompt (adapts content per behavior)\n * \n * The prompt renders INSIDE the app layout (sidebar stays visible) — it replaces\n * only the route content area, not the entire page.\n */\n\nimport React from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport {\n  FeatureUnavailabilityBehavior,\n  NavigationZoneName,\n  type RequiredFeaturesConfig,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useOperationFeatureAvailability, type RequiredFeaturesCheckable } from './useOperationFeatureAvailability';\nimport { FeatureUnavailablePrompt } from '~wildo-frontend-lib/components/feedback/features/feature-unavailable-prompt';\nimport { useBillingAction } from '~wildo-frontend-lib/core/billing/useBillingAction';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { NavigationContext } from '~wildo-frontend-lib/core/navigation/NavigationContext';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { navigateHomeWithFreshStart } from '~wildo-frontend-lib/core/navigation/navigation-clean-break.frontend.utils';\n\n// ================================\n// Props\n// ================================\n\ninterface FeatureRouteGuardProps {\n  /** For resource routes: the operation to check. */\n  operation?: FrontendResourceConfiguration_Operation;\n  /** For view routes: the view's required features config. */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /** The page content to render when features are available */\n  children: React.ReactNode;\n}\n\n// ================================\n// Component\n// ================================\n\nexport const FeatureRouteGuard: React.FC<FeatureRouteGuardProps> = ({\n  operation,\n  requiredFeatures,\n  children,\n}) => {\n  const navigate = useNavigate();\n  const billingAction = useBillingAction();\n  const { emit } = useEventBus();\n  const navigationContext = React.useContext(NavigationContext);\n\n  const effectiveOperation = React.useMemo(() => {\n    if (operation) return operation;\n    if (requiredFeatures) {\n      return { requiredFeatures, operationIdentifier: 'VIEW_ACCESS' } as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation;\n    }\n    return null;\n  }, [operation, requiredFeatures]);\n\n  const availability = useOperationFeatureAvailability(effectiveOperation);\n\n  const navigateHome = React.useCallback(() => {\n    navigateHomeWithFreshStart({\n      emit,\n      routerNavigate: navigate,\n    });\n  }, [emit, navigate]);\n\n  // Dismiss handler: prefer runtime-owned back semantics, otherwise fall back to\n  // a full fresh-start redirect home.\n  const handleDismiss = React.useCallback(() => {\n    if (navigationContext) {\n      // The ONE go-back resolver (see `NavigationUtils.resolveGoBackTarget`): a hosted pane's URL is\n      // composed under its host here exactly as the controller's `goBack` composes it.\n      const target = NavigationUtils.resolveGoBackTarget({\n        currentBrowserUrl: NavigationUtils.buildBrowserUrl(window.location.pathname, window.location.search),\n        getZoneState: navigationContext.getZoneState,\n      });\n      if (target?.browserUrl) {\n        emit(FrontendEvents.NAVIGATION_POP, { zone: target.zone });\n        navigate(target.browserUrl, { replace: true });\n        return;\n      }\n    }\n\n    navigateHome();\n  }, [emit, navigate, navigateHome, navigationContext]);\n\n  // Computed (and the effect registered) BEFORE the early returns below:\n  // `availability` flips between undefined / available / unavailable across\n  // renders, so the hook count must not depend on it (rules of hooks).\n  const shouldHide =\n    availability !== undefined &&\n    !availability.isAvailable &&\n    availability.behavior === FeatureUnavailabilityBehavior.HIDE;\n\n  React.useEffect(() => {\n    if (!shouldHide) {\n      return;\n    }\n\n    navigateHome();\n  }, [navigateHome, shouldHide]);\n\n  // No requiredFeatures → no gating\n  if (!availability) return <>{children}</>;\n\n  // Features are available → render children\n  if (availability.isAvailable) return <>{children}</>;\n\n  // HIDE → navigate away silently\n  if (shouldHide) {\n    return null;\n  }\n\n  // All other behaviors → single reusable prompt (adapts per behavior)\n  return (\n    <FeatureUnavailablePrompt\n      behavior={availability.behavior}\n      missingFeatures={availability.missingFeatures}\n      limitInfo={availability.limitInfo}\n      upgradeOptionsCount={availability.upgradeOptions?.length}\n      onDismiss={handleDismiss}\n      onAction={() => billingAction(availability)}\n    />\n  );\n};\n"]}
+{"version":3,"file":"FeatureRouteGuard.js","sourceRoot":"","sources":["../../../../src/core/features/FeatureRouteGuard.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * FeatureRouteGuard\n * \n * Route-level guard that checks feature availability before rendering page content.\n * Routes are always registered (so deep links and bookmarks work), but the guard\n * intercepts rendering when a feature is unavailable.\n * \n * Behavior is determined by the feature unavailability policy:\n * - HIDE → Navigate to home\n * - All other behaviors → FeatureUnavailablePrompt (adapts content per behavior)\n * \n * The prompt renders INSIDE the app layout (sidebar stays visible) — it replaces\n * only the route content area, not the entire page.\n */\n\nimport React from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport {\n  FeatureUnavailabilityBehavior,\n  NavigationZoneName,\n  type RequiredFeaturesConfig,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useOperationFeatureAvailability, type RequiredFeaturesCheckable } from './useOperationFeatureAvailability';\nimport { FeatureUnavailablePrompt } from '~wildo-frontend-lib/components/feedback/features/feature-unavailable-prompt';\nimport { useBillingAction } from '~wildo-frontend-lib/core/billing/useBillingAction';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { NavigationContext } from '~wildo-frontend-lib/core/navigation/NavigationContext';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { navigateHomeWithFreshStart } from '~wildo-frontend-lib/core/navigation/navigation-clean-break.frontend.utils';\n\n// ================================\n// Props\n// ================================\n\ninterface FeatureRouteGuardProps {\n  /** For resource routes: the operation to check. */\n  operation?: FrontendResourceConfiguration_Operation;\n  /** For view routes: the view's required features config. */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /** The page content to render when features are available */\n  children: React.ReactNode;\n}\n\n// ================================\n// Component\n// ================================\n\nexport const FeatureRouteGuard: React.FC<FeatureRouteGuardProps> = ({\n  operation,\n  requiredFeatures,\n  children,\n}) => {\n  const navigate = useNavigate();\n  const billingAction = useBillingAction();\n  const { emit } = useEventBus();\n  const navigationContext = React.useContext(NavigationContext);\n\n  const effectiveOperation = React.useMemo(() => {\n    if (operation) return operation;\n    if (requiredFeatures) {\n      return { requiredFeatures, operationIdentifier: 'VIEW_ACCESS' } as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation;\n    }\n    return null;\n  }, [operation, requiredFeatures]);\n\n  const availability = useOperationFeatureAvailability(effectiveOperation);\n\n  const navigateHome = React.useCallback(() => {\n    navigateHomeWithFreshStart({\n      emit,\n      routerNavigate: navigate,\n    });\n  }, [emit, navigate]);\n\n  // Dismiss handler: prefer runtime-owned back semantics, otherwise fall back to\n  // a full fresh-start redirect home.\n  const handleDismiss = React.useCallback(() => {\n    if (navigationContext) {\n      // The ONE go-back resolver (see `NavigationUtils.resolveGoBackTarget`): a hosted pane's URL is\n      // composed under its host here exactly as the controller's `goBack` composes it.\n      const target = NavigationUtils.resolveGoBackTarget({\n        currentBrowserUrl: NavigationUtils.buildBrowserUrl(window.location.pathname, window.location.search),\n        getZoneState: navigationContext.getZoneState,\n      });\n      if (target?.browserUrl) {\n        emit(FrontendEvents.NAVIGATION_POP, { zone: target.zone });\n        navigate(target.browserUrl, { replace: true });\n        return;\n      }\n    }\n\n    navigateHome();\n  }, [emit, navigate, navigateHome, navigationContext]);\n\n  // Computed (and the effect registered) BEFORE the early returns below:\n  // `availability` flips between undefined / available / unavailable across\n  // renders, so the hook count must not depend on it (rules of hooks).\n  const shouldHide =\n    availability !== undefined &&\n    !availability.isAvailable &&\n    availability.behavior === FeatureUnavailabilityBehavior.HIDE;\n\n  React.useEffect(() => {\n    if (!shouldHide) {\n      return;\n    }\n\n    navigateHome();\n  }, [navigateHome, shouldHide]);\n\n  // No requiredFeatures → no gating\n  if (!availability) return <>{children}</>;\n\n  // Features are available → render children\n  if (availability.isAvailable) return <>{children}</>;\n\n  // HIDE → navigate away silently\n  if (shouldHide) {\n    return null;\n  }\n\n  // All other behaviors → single reusable prompt (adapts per behavior)\n  return (\n    <FeatureUnavailablePrompt\n      behavior={availability.behavior}\n      missingFeatures={availability.missingFeatures}\n      limitInfo={availability.limitInfo}\n      upgradeOptionsCount={availability.upgradeOptions?.length}\n      customComponentRef={availability.customComponentRef}\n      onDismiss={handleDismiss}\n      onAction={() => billingAction(availability)}\n    />\n  );\n};\n"]}

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,KAA2E,MAAM,OAAO,CAAC;AAChG,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAiC/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,CAoO9G"}
+{"version":3,"file":"FeaturesContext.d.ts","sourceRoot":"","sources":["../../../../src/core/features/FeaturesContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA2E,MAAM,OAAO,CAAC;AAChG,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAiC/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,CAoO9G"}

package/dist/esm/core/features/FeaturesContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeaturesContext.js","sourceRoot":"","sources":["../../../../../src/core/features/FeaturesContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * FeaturesContext\n *\n * Central context for feature gating on the frontend.\n *\n * Responsibilities:\n * - Receives the merged FeatureConfiguration (core + custom) from app initialization\n * - Builds a definitions map for fast lookup\n * - Fetches resolved features from backend API: GET /api/v1/features/resolved\n * - Caches resolved features in context state\n * - Invalidates on WebSocket events (FEATURES_CHANGED, BILLING_STATUS_CHANGED, etc.)\n * - Exposes raw resolved features + definitions + unavailability policy\n *\n * Frontend limit checking is ADVISORY — backend gate is authoritative.\n * Stale usage data means the frontend might allow a click that the backend rejects\n * (which is acceptable — the error is caught and displayed).\n */\n\nimport React, { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';\nimport {\n  CoreWebSocketEvent,\n  FEATURES_UNLIMITED,\n  MAIN_API_BASE_PATH,\n  type FeatureConfiguration,\n  type FeatureDefinition,\n  type ResolvedFeaturesResponse,\n  type ResolvedFeaturesWithUsage,\n} from '@wildo-ai/saas-models';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\nimport { useAuthSession } from '~wildo-frontend-lib/core/security/useAuthSession';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\n\n// ================================\n// Logger\n// ================================\n\nconst featuresLogger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = featuresLogger.debugByType('FeaturesContext');\nfeaturesLogger.setDebugTypeLogging('FeaturesContext', false);\n\n// ================================\n// Constants\n// ================================\n\nconst FEATURES_API_URL = `${MAIN_API_BASE_PATH}/features/resolved`;\n\n/** WebSocket events that trigger a refetch of resolved features */\nconst INVALIDATION_EVENTS = [\n  CoreWebSocketEvent.BILLING_STATUS_CHANGED,\n  CoreWebSocketEvent.BILLING_SUBSCRIPTION_UPDATED,\n  CoreWebSocketEvent.BILLING_ACCOUNT_CHANGED,\n  CoreWebSocketEvent.BILLING_FEATURES_UPDATED,\n] as const;\n\n// ================================\n// Context Type\n// ================================\n\nexport interface FeaturesContextType {\n  // ── Resolved features from backend ──\n  /** Raw resolved features with usage data (from backend API) */\n  resolvedFeatures: ResolvedFeaturesWithUsage;\n  /** Full response including upgrade options */\n  resolvedFeaturesResponse: ResolvedFeaturesResponse | null;\n\n  // ── Feature definitions (from configuration) ──\n  /** Feature definitions map (built from featureConfiguration.definitions) */\n  featureDefinitions: Map<string, FeatureDefinition>;\n\n  // ── Policy ──\n  /** The unavailability policy (from featureConfiguration.unavailabilityPolicy) */\n  unavailabilityPolicy: FeatureConfiguration['unavailabilityPolicy'];\n\n  // ── Convenience accessors ──\n  /** Check if a boolean feature is ENTITLED for the current scope (plan/profile). */\n  isFeatureEnabled: (featureId: string) => boolean;\n  /**\n   * Check if the app OFFERS a feature for the current scope — entitled now, or\n   * reachable via an upgrade/add-on. Plan-independent survival signal, distinct\n   * from `isFeatureEnabled` (entitlement). See the impl for the two-axis rationale.\n   */\n  isFeatureOffered: (featureId: string) => boolean;\n  /** Get a limit value (FEATURES_UNLIMITED = unlimited). Returns undefined if feature not found. */\n  getLimit: (featureId: string) => number | undefined;\n  /** Get current usage for a limit feature. undefined if no usage data. */\n  getCurrentUsage: (featureId: string) => number | undefined;\n  /** Get remaining capacity (limit - current). undefined if unlimited or no counting. */\n  getRemainingCapacity: (featureId: string) => number | undefined;\n\n  // ── State ──\n  isLoading: boolean;\n  error: Error | null;\n\n  // ── Actions ──\n  /** Force refetch of resolved features (e.g., after a mutation on a counted resource) */\n  refetch: () => void;\n}\n\n// ── Default empty state ──\nconst EMPTY_RESOLVED: ResolvedFeaturesWithUsage = {\n  features: [],\n  limits: {},\n  currentUsage: {},\n};\n\nexport const FeaturesContext: React.Context<FeaturesContextType | undefined> = createContext<FeaturesContextType | undefined>(undefined);\n\n// ================================\n// Provider\n// ================================\n\ninterface FeaturesProviderProps {\n  /** Merged FeatureConfiguration (core + custom) — passed from app initialization */\n  featureConfiguration: FeatureConfiguration;\n  children: React.ReactNode;\n}\n\nexport function FeaturesProvider({ featureConfiguration, children }: FeaturesProviderProps): React.ReactElement {\n  // ── State ──\n  const [resolvedFeaturesResponse, setResolvedFeaturesResponse] = useState<ResolvedFeaturesResponse | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  // ── Refs for stable callbacks ──\n  const fetchInFlightRef = useRef<boolean>(false);\n  const mountedRef = useRef<boolean>(true);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // ── Auth — features are user-scoped, only fetch when authenticated ──\n  const { isAuthenticated } = useAuthSession();\n  const authenticated = isAuthenticated();\n  const appScope = useAppScopeSafe();\n  const currentOrganizationId = appScope?.currentOrganizationId ?? null;\n\n  // ── WebSocket ──\n  const { on } = useWebSocket();\n\n  // ── Build definitions map from configuration ──\n  const featureDefinitions = useMemo(() => {\n    const map = new Map<string, FeatureDefinition>();\n    for (const def of featureConfiguration.definitions) {\n      map.set(def.identifier, def);\n    }\n    logDebug('Feature definitions map built', { count: map.size });\n    return map;\n  }, [featureConfiguration.definitions]);\n\n  // ── Unavailability policy ──\n  const unavailabilityPolicy = useMemo(\n    () => featureConfiguration.unavailabilityPolicy,\n    [featureConfiguration.unavailabilityPolicy],\n  );\n\n  // ── Derived resolved features ──\n  const resolvedFeatures: ResolvedFeaturesWithUsage = useMemo(() => {\n    if (!resolvedFeaturesResponse) return EMPTY_RESOLVED;\n    return {\n      features: resolvedFeaturesResponse.features,\n      limits: resolvedFeaturesResponse.limits,\n      currentUsage: resolvedFeaturesResponse.currentUsage,\n    };\n  }, [resolvedFeaturesResponse]);\n\n  const clearResolvedFeatures = useCallback(() => {\n    setResolvedFeaturesResponse(null);\n    setError(null);\n    setIsLoading(false);\n  }, []);\n\n  // ── Fetch resolved features from backend ──\n  const fetchResolvedFeatures = useCallback(async () => {\n    if (fetchInFlightRef.current) return;\n    fetchInFlightRef.current = true;\n\n    try {\n      logDebug('Fetching resolved features from backend');\n      const httpClient = getManualCallsHttpClient();\n      const response = await httpClient.get<ResolvedFeaturesResponse>(FEATURES_API_URL);\n\n      if (mountedRef.current) {\n        setResolvedFeaturesResponse(response);\n        setError(null);\n        logDebug('Resolved features fetched', {\n          featureCount: response.features.length,\n          limitCount: Object.keys(response.limits).length,\n          usageCount: Object.keys(response.currentUsage).length,\n        });\n      }\n    } catch (err: any) {\n      if (mountedRef.current) {\n        setError(err instanceof Error ? err : new Error(err?.message ?? 'Failed to fetch features'));\n        logDebug('Failed to fetch resolved features', { error: err?.message });\n      }\n    } finally {\n      if (mountedRef.current) {\n        setIsLoading(false);\n      }\n      fetchInFlightRef.current = false;\n    }\n  }, []);\n\n  // ── Fetch when authenticated (and refetch on auth change) ──\n  useEffect(() => {\n    mountedRef.current = true;\n    if (authenticated) {\n      setIsLoading(true);\n      fetchResolvedFeatures();\n    } else {\n      clearResolvedFeatures();\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [authenticated, currentOrganizationId, fetchResolvedFeatures, clearResolvedFeatures]);\n\n  // ── WebSocket invalidation (debounced to coalesce rapid events) ──\n  useEffect(() => {\n    if (!authenticated) return;\n\n    const unsubscribers: Array<() => void> = [];\n\n    const debouncedRefetch = () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = null;\n        fetchResolvedFeatures();\n      }, 300);\n    };\n\n    for (const event of INVALIDATION_EVENTS) {\n      const unsub = on(event, () => {\n        logDebug('WebSocket invalidation event received, scheduling refetch', { event });\n        debouncedRefetch();\n      });\n      unsubscribers.push(unsub);\n    }\n\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      for (const unsub of unsubscribers) {\n        unsub();\n      }\n    };\n  }, [authenticated, on, fetchResolvedFeatures]);\n\n  // ── Derived features set for O(1) lookups ──\n  const resolvedFeaturesSet = useMemo(\n    () => new Set(resolvedFeatures.features),\n    [resolvedFeatures.features],\n  );\n\n  // ── Convenience accessors ──\n  const isFeatureEnabled = useCallback(\n    (featureId: string): boolean => {\n      return resolvedFeaturesSet.has(featureId);\n    },\n    [resolvedFeaturesSet],\n  );\n\n  const isFeatureOffered = useCallback(\n    (featureId: string): boolean => {\n      // \"Offered\" = the app makes this feature available for the current scope,\n      // INDEPENDENT of whether the current plan/profile currently ENTITLES it:\n      //  - entitled now (in `resolvedFeatures`), OR\n      //  - not entitled but reachable via an upgrade/add-on the backend surfaced\n      //    in `upgradeOptions`.\n      // This is the plan-independent \"does this app offer feature X\" axis, distinct\n      // from `isFeatureEnabled` (the entitlement axis). Consumers gate SURVIVAL\n      // (should the surface exist at all) on `isFeatureOffered`, then render the\n      // entitlement state via {@link FeatureGate} (content vs upgrade/add-on prompt).\n      // Billing OFF → `upgradeOptions` is empty, so offered == entitled (no\n      // \"offered-but-locked\" state exists without a plan to upgrade to). Billing ON\n      // → `upgradeOptions` carries the sellable-but-not-yet-owned features.\n      if (resolvedFeaturesSet.has(featureId)) return true;\n      return Boolean(resolvedFeaturesResponse?.upgradeOptions?.[featureId]);\n    },\n    [resolvedFeaturesSet, resolvedFeaturesResponse],\n  );\n\n  const getLimit = useCallback(\n    (featureId: string): number | undefined => {\n      return resolvedFeatures.limits[featureId];\n    },\n    [resolvedFeatures.limits],\n  );\n\n  const getCurrentUsage = useCallback(\n    (featureId: string): number | undefined => {\n      return resolvedFeatures.currentUsage[featureId];\n    },\n    [resolvedFeatures.currentUsage],\n  );\n\n  const getRemainingCapacity = useCallback(\n    (featureId: string): number | undefined => {\n      const limit = resolvedFeatures.limits[featureId];\n      if (limit === undefined) return undefined;\n      if (limit === FEATURES_UNLIMITED) return undefined; // unlimited → no meaningful remaining\n      const usage = resolvedFeatures.currentUsage[featureId] ?? 0;\n      return Math.max(0, limit - usage);\n    },\n    [resolvedFeatures.limits, resolvedFeatures.currentUsage],\n  );\n\n  // ── Context value (memoized for stable reference) ──\n  const contextValue: FeaturesContextType = useMemo(\n    () => ({\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      isFeatureEnabled,\n      isFeatureOffered,\n      getLimit,\n      getCurrentUsage,\n      getRemainingCapacity,\n      isLoading,\n      error,\n      refetch: fetchResolvedFeatures,\n    }),\n    [\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      isFeatureEnabled,\n      isFeatureOffered,\n      getLimit,\n      getCurrentUsage,\n      getRemainingCapacity,\n      isLoading,\n      error,\n      fetchResolvedFeatures,\n    ],\n  );\n\n  return (\n    <FeaturesContext.Provider value={contextValue}>\n      {children}\n    </FeaturesContext.Provider>\n  );\n}\n\n// Note: useFeatures hook is in a separate file (useFeatures.ts) for React Fast Refresh compatibility.\n"]}
+{"version":3,"file":"FeaturesContext.js","sourceRoot":"","sources":["../../../../src/core/features/FeaturesContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * FeaturesContext\n *\n * Central context for feature gating on the frontend.\n *\n * Responsibilities:\n * - Receives the merged FeatureConfiguration (core + custom) from app initialization\n * - Builds a definitions map for fast lookup\n * - Fetches resolved features from backend API: GET /api/v1/features/resolved\n * - Caches resolved features in context state\n * - Invalidates on WebSocket events (FEATURES_CHANGED, BILLING_STATUS_CHANGED, etc.)\n * - Exposes raw resolved features + definitions + unavailability policy\n *\n * Frontend limit checking is ADVISORY — backend gate is authoritative.\n * Stale usage data means the frontend might allow a click that the backend rejects\n * (which is acceptable — the error is caught and displayed).\n */\n\nimport React, { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';\nimport {\n  CoreWebSocketEvent,\n  FEATURES_UNLIMITED,\n  MAIN_API_BASE_PATH,\n  type FeatureConfiguration,\n  type FeatureDefinition,\n  type ResolvedFeaturesResponse,\n  type ResolvedFeaturesWithUsage,\n} from '@wildo-ai/saas-models';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\nimport { useAuthSession } from '~wildo-frontend-lib/core/security/useAuthSession';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\n\n// ================================\n// Logger\n// ================================\n\nconst featuresLogger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = featuresLogger.debugByType('FeaturesContext');\nfeaturesLogger.setDebugTypeLogging('FeaturesContext', false);\n\n// ================================\n// Constants\n// ================================\n\nconst FEATURES_API_URL = `${MAIN_API_BASE_PATH}/features/resolved`;\n\n/** WebSocket events that trigger a refetch of resolved features */\nconst INVALIDATION_EVENTS = [\n  CoreWebSocketEvent.BILLING_STATUS_CHANGED,\n  CoreWebSocketEvent.BILLING_SUBSCRIPTION_UPDATED,\n  CoreWebSocketEvent.BILLING_ACCOUNT_CHANGED,\n  CoreWebSocketEvent.BILLING_FEATURES_UPDATED,\n] as const;\n\n// ================================\n// Context Type\n// ================================\n\nexport interface FeaturesContextType {\n  // ── Resolved features from backend ──\n  /** Raw resolved features with usage data (from backend API) */\n  resolvedFeatures: ResolvedFeaturesWithUsage;\n  /** Full response including upgrade options */\n  resolvedFeaturesResponse: ResolvedFeaturesResponse | null;\n\n  // ── Feature definitions (from configuration) ──\n  /** Feature definitions map (built from featureConfiguration.definitions) */\n  featureDefinitions: Map<string, FeatureDefinition>;\n\n  // ── Policy ──\n  /** The unavailability policy (from featureConfiguration.unavailabilityPolicy) */\n  unavailabilityPolicy: FeatureConfiguration['unavailabilityPolicy'];\n\n  // ── Convenience accessors ──\n  /** Check if a boolean feature is ENTITLED for the current scope (plan/profile). */\n  isFeatureEnabled: (featureId: string) => boolean;\n  /**\n   * Check if the app OFFERS a feature for the current scope — entitled now, or\n   * reachable via an upgrade/add-on. Plan-independent survival signal, distinct\n   * from `isFeatureEnabled` (entitlement). See the impl for the two-axis rationale.\n   */\n  isFeatureOffered: (featureId: string) => boolean;\n  /** Get a limit value (FEATURES_UNLIMITED = unlimited). Returns undefined if feature not found. */\n  getLimit: (featureId: string) => number | undefined;\n  /** Get current usage for a limit feature. undefined if no usage data. */\n  getCurrentUsage: (featureId: string) => number | undefined;\n  /** Get remaining capacity (limit - current). undefined if unlimited or no counting. */\n  getRemainingCapacity: (featureId: string) => number | undefined;\n\n  // ── State ──\n  isLoading: boolean;\n  error: Error | null;\n\n  // ── Actions ──\n  /** Force refetch of resolved features (e.g., after a mutation on a counted resource) */\n  refetch: () => void;\n}\n\n// ── Default empty state ──\nconst EMPTY_RESOLVED: ResolvedFeaturesWithUsage = {\n  features: [],\n  limits: {},\n  currentUsage: {},\n};\n\nexport const FeaturesContext: React.Context<FeaturesContextType | undefined> = createContext<FeaturesContextType | undefined>(undefined);\n\n// ================================\n// Provider\n// ================================\n\ninterface FeaturesProviderProps {\n  /** Merged FeatureConfiguration (core + custom) — passed from app initialization */\n  featureConfiguration: FeatureConfiguration;\n  children: React.ReactNode;\n}\n\nexport function FeaturesProvider({ featureConfiguration, children }: FeaturesProviderProps): React.ReactElement {\n  // ── State ──\n  const [resolvedFeaturesResponse, setResolvedFeaturesResponse] = useState<ResolvedFeaturesResponse | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  // ── Refs for stable callbacks ──\n  const fetchInFlightRef = useRef<boolean>(false);\n  const mountedRef = useRef<boolean>(true);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // ── Auth — features are user-scoped, only fetch when authenticated ──\n  const { isAuthenticated } = useAuthSession();\n  const authenticated = isAuthenticated();\n  const appScope = useAppScopeSafe();\n  const currentOrganizationId = appScope?.currentOrganizationId ?? null;\n\n  // ── WebSocket ──\n  const { on } = useWebSocket();\n\n  // ── Build definitions map from configuration ──\n  const featureDefinitions = useMemo(() => {\n    const map = new Map<string, FeatureDefinition>();\n    for (const def of featureConfiguration.definitions) {\n      map.set(def.identifier, def);\n    }\n    logDebug('Feature definitions map built', { count: map.size });\n    return map;\n  }, [featureConfiguration.definitions]);\n\n  // ── Unavailability policy ──\n  const unavailabilityPolicy = useMemo(\n    () => featureConfiguration.unavailabilityPolicy,\n    [featureConfiguration.unavailabilityPolicy],\n  );\n\n  // ── Derived resolved features ──\n  const resolvedFeatures: ResolvedFeaturesWithUsage = useMemo(() => {\n    if (!resolvedFeaturesResponse) return EMPTY_RESOLVED;\n    return {\n      features: resolvedFeaturesResponse.features,\n      limits: resolvedFeaturesResponse.limits,\n      currentUsage: resolvedFeaturesResponse.currentUsage,\n    };\n  }, [resolvedFeaturesResponse]);\n\n  const clearResolvedFeatures = useCallback(() => {\n    setResolvedFeaturesResponse(null);\n    setError(null);\n    setIsLoading(false);\n  }, []);\n\n  // ── Fetch resolved features from backend ──\n  const fetchResolvedFeatures = useCallback(async () => {\n    if (fetchInFlightRef.current) return;\n    fetchInFlightRef.current = true;\n\n    try {\n      logDebug('Fetching resolved features from backend');\n      const httpClient = getManualCallsHttpClient();\n      const response = await httpClient.get<ResolvedFeaturesResponse>(FEATURES_API_URL);\n\n      if (mountedRef.current) {\n        setResolvedFeaturesResponse(response);\n        setError(null);\n        logDebug('Resolved features fetched', {\n          featureCount: response.features.length,\n          limitCount: Object.keys(response.limits).length,\n          usageCount: Object.keys(response.currentUsage).length,\n        });\n      }\n    } catch (err: any) {\n      if (mountedRef.current) {\n        setError(err instanceof Error ? err : new Error(err?.message ?? 'Failed to fetch features'));\n        logDebug('Failed to fetch resolved features', { error: err?.message });\n      }\n    } finally {\n      if (mountedRef.current) {\n        setIsLoading(false);\n      }\n      fetchInFlightRef.current = false;\n    }\n  }, []);\n\n  // ── Fetch when authenticated (and refetch on auth change) ──\n  useEffect(() => {\n    mountedRef.current = true;\n    if (authenticated) {\n      setIsLoading(true);\n      fetchResolvedFeatures();\n    } else {\n      clearResolvedFeatures();\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [authenticated, currentOrganizationId, fetchResolvedFeatures, clearResolvedFeatures]);\n\n  // ── WebSocket invalidation (debounced to coalesce rapid events) ──\n  useEffect(() => {\n    if (!authenticated) return;\n\n    const unsubscribers: Array<() => void> = [];\n\n    const debouncedRefetch = () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = null;\n        fetchResolvedFeatures();\n      }, 300);\n    };\n\n    for (const event of INVALIDATION_EVENTS) {\n      const unsub = on(event, () => {\n        logDebug('WebSocket invalidation event received, scheduling refetch', { event });\n        debouncedRefetch();\n      });\n      unsubscribers.push(unsub);\n    }\n\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      for (const unsub of unsubscribers) {\n        unsub();\n      }\n    };\n  }, [authenticated, on, fetchResolvedFeatures]);\n\n  // ── Derived features set for O(1) lookups ──\n  const resolvedFeaturesSet = useMemo(\n    () => new Set(resolvedFeatures.features),\n    [resolvedFeatures.features],\n  );\n\n  // ── Convenience accessors ──\n  const isFeatureEnabled = useCallback(\n    (featureId: string): boolean => {\n      return resolvedFeaturesSet.has(featureId);\n    },\n    [resolvedFeaturesSet],\n  );\n\n  const isFeatureOffered = useCallback(\n    (featureId: string): boolean => {\n      // \"Offered\" = the app makes this feature available for the current scope,\n      // INDEPENDENT of whether the current plan/profile currently ENTITLES it:\n      //  - entitled now (in `resolvedFeatures`), OR\n      //  - not entitled but reachable via an upgrade/add-on the backend surfaced\n      //    in `upgradeOptions`.\n      // This is the plan-independent \"does this app offer feature X\" axis, distinct\n      // from `isFeatureEnabled` (the entitlement axis). Consumers gate SURVIVAL\n      // (should the surface exist at all) on `isFeatureOffered`, then render the\n      // entitlement state via {@link FeatureGate} (content vs upgrade/add-on prompt).\n      // Billing OFF → `upgradeOptions` is empty, so offered == entitled (no\n      // \"offered-but-locked\" state exists without a plan to upgrade to). Billing ON\n      // → `upgradeOptions` carries the sellable-but-not-yet-owned features.\n      if (resolvedFeaturesSet.has(featureId)) return true;\n      return Boolean(resolvedFeaturesResponse?.upgradeOptions?.[featureId]);\n    },\n    [resolvedFeaturesSet, resolvedFeaturesResponse],\n  );\n\n  const getLimit = useCallback(\n    (featureId: string): number | undefined => {\n      return resolvedFeatures.limits[featureId];\n    },\n    [resolvedFeatures.limits],\n  );\n\n  const getCurrentUsage = useCallback(\n    (featureId: string): number | undefined => {\n      return resolvedFeatures.currentUsage[featureId];\n    },\n    [resolvedFeatures.currentUsage],\n  );\n\n  const getRemainingCapacity = useCallback(\n    (featureId: string): number | undefined => {\n      const limit = resolvedFeatures.limits[featureId];\n      if (limit === undefined) return undefined;\n      if (limit === FEATURES_UNLIMITED) return undefined; // unlimited → no meaningful remaining\n      const usage = resolvedFeatures.currentUsage[featureId] ?? 0;\n      return Math.max(0, limit - usage);\n    },\n    [resolvedFeatures.limits, resolvedFeatures.currentUsage],\n  );\n\n  // ── Context value (memoized for stable reference) ──\n  const contextValue: FeaturesContextType = useMemo(\n    () => ({\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      isFeatureEnabled,\n      isFeatureOffered,\n      getLimit,\n      getCurrentUsage,\n      getRemainingCapacity,\n      isLoading,\n      error,\n      refetch: fetchResolvedFeatures,\n    }),\n    [\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      isFeatureEnabled,\n      isFeatureOffered,\n      getLimit,\n      getCurrentUsage,\n      getRemainingCapacity,\n      isLoading,\n      error,\n      fetchResolvedFeatures,\n    ],\n  );\n\n  return (\n    <FeaturesContext.Provider value={contextValue}>\n      {children}\n    </FeaturesContext.Provider>\n  );\n}\n\n// Note: useFeatures hook is in a separate file (useFeatures.ts) for React Fast Refresh compatibility.\n"]}

package/dist/esm/core/features/feature-unavailability.frontend.utils.d.ts

@@ -23,6 +23,13 @@ export declare function buildFeaturePolicyRoles(permissions: FeaturePolicyPermis
 export declare function resolveFeatureUnavailabilityBehavior(params: ResolveFeatureUnavailabilityBehaviorParams): {
     behavior: FeatureUnavailabilityBehavior;
     suggestedProductRef?: string;
+    /**
+     * The component a CUSTOM-behaviour feature declares. Returned from EVERY arm, unlike
+     * `suggestedProductRef`, because the ref is a property of the FEATURE rather than of the cascade
+     * arm that selected the behaviour — a global role or reason default of CUSTOM must still reach
+     * the component the feature declared, or it renders nothing.
+     */
+    customComponentRef?: string;
     debugTrace: string[];
 };
 export {};

package/dist/esm/core/features/feature-unavailability.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-unavailability.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/feature-unavailability.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,UAAU,wBAAwB;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,UAAU,0CAA0C;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC1C,MAAM,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,EACxD,qBAAqB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,EAAE,CAYV;AAgBD;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,0CAA0C,GACjD;IACD,QAAQ,EAAE,6BAA6B,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAsFA"}
+{"version":3,"file":"feature-unavailability.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/features/feature-unavailability.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,UAAU,wBAAwB;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,UAAU,0CAA0C;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC1C,MAAM,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,EACxD,qBAAqB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,EAAE,CAYV;AAgBD;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,0CAA0C,GACjD;IACD,QAAQ,EAAE,6BAA6B,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CA2FA"}

package/dist/esm/core/features/feature-unavailability.frontend.utils.js

@@ -38,6 +38,7 @@ export function resolveFeatureUnavailabilityBehavior(params) {
         return {
             behavior: applyBillingDisabledBehaviorOverride(featureDef.unavailability.behavior, billingEnabled, policy, trace),
             suggestedProductRef: featureDef.unavailability.suggestedProductRef,
+            customComponentRef: featureDef?.unavailability?.customComponentRef,
             debugTrace: trace,
         };
     }
@@ -49,6 +50,7 @@ export function resolveFeatureUnavailabilityBehavior(params) {
                 return {
                     behavior: applyBillingDisabledBehaviorOverride(roleBehavior, billingEnabled, policy, trace),
                     suggestedProductRef: featureDef.unavailability.suggestedProductRef,
+                    customComponentRef: featureDef?.unavailability?.customComponentRef,
                     debugTrace: trace,
                 };
             }
@@ -61,6 +63,7 @@ export function resolveFeatureUnavailabilityBehavior(params) {
             trace.push(`[3] Global role default (${role}): ${globalRoleBehavior}`);
             return {
                 behavior: applyBillingDisabledBehaviorOverride(globalRoleBehavior, billingEnabled, policy, trace),
+                customComponentRef: featureDef?.unavailability?.customComponentRef,
                 debugTrace: trace,
             };
         }
@@ -71,6 +74,7 @@ export function resolveFeatureUnavailabilityBehavior(params) {
         trace.push(`[4] Global reason default (${reason}): ${reasonBehavior}`);
         return {
             behavior: applyBillingDisabledBehaviorOverride(reasonBehavior, billingEnabled, policy, trace),
+            customComponentRef: featureDef?.unavailability?.customComponentRef,
             debugTrace: trace,
         };
     }
@@ -78,6 +82,7 @@ export function resolveFeatureUnavailabilityBehavior(params) {
     trace.push(`[5] Global default: ${policy.defaultBehavior}`);
     return {
         behavior: applyBillingDisabledBehaviorOverride(policy.defaultBehavior, billingEnabled, policy, trace),
+        customComponentRef: featureDef?.unavailability?.customComponentRef,
         debugTrace: trace,
     };
 }

package/dist/esm/core/features/feature-unavailability.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature-unavailability.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/features/feature-unavailability.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FeatureUnavailabilityBehavior,\n  type FeatureConfiguration,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\n\ninterface FeaturePolicyPermissions {\n  appLevel?: string[] | null;\n  organizations?: Record<string, string[]> | null;\n}\n\ninterface ResolveFeatureUnavailabilityBehaviorParams {\n  billingEnabled: boolean;\n  featureDef: FeatureDefinition | undefined;\n  policy: FeatureConfiguration['unavailabilityPolicy'];\n  reason: string;\n  userRoles: string[];\n}\n\nconst BILLING_PROMPT_BEHAVIORS = new Set<FeatureUnavailabilityBehavior>([\n  FeatureUnavailabilityBehavior.UPGRADE_PROMPT,\n  FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT,\n  FeatureUnavailabilityBehavior.ADDON_PROMPT,\n]);\n\n/**\n * Merge app-level roles with the current organization's membership roles.\n * The frontend policy contract can target either layer, so availability\n * checks must resolve against the same effective role surface the user sees.\n */\nexport function buildFeaturePolicyRoles(\n  permissions: FeaturePolicyPermissions | null | undefined,\n  currentOrganizationId: string | null | undefined,\n): string[] {\n  const roles: string[] = [];\n\n  if (permissions?.appLevel?.length) {\n    roles.push(...permissions.appLevel);\n  }\n\n  if (currentOrganizationId && permissions?.organizations?.[currentOrganizationId]?.length) {\n    roles.push(...permissions.organizations[currentOrganizationId]);\n  }\n\n  return [...new Set(roles)];\n}\n\nfunction applyBillingDisabledBehaviorOverride(\n  behavior: FeatureUnavailabilityBehavior,\n  billingEnabled: boolean,\n  policy: FeatureConfiguration['unavailabilityPolicy'],\n  trace: string[],\n): FeatureUnavailabilityBehavior {\n  if (billingEnabled || !BILLING_PROMPT_BEHAVIORS.has(behavior)) {\n    return behavior;\n  }\n\n  trace.push(`[billing-disabled] Replacing ${behavior} with ${policy.whenBillingDisabled}`);\n  return policy.whenBillingDisabled;\n}\n\n/**\n * Resolve the final unavailability behavior with a single cascade shared by\n * feature-level and operation-level checks.\n */\nexport function resolveFeatureUnavailabilityBehavior(\n  params: ResolveFeatureUnavailabilityBehaviorParams,\n): {\n  behavior: FeatureUnavailabilityBehavior;\n  suggestedProductRef?: string;\n  debugTrace: string[];\n} {\n  const {\n    billingEnabled,\n    featureDef,\n    policy,\n    reason,\n    userRoles,\n  } = params;\n  const trace: string[] = [];\n\n  if (featureDef?.unavailability?.behavior) {\n    trace.push(`[1] Per-feature override: ${featureDef.unavailability.behavior}`);\n    return {\n      behavior: applyBillingDisabledBehaviorOverride(\n        featureDef.unavailability.behavior,\n        billingEnabled,\n        policy,\n        trace,\n      ),\n      suggestedProductRef: featureDef.unavailability.suggestedProductRef,\n      debugTrace: trace,\n    };\n  }\n\n  if (featureDef?.unavailability?.byRole) {\n    for (const role of userRoles) {\n      const roleBehavior = featureDef.unavailability.byRole[role];\n      if (roleBehavior) {\n        trace.push(`[2] Per-feature role override (${role}): ${roleBehavior}`);\n        return {\n          behavior: applyBillingDisabledBehaviorOverride(\n            roleBehavior,\n            billingEnabled,\n            policy,\n            trace,\n          ),\n          suggestedProductRef: featureDef.unavailability.suggestedProductRef,\n          debugTrace: trace,\n        };\n      }\n    }\n    trace.push('[2] Per-feature role override: no match');\n  }\n\n  for (const role of userRoles) {\n    const globalRoleBehavior = policy.roleDefaults[role];\n    if (globalRoleBehavior) {\n      trace.push(`[3] Global role default (${role}): ${globalRoleBehavior}`);\n      return {\n        behavior: applyBillingDisabledBehaviorOverride(\n          globalRoleBehavior,\n          billingEnabled,\n          policy,\n          trace,\n        ),\n        debugTrace: trace,\n      };\n    }\n  }\n  trace.push('[3] Global role default: no match');\n\n  const reasonBehavior = policy.reasonDefaults[reason];\n  if (reasonBehavior) {\n    trace.push(`[4] Global reason default (${reason}): ${reasonBehavior}`);\n    return {\n      behavior: applyBillingDisabledBehaviorOverride(\n        reasonBehavior,\n        billingEnabled,\n        policy,\n        trace,\n      ),\n      debugTrace: trace,\n    };\n  }\n  trace.push(`[4] Global reason default (${reason}): no match`);\n\n  trace.push(`[5] Global default: ${policy.defaultBehavior}`);\n  return {\n    behavior: applyBillingDisabledBehaviorOverride(\n      policy.defaultBehavior,\n      billingEnabled,\n      policy,\n      trace,\n    ),\n    debugTrace: trace,\n  };\n}\n"]}
+{"version":3,"file":"feature-unavailability.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/features/feature-unavailability.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FeatureUnavailabilityBehavior,\n  type FeatureConfiguration,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\n\ninterface FeaturePolicyPermissions {\n  appLevel?: string[] | null;\n  organizations?: Record<string, string[]> | null;\n}\n\ninterface ResolveFeatureUnavailabilityBehaviorParams {\n  billingEnabled: boolean;\n  featureDef: FeatureDefinition | undefined;\n  policy: FeatureConfiguration['unavailabilityPolicy'];\n  reason: string;\n  userRoles: string[];\n}\n\nconst BILLING_PROMPT_BEHAVIORS = new Set<FeatureUnavailabilityBehavior>([\n  FeatureUnavailabilityBehavior.UPGRADE_PROMPT,\n  FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT,\n  FeatureUnavailabilityBehavior.ADDON_PROMPT,\n]);\n\n/**\n * Merge app-level roles with the current organization's membership roles.\n * The frontend policy contract can target either layer, so availability\n * checks must resolve against the same effective role surface the user sees.\n */\nexport function buildFeaturePolicyRoles(\n  permissions: FeaturePolicyPermissions | null | undefined,\n  currentOrganizationId: string | null | undefined,\n): string[] {\n  const roles: string[] = [];\n\n  if (permissions?.appLevel?.length) {\n    roles.push(...permissions.appLevel);\n  }\n\n  if (currentOrganizationId && permissions?.organizations?.[currentOrganizationId]?.length) {\n    roles.push(...permissions.organizations[currentOrganizationId]);\n  }\n\n  return [...new Set(roles)];\n}\n\nfunction applyBillingDisabledBehaviorOverride(\n  behavior: FeatureUnavailabilityBehavior,\n  billingEnabled: boolean,\n  policy: FeatureConfiguration['unavailabilityPolicy'],\n  trace: string[],\n): FeatureUnavailabilityBehavior {\n  if (billingEnabled || !BILLING_PROMPT_BEHAVIORS.has(behavior)) {\n    return behavior;\n  }\n\n  trace.push(`[billing-disabled] Replacing ${behavior} with ${policy.whenBillingDisabled}`);\n  return policy.whenBillingDisabled;\n}\n\n/**\n * Resolve the final unavailability behavior with a single cascade shared by\n * feature-level and operation-level checks.\n */\nexport function resolveFeatureUnavailabilityBehavior(\n  params: ResolveFeatureUnavailabilityBehaviorParams,\n): {\n  behavior: FeatureUnavailabilityBehavior;\n  suggestedProductRef?: string;\n  /**\n   * The component a CUSTOM-behaviour feature declares. Returned from EVERY arm, unlike\n   * `suggestedProductRef`, because the ref is a property of the FEATURE rather than of the cascade\n   * arm that selected the behaviour — a global role or reason default of CUSTOM must still reach\n   * the component the feature declared, or it renders nothing.\n   */\n  customComponentRef?: string;\n  debugTrace: string[];\n} {\n  const {\n    billingEnabled,\n    featureDef,\n    policy,\n    reason,\n    userRoles,\n  } = params;\n  const trace: string[] = [];\n\n  if (featureDef?.unavailability?.behavior) {\n    trace.push(`[1] Per-feature override: ${featureDef.unavailability.behavior}`);\n    return {\n      behavior: applyBillingDisabledBehaviorOverride(\n        featureDef.unavailability.behavior,\n        billingEnabled,\n        policy,\n        trace,\n      ),\n      suggestedProductRef: featureDef.unavailability.suggestedProductRef,\n      customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n    };\n  }\n\n  if (featureDef?.unavailability?.byRole) {\n    for (const role of userRoles) {\n      const roleBehavior = featureDef.unavailability.byRole[role];\n      if (roleBehavior) {\n        trace.push(`[2] Per-feature role override (${role}): ${roleBehavior}`);\n        return {\n          behavior: applyBillingDisabledBehaviorOverride(\n            roleBehavior,\n            billingEnabled,\n            policy,\n            trace,\n          ),\n          suggestedProductRef: featureDef.unavailability.suggestedProductRef,\n          customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n        };\n      }\n    }\n    trace.push('[2] Per-feature role override: no match');\n  }\n\n  for (const role of userRoles) {\n    const globalRoleBehavior = policy.roleDefaults[role];\n    if (globalRoleBehavior) {\n      trace.push(`[3] Global role default (${role}): ${globalRoleBehavior}`);\n      return {\n        behavior: applyBillingDisabledBehaviorOverride(\n          globalRoleBehavior,\n          billingEnabled,\n          policy,\n          trace,\n        ),\n        customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n      };\n    }\n  }\n  trace.push('[3] Global role default: no match');\n\n  const reasonBehavior = policy.reasonDefaults[reason];\n  if (reasonBehavior) {\n    trace.push(`[4] Global reason default (${reason}): ${reasonBehavior}`);\n    return {\n      behavior: applyBillingDisabledBehaviorOverride(\n        reasonBehavior,\n        billingEnabled,\n        policy,\n        trace,\n      ),\n      customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n    };\n  }\n  trace.push(`[4] Global reason default (${reason}): no match`);\n\n  trace.push(`[5] Global default: ${policy.defaultBehavior}`);\n  return {\n    behavior: applyBillingDisabledBehaviorOverride(\n      policy.defaultBehavior,\n      billingEnabled,\n      policy,\n      trace,\n    ),\n    customComponentRef: featureDef?.unavailability?.customComponentRef,\n    debugTrace: trace,\n  };\n}\n"]}

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

@@ -34,6 +34,8 @@ export interface FeatureAvailability {
     upgradeOptions?: FeatureUpgradeOption[];
     /** Suggested product reference (from per-feature override) */
     suggestedProductRef?: string;
+    /** Component reference for CUSTOM behaviour (from the feature's unavailability config). */
+    customComponentRef?: string;
     /** Policy resolution trace — only populated in development mode */
     debugTrace?: string[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"useFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAGL,6BAA6B,EAC7B,2BAA2B,EAE3B,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAmB/B,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IAGrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,wCAAwC;IACxC,QAAQ,EAAE,6BAA6B,CAAC;IACxC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,yEAAyE;IACzE,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAwJ7E"}
+{"version":3,"file":"useFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAGL,6BAA6B,EAC7B,2BAA2B,EAE3B,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAmB/B,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IAGrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,wCAAwC;IACxC,QAAQ,EAAE,6BAA6B,CAAC;IACxC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,yEAAyE;IACzE,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CA0J7E"}

package/dist/esm/core/features/useFeatureAvailability.js

@@ -71,7 +71,7 @@ export function useFeatureAvailability(featureId) {
             }
             // Not enabled → resolve behavior
             const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;
-            const { behavior, suggestedProductRef, debugTrace } = resolveFeatureUnavailabilityBehavior({
+            const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({
                 reason,
                 featureDef,
                 policy: unavailabilityPolicy,
@@ -87,6 +87,7 @@ export function useFeatureAvailability(featureId) {
                 missingFeatures: [featureId],
                 upgradeOptions,
                 suggestedProductRef,
+                customComponentRef,
                 debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,
             };
         }
@@ -108,7 +109,7 @@ export function useFeatureAvailability(featureId) {
             }
             // At or over limit → resolve behavior
             const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;
-            const { behavior, suggestedProductRef, debugTrace } = resolveFeatureUnavailabilityBehavior({
+            const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({
                 reason,
                 featureDef,
                 policy: unavailabilityPolicy,
@@ -123,6 +124,7 @@ export function useFeatureAvailability(featureId) {
                 limitInfo: { featureId, current: currentUsage, limit },
                 upgradeOptions,
                 suggestedProductRef,
+                customComponentRef,
                 debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,
             };
         }

package/dist/esm/core/features/useFeatureAvailability.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureAvailability.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useFeatureAvailability Hook\n * \n * Resolves \"is this feature available, and if not, what to do about it\" for a single feature.\n * Uses the FeaturesContext (resolved features + definitions + unavailability policy) and\n * UserOrgsContext (for role) to resolve the complete availability state.\n * \n * Policy cascade (first match wins):\n *   1. Per-feature override → feature.unavailability.behavior\n *   2. Per-feature role override → feature.unavailability.byRole[role]\n *   3. Global role default → policy.roleDefaults[role]\n *   4. Global reason default → policy.reasonDefaults[reason]\n *   5. Global default → policy.defaultBehavior\n * \n * Includes dev-only debugTrace for debugging policy resolution.\n */\n\nimport { useEffect, useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  type FeatureDefinition,\n  type FeatureUpgradeOption,\n} from '@wildo-ai/saas-models';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAnalytics } from '~wildo-frontend-lib/core/monitoring/analytics/useAnalytics';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Cross-instance dedup for feature gate analytics\nconst reportedFeatures = new Set<string>();\n\n// ================================\n// FeatureAvailability Type\n// ================================\n\nexport interface FeatureAvailability {\n  /** Whether the feature is available for the current context */\n  isAvailable: boolean;\n\n  // ── When not available ──\n  /** Why the feature is unavailable */\n  reason?: FeatureUnavailabilityReason;\n  /** What behavior the UI should adopt */\n  behavior: FeatureUnavailabilityBehavior;\n  /** Which feature(s) are missing (for boolean OR/AND modes) */\n  missingFeatures?: string[];\n  /** Limit information (for limit features) */\n  limitInfo?: { featureId: string; current: number; limit: number };\n  /** Upgrade options from the backend (from resolved features response) */\n  upgradeOptions?: FeatureUpgradeOption[];\n  /** Suggested product reference (from per-feature override) */\n  suggestedProductRef?: string;\n\n  // ── Debug (dev only) ──\n  /** Policy resolution trace — only populated in development mode */\n  debugTrace?: string[];\n}\n\n/**\n * Resolve availability + behavior for a single feature.\n * \n * @param featureId - The feature identifier to check\n * @returns FeatureAvailability — the resolved availability, behavior, and metadata\n */\nexport function useFeatureAvailability(featureId: string): FeatureAvailability {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const { track, isActive } = useAnalytics();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  const result = useMemo((): FeatureAvailability => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n    }\n\n    const featureDef = featureDefinitions.get(featureId);\n\n    // Feature not registered → NOT_CONFIGURED\n    if (!featureDef) {\n      const { behavior, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        featureDef: undefined,\n        policy: unavailabilityPolicy,\n        userRoles: [],\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n      return {\n        isAvailable: false,\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        behavior,\n        missingFeatures: [featureId],\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Build user roles array for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    // ── Boolean feature check ──\n    if (featureDef.valueType === FeatureValueType.BOOLEAN) {\n      const resolvedSet = new Set(resolvedFeatures.features);\n      const isEnabled = resolvedSet.has(featureId);\n      if (isEnabled) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Not enabled → resolve behavior\n      const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n      const { behavior, suggestedProductRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      // Get upgrade options from backend response\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        missingFeatures: [featureId],\n        upgradeOptions,\n        suggestedProductRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // ── Limit feature check ──\n    if (featureDef.valueType === FeatureValueType.LIMIT) {\n      const limit = resolvedFeatures.limits[featureId];\n\n      // No limit set → available (no restriction configured)\n      if (limit === undefined) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Unlimited → always available\n      if (limit === FEATURES_UNLIMITED) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      const currentUsage = resolvedFeatures.currentUsage[featureId] ?? 0;\n\n      // Under the limit → available\n      if (currentUsage < limit) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // At or over limit → resolve behavior\n      const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n      const { behavior, suggestedProductRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        limitInfo: { featureId, current: currentUsage, limit },\n        upgradeOptions,\n        suggestedProductRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Unknown value type → treat as available (defensive)\n    return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n  }, [\n    featureId,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n\n  useEffect(() => {\n    if (!isActive) return;\n    const dedupKey = `${featureId}:${result.isAvailable}`;\n    if (reportedFeatures.has(dedupKey)) return;\n    reportedFeatures.add(dedupKey);\n    track('feature_gate', {\n      featureRef: featureId,\n      isAvailable: result.isAvailable,\n      reason: result.reason,\n    });\n    if (result.isAvailable) {\n      track('feature_accessed', { featureId });\n    }\n  }, [featureId, result.isAvailable, result.reason, isActive, track]);\n\n  return result;\n}\n"]}
+{"version":3,"file":"useFeatureAvailability.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useFeatureAvailability Hook\n * \n * Resolves \"is this feature available, and if not, what to do about it\" for a single feature.\n * Uses the FeaturesContext (resolved features + definitions + unavailability policy) and\n * UserOrgsContext (for role) to resolve the complete availability state.\n * \n * Policy cascade (first match wins):\n *   1. Per-feature override → feature.unavailability.behavior\n *   2. Per-feature role override → feature.unavailability.byRole[role]\n *   3. Global role default → policy.roleDefaults[role]\n *   4. Global reason default → policy.reasonDefaults[reason]\n *   5. Global default → policy.defaultBehavior\n * \n * Includes dev-only debugTrace for debugging policy resolution.\n */\n\nimport { useEffect, useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  type FeatureDefinition,\n  type FeatureUpgradeOption,\n} from '@wildo-ai/saas-models';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAnalytics } from '~wildo-frontend-lib/core/monitoring/analytics/useAnalytics';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Cross-instance dedup for feature gate analytics\nconst reportedFeatures = new Set<string>();\n\n// ================================\n// FeatureAvailability Type\n// ================================\n\nexport interface FeatureAvailability {\n  /** Whether the feature is available for the current context */\n  isAvailable: boolean;\n\n  // ── When not available ──\n  /** Why the feature is unavailable */\n  reason?: FeatureUnavailabilityReason;\n  /** What behavior the UI should adopt */\n  behavior: FeatureUnavailabilityBehavior;\n  /** Which feature(s) are missing (for boolean OR/AND modes) */\n  missingFeatures?: string[];\n  /** Limit information (for limit features) */\n  limitInfo?: { featureId: string; current: number; limit: number };\n  /** Upgrade options from the backend (from resolved features response) */\n  upgradeOptions?: FeatureUpgradeOption[];\n  /** Suggested product reference (from per-feature override) */\n  suggestedProductRef?: string;\n  /** Component reference for CUSTOM behaviour (from the feature's unavailability config). */\n  customComponentRef?: string;\n\n  // ── Debug (dev only) ──\n  /** Policy resolution trace — only populated in development mode */\n  debugTrace?: string[];\n}\n\n/**\n * Resolve availability + behavior for a single feature.\n * \n * @param featureId - The feature identifier to check\n * @returns FeatureAvailability — the resolved availability, behavior, and metadata\n */\nexport function useFeatureAvailability(featureId: string): FeatureAvailability {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const { track, isActive } = useAnalytics();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  const result = useMemo((): FeatureAvailability => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n    }\n\n    const featureDef = featureDefinitions.get(featureId);\n\n    // Feature not registered → NOT_CONFIGURED\n    if (!featureDef) {\n      const { behavior, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        featureDef: undefined,\n        policy: unavailabilityPolicy,\n        userRoles: [],\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n      return {\n        isAvailable: false,\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        behavior,\n        missingFeatures: [featureId],\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Build user roles array for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    // ── Boolean feature check ──\n    if (featureDef.valueType === FeatureValueType.BOOLEAN) {\n      const resolvedSet = new Set(resolvedFeatures.features);\n      const isEnabled = resolvedSet.has(featureId);\n      if (isEnabled) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Not enabled → resolve behavior\n      const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      // Get upgrade options from backend response\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        missingFeatures: [featureId],\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // ── Limit feature check ──\n    if (featureDef.valueType === FeatureValueType.LIMIT) {\n      const limit = resolvedFeatures.limits[featureId];\n\n      // No limit set → available (no restriction configured)\n      if (limit === undefined) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Unlimited → always available\n      if (limit === FEATURES_UNLIMITED) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      const currentUsage = resolvedFeatures.currentUsage[featureId] ?? 0;\n\n      // Under the limit → available\n      if (currentUsage < limit) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // At or over limit → resolve behavior\n      const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        limitInfo: { featureId, current: currentUsage, limit },\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Unknown value type → treat as available (defensive)\n    return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n  }, [\n    featureId,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n\n  useEffect(() => {\n    if (!isActive) return;\n    const dedupKey = `${featureId}:${result.isAvailable}`;\n    if (reportedFeatures.has(dedupKey)) return;\n    reportedFeatures.add(dedupKey);\n    track('feature_gate', {\n      featureRef: featureId,\n      isAvailable: result.isAvailable,\n      reason: result.reason,\n    });\n    if (result.isAvailable) {\n      track('feature_accessed', { featureId });\n    }\n  }, [featureId, result.isAvailable, result.reason, isActive, track]);\n\n  return result;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useFeatureGate.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAErE"}
+{"version":3,"file":"useFeatureGate.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAErE"}

package/dist/esm/core/features/useFeatureGate.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureGate.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/**\n * useFeatureGate Hook\n * \n * Separated from FeatureGate.tsx for React Fast Refresh compatibility.\n */\n\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\n\n/**\n * Programmatic hook for checking a single feature's availability.\n * Equivalent to useFeatureAvailability — provides both the availability state and\n * a convenience `isAvailable` boolean.\n */\nexport function useFeatureGate(featureId: string): FeatureAvailability {\n  return useFeatureAvailability(featureId);\n}\n"]}
+{"version":3,"file":"useFeatureGate.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/**\n * useFeatureGate Hook\n * \n * Separated from FeatureGate.tsx for React Fast Refresh compatibility.\n */\n\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\n\n/**\n * Programmatic hook for checking a single feature's availability.\n * Equivalent to useFeatureAvailability — provides both the availability state and\n * a convenience `isAvailable` boolean.\n */\nexport function useFeatureGate(featureId: string): FeatureAvailability {\n  return useFeatureAvailability(featureId);\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useFeatures.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAO,mBAM9B,CAAC"}
+{"version":3,"file":"useFeatures.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAO,mBAM9B,CAAC"}

package/dist/esm/core/features/useFeatures.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatures.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,eAAe,EAA4B,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAwB,EAAE;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * useFeatures Hook\n * \n * Separated from FeaturesContext.tsx for React Fast Refresh compatibility.\n * Provides access to the feature context: resolved features, definitions, policy, and convenience methods.\n */\n\nimport { useContext } from 'react';\nimport { FeaturesContext, type FeaturesContextType } from './FeaturesContext';\n\n/**\n * Hook to access the Features context.\n * @returns FeaturesContextType with resolved features, definitions, policy, and convenience methods.\n * @throws Error if used outside of FeaturesProvider.\n */\nexport const useFeatures = (): FeaturesContextType => {\n  const context = useContext(FeaturesContext);\n  if (!context) {\n    throw new Error('useFeatures must be used within a FeaturesProvider');\n  }\n  return context;\n};\n"]}
+{"version":3,"file":"useFeatures.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,eAAe,EAA4B,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAwB,EAAE;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * useFeatures Hook\n * \n * Separated from FeaturesContext.tsx for React Fast Refresh compatibility.\n * Provides access to the feature context: resolved features, definitions, policy, and convenience methods.\n */\n\nimport { useContext } from 'react';\nimport { FeaturesContext, type FeaturesContextType } from './FeaturesContext';\n\n/**\n * Hook to access the Features context.\n * @returns FeaturesContextType with resolved features, definitions, policy, and convenience methods.\n * @throws Error if used outside of FeaturesProvider.\n */\nexport const useFeatures = (): FeaturesContextType => {\n  const context = useContext(FeaturesContext);\n  if (!context) {\n    throw new Error('useFeatures must be used within a FeaturesProvider');\n  }\n  return context;\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useOperationFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAML,KAAK,sBAAsB,EAE3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAC7H,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AASpE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC/G,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,EAAE,oBAAoB,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9G,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnD,oBAAoB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,EACrE,GAAG,EAAE,0CAA0C,GAC9C,mBAAmB,GAAG,SAAS,CAyIjC;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,GACpE,mBAAmB,GAAG,SAAS,CA8CjC"}
+{"version":3,"file":"useOperationFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAML,KAAK,sBAAsB,EAE3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAC7H,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AASpE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC/G,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,EAAE,oBAAoB,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9G,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnD,oBAAoB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,EACrE,GAAG,EAAE,0CAA0C,GAC9C,mBAAmB,GAAG,SAAS,CAyIjC;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,GACpE,mBAAmB,GAAG,SAAS,CA8CjC"}

package/dist/esm/core/features/useOperationFeatureAvailability.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationFeatureAvailability.js","sourceRoot":"","sources":["../../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useOperationFeatureAvailability Hook\n * \n * Resolves feature availability for an operation's `requiredFeatures` config.\n * Evaluates both boolean features (OR/AND mode) and limit checks.\n * \n * For boolean features:\n *   - OR mode: any single enabled feature is enough\n *   - AND mode: all features must be enabled\n * \n * For limit features:\n *   - CREATE operations: checks currentUsage + 1 <= limit\n *   - CREATE_MANY: checks currentUsage < limit (conservative — backend does exact check)\n *   - Other operations: increment = 0, so limits are not checked\n * \n * Returns the \"worst\" availability result (boolean failure takes precedence over limit failure).\n */\n\nimport { useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  CoreResourceOperation,\n  type RequiredFeaturesConfig,\n  type RequiredFeaturesFullConfig,\n  type FeatureUpgradeOption,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { FeatureAvailability } from './useFeatureAvailability';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Re-export the FeatureAvailability type for convenience\nexport type { FeatureAvailability };\n\n/**\n * Minimal operation-like shape accepted by resolveOperationFeatureAvailability.\n * Used to wrap view-level requiredFeatures or standalone feature checks\n * without needing the full FrontendResourceConfiguration_Operation type.\n * \n * Cast to FrontendResourceConfiguration_Operation when calling resolveOperationFeatureAvailability:\n *   `viewCheckable as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation`\n */\nexport interface RequiredFeaturesCheckable {\n  requiredFeatures: RequiredFeaturesConfig;\n  operationIdentifier: string;\n}\n\n// ================================\n// Pure Resolution Function (for batch + hook use)\n// ================================\n\n/**\n * Parameters for the pure resolution function.\n * Contains all the context needed to resolve feature availability without hooks.\n */\nexport interface ResolveOperationFeatureAvailabilityContext {\n  resolvedFeatures: { features: string[]; limits: Record<string, number>; currentUsage: Record<string, number> };\n  resolvedFeaturesResponse: { upgradeOptions: Record<string, { availableVia: FeatureUpgradeOption[] }> } | null;\n  featureDefinitions: Map<string, FeatureDefinition>;\n  unavailabilityPolicy: ReturnType<typeof useFeatures>['unavailabilityPolicy'];\n  userRoles: string[];\n  billingEnabled: boolean;\n}\n\n/**\n * Pure function to resolve feature availability for an operation's requiredFeatures.\n * Can be called from hooks (via useMemo) or from batch evaluation effects.\n * \n * @param operation - The frontend resource operation configuration\n * @param ctx - Resolution context (resolved features, definitions, policy, roles)\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function resolveOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n  ctx: ResolveOperationFeatureAvailabilityContext,\n): FeatureAvailability | undefined {\n  if (!operation) return undefined;\n\n  // Normalize requiredFeatures (may be string[] or RequiredFeaturesFullConfig)\n  const raw = operation.requiredFeatures;\n  if (!raw) return undefined;\n\n  const normalized: RequiredFeaturesFullConfig = Array.isArray(raw)\n    ? { features: raw, mode: 'OR' }\n    : raw;\n\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    userRoles,\n    billingEnabled,\n  } = ctx;\n  const resolvedSet = new Set(resolvedFeatures.features);\n\n  // ── Phase 1: Boolean features ──\n  if (normalized.features && normalized.features.length > 0) {\n    const mode = normalized.mode ?? 'OR';\n\n    if (mode === 'OR') {\n      // OR: at least one boolean feature must be enabled\n      const booleanFeatures = normalized.features.filter(fId => {\n        const def = featureDefinitions.get(fId);\n        return !def || def.valueType === FeatureValueType.BOOLEAN;\n      });\n\n      const anyEnabled = booleanFeatures.some(fId => resolvedSet.has(fId));\n      if (booleanFeatures.length > 0 && !anyEnabled) {\n        const missingFeatures = booleanFeatures.filter(fId => !resolvedSet.has(fId));\n        const firstMissing = featureDefinitions.get(missingFeatures[0]);\n        const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef: firstMissing,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[missingFeatures[0]]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          missingFeatures,\n          upgradeOptions,\n          suggestedProductRef: firstMissing?.unavailability?.suggestedProductRef,\n        };\n      }\n    } else {\n      // AND: all boolean features must be enabled\n      for (const featureId of normalized.features) {\n        const def = featureDefinitions.get(featureId);\n        if (def && def.valueType !== FeatureValueType.BOOLEAN) continue;\n\n        if (!resolvedSet.has(featureId)) {\n          const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n          const { behavior } = resolveFeatureUnavailabilityBehavior({\n            reason,\n            featureDef: def,\n            policy: unavailabilityPolicy,\n            userRoles,\n            billingEnabled,\n          });\n          const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n          return {\n            isAvailable: false,\n            reason,\n            behavior,\n            missingFeatures: [featureId],\n            upgradeOptions,\n            suggestedProductRef: def?.unavailability?.suggestedProductRef,\n          };\n        }\n      }\n    }\n  }\n\n  // ── Phase 2: Limit checks ──\n  if (normalized.limitChecks && normalized.limitChecks.length > 0) {\n    const operationId = operation.operationIdentifier as string;\n\n    for (const check of normalized.limitChecks) {\n      const limit = resolvedFeatures.limits[check.featureId];\n\n      // No limit or unlimited → pass\n      if (limit === undefined || limit === FEATURES_UNLIMITED) continue;\n\n      const currentUsage = resolvedFeatures.currentUsage[check.featureId] ?? 0;\n\n      // Infer increment (frontend-side: same logic as backend, conservative for CREATE_MANY)\n      let increment: number;\n      if (check.increment !== undefined) {\n        increment = check.increment;\n      } else if (operationId === CoreResourceOperation.CREATE) {\n        increment = 1;\n      } else if (operationId === CoreResourceOperation.CREATE_MANY) {\n        increment = 1; // Conservative — backend does exact check\n      } else {\n        increment = 0;\n      }\n\n      if (increment === 0) continue;\n\n      if (currentUsage + increment > limit) {\n        const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n        const featureDef = featureDefinitions.get(check.featureId);\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[check.featureId]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          limitInfo: { featureId: check.featureId, current: currentUsage, limit },\n          upgradeOptions,\n          suggestedProductRef: featureDef?.unavailability?.suggestedProductRef,\n        };\n      }\n    }\n  }\n\n  // All checks passed\n  return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n}\n\n// ================================\n// Hook (convenience wrapper over pure function)\n// ================================\n\n/**\n * Resolve feature availability for an operation's requiredFeatures.\n * \n * @param operation - The frontend resource operation configuration\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function useOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n): FeatureAvailability | undefined {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  return useMemo((): FeatureAvailability | undefined => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return operation?.requiredFeatures\n        ? { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE }\n        : undefined;\n    }\n\n    // Build user roles for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    return resolveOperationFeatureAvailability(operation, {\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      userRoles,\n      billingEnabled: billing?.isEnabled ?? false,\n    });\n  }, [\n    operation,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n}\n"]}
+{"version":3,"file":"useOperationFeatureAvailability.js","sourceRoot":"","sources":["../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useOperationFeatureAvailability Hook\n * \n * Resolves feature availability for an operation's `requiredFeatures` config.\n * Evaluates both boolean features (OR/AND mode) and limit checks.\n * \n * For boolean features:\n *   - OR mode: any single enabled feature is enough\n *   - AND mode: all features must be enabled\n * \n * For limit features:\n *   - CREATE operations: checks currentUsage + 1 <= limit\n *   - CREATE_MANY: checks currentUsage < limit (conservative — backend does exact check)\n *   - Other operations: increment = 0, so limits are not checked\n * \n * Returns the \"worst\" availability result (boolean failure takes precedence over limit failure).\n */\n\nimport { useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  CoreResourceOperation,\n  type RequiredFeaturesConfig,\n  type RequiredFeaturesFullConfig,\n  type FeatureUpgradeOption,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { FeatureAvailability } from './useFeatureAvailability';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Re-export the FeatureAvailability type for convenience\nexport type { FeatureAvailability };\n\n/**\n * Minimal operation-like shape accepted by resolveOperationFeatureAvailability.\n * Used to wrap view-level requiredFeatures or standalone feature checks\n * without needing the full FrontendResourceConfiguration_Operation type.\n * \n * Cast to FrontendResourceConfiguration_Operation when calling resolveOperationFeatureAvailability:\n *   `viewCheckable as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation`\n */\nexport interface RequiredFeaturesCheckable {\n  requiredFeatures: RequiredFeaturesConfig;\n  operationIdentifier: string;\n}\n\n// ================================\n// Pure Resolution Function (for batch + hook use)\n// ================================\n\n/**\n * Parameters for the pure resolution function.\n * Contains all the context needed to resolve feature availability without hooks.\n */\nexport interface ResolveOperationFeatureAvailabilityContext {\n  resolvedFeatures: { features: string[]; limits: Record<string, number>; currentUsage: Record<string, number> };\n  resolvedFeaturesResponse: { upgradeOptions: Record<string, { availableVia: FeatureUpgradeOption[] }> } | null;\n  featureDefinitions: Map<string, FeatureDefinition>;\n  unavailabilityPolicy: ReturnType<typeof useFeatures>['unavailabilityPolicy'];\n  userRoles: string[];\n  billingEnabled: boolean;\n}\n\n/**\n * Pure function to resolve feature availability for an operation's requiredFeatures.\n * Can be called from hooks (via useMemo) or from batch evaluation effects.\n * \n * @param operation - The frontend resource operation configuration\n * @param ctx - Resolution context (resolved features, definitions, policy, roles)\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function resolveOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n  ctx: ResolveOperationFeatureAvailabilityContext,\n): FeatureAvailability | undefined {\n  if (!operation) return undefined;\n\n  // Normalize requiredFeatures (may be string[] or RequiredFeaturesFullConfig)\n  const raw = operation.requiredFeatures;\n  if (!raw) return undefined;\n\n  const normalized: RequiredFeaturesFullConfig = Array.isArray(raw)\n    ? { features: raw, mode: 'OR' }\n    : raw;\n\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    userRoles,\n    billingEnabled,\n  } = ctx;\n  const resolvedSet = new Set(resolvedFeatures.features);\n\n  // ── Phase 1: Boolean features ──\n  if (normalized.features && normalized.features.length > 0) {\n    const mode = normalized.mode ?? 'OR';\n\n    if (mode === 'OR') {\n      // OR: at least one boolean feature must be enabled\n      const booleanFeatures = normalized.features.filter(fId => {\n        const def = featureDefinitions.get(fId);\n        return !def || def.valueType === FeatureValueType.BOOLEAN;\n      });\n\n      const anyEnabled = booleanFeatures.some(fId => resolvedSet.has(fId));\n      if (booleanFeatures.length > 0 && !anyEnabled) {\n        const missingFeatures = booleanFeatures.filter(fId => !resolvedSet.has(fId));\n        const firstMissing = featureDefinitions.get(missingFeatures[0]);\n        const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef: firstMissing,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[missingFeatures[0]]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          missingFeatures,\n          upgradeOptions,\n          suggestedProductRef: firstMissing?.unavailability?.suggestedProductRef,\n        };\n      }\n    } else {\n      // AND: all boolean features must be enabled\n      for (const featureId of normalized.features) {\n        const def = featureDefinitions.get(featureId);\n        if (def && def.valueType !== FeatureValueType.BOOLEAN) continue;\n\n        if (!resolvedSet.has(featureId)) {\n          const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n          const { behavior } = resolveFeatureUnavailabilityBehavior({\n            reason,\n            featureDef: def,\n            policy: unavailabilityPolicy,\n            userRoles,\n            billingEnabled,\n          });\n          const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n          return {\n            isAvailable: false,\n            reason,\n            behavior,\n            missingFeatures: [featureId],\n            upgradeOptions,\n            suggestedProductRef: def?.unavailability?.suggestedProductRef,\n          };\n        }\n      }\n    }\n  }\n\n  // ── Phase 2: Limit checks ──\n  if (normalized.limitChecks && normalized.limitChecks.length > 0) {\n    const operationId = operation.operationIdentifier as string;\n\n    for (const check of normalized.limitChecks) {\n      const limit = resolvedFeatures.limits[check.featureId];\n\n      // No limit or unlimited → pass\n      if (limit === undefined || limit === FEATURES_UNLIMITED) continue;\n\n      const currentUsage = resolvedFeatures.currentUsage[check.featureId] ?? 0;\n\n      // Infer increment (frontend-side: same logic as backend, conservative for CREATE_MANY)\n      let increment: number;\n      if (check.increment !== undefined) {\n        increment = check.increment;\n      } else if (operationId === CoreResourceOperation.CREATE) {\n        increment = 1;\n      } else if (operationId === CoreResourceOperation.CREATE_MANY) {\n        increment = 1; // Conservative — backend does exact check\n      } else {\n        increment = 0;\n      }\n\n      if (increment === 0) continue;\n\n      if (currentUsage + increment > limit) {\n        const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n        const featureDef = featureDefinitions.get(check.featureId);\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[check.featureId]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          limitInfo: { featureId: check.featureId, current: currentUsage, limit },\n          upgradeOptions,\n          suggestedProductRef: featureDef?.unavailability?.suggestedProductRef,\n        };\n      }\n    }\n  }\n\n  // All checks passed\n  return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n}\n\n// ================================\n// Hook (convenience wrapper over pure function)\n// ================================\n\n/**\n * Resolve feature availability for an operation's requiredFeatures.\n * \n * @param operation - The frontend resource operation configuration\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function useOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n): FeatureAvailability | undefined {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  return useMemo((): FeatureAvailability | undefined => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return operation?.requiredFeatures\n        ? { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE }\n        : undefined;\n    }\n\n    // Build user roles for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    return resolveOperationFeatureAvailability(operation, {\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      userRoles,\n      billingEnabled: billing?.isEnabled ?? false,\n    });\n  }, [\n    operation,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n}\n"]}

package/dist/esm/core/flows-actors/FlowsActorsContext.d.ts

@@ -33,12 +33,31 @@ export interface FlowsActorsExecution {
          */
         messageId?: string;
     }>;
+    /**
+     * The decision a paused turn is waiting on.
+     *
+     * `riskLevel` and `requiredRoles` are OPTIONAL because nothing populates them: they belong to
+     * `WS_FlowsActorsApprovalRequestPayload`, a payload no code has ever emitted. What the server
+     * actually announces is `WS_FlowsActorsApprovalAnnouncementData`, carried in the `data` bag of a
+     * PROGRESS message — tool name, tool arguments, timing, and the isolation axis (#528). Typing
+     * them as required would let a surface render a risk claim nothing declared.
+     */
     pendingApproval?: {
         approvalId: string;
         actionDescription: string;
-        riskLevel: 'low' | 'medium' | 'high' | 'critical';
+        riskLevel?: 'low' | 'medium' | 'high' | 'critical';
         expiresAt?: Date;
         requiredRoles?: string[];
+        /** The tool call being gated, and its arguments — the structured thing being approved. */
+        toolName?: string;
+        toolArgs?: Record<string, unknown>;
+        requestedAt?: Date;
+        /**
+         * ECHOED back on the decision. Dropping it filters the resume against the default-instance
+         * sentinel, so an approval raised on a named agent instance matches no row and is discarded
+         * silently, leaving the turn paused forever.
+         */
+        resourceServerInstanceRef?: string;
     };
     /** Set when the last error is recoverable (UI can offer a retry action) */
     recoverable?: boolean;
@@ -61,7 +80,12 @@ export interface FlowsActorsContextType {
     /** Start a new execution (fire-and-forget via WebSocket; returns local executionId) */
     startExecution: (systemRef: string, initialInput?: Record<string, unknown>, existingExecutionId?: string) => string | null;
     /** Respond to an approval request (fire-and-forget via WebSocket) */
-    respondToApproval: (executionId: string, approvalId: string, approved: boolean, comment?: string) => void;
+    /**
+     * `modifiedToolArgs` (#566) replaces the arguments the agent proposed. Absent means "run the call
+     * as proposed"; the server validates the edit against the tool's own schema and refuses through
+     * `FLOWS_ACTORS_ERROR` with the approval left pending.
+     */
+    respondToApproval: (executionId: string, approvalId: string, approved: boolean, comment?: string, modifiedToolArgs?: Record<string, unknown>) => void;
     /** Remove a completed/errored execution from state */
     clearExecution: (executionId: string) => void;
     /** Get execution by ID (reads from ref; consume `executions` to re-render on changes) */