@bluealba/pae-ui-react-core 4.0.1-feature-feature-flags-1243 → 4.0.1-feature-feature-flags-1245

package/dist/src/feature-flags/FeatureFlagGuard.d.ts

@@ -23,11 +23,6 @@ export interface FeatureFlagGuardProps {
      * @default false
      */
     invert?: boolean;
-    /**
-     * Base URL for the gateway API
-     * @default ''
-     */
-    gatewayUrl?: string;
 }
 /**
  * Component for conditional rendering based on feature flags

package/dist/src/feature-flags/FeatureFlagsApiClient.d.ts

@@ -0,0 +1,39 @@
+import { ServiceInvoker } from '../hooks/useServiceInvoker';
+import { UnifiedEvaluationResponse, FeatureFlagsResponse } from './types';
+
+/**
+ * API client for feature flag operations
+ */
+export declare class FeatureFlagsApiClient {
+    /**
+     * Evaluate a single feature flag using the unified endpoint
+     *
+     * This endpoint returns the flag's value which can be:
+     * - For boolean flags: true or false
+     * - For variant flags: variant name (string), null, or undefined
+     *
+     * Note: This endpoint does NOT return payload data for variants.
+     * To get payloads, use evaluateFlags() with the bulk endpoint.
+     *
+     * @param invoker - ServiceInvoker for the gateway service
+     * @param flagName - Name of the feature flag to evaluate
+     * @returns Unified evaluation response
+     * @throws Error if the API request fails
+     */
+    static evaluateFlag(invoker: ServiceInvoker, flagName: string): Promise<UnifiedEvaluationResponse>;
+    /**
+     * Evaluate multiple feature flags using the bulk evaluation endpoint
+     *
+     * This endpoint returns full flag evaluation results including:
+     * - Boolean enabled state
+     * - Variant information with payload data
+     * - Evaluation timestamp
+     *
+     * @param invoker - ServiceInvoker for the gateway service
+     * @param flagNames - Array of flag names to evaluate
+     * @param customProperties - Optional custom properties for evaluation context
+     * @returns Feature flags response with array of evaluation results
+     * @throws Error if the API request fails
+     */
+    static evaluateFlags(invoker: ServiceInvoker, flagNames: string[], customProperties?: Record<string, any>): Promise<FeatureFlagsResponse>;
+}

package/dist/src/feature-flags/FeatureFlagsProvider.d.ts

@@ -49,11 +49,6 @@ export interface FeatureFlagsContextValue {
  * Props for the FeatureFlagsProvider component
  */
 export interface FeatureFlagsProviderProps {
-    /**
-     * Base URL for the gateway API
-     * @default ''
-     */
-    gatewayUrl?: string;
     /**
      * Array of flag names to prefetch on mount and refresh
      * These flags will be eagerly loaded and cached

package/dist/src/feature-flags/index.d.ts

@@ -3,7 +3,12 @@
  *
  * This module provides React hooks and components for working with feature flags
  * in the Blue Alba Platform. All utilities are compatible with the gateway's
- * feature flags API (/_/feature-flags).
+ * feature flags API (/_/feature-flags) and use the platform's service discovery pattern.
+ *
+ * Key Features:
+ * - Automatic service discovery via useServiceInvoker
+ * - No need to manually configure gateway URLs
+ * - Centralized API client for feature flag operations
  *
  * @example
  * ```tsx
@@ -11,13 +16,12 @@
  *   FeatureFlagsProvider,
  *   useFeatureFlag,
  *   useFeatureFlags,
- *   useVariant,
+ *   useFeatureFlagVariant,
  *   FeatureFlagGuard
  * } from '@bluealba/pae-ui-react-core';
  *
  * // Wrap your app with the provider
  * <FeatureFlagsProvider
- *   gatewayUrl="/api"
  *   prefetchFlags={['new-ui', 'beta-feature']}
  *   refreshInterval={60000}
  * >
@@ -31,9 +35,10 @@
  * }
  * ```
  */
+export { FeatureFlagsApiClient } from './FeatureFlagsApiClient';
 export type { FlagEvaluationResult, FeatureFlagVariant, FeatureFlagsResponse, SingleFlagResponse, VariantResponse, UnifiedEvaluationResponse, } from './types';
 export { FeatureFlagsProvider, FeatureFlagsContext, type FeatureFlagsProviderProps, type FeatureFlagsContextValue, } from './FeatureFlagsProvider';
 export { useFeatureFlag } from './useFeatureFlag';
 export { useFeatureFlags } from './useFeatureFlags';
-export { useVariant, type UseVariantResult } from './useVariant';
+export { useFeatureFlagVariant, type UseFeatureFlagVariantResult } from './useFeatureFlagVariant';
 export { FeatureFlagGuard, type FeatureFlagGuardProps } from './FeatureFlagGuard';

package/dist/src/feature-flags/useFeatureFlag.d.ts

@@ -3,7 +3,7 @@
  *
  * A React hook for evaluating a single boolean feature flag.
  * This hook first checks if the flag is in the prefetched cache (from FeatureFlagsProvider).
- * If not found in cache, it fetches the flag individually from the API.
+ * If not found in cache, it fetches the flag individually from the API using service discovery.
  *
  * @example
  * ```tsx
@@ -19,7 +19,6 @@
  *
  * @param flagName - Name of the feature flag to evaluate
  * @param defaultValue - Default value to use if flag cannot be evaluated (default: false)
- * @param gatewayUrl - Base URL for the gateway API (default: '')
  * @returns Boolean indicating whether the flag is enabled
  */
-export declare function useFeatureFlag(flagName: string, defaultValue?: boolean, gatewayUrl?: string): boolean;
+export declare function useFeatureFlag(flagName: string, defaultValue?: boolean): boolean;

package/dist/src/feature-flags/{useVariant.d.ts → useFeatureFlagVariant.d.ts}

@@ -1,9 +1,9 @@
 /**
- * useVariant Hook
+ * useFeatureFlagVariant Hook
  *
  * A React hook for getting the variant value of a multivariant feature flag.
  * This hook first checks if the variant is in the prefetched cache (from FeatureFlagsProvider).
- * If not found in cache, it fetches the variant individually from the unified API.
+ * If not found in cache, it fetches the variant individually from the unified API using service discovery.
  *
  * IMPORTANT: The unified individual API endpoint does NOT return the payload.
  * To get payload data, you should either:
@@ -13,7 +13,7 @@
  * @example
  * ```tsx
  * function MyComponent() {
- *   const { variant, payload, isLoading } = useVariant('checkout-flow');
+ *   const { variant, payload, isLoading } = useFeatureFlagVariant('checkout-flow');
  *
  *   if (isLoading) return <Spinner />;
  *
@@ -26,9 +26,9 @@
  * ```
  */
 /**
- * Return type for the useVariant hook
+ * Return type for the useFeatureFlagVariant hook
  */
-export interface UseVariantResult {
+export interface UseFeatureFlagVariantResult {
     /**
      * The selected variant name, or null if no variant is selected
      */
@@ -48,7 +48,6 @@ export interface UseVariantResult {
  * Hook for getting the variant value of a multivariant feature flag
  *
  * @param flagName - Name of the feature flag
- * @param gatewayUrl - Base URL for the gateway API (default: '')
  * @returns Object containing variant, payload, and loading state
  */
-export declare function useVariant(flagName: string, gatewayUrl?: string): UseVariantResult;
+export declare function useFeatureFlagVariant(flagName: string): UseFeatureFlagVariantResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluealba/pae-ui-react-core",
-  "version": "4.0.1-feature-feature-flags-1243",
+  "version": "4.0.1-feature-feature-flags-1245",
   "type": "module",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",