@bluealba/pae-feature-flags 1.0.0-feature-initial-feature-flags-poc-1233

package/dist/nestjs/FeatureFlagsClient.js

@@ -0,0 +1,173 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var FeatureFlagsClient_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagsClient = void 0;
+const common_1 = require("@nestjs/common");
+const axios_1 = require("@nestjs/axios");
+const rxjs_1 = require("rxjs");
+/**
+ * Client for consuming feature flags from the gateway service
+ *
+ * This service provides methods to evaluate feature flags by calling
+ * the gateway API endpoints. It handles errors gracefully by returning
+ * default values when the API is unavailable or returns errors.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class MyService {
+ *   constructor(private readonly featureFlagsClient: FeatureFlagsClient) {}
+ *
+ *   async doSomething() {
+ *     const isEnabled = await this.featureFlagsClient.isEnabled('my-feature');
+ *     if (isEnabled) {
+ *       // New implementation
+ *     }
+ *   }
+ * }
+ * ```
+ */
+let FeatureFlagsClient = FeatureFlagsClient_1 = class FeatureFlagsClient {
+    constructor(gatewayUrl, httpService) {
+        this.gatewayUrl = gatewayUrl;
+        this.httpService = httpService;
+        this.logger = new common_1.Logger(FeatureFlagsClient_1.name);
+    }
+    /**
+     * Evaluates if a feature flag is enabled
+     *
+     * @param flagName - The name of the feature flag to evaluate
+     * @param defaultValue - The default value to return if evaluation fails (default: false)
+     * @param context - Optional evaluation context (user, tenant, custom properties)
+     * @returns Promise resolving to true if flag is enabled, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const isEnabled = await client.isEnabled('new-dashboard', false, {
+     *   userId: '123',
+     *   tenantId: 'tenant-1'
+     * });
+     * ```
+     */
+    async isEnabled(flagName, defaultValue = false, context) {
+        try {
+            const url = `${this.gatewayUrl}/feature-flags/${flagName}`;
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService.get(url, {
+                params: context ? { context: JSON.stringify(context) } : undefined,
+            }));
+            return response.data.enabled;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to evaluate flag "${flagName}": ${errorMessage}. Returning default value: ${defaultValue}`);
+            return defaultValue;
+        }
+    }
+    /**
+     * Gets the variant for a multivariant feature flag
+     *
+     * @param flagName - The name of the feature flag
+     * @param context - Optional evaluation context
+     * @returns Promise resolving to variant object with name and payload, or null if no variant
+     *
+     * @example
+     * ```typescript
+     * const variant = await client.getVariant('ab-test', {
+     *   userId: '123'
+     * });
+     *
+     * if (variant?.name === 'variant-a') {
+     *   // Variant A logic
+     * } else if (variant?.name === 'variant-b') {
+     *   // Variant B logic
+     * }
+     * ```
+     */
+    async getVariant(flagName, context) {
+        try {
+            const url = `${this.gatewayUrl}/feature-flags/${flagName}/variant`;
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService.get(url, {
+                params: context ? { context: JSON.stringify(context) } : undefined,
+            }));
+            if (response.data.variant) {
+                return {
+                    name: response.data.variant,
+                    payload: response.data.payload,
+                };
+            }
+            return null;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to get variant for flag "${flagName}": ${errorMessage}. Returning null`);
+            return null;
+        }
+    }
+    /**
+     * Evaluates multiple feature flags in a single request
+     *
+     * This method is more efficient than calling isEnabled multiple times
+     * as it reduces the number of HTTP requests.
+     *
+     * @param flagNames - Array of feature flag names to evaluate
+     * @param context - Optional evaluation context
+     * @returns Promise resolving to a Map of flag names to evaluation results
+     *
+     * @example
+     * ```typescript
+     * const results = await client.evaluateFlags(
+     *   ['feature-a', 'feature-b', 'ab-test'],
+     *   { userId: '123', tenantId: 'tenant-1' }
+     * );
+     *
+     * const featureAEnabled = results.get('feature-a')?.enabled ?? false;
+     * const abTestVariant = results.get('ab-test')?.variant;
+     * ```
+     */
+    async evaluateFlags(flagNames, context) {
+        try {
+            const url = `${this.gatewayUrl}/feature-flags/evaluate`;
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService.post(url, {
+                flagNames,
+                context,
+            }));
+            // Convert the response object to a Map
+            const resultMap = new Map();
+            Object.entries(response.data.flags).forEach(([name, result]) => {
+                resultMap.set(name, result);
+            });
+            return resultMap;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to evaluate flags in bulk: ${errorMessage}. Returning empty map`);
+            return new Map();
+        }
+    }
+    /**
+     * Gets the configured gateway URL
+     * Useful for debugging and logging purposes
+     */
+    getGatewayUrl() {
+        return this.gatewayUrl;
+    }
+};
+exports.FeatureFlagsClient = FeatureFlagsClient;
+exports.FeatureFlagsClient = FeatureFlagsClient = FeatureFlagsClient_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('GATEWAY_URL')),
+    __metadata("design:paramtypes", [String, axios_1.HttpService])
+], FeatureFlagsClient);
+//# sourceMappingURL=FeatureFlagsClient.js.map

package/dist/nestjs/FeatureFlagsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagsClient.js","sourceRoot":"","sources":["../../src/nestjs/FeatureFlagsClient.ts"],"names":[],"mappings":"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"}

package/dist/nestjs/FeatureFlagsModule.d.ts

@@ -0,0 +1,79 @@
+import { DynamicModule } from '@nestjs/common';
+/**
+ * Configuration options for the FeatureFlagsModule
+ */
+export interface FeatureFlagsModuleConfig {
+    /**
+     * The base URL of the gateway service
+     * @example 'http://localhost:3000' or 'https://gateway.example.com'
+     */
+    gatewayUrl: string;
+    /**
+     * Optional timeout in milliseconds for HTTP requests
+     * @default 5000
+     */
+    timeout?: number;
+    /**
+     * Optional maximum number of redirects to follow
+     * @default 5
+     */
+    maxRedirects?: number;
+}
+/**
+ * NestJS module for feature flags client
+ *
+ * This module provides the FeatureFlagsClient service to consume
+ * feature flags from the gateway service.
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     FeatureFlagsModule.forRoot({
+ *       gatewayUrl: 'http://localhost:3000',
+ *       timeout: 5000
+ *     }),
+ *   ],
+ *   providers: [MyService],
+ * })
+ * export class MyServiceModule {}
+ * ```
+ */
+export declare class FeatureFlagsModule {
+    /**
+     * Register the FeatureFlagsModule with configuration
+     *
+     * Supports two call signatures:
+     * - `forRoot(gatewayUrl: string)` - Simple URL configuration
+     * - `forRoot(config: FeatureFlagsModuleConfig)` - Full configuration object
+     *
+     * @param configOrUrl - Either a gateway URL string or full configuration object
+     * @returns A configured DynamicModule
+     *
+     * @example Simple usage with URL
+     * ```typescript
+     * @Module({
+     *   imports: [
+     *     FeatureFlagsModule.forRoot('http://localhost:3000'),
+     *   ],
+     * })
+     * export class MyModule {}
+     * ```
+     *
+     * @example Advanced usage with config
+     * ```typescript
+     * @Module({
+     *   imports: [
+     *     FeatureFlagsModule.forRoot({
+     *       gatewayUrl: 'http://localhost:3000',
+     *       timeout: 5000,
+     *       maxRedirects: 5,
+     *     }),
+     *   ],
+     * })
+     * export class MyModule {}
+     * ```
+     */
+    static forRoot(configOrUrl: string | FeatureFlagsModuleConfig): DynamicModule;
+}
+//# sourceMappingURL=FeatureFlagsModule.d.ts.map

package/dist/nestjs/FeatureFlagsModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagsModule.d.ts","sourceRoot":"","sources":["../../src/nestjs/FeatureFlagsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAIvD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,kBAAkB;IAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,GAAG,aAAa;CA2B9E"}

package/dist/nestjs/FeatureFlagsModule.js

@@ -0,0 +1,98 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var FeatureFlagsModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagsModule = void 0;
+const common_1 = require("@nestjs/common");
+const axios_1 = require("@nestjs/axios");
+const FeatureFlagsClient_1 = require("./FeatureFlagsClient");
+/**
+ * NestJS module for feature flags client
+ *
+ * This module provides the FeatureFlagsClient service to consume
+ * feature flags from the gateway service.
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     FeatureFlagsModule.forRoot({
+ *       gatewayUrl: 'http://localhost:3000',
+ *       timeout: 5000
+ *     }),
+ *   ],
+ *   providers: [MyService],
+ * })
+ * export class MyServiceModule {}
+ * ```
+ */
+let FeatureFlagsModule = FeatureFlagsModule_1 = class FeatureFlagsModule {
+    /**
+     * Register the FeatureFlagsModule with configuration
+     *
+     * Supports two call signatures:
+     * - `forRoot(gatewayUrl: string)` - Simple URL configuration
+     * - `forRoot(config: FeatureFlagsModuleConfig)` - Full configuration object
+     *
+     * @param configOrUrl - Either a gateway URL string or full configuration object
+     * @returns A configured DynamicModule
+     *
+     * @example Simple usage with URL
+     * ```typescript
+     * @Module({
+     *   imports: [
+     *     FeatureFlagsModule.forRoot('http://localhost:3000'),
+     *   ],
+     * })
+     * export class MyModule {}
+     * ```
+     *
+     * @example Advanced usage with config
+     * ```typescript
+     * @Module({
+     *   imports: [
+     *     FeatureFlagsModule.forRoot({
+     *       gatewayUrl: 'http://localhost:3000',
+     *       timeout: 5000,
+     *       maxRedirects: 5,
+     *     }),
+     *   ],
+     * })
+     * export class MyModule {}
+     * ```
+     */
+    static forRoot(configOrUrl) {
+        // Handle both string URL and config object
+        const config = typeof configOrUrl === 'string'
+            ? { gatewayUrl: configOrUrl }
+            : configOrUrl;
+        const { gatewayUrl, timeout = 5000, maxRedirects = 5 } = config;
+        return {
+            module: FeatureFlagsModule_1,
+            imports: [
+                axios_1.HttpModule.register({
+                    timeout,
+                    maxRedirects,
+                }),
+            ],
+            providers: [
+                {
+                    provide: 'GATEWAY_URL',
+                    useValue: gatewayUrl,
+                },
+                FeatureFlagsClient_1.FeatureFlagsClient,
+            ],
+            exports: [FeatureFlagsClient_1.FeatureFlagsClient],
+        };
+    }
+};
+exports.FeatureFlagsModule = FeatureFlagsModule;
+exports.FeatureFlagsModule = FeatureFlagsModule = FeatureFlagsModule_1 = __decorate([
+    (0, common_1.Module)({})
+], FeatureFlagsModule);
+//# sourceMappingURL=FeatureFlagsModule.js.map

package/dist/nestjs/FeatureFlagsModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagsModule.js","sourceRoot":"","sources":["../../src/nestjs/FeatureFlagsModule.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,yCAA2C;AAC3C,6DAA0D;AAyB1D;;;;;;;;;;;;;;;;;;;GAmBG;AAEI,IAAM,kBAAkB,0BAAxB,MAAM,kBAAkB;IAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,MAAM,CAAC,OAAO,CAAC,WAA8C;QAC3D,2CAA2C;QAC3C,MAAM,MAAM,GACV,OAAO,WAAW,KAAK,QAAQ;YAC7B,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE;YAC7B,CAAC,CAAC,WAAW,CAAC;QAElB,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC;QAEhE,OAAO;YACL,MAAM,EAAE,oBAAkB;YAC1B,OAAO,EAAE;gBACP,kBAAU,CAAC,QAAQ,CAAC;oBAClB,OAAO;oBACP,YAAY;iBACb,CAAC;aACH;YACD,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,aAAa;oBACtB,QAAQ,EAAE,UAAU;iBACrB;gBACD,uCAAkB;aACnB;YACD,OAAO,EAAE,CAAC,uCAAkB,CAAC;SAC9B,CAAC;IACJ,CAAC;CACF,CAAA;AA9DY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,kBAAkB,CA8D9B"}

package/dist/nestjs/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * NestJS client for feature flags
+ *
+ * This module provides a client to consume feature flags from the gateway service.
+ *
+ * @example
+ * ```typescript
+ * import { FeatureFlagsModule, FeatureFlagsClient } from '@bluealba/pae-feature-flags/nestjs';
+ *
+ * @Module({
+ *   imports: [
+ *     FeatureFlagsModule.forRoot('http://gateway:3000'),
+ *   ],
+ * })
+ * export class MyModule {}
+ * ```
+ */
+export * from './FeatureFlagsClient';
+export * from './FeatureFlagsModule';
+//# sourceMappingURL=index.d.ts.map

package/dist/nestjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/nestjs/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * NestJS client for feature flags
+ *
+ * This module provides a client to consume feature flags from the gateway service.
+ *
+ * @example
+ * ```typescript
+ * import { FeatureFlagsModule, FeatureFlagsClient } from '@bluealba/pae-feature-flags/nestjs';
+ *
+ * @Module({
+ *   imports: [
+ *     FeatureFlagsModule.forRoot('http://gateway:3000'),
+ *   ],
+ * })
+ * export class MyModule {}
+ * ```
+ */
+__exportStar(require("./FeatureFlagsClient"), exports);
+__exportStar(require("./FeatureFlagsModule"), exports);
+//# sourceMappingURL=index.js.map

package/dist/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,uDAAqC;AACrC,uDAAqC"}

package/dist/react/FeatureFlagGuard.d.ts

@@ -0,0 +1,60 @@
+/**
+ * FeatureFlagGuard Component
+ *
+ * A React component for conditional rendering based on feature flag state.
+ * This component uses the useFeatureFlag hook internally to evaluate the flag
+ * and renders either the children (if flag is enabled) or a fallback (if disabled).
+ *
+ * @example
+ * ```tsx
+ * // Show feature if enabled, hide if disabled
+ * <FeatureFlagGuard flag="beta-feature">
+ *   <BetaFeature />
+ * </FeatureFlagGuard>
+ *
+ * // Show feature if enabled, show fallback if disabled
+ * <FeatureFlagGuard flag="new-ui" fallback={<OldUI />}>
+ *   <NewUI />
+ * </FeatureFlagGuard>
+ *
+ * // Inverted logic - show if disabled
+ * <FeatureFlagGuard flag="maintenance-mode" invert>
+ *   <MainApp />
+ * </FeatureFlagGuard>
+ * ```
+ */
+import { type FC, type ReactNode } from 'react';
+/**
+ * Props for the FeatureFlagGuard component
+ */
+export interface FeatureFlagGuardProps {
+    /**
+     * Name of the feature flag to check
+     */
+    flag: string;
+    /**
+     * Content to render when the flag is enabled (or disabled if inverted)
+     */
+    children: ReactNode;
+    /**
+     * Optional content to render when the flag is disabled (or enabled if inverted)
+     * If not provided, nothing will be rendered when the flag is disabled
+     */
+    fallback?: ReactNode;
+    /**
+     * Whether to invert the logic
+     * If true, children are shown when flag is disabled, fallback when enabled
+     * @default false
+     */
+    invert?: boolean;
+    /**
+     * Base URL for the gateway API
+     * @default ''
+     */
+    gatewayUrl?: string;
+}
+/**
+ * Component for conditional rendering based on feature flags
+ */
+export declare const FeatureFlagGuard: FC<FeatureFlagGuardProps>;
+//# sourceMappingURL=FeatureFlagGuard.d.ts.map

package/dist/react/FeatureFlagGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagGuard.d.ts","sourceRoot":"","sources":["../../src/react/FeatureFlagGuard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAc,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CAiBtD,CAAC"}

package/dist/react/FeatureFlagGuard.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * FeatureFlagGuard Component
+ *
+ * A React component for conditional rendering based on feature flag state.
+ * This component uses the useFeatureFlag hook internally to evaluate the flag
+ * and renders either the children (if flag is enabled) or a fallback (if disabled).
+ *
+ * @example
+ * ```tsx
+ * // Show feature if enabled, hide if disabled
+ * <FeatureFlagGuard flag="beta-feature">
+ *   <BetaFeature />
+ * </FeatureFlagGuard>
+ *
+ * // Show feature if enabled, show fallback if disabled
+ * <FeatureFlagGuard flag="new-ui" fallback={<OldUI />}>
+ *   <NewUI />
+ * </FeatureFlagGuard>
+ *
+ * // Inverted logic - show if disabled
+ * <FeatureFlagGuard flag="maintenance-mode" invert>
+ *   <MainApp />
+ * </FeatureFlagGuard>
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagGuard = void 0;
+const react_1 = __importDefault(require("react"));
+const useFeatureFlag_1 = require("./useFeatureFlag");
+/**
+ * Component for conditional rendering based on feature flags
+ */
+const FeatureFlagGuard = ({ flag, children, fallback = null, invert = false, gatewayUrl = '', }) => {
+    const isEnabled = (0, useFeatureFlag_1.useFeatureFlag)(flag, false, gatewayUrl);
+    // Determine whether to show children based on flag state and invert setting
+    const shouldShowChildren = invert ? !isEnabled : isEnabled;
+    if (shouldShowChildren) {
+        return react_1.default.createElement(react_1.default.Fragment, null, children);
+    }
+    return react_1.default.createElement(react_1.default.Fragment, null, fallback);
+};
+exports.FeatureFlagGuard = FeatureFlagGuard;
+exports.FeatureFlagGuard.displayName = 'FeatureFlagGuard';
+//# sourceMappingURL=FeatureFlagGuard.js.map

package/dist/react/FeatureFlagGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagGuard.js","sourceRoot":"","sources":["../../src/react/FeatureFlagGuard.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;;;;AAEH,kDAAuD;AACvD,qDAAkD;AAgClD;;GAEG;AACI,MAAM,gBAAgB,GAA8B,CAAC,EAC1D,IAAI,EACJ,QAAQ,EACR,QAAQ,GAAG,IAAI,EACf,MAAM,GAAG,KAAK,EACd,UAAU,GAAG,EAAE,GAChB,EAAE,EAAE;IACH,MAAM,SAAS,GAAG,IAAA,+BAAc,EAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAE1D,4EAA4E;IAC5E,MAAM,kBAAkB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3D,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,8DAAG,QAAQ,CAAI,CAAC;IACzB,CAAC;IAED,OAAO,8DAAG,QAAQ,CAAI,CAAC;AACzB,CAAC,CAAC;AAjBW,QAAA,gBAAgB,oBAiB3B;AAEF,wBAAgB,CAAC,WAAW,GAAG,kBAAkB,CAAC"}

package/dist/react/FeatureFlagsProvider.d.ts

@@ -0,0 +1,102 @@
+/**
+ * FeatureFlagsProvider
+ *
+ * A React Context provider that manages feature flag state with prefetching and caching capabilities.
+ * This provider should wrap your application or a section of it to provide feature flag access to child components.
+ *
+ * Features:
+ * - Prefetches specified flags on mount
+ * - Optional automatic refresh at configurable intervals
+ * - Caches flag values for efficient access
+ * - Provides both boolean flags and multivariant flags
+ *
+ * @example
+ * ```tsx
+ * <FeatureFlagsProvider
+ *   gatewayUrl="/api"
+ *   prefetchFlags={['new-ui', 'beta-feature']}
+ *   refreshInterval={60000}
+ * >
+ *   <App />
+ * </FeatureFlagsProvider>
+ * ```
+ */
+import React, { type ReactNode } from 'react';
+/**
+ * Shape of the feature flags context
+ */
+export interface FeatureFlagsContextValue {
+    /**
+     * Map of flag names to their boolean enabled state
+     */
+    flags: Map<string, boolean>;
+    /**
+     * Map of flag names to their variant data
+     */
+    variants: Map<string, {
+        variant: string | null;
+        payload: unknown;
+    }>;
+    /**
+     * Whether the initial prefetch is in progress
+     */
+    isLoading: boolean;
+    /**
+     * Any error that occurred during flag fetching
+     */
+    error: Error | null;
+    /**
+     * Check if a cached flag is enabled
+     * @param flagName - Name of the flag to check
+     * @param defaultValue - Default value if flag is not in cache (default: false)
+     * @returns Whether the flag is enabled
+     */
+    checkFlag: (flagName: string, defaultValue?: boolean) => boolean;
+    /**
+     * Get a cached variant value
+     * @param flagName - Name of the flag
+     * @returns Variant data or null if not in cache
+     */
+    getVariant: (flagName: string) => {
+        variant: string | null;
+        payload: unknown;
+    } | null;
+    /**
+     * Manually refresh all prefetched flags
+     * @returns Promise that resolves when refresh is complete
+     */
+    refresh: () => Promise<void>;
+}
+/**
+ * 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
+     */
+    prefetchFlags?: string[];
+    /**
+     * Interval in milliseconds for automatic refresh
+     * If not provided, automatic refresh is disabled
+     */
+    refreshInterval?: number;
+    /**
+     * Child components that will have access to the feature flags context
+     */
+    children: ReactNode;
+}
+/**
+ * React Context for feature flags
+ */
+export declare const FeatureFlagsContext: React.Context<FeatureFlagsContextValue>;
+/**
+ * Provider component for feature flags
+ */
+export declare const FeatureFlagsProvider: React.FC<FeatureFlagsProviderProps>;
+//# sourceMappingURL=FeatureFlagsProvider.d.ts.map

package/dist/react/FeatureFlagsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagsProvider.d.ts","sourceRoot":"","sources":["../../src/react/FeatureFlagsProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,EAA4D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGxG;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpE;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB;;;;;OAKG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IACjE;;;;OAIG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACtF;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAeD;;GAEG;AACH,eAAO,MAAM,mBAAmB,yCAA+D,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAwIpE,CAAC"}