@plyaz/core 1.2.0 → 1.2.1

package/dist/backend/featureFlags/database/connection.d.ts

@@ -1,321 +0,0 @@
-import { type DatabaseServiceInterface, type Transaction } from '@plyaz/types/db';
-/**
- * DatabaseConnectionManager - Singleton manager for feature flag database connections
- *
- * @description Manages Supabase database connections for the feature flag system using a singleton pattern.
- * Handles connection initialization, table registration, transactions, and cleanup. This is the core
- * database layer that all feature flag operations depend on.
- *
- * **Initialization Flow:**
- * 1. FeatureFlagService calls initialize() during onModuleInit()
- * 2. Reads Supabase credentials from environment variables
- * 3. Creates database service with @plyaz/db
- * 4. Registers feature flag tables
- * 5. Enables caching and other optimizations
- *
- * **Required Environment Variables:**
- * - SUPABASE_URL: Your Supabase project URL
- * - SUPABASE_SERVICE_ROLE_KEY: Service role key for admin operations
- * - SUPABASE_ANON_PUBLIC_KEY: Anonymous key for public operations
- *
- * @example Environment Setup (.env.local)
- * ```bash
- * SUPABASE_URL=https://your-project.supabase.co
- * SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
- * SUPABASE_ANON_PUBLIC_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
- * ```
- *
- * @example Basic Usage (Internal - called by FeatureFlagService)
- * ```typescript
- * // During system initialization:
- * const manager = DatabaseConnectionManager.getInstance();
- * await manager.initialize();
- *
- * // During runtime operations:
- * const db = manager.getDatabase();
- * const flags = await db.query('feature_flags', { limit: 100 });
- * ```
- *
- * @example Transaction Usage
- * ```typescript
- * const manager = DatabaseConnectionManager.getInstance();
- *
- * // Atomic flag creation with rules
- * const result = await manager.transaction(async (tx) => {
- *   // Create flag
- *   const flag = await tx.create('feature_flags', {
- *     key: 'NEW_FEATURE',
- *     value: true,
- *     is_enabled: true
- *   });
- *
- *   // Create associated rule
- *   const rule = await tx.create('feature_flag_rules', {
- *     flag_key: 'NEW_FEATURE',
- *     name: 'Premium Users Only',
- *     conditions: [{ field: 'userRole', operator: 'equals', value: 'premium' }]
- *   });
- *
- *   return { flag, rule };
- * });
- * ```
- *
- */
-export declare class DatabaseConnectionManager {
-    private static instance;
-    private databaseService;
-    private constructor();
-    /**
-     * Gets the singleton instance of DatabaseConnectionManager
-     *
-     * @description Returns the single instance of the connection manager, creating it if it doesn't exist.
-     * This ensures only one database connection pool is maintained across the application.
-     *
-     * @returns {DatabaseConnectionManager} The singleton instance
-     *
-     * @example Getting the Instance
-     * ```typescript
-     * // Always returns the same instance
-     * const manager1 = DatabaseConnectionManager.getInstance();
-     * const manager2 = DatabaseConnectionManager.getInstance();
-     * console.log(manager1 === manager2); // true
-     *
-     * // Use in services
-     * class FeatureFlagRepository {
-     *   private connectionManager = DatabaseConnectionManager.getInstance();
-     *
-     *   async getFlags() {
-     *     const db = this.connectionManager.getDatabase();
-     *     return db.query('feature_flags');
-     *   }
-     * }
-     * ```
-     */
-    static getInstance(): DatabaseConnectionManager;
-    /**
-     * Initializes the database connection and registers feature flag tables
-     *
-     * @description Sets up the Supabase connection using environment variables and registers
-     * all feature flag related tables. This method is idempotent - calling it multiple
-     * times won't create additional connections.
-     *
-     * **What it does:**
-     * 1. Validates required environment variables
-     * 2. Creates Supabase database service
-     * 3. Configures caching (5-minute TTL)
-     * 4. Registers feature flag tables with proper ID columns
-     * 5. Disables audit logging (until tables are created)
-     *
-     * @throws {DatabaseError} When environment variables are missing or connection fails
-     *
-     * @example Initialization Process
-     * ```typescript
-     * // Called automatically by FeatureFlagService.onModuleInit()
-     * const manager = DatabaseConnectionManager.getInstance();
-     *
-     * try {
-     *   await manager.initialize();
-     *   console.log('Database connection established');
-     * } catch (error) {
-     *   console.error('Failed to connect to database:', error.message);
-     *   // Error: Missing environment variables for Supabase connection
-     * }
-     * ```
-     *
-     * @example Environment Variable Validation
-     * ```typescript
-     * // If any of these are missing, initialization fails:
-     * // SUPABASE_URL=undefined
-     * // SUPABASE_SERVICE_ROLE_KEY=undefined
-     * // SUPABASE_ANON_PUBLIC_KEY=undefined
-     *
-     * // Throws: DatabaseError with code CONFIG_REQUIRED
-     * ```
-     *
-     * @example Registered Tables
-     * ```typescript
-     * // These tables are automatically registered:
-     * // - feature_flags (ID: key)
-     * // - feature_flag_rules (ID: id)
-     * // - feature_flag_overrides (ID: id)
-     * // - feature_flag_evaluations (ID: id)
-     * ```
-     */
-    initialize(): Promise<void>;
-    /**
-     * Gets the initialized database service instance
-     *
-     * @description Returns the database service for performing queries. The database must be
-     * initialized first using initialize() method, otherwise this will throw an error.
-     *
-     * @returns {DatabaseServiceInterface} The database service instance
-     * @throws {DatabaseError} When database is not initialized
-     *
-     * @example Basic Usage
-     * ```typescript
-     * const manager = DatabaseConnectionManager.getInstance();
-     * await manager.initialize(); // Must initialize first
-     *
-     * const db = manager.getDatabase();
-     *
-     * // Query feature flags
-     * const result = await db.query('feature_flags', {
-     *   filters: [{ field: 'is_enabled', operator: 'eq', value: true }],
-     *   sort: [{ field: 'key', direction: 'asc' }]
-     * });
-     *
-     * if (result.success) {
-     *   console.log('Found flags:', result.value.data);
-     * }
-     * ```
-     *
-     * @example Error Handling
-     * ```typescript
-     * const manager = DatabaseConnectionManager.getInstance();
-     * // Don't call initialize()
-     *
-     * try {
-     *   const db = manager.getDatabase();
-     * } catch (error) {
-     *   console.error(error.message);
-     *   // "Database not initialized. Call initialize() first."
-     * }
-     * ```
-     *
-     * @example CRUD Operations
-     * ```typescript
-     * const db = manager.getDatabase();
-     *
-     * // Create a flag
-     * const createResult = await db.create('feature_flags', {
-     *   key: 'NEW_FEATURE',
-     *   value: true,
-     *   is_enabled: true
-     * });
-     *
-     * // Update a flag
-     * const updateResult = await db.update('feature_flags', 'NEW_FEATURE', {
-     *   value: false
-     * });
-     *
-     * // Delete a flag
-     * const deleteResult = await db.delete('feature_flags', 'NEW_FEATURE');
-     * ```
-     */
-    getDatabase(): DatabaseServiceInterface;
-    /**
-     * Executes a database transaction with automatic rollback on failure
-     *
-     * @description Provides atomic database operations by wrapping multiple queries in a transaction.
-     * If any operation fails, all changes are rolled back automatically. This is essential for
-     * maintaining data consistency when creating flags with rules or performing bulk operations.
-     *
-     * @template T The return type of the transaction callback
-     * @param {Function} callback - Function that receives transaction object and performs operations
-     * @returns {Promise<T>} The result of the transaction callback
-     * @throws {DatabaseError} When transaction fails or returns no value
-     *
-     * @example Atomic Flag Creation with Rules
-     * ```typescript
-     * const manager = DatabaseConnectionManager.getInstance();
-     *
-     * const result = await manager.transaction(async (tx) => {
-     *   // Create the flag
-     *   const flag = await tx.create('feature_flags', {
-     *     key: 'PREMIUM_CHECKOUT',
-     *     value: true,
-     *     is_enabled: true,
-     *     description: 'Premium checkout flow'
-     *   });
-     *
-     *   // Create targeting rule
-     *   const rule = await tx.create('feature_flag_rules', {
-     *     flag_key: 'PREMIUM_CHECKOUT',
-     *     name: 'Premium Users Only',
-     *     conditions: [
-     *       { field: 'userRole', operator: 'equals', value: 'premium' },
-     *       { field: 'subscriptionActive', operator: 'equals', value: true }
-     *     ],
-     *     value: true,
-     *     priority: 100
-     *   });
-     *
-     *   return { flag, rule };
-     * });
-     *
-     * console.log('Created flag and rule:', result);
-     * ```
-     *
-     * @example Bulk Flag Updates
-     * ```typescript
-     * const flagsToUpdate = ['FEATURE_A', 'FEATURE_B', 'FEATURE_C'];
-     *
-     * await manager.transaction(async (tx) => {
-     *   for (const flagKey of flagsToUpdate) {
-     *     await tx.update('feature_flags', flagKey, {
-     *       is_enabled: false,
-     *       updated_at: new Date().toISOString()
-     *     });
-     *   }
-     *
-     *   // Log the bulk update
-     *   await tx.create('feature_flag_evaluations', {
-     *     flag_key: 'BULK_UPDATE',
-     *     result: { updatedFlags: flagsToUpdate },
-     *     reason: 'bulk_disable',
-     *     evaluated_at: new Date().toISOString()
-     *   });
-     * });
-     * ```
-     *
-     * @example Error Handling and Rollback
-     * ```typescript
-     * try {
-     *   await manager.transaction(async (tx) => {
-     *     await tx.create('feature_flags', { key: 'TEST_FLAG', value: true });
-     *
-     *     // This will cause the entire transaction to rollback
-     *     throw new Error('Something went wrong');
-     *
-     *     // This won't execute, and the flag creation above will be rolled back
-     *     await tx.create('feature_flag_rules', { flag_key: 'TEST_FLAG' });
-     *   });
-     * } catch (error) {
-     *   console.log('Transaction failed, all changes rolled back');
-     * }
-     * ```
-     */
-    transaction<T>(callback: (tx: Transaction) => Promise<T>): Promise<T>;
-    /**
-     * Closes the database connection and cleans up resources
-     *
-     * @description Properly closes the database connection and resets the singleton instance.
-     * This is typically called during application shutdown or in tests that need to reset
-     * the connection state.
-     *
-     * @example Application Shutdown
-     * ```typescript
-     * // In your NestJS module's onModuleDestroy
-     * export class FeatureFlagModule implements OnModuleDestroy {
-     *   async onModuleDestroy() {
-     *     const manager = DatabaseConnectionManager.getInstance();
-     *     await manager.close();
-     *     console.log('Database connection closed');
-     *   }
-     * }
-     * ```
-     *
-     * @example Test Cleanup
-     * ```typescript
-     * describe('Feature Flag Tests', () => {
-     *   afterEach(async () => {
-     *     // Clean up connection between tests
-     *     const manager = DatabaseConnectionManager.getInstance();
-     *     await manager.close();
-     *   });
-     * });
-     * ```
-     */
-    close(): Promise<void>;
-}
-//# sourceMappingURL=connection.d.ts.map

package/dist/backend/featureFlags/database/connection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/database/connection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,wBAAwB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,eAAe,CAAyC;IAEhE,OAAO;IAEP;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgDG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4DjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;IACH,WAAW,IAAI,wBAAwB;IAUvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiFG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAe3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/backend/featureFlags/database/repository.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/backend/featureFlags/database/repository.ts"],"names":[],"mappings":"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"}

package/dist/backend/featureFlags/feature-flag.repository.d.ts

@@ -1,85 +0,0 @@
-/**
- * Feature Flag Repository
- *
- * NestJS repository for feature flag data persistence.
- * Handles database operations and data mapping.
- *
- * @fileoverview NestJS repository for feature flags
- * @version 1.0.0
- */
-import type { FeatureFlag, FeatureFlagRule, CreateFlagRequest } from '@plyaz/types';
-/**
- * Feature Flag Repository
- *
- * Handles all database operations for feature flags.
- * This is a stub implementation that provides the interface
- * for integration with @plyaz/db when available.
- */
-export declare class FeatureFlagRepository<FeatureFlagKey extends string> {
-    private readonly logger;
-    private static readonly ONE_DAY_MS;
-    /**
-     * Creates a new feature flag in the database.
-     *
-     * @param createData - Flag creation data
-     * @returns Created feature flag
-     */
-    createFlag(createData: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
-    /**
-     * Updates an existing feature flag.
-     *
-     * @param key - Feature flag key
-     * @param updateData - Flag update data
-     * @returns Updated feature flag
-     */
-    updateFlag(key: FeatureFlagKey, updateData: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
-    /**
-     * Deletes a feature flag from the database.
-     *
-     * @param key - Feature flag key
-     */
-    deleteFlag(key: FeatureFlagKey): Promise<void>;
-    /**
-     * Gets all feature flags from the database.
-     *
-     * @param environment - Filter by environment
-     * @returns List of feature flags
-     */
-    getAllFlags(environment?: string): Promise<FeatureFlag<FeatureFlagKey>[]>;
-    /**
-     * Creates sample flags for stub implementation.
-     *
-     * @returns Array of sample feature flags
-     */
-    private createSampleFlags;
-    /**
-     * Filters flags by environment.
-     *
-     * @param flags - Array of flags to filter
-     * @param environment - Environment to filter by
-     * @returns Filtered flags
-     */
-    private filterFlagsByEnvironment;
-    /**
-     * Gets all rules for a specific flag.
-     *
-     * @param key - Feature flag key
-     * @returns List of rules for the flag
-     */
-    getFlagRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
-    /**
-     * Gets a single feature flag by key.
-     *
-     * @param key - Feature flag key
-     * @returns Feature flag or null if not found
-     */
-    getFlagByKey(key: FeatureFlagKey): Promise<FeatureFlag<FeatureFlagKey> | null>;
-    /**
-     * Infers the type of a feature flag value.
-     *
-     * @param value - The flag value
-     * @returns Inferred type string
-     */
-    private inferFlagType;
-}
-//# sourceMappingURL=feature-flag.repository.d.ts.map

package/dist/backend/featureFlags/feature-flag.repository.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"feature-flag.repository.d.ts","sourceRoot":"","sources":["../../../src/backend/featureFlags/feature-flag.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAEV,WAAW,EACX,eAAe,EACf,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,qBACa,qBAAqB,CAAC,cAAc,SAAS,MAAM;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAGjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAc;IAKhD;;;;;OAKG;IACG,UAAU,CACd,UAAU,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAC5C,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAgCvC;;;;;;OAMG;IACG,UAAU,CACd,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IA0CvC;;;;OAIG;IACG,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD;;;;;OAKG;IACG,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;IAW/E;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAShC;;;;;OAKG;IACG,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;IAmBnF;;;;;OAKG;IACG,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAepF;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAwDtB"}

package/dist/backend/featureFlags/feature-flag.service.d.ts

@@ -1,264 +0,0 @@
-/**
- * Feature Flag Service
- *
- * NestJS service for feature flag business logic.
- * Orchestrates between providers, repositories, and external systems.
- *
- * @fileoverview NestJS service for feature flags
- */
-import type { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
-import { type FeatureFlagValue, type FeatureFlagContext, type FeatureFlagEvaluation, type FeatureFlag, type FeatureFlagRule, type CreateFlagRequest, type ProviderHealthStatus } from '@plyaz/types';
-import type { FeatureFlagRepository } from './feature-flag.repository';
-import type { FeatureFlagKey } from '@domain/types';
-/**
- * Feature Flag Service
- *
- * **MAIN ORCHESTRATOR** - This service coordinates the entire feature flag system.
- *
- * **EXECUTION FLOW:**
- * 1. NestJS Module System → Instantiates this service
- * 2. **onModuleInit()** ← ENTRY POINT - Called automatically by NestJS
- * 3. initializeProvider() → Loads configuration and creates provider
- * 4. Provider.initialize() → Establishes database connection
- * 5. System ready to serve requests
- *
- * **RUNTIME FLOW:**
- * Client Request → Controller → **This Service** → Provider → Database/Cache
- *
- * @example Basic Usage in Controller
- * ```typescript
- * @Controller('features')
- * export class FeatureController {
- *   constructor(private readonly featureFlagService: FeatureFlagService) {}
- *
- *   @Get(':key')
- *   async getFeature(@Param('key') key: string) {
- *     // This calls the service which orchestrates the entire evaluation
- *     return this.featureFlagService.evaluateFlag(key);
- *   }
- * }
- * ```
- *
- * @example Advanced Usage with Context
- * ```typescript
- * // Evaluate flag with user context for targeting rules
- * const evaluation = await this.featureFlagService.evaluateFlag('PREMIUM_FEATURE', {
- *   userId: 'user123',
- *   userRole: 'premium',
- *   environment: 'production'
- * });
- *
- * if (evaluation.isEnabled) {
- *   // Execute premium feature logic
- * }
- * ```
- *
- * Provides business logic for feature flag operations.
- * Manages provider lifecycle, caching, and data persistence.
- */
-export declare class FeatureFlagService implements OnModuleInit, OnModuleDestroy {
-    private readonly featureFlagRepository;
-    [x: string]: unknown;
-    private readonly logger;
-    private provider;
-    constructor(featureFlagRepository: FeatureFlagRepository<FeatureFlagKey>);
-    /**
-     * **FIRST METHOD CALLED** - NestJS lifecycle hook for module initialization
-     *
-     * **EXECUTION ORDER:**
-     * 1. NestJS creates FeatureFlagModule
-     * 2. NestJS instantiates FeatureFlagService
-     * 3. **THIS METHOD CALLED AUTOMATICALLY** ← YOU ARE HERE
-     * 4. → initializeProvider() called
-     * 5. → Configuration loaded from .env.local
-     * 6. → Database provider created and initialized
-     * 7. → Database connection established
-     * 8. → Initial data loaded from database
-     * 9. System ready to serve requests
-     *
-     * @throws {Error} If provider initialization fails
-     *
-     * @example What happens during initialization:
-     * ```typescript
-     * // 1. Load config from environment
-     * const config = FeatureFlagConfigFactory.fromEnvironment();
-     *
-     * // 2. Create database provider
-     * this.provider = FeatureFlagProviderFactory.create(config, FEATURES);
-     *
-     * // 3. Initialize database connection
-     * await this.provider.initialize();
-     *
-     * // 4. Load flags and rules from database
-     * const { flags, rules } = await this.provider.fetchData();
-     * ```
-     */
-    onModuleInit(): Promise<void>;
-    /**
-     * Cleans up resources on module shutdown.
-     */
-    onModuleDestroy(): Promise<void>;
-    /**
-     * **SECOND METHOD CALLED** - Initializes the feature flag provider
-     *
-     * **EXECUTION FLOW:**
-     * 1. onModuleInit() called by NestJS
-     * 2. **THIS METHOD CALLED** ← YOU ARE HERE
-     * 3. → FeatureFlagConfigFactory.fromEnvironment() - Loads .env.local
-     * 4. → FeatureFlagProviderFactory.create() - Creates database provider
-     * 5. → provider.initialize() - Establishes database connection
-     *
-     * @private
-     * @throws {Error} If configuration is invalid or database connection fails
-     *
-     * @example Configuration Loading Process:
-     * ```typescript
-     * // Reads from .env.local:
-     * // SUPABASE_URL=https://your-project.supabase.co
-     * // FEATURE_FLAG_PROVIDER=database
-     * // FEATURE_FLAG_CACHE_ENABLED=true
-     *
-     * const config = {
-     *   provider: 'database',
-     *   isCacheEnabled: true,
-     *   databaseConfig: {
-     *     connectionString: 'https://your-project.supabase.co',
-     *     tableName: 'feature_flags'
-     *   }
-     * };
-     * ```
-     */
-    private initializeProvider;
-    /**
-     * Gets the current provider instance.
-     */
-    private getProvider;
-    /**
-     * **MAIN RUNTIME METHOD** - Evaluates a feature flag for the given context
-     *
-     * **RUNTIME EXECUTION FLOW:**
-     * 1. Client makes HTTP request to controller
-     * 2. Controller calls **THIS METHOD** ← RUNTIME ENTRY POINT
-     * 3. → getProvider() - Gets initialized provider
-     * 4. → provider.getFlag() - Evaluates flag with context
-     * 5. → Provider checks cache, rules, overrides
-     * 6. → Database query if needed
-     * 7. ← Returns evaluation result
-     *
-     * @param key - Feature flag key (e.g., 'PREMIUM_FEATURE', 'NEW_UI')
-     * @param context - Evaluation context for targeting rules
-     * @returns Feature flag evaluation result with value, reason, and metadata
-     *
-     * @example Simple Usage:
-     * ```typescript
-     * const evaluation = await this.featureFlagService.evaluateFlag('NEW_CHECKOUT');
-     * console.log(evaluation.isEnabled); // true/false
-     * console.log(evaluation.reason);    // 'default_value' | 'rule_match' | 'override'
-     * ```
-     *
-     * @example With User Context (for targeting rules):
-     * ```typescript
-     * const evaluation = await this.featureFlagService.evaluateFlag('BETA_FEATURE', {
-     *   userId: 'user123',
-     *   userRole: 'premium',
-     *   environment: 'production',
-     *   customAttributes: {
-     *     subscriptionTier: 'pro',
-     *     region: 'us-east'
-     *   }
-     * });
-     *
-     * // Provider will:
-     * // 1. Check for user-specific overrides
-     * // 2. Evaluate targeting rules against context
-     * // 3. Return appropriate value with reason
-     * ```
-     *
-     * @example Evaluation Result:
-     * ```typescript
-     * {
-     *   key: 'BETA_FEATURE',
-     *   isEnabled: true,
-     *   value: { enabled: true, variant: 'blue' },
-     *   reason: 'rule_match',
-     *   ruleId: 'premium-users-rule',
-     *   evaluatedAt: '2024-01-15T10:30:00Z'
-     * }
-     * ```
-     */
-    evaluateFlag(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<FeatureFlagEvaluation<FeatureFlagKey>>;
-    /**
-     * Checks if a feature flag is enabled.
-     *
-     * @param key - Feature flag key
-     * @param context - Evaluation context
-     * @returns Boolean indicating if flag is enabled
-     */
-    isEnabled(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<boolean>;
-    /**
-     * Gets all feature flags with their evaluations.
-     *
-     * @param context - Evaluation context
-     * @returns All feature flag evaluations
-     */
-    getAllFlags(context?: FeatureFlagContext): Promise<Record<string, FeatureFlagEvaluation<FeatureFlagKey>>>;
-    /**
-     * Creates a new feature flag.
-     *
-     * @param createData - Flag creation data
-     * @returns Created feature flag
-     */
-    createFlag(createData: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
-    /**
-     * Updates an existing feature flag.
-     *
-     * @param key - Feature flag key
-     * @param updateData - Flag update data
-     * @returns Updated feature flag
-     */
-    updateFlag(key: FeatureFlagKey, updateData: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
-    /**
-     * Deletes a feature flag.
-     *
-     * @param key - Feature flag key
-     */
-    deleteFlag(key: FeatureFlagKey): Promise<void>;
-    /**
-     * Sets a manual override for a flag.
-     *
-     * @param key - Feature flag key
-     * @param value - Override value
-     */
-    setOverride(key: FeatureFlagKey, value: FeatureFlagValue): Promise<void>;
-    /**
-     * Removes a manual override for a flag.
-     *
-     * @param key - Feature flag key
-     */
-    removeOverride(key: FeatureFlagKey): Promise<void>;
-    /**
-     * Gets all available feature flags.
-     *
-     * @param environment - Filter by environment
-     * @returns List of feature flags
-     */
-    getAllFeatureFlags(environment?: string): Promise<FeatureFlag<FeatureFlagKey>[]>;
-    /**
-     * Gets all rules for a specific flag.
-     *
-     * @param key - Feature flag key
-     * @returns List of rules for the flag
-     */
-    getFlagRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
-    /**
-     * Forces a refresh of the feature flag cache.
-     */
-    refreshCache(): Promise<void>;
-    /**
-     * Gets provider health status.
-     *
-     * @returns Provider health information
-     */
-    getHealthStatus(): Promise<ProviderHealthStatus>;
-}
-//# sourceMappingURL=feature-flag.service.d.ts.map

package/dist/backend/featureFlags/feature-flag.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"feature-flag.service.d.ts","sourceRoot":"","sources":["../../../src/backend/featureFlags/feature-flag.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAI1B,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,qBACa,kBAAmB,YAAW,YAAY,EAAE,eAAe;IAK1D,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAJlD,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAuC;gBAE1B,qBAAqB,EAAE,qBAAqB,CAAC,cAAc,CAAC;IAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;YACW,kBAAkB;IAkBhC;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACG,YAAY,CAChB,GAAG,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAmBjD;;;;;;OAMG;IACG,SAAS,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpF;;;;;OAKG;IACG,WAAW,CACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC,CAAC;IAiBjE;;;;;OAKG;IACG,UAAU,CACd,UAAU,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAC5C,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAevC;;;;;;OAMG;IACG,UAAU,CACd,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAevC;;;;OAIG;IACG,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9E;;;;OAIG;IACG,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxD;;;;;OAKG;IACG,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;IAStF;;;;;OAKG;IACG,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;IASnF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAYnC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAOvD"}