@plyaz/core 1.0.0

package/dist/frontend/featureFlags/hooks/useFeatureFlagHelpers.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Feature Flag Hook Helpers
+ *
+ * Helper functions for feature flag hooks to reduce function complexity.
+ *
+ * @fileoverview Helper functions for feature flag hooks
+ * @version 1.0.0
+ */
+import type * as React from 'react';
+import type { FeatureFlagValue, FeatureFlagContext, FeatureFlagHook, FeatureFlagProvider, FeatureFlagState } from '@plyaz/types';
+/**
+ * Creates evaluation function for a feature flag.
+ *
+ * @template FeatureFlagKey - The type of feature flag keys
+ * @template T - The expected type of the flag value
+ * @param params - Evaluation parameters
+ * @param params.provider - Feature flag provider instance
+ * @param params.key - Feature flag key to evaluate
+ * @param params.context - Optional evaluation context
+ * @param params.defaultValue - Default value if evaluation fails
+ * @param setState - React state setter for flag state
+ * @returns Async function that evaluates the flag
+ */
+export declare function createEvaluationFunction<FeatureFlagKey extends string, T extends FeatureFlagValue = string | number | boolean | Record<string, unknown>>(params: {
+    provider: FeatureFlagProvider<FeatureFlagKey> | null;
+    key: FeatureFlagKey;
+    context: FeatureFlagContext | undefined;
+    defaultValue: T | undefined;
+}, setState: React.Dispatch<React.SetStateAction<FeatureFlagState<FeatureFlagKey, T>>>): () => Promise<void>;
+/**
+ * Custom hook for managing feature flag evaluation logic.
+ * Handles loading state, error management, and automatic evaluation.
+ *
+ * @template FeatureFlagKey - The type of feature flag keys
+ * @template T - The expected type of the flag value
+ * @param key - Feature flag key to evaluate
+ * @param context - Optional evaluation context
+ * @param defaultValue - Default value if evaluation fails
+ * @param provider - Feature flag provider instance
+ * @returns Feature flag hook state with value, loading, error, and refresh function
+ */
+export declare function useFeatureFlagEvaluation<FeatureFlagKey extends string, T extends FeatureFlagValue = boolean>(key: FeatureFlagKey, context: FeatureFlagContext | undefined, defaultValue: T | undefined, provider: FeatureFlagProvider<FeatureFlagKey> | null): FeatureFlagHook<T>;
+/**
+ * Custom hook for managing multiple feature flags evaluation.
+ * Returns a record of flag states for multiple flags.
+ *
+ * @template FeatureFlagKey - The type of feature flag keys
+ * @param keys - Array of feature flag keys to evaluate
+ * @param context - Optional evaluation context
+ * @param defaultValue - Default value for all flags if evaluation fails
+ * @param provider - Feature flag provider instance
+ * @returns Record mapping flag keys to their hook states
+ */
+export declare function useMultipleFeatureFlagsEvaluation<FeatureFlagKey extends string>(keys: FeatureFlagKey[], context: FeatureFlagContext | undefined, defaultValue: FeatureFlagValue, provider: FeatureFlagProvider<FeatureFlagKey> | null): Record<string, FeatureFlagHook<FeatureFlagValue>>;
+//# sourceMappingURL=useFeatureFlagHelpers.d.ts.map

package/dist/frontend/featureFlags/hooks/useFeatureFlagHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeatureFlagHelpers.d.ts","sourceRoot":"","sources":["../../../../src/frontend/featureFlags/hooks/useFeatureFlagHelpers.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,SAAS,MAAM,EAC7B,CAAC,SAAS,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEhF,MAAM,EAAE;IACN,QAAQ,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IACrD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACxC,YAAY,EAAE,CAAC,GAAG,SAAS,CAAC;CAC7B,EACD,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,GAClF,MAAM,OAAO,CAAC,IAAI,CAAC,CA0BrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,SAAS,MAAM,EAC7B,CAAC,SAAS,gBAAgB,GAAG,OAAO,EAEpC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,YAAY,EAAE,CAAC,GAAG,SAAS,EAC3B,QAAQ,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,IAAI,GACnD,eAAe,CAAC,CAAC,CAAC,CA+BpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAAC,cAAc,SAAS,MAAM,EAC7E,IAAI,EAAE,cAAc,EAAE,EACtB,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,YAAY,EAAE,gBAAgB,EAC9B,QAAQ,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,IAAI,GACnD,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC,CA6InD"}

package/dist/frontend/featureFlags/hooks/useFeatureFlagProvider.d.ts

@@ -0,0 +1,57 @@
+/**
+ * useFeatureFlagProvider Hook
+ *
+ * React hook for accessing the feature flag provider from context.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Provider access hook for feature flags
+ * @version 1.0.0
+ */
+import type { FeatureFlagProvider } from '@plyaz/types';
+/**
+ * Hook for accessing the feature flag provider from React context.
+ * Must be used within a FeatureFlagProvider component.
+ *
+ * @returns Feature flag provider instance
+ * @throws Error if used outside of FeatureFlagProvider
+ *
+ * @example
+ * ```typescript
+ * function MyComponent() {
+ *   const provider = useFeatureFlagProvider<FeatureFlagKey>();
+ *
+ *   const handleRefresh = async () => {
+ *     await provider.refresh();
+ *   };
+ *
+ *   return <button onClick={handleRefresh}>Refresh Flags</button>;
+ * }
+ * ```
+ */
+export declare function useFeatureFlagProvider<FeatureFlagKey extends string>(): FeatureFlagProvider<FeatureFlagKey>;
+/**
+ * Hook for accessing the feature flag provider status.
+ * Provides information about provider initialization and health.
+ *
+ * @returns Provider status information
+ *
+ * @example
+ * ```typescript
+ * function StatusComponent() {
+ *   const { isInitialized, isLoading, error } = useFeatureFlagProviderStatus<FeatureFlagKey>();
+ *
+ *   if (isLoading) return <div>Loading feature flags...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (!isInitialized) return <div>Initializing...</div>;
+ *
+ *   return <div>Feature flags ready!</div>;
+ * }
+ * ```
+ */
+export declare function useFeatureFlagProviderStatus<FeatureFlagKey extends string>(): {
+    isInitialized: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    lastUpdated: Date | null;
+};
+//# sourceMappingURL=useFeatureFlagProvider.d.ts.map

package/dist/frontend/featureFlags/hooks/useFeatureFlagProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeatureFlagProvider.d.ts","sourceRoot":"","sources":["../../../../src/frontend/featureFlags/hooks/useFeatureFlagProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,cAAc,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,SAAS,MAAM,KAC1B,mBAAmB,CAAC,cAAc,CAAC,CAWvC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAAC,cAAc,SAAS,MAAM,KAAK;IAC7E,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B,CAgBA"}

package/dist/frontend/featureFlags/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Frontend Feature Flags - Main Exports
+ *
+ * React-specific exports for feature flag integration.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Frontend feature flags exports
+ * @version 1.0.0
+ */
+export { FeatureFlagContext, FeatureFlagAppProvider, createFeatureFlagProvider, } from './providers/FeatureFlagProvider';
+export { useFeatureFlag, useFeatureFlagEnabled, useFeatureFlagValue, useMultipleFeatureFlags, } from './hooks/useFeatureFlag';
+export { useFeatureFlagProvider, useFeatureFlagProviderStatus, } from './hooks/useFeatureFlagProvider';
+export { useFeatureFlagHelpers } from './hooks/useFeatureFlagActions';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/featureFlags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frontend/featureFlags/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/frontend/featureFlags/providers/FeatureFlagProvider.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Feature Flag Provider Component
+ *
+ * React context provider for feature flags system.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview React provider for feature flag context
+ * @version 1.0.0
+ */
+import React from 'react';
+import type { FeatureFlagConfig, FeatureFlagContextValue, FeatureFlagProviderProps, FeatureFlagValue } from '@plyaz/types';
+import type { FeatureFlagKey } from '@domain/types';
+/**
+ * React context for feature flag provider.
+ * Using string as the base type to support any feature flag key.
+ */
+export declare const FeatureFlagContext: React.Context<FeatureFlagContextValue<"AUTH_GOOGLE" | "AUTH_DISCORD" | "AUTH_FACEBOOK" | "AUTH_GITHUB"> | null>;
+/**
+ * Feature Flag Provider component that manages the feature flag system.
+ * Provides context for accessing feature flags throughout the React component tree.
+ *
+ * @param props - Provider configuration and options
+ * @returns JSX element providing feature flag context
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * function App() {
+ *   return (
+ *     <FeatureFlagAppProvider
+ *       config={{
+ *         provider: 'memory',
+ *         isCacheEnabled: true,
+ *         cacheTtl: 300,
+ *       }}
+ *       features={FEATURES}
+ *     >
+ *       <MyApplication />
+ *     </FeatureFlagAppProvider>
+ *   );
+ * }
+ *
+ * // With custom context and callbacks
+ * function App() {
+ *   const featureFlagConfig = {
+ *     provider: 'api' as const,
+ *     apiEndpoint: 'https://api.example.com',
+ *     apiKey: process.env.REACT_APP_FF_API_KEY,
+ *     isCacheEnabled: true,
+ *     cacheTtl: 300,
+ *   };
+ *
+ *   const defaultContext = {
+ *     environment: 'production' as const,
+ *     userId: getCurrentUserId(),
+ *     userRole: getCurrentUserRole(),
+ *   };
+ *
+ *   return (
+ *     <FeatureFlagAppProvider
+ *       config={featureFlagConfig}
+ *       features={FEATURES}
+ *       defaultContext={defaultContext}
+ *       onReady={(provider) => console.log('Feature flags ready!')}
+ *       onError={(error) => console.error('Feature flag error:', error)}
+ *       showLoading
+ *     >
+ *       <MyApplication />
+ *     </FeatureFlagAppProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function FeatureFlagAppProvider<FeatureFlags extends Record<FeatureFlagKey, FeatureFlagValue>>({ config, children, features, onReady, onError, isShowLoading, loadingComponent, errorComponent, }: FeatureFlagProviderProps<FeatureFlagKey, FeatureFlags>): React.ReactElement;
+export declare namespace FeatureFlagAppProvider {
+    var displayName: string;
+}
+/**
+ * Higher-order component for providing feature flag context.
+ * Alternative to using the FeatureFlagAppProvider component directly.
+ *
+ * @param config - Feature flag configuration
+ * @param options - Additional provider options
+ * @returns HOC function that wraps components with feature flag provider
+ *
+ * @example
+ * ```typescript
+ * const withFeatureFlags = createFeatureFlagProvider({
+ *   provider: 'memory',
+ *   isCacheEnabled: true,
+ * }, {
+ *   features: FEATURES
+ * });
+ *
+ * const AppWithFeatureFlags = withFeatureFlags(App);
+ * ```
+ */
+export declare function createFeatureFlagProvider<FeatureFlags extends Record<FeatureFlagKey, FeatureFlagValue>>(config: FeatureFlagConfig<FeatureFlagKey>, options?: Pick<FeatureFlagProviderProps<FeatureFlagKey, FeatureFlags>, 'defaultContext' | 'onReady' | 'onError' | 'features'>): <P extends object>(component: React.ComponentType<P>) => React.ComponentType<P>;
+//# sourceMappingURL=FeatureFlagProvider.d.ts.map

package/dist/frontend/featureFlags/providers/FeatureFlagProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagProvider.d.ts","sourceRoot":"","sources":["../../../../src/frontend/featureFlags/providers/FeatureFlagProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAEV,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,iHAE9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,wBAAgB,sBAAsB,CACpC,YAAY,SAAS,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,EAC7D,EACA,MAAM,EAEN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,OAAO,EACP,aAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,EAAE,wBAAwB,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,YAAY,CA0J7E;yBAtKe,sBAAsB;;;AA2KtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,SAAS,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,EAE7D,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,OAAO,CAAC,EAAE,IAAI,CACZ,wBAAwB,CAAC,cAAc,EAAE,YAAY,CAAC,EACtD,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CACtD,IAEgC,CAAC,SAAS,MAAM,EAC/C,WAAW,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAChC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAe1B"}

package/dist/frontend/featureFlags/providers/FeatureFlagProviderHelpers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Feature Flag Provider Helpers
+ *
+ * Helper functions for the FeatureFlagProvider component to reduce complexity.
+ *
+ * @fileoverview Helper functions for FeatureFlagProvider
+ * @version 1.0.0
+ */
+import React from 'react';
+import type { FeatureFlagProvider as IFeatureFlagProvider, FeatureFlagConfig } from '@plyaz/types';
+/**
+ * Provider state interface.
+ */
+export interface ProviderState<FeatureFlagKey extends string> {
+    provider: IFeatureFlagProvider<FeatureFlagKey> | null;
+    isInitialized: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    lastUpdated: Date | null;
+}
+export interface UseFeatureFlagProviderState<FeatureFlagKey extends string> {
+    state: ProviderState<FeatureFlagKey>;
+    setState: React.Dispatch<React.SetStateAction<ProviderState<FeatureFlagKey>>>;
+    initializeProvider: () => Promise<void>;
+}
+/**
+ * Hook for managing feature flag provider state and initialization.
+ */
+export declare function useFeatureFlagProviderState<FeatureFlagKey extends string>(config: FeatureFlagConfig<FeatureFlagKey>, onReady?: () => void, onError?: (error: Error) => void): UseFeatureFlagProviderState<FeatureFlagKey>;
+/**
+ * Hook for setting up provider subscription and cleanup.
+ */
+export declare function useProviderSubscription<FeatureFlagKey extends string>(state: ProviderState<FeatureFlagKey>, setState: React.Dispatch<React.SetStateAction<ProviderState<FeatureFlagKey>>>): void;
+/**
+ * Renders loading state component.
+ */
+export declare function renderLoadingState(isShowLoading: boolean, isLoading: boolean, loadingComponent?: React.ComponentType): React.ReactElement | null;
+/**
+ * Renders error state component.
+ */
+export declare function renderErrorState(error: Error | null, errorComponent?: React.ComponentType<{
+    error: Error;
+    retry: () => void;
+}>, retry?: () => void): React.ReactElement | null;
+//# sourceMappingURL=FeatureFlagProviderHelpers.d.ts.map

package/dist/frontend/featureFlags/providers/FeatureFlagProviderHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagProviderHelpers.d.ts","sourceRoot":"","sources":["../../../../src/frontend/featureFlags/providers/FeatureFlagProviderHelpers.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAA2C,MAAM,OAAO,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,IAAI,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAInG;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,cAAc,SAAS,MAAM;IAC1D,QAAQ,EAAE,oBAAoB,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IACtD,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B,CAAC,cAAc,SAAS,MAAM;IACxE,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAC9E,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,SAAS,MAAM,EACvE,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,OAAO,CAAC,EAAE,MAAM,IAAI,EACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC/B,2BAA2B,CAAC,cAAc,CAAC,CA8C7C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,SAAS,MAAM,EACnE,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,GAC5E,IAAI,CAeN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,OAAO,EACtB,SAAS,EAAE,OAAO,EAClB,gBAAgB,CAAC,EAAE,KAAK,CAAC,aAAa,GACrC,KAAK,CAAC,YAAY,GAAG,IAAI,CAW3B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,EACzE,KAAK,CAAC,EAAE,MAAM,IAAI,GACjB,KAAK,CAAC,YAAY,GAAG,IAAI,CAO3B"}

package/dist/frontend/index.d.ts

@@ -0,0 +1,2 @@
+export * from './featureFlags';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/frontend/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}