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

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

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

package/dist/esm/core/external-providers/frontend-provider-display-label.frontend.utils.d.ts

@@ -0,0 +1,31 @@
+export interface FrontendProviderDisplayLabelInput {
+    providerRef: string;
+    displayName?: string;
+    displayNameLabelKey?: string;
+    /**
+     * Optional explicit fallback when the caller wants a non-ref technical
+     * fallback (for example a brand label sourced from a static map).
+     */
+    fallbackLabel?: string;
+    translate?: (key: string) => string;
+}
+/**
+ * Collect unique, non-empty provider display-label keys for `useI18n({ keys })`.
+ *
+ * The helper intentionally stays tiny and framework-agnostic: call sites can
+ * build whatever provider view-model they need, then hand only the optional
+ * label keys here to get the deduped request list.
+ */
+export declare function collectFrontendProviderDisplayLabelKeys(labelKeys: ReadonlyArray<string | undefined | null>): string[];
+/**
+ * Resolve a user-facing provider label without freezing locale-bound copy into
+ * provider metadata or generated artifacts.
+ *
+ * Order of preference:
+ * 1. Translation resolved from the provider label key.
+ * 2. Authored display name on the provider metadata.
+ * 3. Optional caller-supplied fallback label.
+ * 4. Raw provider ref as the technical last resort.
+ */
+export declare function resolveFrontendProviderDisplayLabel(input: FrontendProviderDisplayLabelInput): string;
+//# sourceMappingURL=frontend-provider-display-label.frontend.utils.d.ts.map

package/dist/esm/core/external-providers/frontend-provider-display-label.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-provider-display-label.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-display-label.frontend.utils.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iCAAiC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAClD,MAAM,EAAE,CASV;AAED;;;;;;;;;GASG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,iCAAiC,GACvC,MAAM,CASR"}

package/dist/esm/core/external-providers/frontend-provider-display-label.frontend.utils.js

@@ -0,0 +1,30 @@
+import { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';
+/**
+ * Collect unique, non-empty provider display-label keys for `useI18n({ keys })`.
+ *
+ * The helper intentionally stays tiny and framework-agnostic: call sites can
+ * build whatever provider view-model they need, then hand only the optional
+ * label keys here to get the deduped request list.
+ */
+export function collectFrontendProviderDisplayLabelKeys(labelKeys) {
+    return Array.from(new Set(labelKeys.filter((labelKey) => typeof labelKey === 'string' && labelKey.length > 0)));
+}
+/**
+ * Resolve a user-facing provider label without freezing locale-bound copy into
+ * provider metadata or generated artifacts.
+ *
+ * Order of preference:
+ * 1. Translation resolved from the provider label key.
+ * 2. Authored display name on the provider metadata.
+ * 3. Optional caller-supplied fallback label.
+ * 4. Raw provider ref as the technical last resort.
+ */
+export function resolveFrontendProviderDisplayLabel(input) {
+    const labelKey = input.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(input.providerRef);
+    const translated = input.translate?.(labelKey);
+    if (translated && translated !== labelKey) {
+        return translated;
+    }
+    return input.displayName ?? input.fallbackLabel ?? input.providerRef;
+}
+//# sourceMappingURL=frontend-provider-display-label.frontend.utils.js.map

package/dist/esm/core/external-providers/frontend-provider-display-label.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-provider-display-label.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-display-label.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAcxF;;;;;;GAMG;AACH,MAAM,UAAU,uCAAuC,CACrD,SAAmD;IAEnD,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CACL,SAAS,CAAC,MAAM,CACd,CAAC,QAAQ,EAAsB,EAAE,CAC/B,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CACtD,CACF,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mCAAmC,CACjD,KAAwC;IAExC,MAAM,QAAQ,GAAG,KAAK,CAAC,mBAAmB,IAAI,gCAAgC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAClG,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,UAAU,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,CAAC;AACvE,CAAC","sourcesContent":["import { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';\n\nexport interface FrontendProviderDisplayLabelInput {\n  providerRef: string;\n  displayName?: string;\n  displayNameLabelKey?: string;\n  /**\n   * Optional explicit fallback when the caller wants a non-ref technical\n   * fallback (for example a brand label sourced from a static map).\n   */\n  fallbackLabel?: string;\n  translate?: (key: string) => string;\n}\n\n/**\n * Collect unique, non-empty provider display-label keys for `useI18n({ keys })`.\n *\n * The helper intentionally stays tiny and framework-agnostic: call sites can\n * build whatever provider view-model they need, then hand only the optional\n * label keys here to get the deduped request list.\n */\nexport function collectFrontendProviderDisplayLabelKeys(\n  labelKeys: ReadonlyArray<string | undefined | null>,\n): string[] {\n  return Array.from(\n    new Set(\n      labelKeys.filter(\n        (labelKey): labelKey is string =>\n          typeof labelKey === 'string' && labelKey.length > 0,\n      ),\n    ),\n  );\n}\n\n/**\n * Resolve a user-facing provider label without freezing locale-bound copy into\n * provider metadata or generated artifacts.\n *\n * Order of preference:\n * 1. Translation resolved from the provider label key.\n * 2. Authored display name on the provider metadata.\n * 3. Optional caller-supplied fallback label.\n * 4. Raw provider ref as the technical last resort.\n */\nexport function resolveFrontendProviderDisplayLabel(\n  input: FrontendProviderDisplayLabelInput,\n): string {\n  const labelKey = input.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(input.providerRef);\n  const translated = input.translate?.(labelKey);\n\n  if (translated && translated !== labelKey) {\n    return translated;\n  }\n\n  return input.displayName ?? input.fallbackLabel ?? input.providerRef;\n}\n"]}

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

@@ -0,0 +1,40 @@
+/**
+ * `FrontendProviderRegistryFrontendService` — frontend-side API for
+ * reading the per-app provider catalog hydrated from the backend.
+ *
+ * Hydrated once at app start from
+ * `FrontendAppBootstrapPayload.frontendProviders` (Phase 6 wiring); the
+ * payload is built by `FrontendBootstrapBackendService.buildPayload()`,
+ * which is the SOLE cross-facet seam where backend code projects a
+ * `BackendProviderModule` into a `FrontendProviderEntry`. From the
+ * frontend's perspective this service is the only legal way to read
+ * provider information — direct imports from
+ * `@wildo-ai/external-connectors-private/*` are a TypeScript error
+ * because the frontend bundle does not depend on that package.
+ *
+ * See `.cursor/plans/provider-registration-refactor-implementation-plan.md`
+ * §Phase 0.8.
+ */
+import type { FrontendProvidersBlock, ProviderCapability } from '@wildo-ai/saas-models';
+import type { ProviderProtocol } from '@wildo-ai/saas-models/public-runtime';
+import type { FrontendAppProviderModule, FrontendAppProviderRef } from '@wildo-ai/external-connectors-public/app';
+export interface FrontendProviderRegistryFrontendService {
+    /** Hydrated from `FrontendAppBootstrapPayload` at app start. */
+    getProviderByRef(ref: FrontendAppProviderRef): FrontendAppProviderModule | undefined;
+    listByProviderCapability(providerCapability: ProviderCapability): ReadonlyArray<FrontendAppProviderModule>;
+    findByProviderCapability(providerCapability: ProviderCapability): FrontendAppProviderModule | undefined;
+    findByProviderCapabilityAndProtocol(providerCapability: ProviderCapability, providerProtocol: ProviderProtocol | string): FrontendAppProviderModule | undefined;
+    /** All providers (read-only). For debug / introspection only. */
+    listAll(): ReadonlyArray<FrontendAppProviderModule>;
+}
+export declare class InMemoryFrontendProviderRegistryFrontendService implements FrontendProviderRegistryFrontendService {
+    private registry;
+    initialize(frontendProviders?: FrontendProvidersBlock): void;
+    getProviderByRef(ref: FrontendAppProviderRef): FrontendAppProviderModule | undefined;
+    listByProviderCapability(providerCapability: ProviderCapability): ReadonlyArray<FrontendAppProviderModule>;
+    findByProviderCapability(providerCapability: ProviderCapability): FrontendAppProviderModule | undefined;
+    findByProviderCapabilityAndProtocol(providerCapability: ProviderCapability, providerProtocol: ProviderProtocol | string): FrontendAppProviderModule | undefined;
+    listAll(): ReadonlyArray<FrontendAppProviderModule>;
+}
+export declare function createFrontendProviderRegistryFrontendService(frontendProviders?: FrontendProvidersBlock): FrontendProviderRegistryFrontendService;
+//# sourceMappingURL=frontend-provider-registry.frontend.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-provider-registry.frontend.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,0CAA0C,CAAC;AAElD,MAAM,WAAW,uCAAuC;IACtD,gEAAgE;IAChE,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,yBAAyB,GAAG,SAAS,CAAC;IAErF,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS,CAAC;IAEzC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS,CAAC;IAEzC,iEAAiE;IACjE,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC,CAAC;CACrD;AAED,qBAAa,+CACX,YAAW,uCAAuC;IAElD,OAAO,CAAC,QAAQ,CAEb;IAEH,UAAU,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAW5D,gBAAgB,CACd,GAAG,EAAE,sBAAsB,GAC1B,yBAAyB,GAAG,SAAS;IAIxC,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC;IAI3C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS;IAIxC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS;IAQxC,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC;CAGpD;AAED,wBAAgB,6CAA6C,CAC3D,iBAAiB,CAAC,EAAE,sBAAsB,GACzC,uCAAuC,CAIzC"}

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

@@ -0,0 +1,53 @@
+/**
+ * `FrontendProviderRegistryFrontendService` — frontend-side API for
+ * reading the per-app provider catalog hydrated from the backend.
+ *
+ * Hydrated once at app start from
+ * `FrontendAppBootstrapPayload.frontendProviders` (Phase 6 wiring); the
+ * payload is built by `FrontendBootstrapBackendService.buildPayload()`,
+ * which is the SOLE cross-facet seam where backend code projects a
+ * `BackendProviderModule` into a `FrontendProviderEntry`. From the
+ * frontend's perspective this service is the only legal way to read
+ * provider information — direct imports from
+ * `@wildo-ai/external-connectors-private/*` are a TypeScript error
+ * because the frontend bundle does not depend on that package.
+ *
+ * See `.cursor/plans/provider-registration-refactor-implementation-plan.md`
+ * §Phase 0.8.
+ */
+import { composeFrontendAppProviders } from '@wildo-ai/external-connectors-public/app';
+export class InMemoryFrontendProviderRegistryFrontendService {
+    registry = composeFrontendAppProviders({
+        modules: new Map(),
+    });
+    initialize(frontendProviders) {
+        const modules = new Map(Object.entries(frontendProviders?.providers ?? {}).map(([ref, provider]) => [
+            ref,
+            provider,
+        ]));
+        this.registry = composeFrontendAppProviders({ modules });
+    }
+    getProviderByRef(ref) {
+        return this.registry.getProviderByRef(ref);
+    }
+    listByProviderCapability(providerCapability) {
+        return this.registry.getProvidersByProviderCapability(providerCapability);
+    }
+    findByProviderCapability(providerCapability) {
+        return this.registry.findProviderByProviderCapability(providerCapability);
+    }
+    findByProviderCapabilityAndProtocol(providerCapability, providerProtocol) {
+        return this.registry
+            .getProvidersByProviderCapability(providerCapability)
+            .find((provider) => provider.protocols.some((protocol) => protocol === providerProtocol));
+    }
+    listAll() {
+        return [...this.registry.modules.values()];
+    }
+}
+export function createFrontendProviderRegistryFrontendService(frontendProviders) {
+    const service = new InMemoryFrontendProviderRegistryFrontendService();
+    service.initialize(frontendProviders);
+    return service;
+}
+//# sourceMappingURL=frontend-provider-registry.frontend.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-provider-registry.frontend.service.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AA2BvF,MAAM,OAAO,+CAA+C;IAGlD,QAAQ,GAAG,2BAA2B,CAAC;QAC7C,OAAO,EAAE,IAAI,GAAG,EAAqD;KACtE,CAAC,CAAC;IAEH,UAAU,CAAC,iBAA0C;QACnD,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;YAC1E,GAA6B;YAC7B,QAAqC;SACtC,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,gBAAgB,CACd,GAA2B;QAE3B,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,mCAAmC,CACjC,kBAAsC,EACtC,gBAA2C;QAE3C,OAAO,IAAI,CAAC,QAAQ;aACjB,gCAAgC,CAAC,kBAAkB,CAAC;aACpD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACjB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,gBAAgB,CAAC,CACrE,CAAC;IACN,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,UAAU,6CAA6C,CAC3D,iBAA0C;IAE1C,MAAM,OAAO,GAAG,IAAI,+CAA+C,EAAE,CAAC;IACtE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * `FrontendProviderRegistryFrontendService` — frontend-side API for\n * reading the per-app provider catalog hydrated from the backend.\n *\n * Hydrated once at app start from\n * `FrontendAppBootstrapPayload.frontendProviders` (Phase 6 wiring); the\n * payload is built by `FrontendBootstrapBackendService.buildPayload()`,\n * which is the SOLE cross-facet seam where backend code projects a\n * `BackendProviderModule` into a `FrontendProviderEntry`. From the\n * frontend's perspective this service is the only legal way to read\n * provider information — direct imports from\n * `@wildo-ai/external-connectors-private/*` are a TypeScript error\n * because the frontend bundle does not depend on that package.\n *\n * See `.cursor/plans/provider-registration-refactor-implementation-plan.md`\n * §Phase 0.8.\n */\n\nimport type {\n  FrontendProvidersBlock,\n  ProviderCapability,\n} from '@wildo-ai/saas-models';\nimport type { ProviderProtocol } from '@wildo-ai/saas-models/public-runtime';\nimport { composeFrontendAppProviders } from '@wildo-ai/external-connectors-public/app';\nimport type {\n  FrontendAppProviderModule,\n  FrontendAppProviderRef,\n} from '@wildo-ai/external-connectors-public/app';\n\nexport interface FrontendProviderRegistryFrontendService {\n  /** Hydrated from `FrontendAppBootstrapPayload` at app start. */\n  getProviderByRef(ref: FrontendAppProviderRef): FrontendAppProviderModule | undefined;\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule>;\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined;\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined;\n\n  /** All providers (read-only). For debug / introspection only. */\n  listAll(): ReadonlyArray<FrontendAppProviderModule>;\n}\n\nexport class InMemoryFrontendProviderRegistryFrontendService\n  implements FrontendProviderRegistryFrontendService\n{\n  private registry = composeFrontendAppProviders({\n    modules: new Map<FrontendAppProviderRef, FrontendAppProviderModule>(),\n  });\n\n  initialize(frontendProviders?: FrontendProvidersBlock): void {\n    const modules = new Map<FrontendAppProviderRef, FrontendAppProviderModule>(\n      Object.entries(frontendProviders?.providers ?? {}).map(([ref, provider]) => [\n        ref as FrontendAppProviderRef,\n        provider as FrontendAppProviderModule,\n      ]),\n    );\n\n    this.registry = composeFrontendAppProviders({ modules });\n  }\n\n  getProviderByRef(\n    ref: FrontendAppProviderRef,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.getProviderByRef(ref);\n  }\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule> {\n    return this.registry.getProvidersByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.findProviderByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry\n      .getProvidersByProviderCapability(providerCapability)\n      .find((provider) =>\n        provider.protocols.some((protocol) => protocol === providerProtocol),\n      );\n  }\n\n  listAll(): ReadonlyArray<FrontendAppProviderModule> {\n    return [...this.registry.modules.values()];\n  }\n}\n\nexport function createFrontendProviderRegistryFrontendService(\n  frontendProviders?: FrontendProvidersBlock,\n): FrontendProviderRegistryFrontendService {\n  const service = new InMemoryFrontendProviderRegistryFrontendService();\n  service.initialize(frontendProviders);\n  return service;\n}\n"]}

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

@@ -19,7 +19,7 @@
  *   </FeatureGate>
  */
 import React from 'react';
-import { type FeatureAvailability } from './useFeatureAvailability.js';
+import { type FeatureAvailability } from './useFeatureAvailability';
 export interface FeatureGateProps {
     /** Feature identifier to check */
     featureId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"FeatureGate.d.ts","sourceRoot":"","sources":["../../../../src/core/features/FeatureGate.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAM5F,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5E;AAED,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,iBAAiB,GAClB,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA+B7C"}
+{"version":3,"file":"FeatureGate.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/FeatureGate.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAM5F,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5E;AAED,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,iBAAiB,GAClB,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA+B7C"}

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

@@ -22,4 +22,4 @@ export function FeatureGate({ featureId, children, renderUnavailable, }) {
     // generic "go back" action because they are embedded into the current page.
     return (_jsx(FeatureUnavailablePrompt, { behavior: availability.behavior, missingFeatures: availability.missingFeatures, limitInfo: availability.limitInfo, upgradeOptionsCount: availability.upgradeOptions?.length, onDismiss: undefined, onAction: () => billingAction(availability) }));
 }
-//# sourceMappingURL=FeatureGate.js.map
+//# sourceMappingURL=FeatureGate.js.map

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

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

@@ -14,7 +14,7 @@
  */
 import React from 'react';
 import { type RequiredFeaturesConfig } from '@wildo-ai/saas-models';
-import type { FrontendResourceConfiguration_Operation } from '../../core/resources/resources.frontend.schemas.js';
+import type { FrontendResourceConfiguration_Operation } from '../../core/resources/resources.frontend.schemas';
 interface FeatureRouteGuardProps {
     /** For resource routes: the operation to check. */
     operation?: FrontendResourceConfiguration_Operation;

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,CAoG9D,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,CA0G9D,CAAC"}

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

@@ -79,19 +79,24 @@ export const FeatureRouteGuard = ({ operation, requiredFeatures, children, }) =>
         }
         navigateHome();
     }, [emit, navigate, navigateHome, navigationContext]);
-    // No requiredFeatures → no gating
-    if (!availability)
-        return _jsx(_Fragment, { children: children });
-    // Features are available → render children
-    if (availability.isAvailable)
-        return _jsx(_Fragment, { children: children });
-    const shouldHide = availability.behavior === FeatureUnavailabilityBehavior.HIDE;
+    // Computed (and the effect registered) BEFORE the early returns below:
+    // `availability` flips between undefined / available / unavailable across
+    // renders, so the hook count must not depend on it (rules of hooks).
+    const shouldHide = availability !== undefined &&
+        !availability.isAvailable &&
+        availability.behavior === FeatureUnavailabilityBehavior.HIDE;
     React.useEffect(() => {
         if (!shouldHide) {
             return;
         }
         navigateHome();
     }, [navigateHome, shouldHide]);
+    // No requiredFeatures → no gating
+    if (!availability)
+        return _jsx(_Fragment, { children: children });
+    // Features are available → render children
+    if (availability.isAvailable)
+        return _jsx(_Fragment, { children: children });
     // HIDE → navigate away silently
     if (shouldHide) {
         return null;
@@ -99,4 +104,4 @@ export const FeatureRouteGuard = ({ operation, requiredFeatures, children, }) =>
     // 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) }));
 };
-//# sourceMappingURL=FeatureRouteGuard.js.map
+//# 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":"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"}
+{"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      const currentBrowserUrl = NavigationUtils.buildBrowserUrl(\n        window.location.pathname,\n        window.location.search,\n      );\n      const routeOwner = NavigationUtils.findStructuralRouteOwner(\n        currentBrowserUrl,\n        navigationContext.getZoneState,\n      );\n      const targetZone = routeOwner?.zone ?? NavigationZoneName.PRIMARY;\n      const zoneState = navigationContext.getZoneState(targetZone);\n\n      if (zoneState.stack.length > 1) {\n        const previousEntry = zoneState.stack[zoneState.stack.length - 2];\n        if (previousEntry?.urlPath) {\n          emit(FrontendEvents.NAVIGATION_POP, { zone: targetZone });\n          navigate(previousEntry.urlPath, { replace: true });\n          return;\n        }\n      } else if (targetZone !== NavigationZoneName.PRIMARY) {\n        const primaryState = navigationContext.getZoneState(NavigationZoneName.PRIMARY);\n        const secondaryState = navigationContext.getZoneState(NavigationZoneName.SECONDARY);\n        const fallbackUrl = targetZone === NavigationZoneName.COMPANION\n          ? secondaryState.stack[secondaryState.stack.length - 1]?.urlPath\n            ?? primaryState.stack[primaryState.stack.length - 1]?.urlPath\n          : primaryState.stack[primaryState.stack.length - 1]?.urlPath;\n\n        if (fallbackUrl) {\n          emit(FrontendEvents.NAVIGATION_POP, { zone: targetZone });\n          navigate(fallbackUrl, { replace: true });\n          return;\n        }\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"]}

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

@@ -26,8 +26,14 @@ export interface FeaturesContextType {
     featureDefinitions: Map<string, FeatureDefinition>;
     /** The unavailability policy (from featureConfiguration.unavailabilityPolicy) */
     unavailabilityPolicy: FeatureConfiguration['unavailabilityPolicy'];
-    /** Check if a boolean feature is enabled */
+    /** Check if a boolean feature is ENTITLED for the current scope (plan/profile). */
     isFeatureEnabled: (featureId: string) => boolean;
+    /**
+     * Check if the app OFFERS a feature for the current scope — entitled now, or
+     * reachable via an upgrade/add-on. Plan-independent survival signal, distinct
+     * from `isFeatureEnabled` (entitlement). See the impl for the two-axis rationale.
+     */
+    isFeatureOffered: (featureId: string) => boolean;
     /** Get a limit value (FEATURES_UNLIMITED = unlimited). Returns undefined if feature not found. */
     getLimit: (featureId: string) => number | undefined;
     /** Get current usage for a limit feature. undefined if no usage data. */

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,EAGL,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,4CAA4C;IAC5C,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,CA8M9G"}
+{"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

@@ -17,7 +17,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * (which is acceptable — the error is caught and displayed).
  */
 import { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';
-import { CoreWebSocketEvent, FEATURES_UNLIMITED, } from '@wildo-ai/saas-models';
+import { CoreWebSocketEvent, FEATURES_UNLIMITED, MAIN_API_BASE_PATH, } from '@wildo-ai/saas-models';
 import { useWebSocket } from '../../core/requests/websockets/useWebSocket.js';
 import { useAuthSession } from '../../core/security/useAuthSession.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
@@ -32,7 +32,7 @@ featuresLogger.setDebugTypeLogging('FeaturesContext', false);
 // ================================
 // Constants
 // ================================
-const FEATURES_API_URL = '/api/v1/features/resolved';
+const FEATURES_API_URL = `${MAIN_API_BASE_PATH}/features/resolved`;
 /** WebSocket events that trigger a refetch of resolved features */
 const INVALIDATION_EVENTS = [
     CoreWebSocketEvent.BILLING_STATUS_CHANGED,
@@ -171,6 +171,23 @@ export function FeaturesProvider({ featureConfiguration, children }) {
     const isFeatureEnabled = useCallback((featureId) => {
         return resolvedFeaturesSet.has(featureId);
     }, [resolvedFeaturesSet]);
+    const isFeatureOffered = useCallback((featureId) => {
+        // "Offered" = the app makes this feature available for the current scope,
+        // INDEPENDENT of whether the current plan/profile currently ENTITLES it:
+        //  - entitled now (in `resolvedFeatures`), OR
+        //  - not entitled but reachable via an upgrade/add-on the backend surfaced
+        //    in `upgradeOptions`.
+        // This is the plan-independent "does this app offer feature X" axis, distinct
+        // from `isFeatureEnabled` (the entitlement axis). Consumers gate SURVIVAL
+        // (should the surface exist at all) on `isFeatureOffered`, then render the
+        // entitlement state via {@link FeatureGate} (content vs upgrade/add-on prompt).
+        // Billing OFF → `upgradeOptions` is empty, so offered == entitled (no
+        // "offered-but-locked" state exists without a plan to upgrade to). Billing ON
+        // → `upgradeOptions` carries the sellable-but-not-yet-owned features.
+        if (resolvedFeaturesSet.has(featureId))
+            return true;
+        return Boolean(resolvedFeaturesResponse?.upgradeOptions?.[featureId]);
+    }, [resolvedFeaturesSet, resolvedFeaturesResponse]);
     const getLimit = useCallback((featureId) => {
         return resolvedFeatures.limits[featureId];
     }, [resolvedFeatures.limits]);
@@ -193,6 +210,7 @@ export function FeaturesProvider({ featureConfiguration, children }) {
         featureDefinitions,
         unavailabilityPolicy,
         isFeatureEnabled,
+        isFeatureOffered,
         getLimit,
         getCurrentUsage,
         getRemainingCapacity,
@@ -205,6 +223,7 @@ export function FeaturesProvider({ featureConfiguration, children }) {
         featureDefinitions,
         unavailabilityPolicy,
         isFeatureEnabled,
+        isFeatureOffered,
         getLimit,
         getCurrentUsage,
         getRemainingCapacity,
@@ -214,4 +233,4 @@ export function FeaturesProvider({ featureConfiguration, children }) {
     ]);
     return (_jsx(FeaturesContext.Provider, { value: contextValue, children: children }));
 }
-//# sourceMappingURL=FeaturesContext.js.map
+//# sourceMappingURL=FeaturesContext.js.map

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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"}
+{"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.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,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAsFA"}

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

@@ -81,4 +81,4 @@ export function resolveFeatureUnavailabilityBehavior(params) {
         debugTrace: trace,
     };
 }
-//# sourceMappingURL=feature-unavailability.frontend.utils.js.map
+//# sourceMappingURL=feature-unavailability.frontend.utils.js.map

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

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;IAG7B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAwJ7E"}

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

@@ -157,4 +157,4 @@ export function useFeatureAvailability(featureId) {
     }, [featureId, result.isAvailable, result.reason, isActive, track]);
     return result;
 }
-//# sourceMappingURL=useFeatureAvailability.js.map
+//# sourceMappingURL=useFeatureAvailability.js.map