@plyaz/core 1.0.0

package/dist/domain/featureFlags/provider.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Feature Flag Provider - Core Implementation
+ *
+ * Main provider class that orchestrates feature flag evaluation and management.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Core feature flag provider implementation
+ * @version 1.0.0
+ */
+import type { FeatureFlagProvider as IFeatureFlagProvider, FeatureFlagConfig, FeatureFlagContext, FeatureFlagEvaluation, FeatureFlagValue, FetchFeatureFlagDataResponse } from '@plyaz/types';
+import { FeatureFlagEngine } from '@engine/featureFlags/engine';
+import { CacheManager } from '@cache/index';
+/**
+ * Subscription callback function type
+ */
+export type SubscriptionCallback = () => void;
+/**
+ * Core feature flag provider that implements the main business logic.
+ * This class orchestrates between the evaluation engine, caching, and data providers.
+ *
+ * @class FeatureFlagProvider
+ * @implements {IFeatureFlagProvider}
+ *
+ * @example
+ * ```typescript
+ * const provider = new MemoryFeatureFlagProvider<MyFeatureFlags>(config, FEATURES);
+ * await provider.initialize();
+ *
+ * const isEnabled = await provider.isEnabled('AUTH_GOOGLE', context);
+ * const value = await provider.getValue('ROLLOUT_PERCENTAGE', context);
+ * ```
+ */
+export declare abstract class FeatureFlagProvider<FeatureFlagKey extends string> implements IFeatureFlagProvider<FeatureFlagKey> {
+    protected config: FeatureFlagConfig<FeatureFlagKey>;
+    protected engine: FeatureFlagEngine<FeatureFlagKey>;
+    protected cacheManager: CacheManager;
+    protected subscribers: Set<SubscriptionCallback>;
+    protected refreshTimer?: ReturnType<typeof setInterval>;
+    protected isInitialized: boolean;
+    protected features: Record<FeatureFlagKey, FeatureFlagValue>;
+    protected initializePromise?: Promise<void>;
+    /**
+     * Creates a new feature flag provider.
+     *
+     * @param config - Provider configuration
+     * @param features - Record of feature flag keys to their default values
+     */
+    constructor(config: FeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>);
+    /**
+     * Abstract method to fetch flags and rules from the provider's data source.
+     * Must be implemented by concrete provider classes.
+     *
+     * @protected
+     * @abstract
+     * @returns Promise resolving to flags and rules
+     */
+    protected abstract fetchData(): Promise<FetchFeatureFlagDataResponse<FeatureFlagKey>>;
+    /**
+     * Initializes the provider by loading initial data.
+     *
+     * @returns Promise that resolves when initialization is complete
+     */
+    initialize(): Promise<void>;
+    /**
+     * Performs the actual initialization work.
+     *
+     * @private
+     * @returns Promise that resolves when initialization is complete
+     */
+    private doInitialize;
+    /**
+     * Gets a feature flag evaluation for the specified key and context.
+     *
+     * @param key - The feature flag key
+     * @param context - Optional context for evaluation
+     * @returns Promise resolving to the flag evaluation
+     */
+    getFlag(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<FeatureFlagEvaluation<FeatureFlagKey>>;
+    /**
+     * Checks if a feature flag is enabled.
+     *
+     * @param key - The feature flag key
+     * @param context - Optional context for evaluation
+     * @returns Promise resolving to boolean indicating if flag is enabled
+     */
+    isEnabled(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<boolean>;
+    /**
+     * Gets the value of a feature flag.
+     *
+     * @template T - The expected type of the flag value
+     * @param key - The feature flag key
+     * @param context - Optional context for evaluation
+     * @returns Promise resolving to the flag value
+     */
+    getValue<T = FeatureFlagValue>(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<T>;
+    /**
+     * Gets all feature flag evaluations for the given context.
+     *
+     * @param context - Optional context for evaluation
+     * @returns Promise resolving to record of flag evaluations
+     */
+    getAllFlags(context?: FeatureFlagContext): Promise<Record<string, FeatureFlagEvaluation<FeatureFlagKey>>>;
+    /**
+     * Refreshes the provider by fetching latest data from the source.
+     *
+     * @returns Promise that resolves when refresh is complete
+     */
+    refresh(): Promise<void>;
+    /**
+     * Subscribes to provider updates.
+     *
+     * @param callback - Function to call when provider updates
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: SubscriptionCallback): () => void;
+    /**
+     * Sets an override for a specific flag key.
+     *
+     * @param key - The flag key to override
+     * @param value - The value to force for this flag
+     */
+    setOverride(key: FeatureFlagKey, value: FeatureFlagValue): void;
+    /**
+     * Removes an override for a specific flag key.
+     *
+     * @param key - The flag key to remove override for
+     */
+    removeOverride(key: FeatureFlagKey): void;
+    /**
+     * Clears all overrides.
+     */
+    clearOverrides(): void;
+    /**
+     * Disposes of the provider, cleaning up resources.
+     */
+    dispose(): void;
+    /**
+     * Generates a cache key for flag evaluation.
+     *
+     * @protected
+     * @param key - Feature flag key
+     * @param context - Evaluation context
+     * @returns Cache key string
+     */
+    protected generateCacheKey(key: FeatureFlagKey, context?: FeatureFlagContext): string;
+    /**
+     * Sets up the automatic refresh timer if configured.
+     *
+     * @protected
+     */
+    protected setupRefreshTimer(): void;
+    /**
+     * Notifies all subscribers of provider updates.
+     *
+     * @protected
+     */
+    protected notifySubscribers(): void;
+    /**
+     * Logs a message if logging is enabled.
+     *
+     * @protected
+     * @param args - Arguments to log
+     */
+    protected log(...args: unknown[]): void;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/domain/featureFlags/provider.d.ts.map

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

package/dist/domain/featureFlags/providers/api.d.ts

@@ -0,0 +1,78 @@
+/**
+ * API Feature Flag Provider (Stub)
+ *
+ * API-based provider stub that requires @plyaz/api package implementation.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview API provider stub for feature flags
+ * @version 1.0.0
+ */
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue } from '@plyaz/types';
+import { FeatureFlagProvider } from '../provider';
+/**
+ * API-based feature flag provider requiring @plyaz/api implementation.
+ *
+ * @class ApiFeatureFlagProvider
+ * @extends {FeatureFlagProvider}
+ *
+ * @example
+ * ```typescript
+ * // This will throw an error until @plyaz/api is implemented
+ * const provider = new ApiFeatureFlagProvider({
+ *   provider: 'api',
+ *   apiEndpoint: 'https://api.plyaz.co.uk',
+ *   apiKey: process.env.FEATURE_FLAG_API_KEY,
+ *   isCacheEnabled: true,
+ *   cacheTtl: 300,
+ * });
+ * ```
+ */
+export declare class ApiFeatureFlagProvider<FeatureFlagKey extends string> extends FeatureFlagProvider<FeatureFlagKey> {
+    /**
+     * Creates a new API feature flag provider.
+     *
+     * @param config - Provider configuration with API settings
+     * @throws Error indicating that @plyaz/api implementation is required
+     */
+    constructor(config: FeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>);
+    /**
+     * Fetches flags and rules from the API endpoint.
+     * Currently throws an error as the API implementation is not ready.
+     *
+     * @protected
+     * @returns Promise that rejects with implementation error
+     * @throws Error indicating missing API implementation
+     */
+    protected fetchData(): Promise<{
+        flags: FeatureFlag<FeatureFlagKey>[];
+        rules: FeatureFlagRule<FeatureFlagKey>[];
+    }>;
+    /**
+     * Validates the API provider configuration.
+     *
+     * @private
+     * @throws Error if configuration is invalid or incomplete
+     */
+    private validateConfig;
+    /**
+     * Validates URL format.
+     *
+     * @private
+     * @param url - URL to validate
+     * @returns True if valid URL
+     */
+    private isValidUrl;
+    /**
+     * Gets API provider status and configuration info.
+     *
+     * @returns API provider status information
+     */
+    getApiInfo(): {
+        endpoint?: string;
+        hasApiKey: boolean;
+        isImplemented: boolean;
+        requiredPackages: string[];
+        documentationPath: string;
+    };
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/domain/featureFlags/providers/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,sBAAsB,CACjC,cAAc,SAAS,MAAM,CAC7B,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC3C;;;;;OAKG;gBAED,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAOpD;;;;;;;OAOG;cACa,SAAS,IAAI,OAAO,CAAC;QACnC,KAAK,EAAE,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;QACrC,KAAK,EAAE,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;KAC1C,CAAC;IA6BF;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAmCtB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IASlB;;;;OAIG;IACH,UAAU,IAAI;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,iBAAiB,EAAE,MAAM,CAAC;KAC3B;CASF"}

package/dist/domain/featureFlags/providers/database.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Database Feature Flag Provider (Stub)
+ *
+ * Database-based provider stub that requires @plyaz/db package implementation.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Database provider stub for feature flags
+ * @version 1.0.0
+ */
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue } from '@plyaz/types';
+import { FeatureFlagProvider } from '../provider';
+/**
+ * Database-based feature flag provider requiring @plyaz/db implementation.
+ *
+ * @class DatabaseFeatureFlagProvider
+ * @extends {FeatureFlagProvider}
+ *
+ * @example
+ * ```typescript
+ * // This will throw an error until @plyaz/db is implemented
+ * const provider = new DatabaseFeatureFlagProvider({
+ *   provider: 'database',
+ *   databaseConfig: {
+ *     connectionString: process.env.DATABASE_URL,
+ *     tableName: 'feature_flags',
+ *   },
+ *   isCacheEnabled: true,
+ *   cacheTtl: 300,
+ * });
+ * ```
+ */
+export declare class DatabaseFeatureFlagProvider<FeatureFlagKey extends string> extends FeatureFlagProvider<FeatureFlagKey> {
+    /**
+     * Creates a new database feature flag provider.
+     *
+     * @param config - Provider configuration with database settings
+     * @throws Error indicating that @plyaz/db implementation is required
+     */
+    constructor(config: FeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>);
+    /**
+     * Fetches flags and rules from the database.
+     * Currently throws an error as the database implementation is not ready.
+     *
+     * @protected
+     * @returns Promise that rejects with implementation error
+     * @throws Error indicating missing database implementation
+     */
+    protected fetchData(): Promise<{
+        flags: FeatureFlag<FeatureFlagKey>[];
+        rules: FeatureFlagRule<FeatureFlagKey>[];
+    }>;
+    /**
+     * Validates the database provider configuration.
+     *
+     * @private
+     * @throws Error if configuration is invalid or incomplete
+     */
+    private validateConfig;
+    private validateProviderType;
+    private validateDatabaseConfig;
+    private validateConnectionString;
+    private logConfigurationStatus;
+    /**
+     * Validates PostgreSQL URL format.
+     *
+     * @private
+     * @param url - URL to validate
+     * @returns True if valid PostgreSQL URL
+     */
+    private isValidPostgresUrl;
+    /**
+     * Validates MySQL URL format.
+     *
+     * @private
+     * @param url - URL to validate
+     * @returns True if valid MySQL URL
+     */
+    private isValidMysqlUrl;
+    /**
+     * Masks sensitive parts of connection string for logging.
+     *
+     * @private
+     * @param connectionString - Original connection string
+     * @returns Masked connection string
+     */
+    private maskConnectionString;
+    /**
+     * Gets database provider status and configuration info.
+     *
+     * @returns Database provider status information
+     */
+    getDatabaseInfo(): {
+        connectionString?: string;
+        tableName?: string;
+        isImplemented: boolean;
+        requiredPackages: string[];
+        recommendedORM: string[];
+        documentationPath: string;
+        schemaPath: string;
+    };
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/domain/featureFlags/providers/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,2BAA2B,CACtC,cAAc,SAAS,MAAM,CAC7B,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC3C;;;;;OAKG;gBAED,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAOpD;;;;;;;OAOG;cACa,SAAS,IAAI,OAAO,CAAC;QACnC,KAAK,EAAE,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;QACrC,KAAK,EAAE,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;KAC1C,CAAC;IAyCF;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,wBAAwB;IA0BhC,OAAO,CAAC,sBAAsB;IAQ9B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;;;OAIG;IACH,eAAe,IAAI;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;KACpB;CAaF"}

package/dist/domain/featureFlags/providers/factory.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Feature Flag Provider Factory
+ *
+ * Factory class for creating and managing feature flag providers.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Provider factory for feature flag system
+ * @version 1.0.0
+ */
+import type { FeatureFlagConfig, FeatureFlagProvider, FeatureFlagValue } from '@plyaz/types';
+import { MemoryFeatureFlagProvider } from './memory';
+import { FileFeatureFlagProvider } from './file';
+import { RedisFeatureFlagProvider } from './redis';
+import { ApiFeatureFlagProvider } from './api';
+import { DatabaseFeatureFlagProvider } from './database';
+/**
+ * Registry of available provider classes.
+ */
+declare const PROVIDER_REGISTRY: {
+    readonly memory: typeof MemoryFeatureFlagProvider;
+    readonly file: typeof FileFeatureFlagProvider;
+    readonly redis: typeof RedisFeatureFlagProvider;
+    readonly api: typeof ApiFeatureFlagProvider;
+    readonly database: typeof DatabaseFeatureFlagProvider;
+};
+/**
+ * Type for available provider names.
+ */
+export type ProviderType = keyof typeof PROVIDER_REGISTRY;
+/**
+ * Feature flag provider factory for creating provider instances.
+ *
+ * @class FeatureFlagProviderFactory
+ *
+ * @example
+ * ```typescript
+ * const provider = FeatureFlagProviderFactory.create({
+ *   provider: 'memory',
+ *   isCacheEnabled: true,
+ *   cacheTtl: 300,
+ * });
+ * ```
+ */
+export declare class FeatureFlagProviderFactory {
+    /**
+     * Creates a new feature flag provider instance based on configuration.
+     *
+     * @param config - Provider configuration
+     * @param features - Record of feature flag keys to their default values
+     * @returns Configured provider instance
+     * @throws Error if provider type is unsupported or configuration is invalid
+     */
+    static create<FeatureFlagKey extends string>(config: FeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>): FeatureFlagProvider<FeatureFlagKey>;
+    /**
+     * Creates a provider with automatic initialization.
+     *
+     * @param config - Provider configuration
+     * @param features - Record of feature flag keys to their default values
+     * @returns Promise resolving to initialized provider instance
+     */
+    static createAndInitialize<FeatureFlagKey extends string>(config: FeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>): Promise<FeatureFlagProvider<FeatureFlagKey>>;
+    /**
+     * Gets a list of all supported provider types.
+     *
+     * @returns Array of supported provider names
+     */
+    static getSupportedProviders(): ProviderType[];
+    /**
+     * Checks if a provider type is supported.
+     *
+     * @param providerType - Provider type to check
+     * @returns True if provider type is supported
+     */
+    static isProviderSupported(providerType: string): providerType is ProviderType;
+    /**
+     * Gets provider information including implementation status.
+     *
+     * @returns Record of provider information
+     */
+    static getProvidersInfo(): Record<ProviderType, {
+        name: string;
+        isImplemented: boolean;
+        description: string;
+        requirements?: string[];
+    }>;
+    /**
+     * Creates a default memory provider for testing environments.
+     *
+     * @param features - Record of feature flag keys to their default values
+     * @param overrides - Optional configuration overrides
+     * @returns Memory provider instance
+     */
+    static createDefault<FeatureFlagKey extends string>(features: Record<FeatureFlagKey, FeatureFlagValue>, overrides?: Partial<FeatureFlagConfig<FeatureFlagKey>>): FeatureFlagProvider<FeatureFlagKey>;
+    /**
+     * Validates provider configuration before instantiation.
+     *
+     * @private
+     * @param config - Configuration to validate
+     * @throws Error if configuration is invalid
+     */
+    private static validateConfig;
+    /**
+     * Validates provider-specific configuration requirements.
+     *
+     * @private
+     * @param config - Configuration to validate
+     * @throws Error if provider-specific configuration is invalid
+     */
+    private static validateProviderSpecificConfig;
+    private static validateFileConfig;
+    private static validateRedisConfig;
+    private static validateApiConfig;
+    private static validateDatabaseConfig;
+}
+export {};
+//# sourceMappingURL=factory.d.ts.map

package/dist/domain/featureFlags/providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,QAAA,MAAM,iBAAiB;;;;;;CAYtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA0B;IACrC;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,cAAc,SAAS,MAAM,EACzC,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,GACjD,mBAAmB,CAAC,cAAc,CAAC;IAsBtC;;;;;;OAMG;WACU,mBAAmB,CAAC,cAAc,SAAS,MAAM,EAC5D,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,GACjD,OAAO,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAM/C;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,IAAI,YAAY,EAAE;IAI9C;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,YAAY;IAI9E;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAC/B,YAAY,EACZ;QACE,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,OAAO,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CACF;IAyCD;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,cAAc,SAAS,MAAM,EAChD,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,EAClD,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,GACrD,mBAAmB,CAAC,cAAc,CAAC;IActC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAgC7B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAmB7C,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAQjC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAQlC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAQhC,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAOtC"}

package/dist/domain/featureFlags/providers/file.d.ts

@@ -0,0 +1,84 @@
+/**
+ * File Feature Flag Provider
+ *
+ * File-based provider implementation supporting JSON and YAML configuration files.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview File provider implementation for feature flags
+ * @version 1.0.0
+ */
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue } from '@plyaz/types';
+import { FeatureFlagProvider } from '../provider';
+/**
+ * File-based feature flag provider supporting JSON and YAML formats.
+ *
+ * @class FileFeatureFlagProvider
+ * @extends {FeatureFlagProvider}
+ *
+ * @example
+ * ```typescript
+ * const provider = new FileFeatureFlagProvider<FeatureFlagKey>({
+ *   provider: 'file',
+ *   fileConfig: {
+ *     filePath: './config/feature-flags.json',
+ *     format: 'json',
+ *     shouldWatchForChanges: true,
+ *   },
+ *   isCacheEnabled: true,
+ *   cacheTtl: 60,
+ * }, FEATURES);
+ *
+ * await provider.initialize();
+ * const isEnabled = await provider.isEnabled('AUTH_GOOGLE');
+ * ```
+ */
+export declare class FileFeatureFlagProvider<FeatureFlagKey extends string> extends FeatureFlagProvider<FeatureFlagKey> {
+    private fileWatcher?;
+    /**
+     * Creates a new file feature flag provider.
+     *
+     * @param config - Provider configuration with file settings
+     * @param features - Record of feature flag keys to their default values
+     */
+    constructor(config: FeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>);
+    /**
+     * Fetches flags and rules from the configuration file.
+     *
+     * @protected
+     * @returns Promise resolving to flags and rules from file
+     */
+    protected fetchData(): Promise<{
+        flags: FeatureFlag<FeatureFlagKey>[];
+        rules: FeatureFlagRule<FeatureFlagKey>[];
+    }>;
+    /**
+     * Validates the file provider configuration.
+     *
+     * @private
+     * @throws Error if configuration is invalid
+     */
+    private validateConfig;
+    /**
+     * Sets up file watching for hot reload if enabled.
+     *
+     * @private
+     */
+    private setupFileWatcher;
+    /**
+     * Disposes of the file provider and stops file watching.
+     */
+    dispose(): void;
+    /**
+     * Gets information about the file provider.
+     *
+     * @returns File provider information
+     */
+    getFileInfo(): {
+        filePath?: string;
+        format?: string;
+        isWatchEnabled: boolean;
+        isImplemented: boolean;
+        requiredImplementation: string[];
+    };
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/domain/featureFlags/providers/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,uBAAuB,CAClC,cAAc,SAAS,MAAM,CAC7B,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC3C,OAAO,CAAC,WAAW,CAAC,CAAiC;IAErD;;;;;OAKG;gBAED,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAQpD;;;;;OAKG;cACa,SAAS,IAAI,OAAO,CAAC;QACnC,KAAK,EAAE,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;QACrC,KAAK,EAAE,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;KAC1C,CAAC;IAsCF;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAUf;;;;OAIG;IACH,WAAW,IAAI;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,EAAE,OAAO,CAAC;QACvB,sBAAsB,EAAE,MAAM,EAAE,CAAC;KAClC;CAeF"}