@plyaz/core 1.0.0

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

@@ -0,0 +1,85 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,123 @@
+/**
+ * Feature Flag Service
+ *
+ * NestJS service for feature flag business logic.
+ * Orchestrates between providers, repositories, and external systems.
+ *
+ * @fileoverview NestJS service for feature flags
+ * @version 1.0.0
+ */
+import type { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import type { FeatureFlagValue, FeatureFlagContext, FeatureFlagEvaluation, FeatureFlag, FeatureFlagRule, CreateFlagRequest, ProviderHealthStatus } from '@plyaz/types';
+import type { FeatureFlagRepository } from './feature-flag.repository';
+import type { FeatureFlagKey } from '@domain/types';
+/**
+ * Feature Flag Service
+ *
+ * Provides business logic for feature flag operations.
+ * Manages provider lifecycle, caching, and data persistence.
+ */
+export declare class FeatureFlagService implements OnModuleInit, OnModuleDestroy {
+    private readonly featureFlagRepository;
+    private readonly logger;
+    private provider;
+    constructor(featureFlagRepository: FeatureFlagRepository<FeatureFlagKey>);
+    /**
+     * Initializes the service on module startup.
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * Cleans up resources on module shutdown.
+     */
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Initializes the feature flag provider.
+     */
+    private initializeProvider;
+    /**
+     * Gets the current provider instance.
+     */
+    private getProvider;
+    /**
+     * Evaluates a feature flag for the given context.
+     *
+     * @param key - Feature flag key
+     * @param context - Evaluation context
+     * @returns Feature flag evaluation result
+     */
+    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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.service.d.ts","sourceRoot":"","sources":["../../../src/backend/featureFlags/feature-flag.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,eAAe,EAGf,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD;;;;;GAKG;AACH,qBACa,kBAAmB,YAAW,YAAY,EAAE,eAAe;IAI1D,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAHlD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAuC;gBAE1B,qBAAqB,EAAE,qBAAqB,CAAC,cAAc,CAAC;IAEzF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;OAEG;YACW,kBAAkB;IAkBhC;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;;;;;OAMG;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"}

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

@@ -0,0 +1,49 @@
+/**
+ * Feature Flag Backend - Main Exports
+ *
+ * NestJS backend exports for feature flag functionality.
+ * Provides controllers, services, repositories, and module for easy integration.
+ *
+ * @fileoverview Backend feature flags exports
+ * @version 1.0.0
+ */
+export { FeatureFlagModule } from './feature-flag.module';
+export { FeatureFlagService } from './feature-flag.service';
+export { FeatureFlagRepository } from './feature-flag.repository';
+export { FeatureFlagController } from './feature-flag.controller';
+/**
+ * NestJS Guard for feature flag protection.
+ * Use this to protect routes based on feature flag status.
+ *
+ * @example
+ * ```typescript
+ * import { UseGuards } from '@nestjs/common';
+ * import { FeatureFlagGuard } from '@plyaz/config/backend/featureFlags';
+ *
+ * @UseGuards(FeatureFlagGuard('BETA_API'))
+ * @Get('beta-endpoint')
+ * async betaEndpoint() {
+ *   // This endpoint is only accessible when BETA_API flag is enabled
+ * }
+ * ```
+ */
+export declare function FeatureFlagGuard(): (_target: object, _propertyName: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * NestJS Decorator for feature flag checking.
+ * Use this to check feature flags within methods.
+ *
+ * @example
+ * ```typescript
+ * import { FeatureFlag } from '@plyaz/config/backend/featureFlags';
+ *
+ * @Injectable()
+ * export class MyService {
+ *   @FeatureFlag('NEW_ALGORITHM')
+ *   async processData(data: any) {
+ *     // This method behavior can be controlled by the NEW_ALGORITHM flag
+ *   }
+ * }
+ * ```
+ */
+export declare function FeatureFlag(): (_target: object, _propertyName: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/featureFlags/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,KAI5B,SAAS,MAAM,EACf,eAAe,MAAM,EACrB,YAAY,kBAAkB,KAC7B,kBAAkB,CAKtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,KAIvB,SAAS,MAAM,EACf,eAAe,MAAM,EACrB,YAAY,kBAAkB,KAC7B,kBAAkB,CAKtB"}

package/dist/backend/index.d.ts

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

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

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

package/dist/cache/index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Cache Manager - Core Caching Layer
+ *
+ * Main cache orchestration service that manages different caching strategies.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Core caching infrastructure
+ * @version 1.0.0
+ */
+import type { CacheConfig, CacheManagerStats } from '@plyaz/types';
+/**
+ * Cache manager that orchestrates different caching strategies.
+ * Provides a unified interface for caching across the application.
+ *
+ * @class CacheManager
+ *
+ * @example
+ * ```typescript
+ * const cache = new CacheManager({
+ *   isEnabled: true,
+ *   ttl: 300,
+ *   strategy: 'redis',
+ *   redisConfig: { url: 'redis://localhost:6379' }
+ * });
+ *
+ * await cache.set('key', value);
+ * const cached = await cache.get('key');
+ * ```
+ */
+export declare class CacheManager {
+    private config;
+    private strategy;
+    /**
+     * Creates a new cache manager with the specified configuration.
+     *
+     * @param config - Cache configuration
+     */
+    constructor(config: CacheConfig);
+    /**
+     * Stores a value in the cache.
+     *
+     * @template T - Type of the value to cache
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param ttl - Optional TTL override in seconds
+     * @returns Promise that resolves when value is cached
+     */
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Retrieves a value from the cache.
+     *
+     * @template T - Expected type of the cached value
+     * @param key - Cache key
+     * @returns Promise that resolves to cached value or null if not found/expired
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Removes a value from the cache.
+     *
+     * @param key - Cache key to remove
+     * @returns Promise that resolves when value is removed
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clears all cached values.
+     *
+     * @returns Promise that resolves when cache is cleared
+     */
+    clear(): Promise<void>;
+    /**
+     * Checks if a key exists in the cache.
+     *
+     * @param key - Cache key to check
+     * @returns Promise that resolves to true if key exists and is not expired
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Gets cache statistics.
+     *
+     * @returns Promise that resolves to cache statistics
+     */
+    getStats(): Promise<CacheManagerStats>;
+    /**
+     * Creates the appropriate cache strategy based on configuration.
+     *
+     * @private
+     * @param config - Cache configuration
+     * @returns Cache strategy instance
+     */
+    private createStrategy;
+    /**
+     * Disposes of the cache manager and cleans up resources.
+     *
+     * @returns Promise that resolves when cleanup is complete
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAiB,WAAW,EAAc,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE9F;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IAQX,OAAO,CAAC,MAAM;IAP1B,OAAO,CAAC,QAAQ,CAAgB;IAEhC;;;;OAIG;gBACiB,MAAM,EAAE,WAAW;IAIvC;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe5C;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAexC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI5C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IActB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/cache/strategies/memory.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Memory Cache Strategy
+ *
+ * In-memory cache implementation for fast local caching.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Memory cache strategy implementation
+ * @version 1.0.0
+ */
+import type { CacheStrategy, CacheEntry, CacheStats, MemoryCacheConfig } from '@plyaz/types';
+/**
+ * In-memory cache strategy implementation.
+ * Provides fast caching for single-instance applications.
+ *
+ * @class MemoryCacheStrategy
+ * @implements {CacheStrategy}
+ *
+ * @example
+ * ```typescript
+ * const cache = new MemoryCacheStrategy({
+ *   maxEntries: 500,
+ *   cleanupInterval: 30000
+ * });
+ *
+ * await cache.set('key', entry);
+ * const cached = await cache.get('key');
+ * ```
+ */
+export declare class MemoryCacheStrategy implements CacheStrategy {
+    private cache;
+    private accessOrder;
+    private stats;
+    private cleanupTimer?;
+    private readonly maxSize;
+    private readonly cleanupInterval;
+    private readonly onEvict?;
+    /**
+     * Creates a new memory cache strategy.
+     *
+     * @param config - Memory cache configuration
+     */
+    constructor(config?: MemoryCacheConfig);
+    /**
+     * Stores a cache entry in memory.
+     *
+     * @param key - Cache key
+     * @param entry - Cache entry to store
+     * @returns Promise that resolves when entry is stored
+     */
+    set<T>(key: string, entry: CacheEntry<T>): Promise<void>;
+    /**
+     * Retrieves a cache entry from memory.
+     *
+     * @param key - Cache key
+     * @returns Promise that resolves to cache entry or null if not found
+     */
+    get<T>(key: string): Promise<CacheEntry<T> | null>;
+    /**
+     * Removes a cache entry from memory.
+     *
+     * @param key - Cache key to remove
+     * @returns Promise that resolves when entry is removed
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clears all cache entries from memory.
+     *
+     * @returns Promise that resolves when cache is cleared
+     */
+    clear(): Promise<void>;
+    /**
+     * Gets cache statistics.
+     *
+     * @returns Promise that resolves to cache statistics
+     */
+    getStats(): Promise<CacheStats>;
+    /**
+     * Disposes of the memory cache and cleans up resources.
+     *
+     * @returns Promise that resolves when cleanup is complete
+     */
+    dispose(): Promise<void>;
+    /**
+     * Starts the periodic cleanup of expired entries.
+     *
+     * @private
+     */
+    private startCleanup;
+    /**
+     * Removes expired entries from the cache.
+     *
+     * @private
+     */
+    private cleanupExpiredEntries;
+    /**
+     * Evicts the oldest entries when cache is full.
+     * Uses LRU-like eviction by removing the oldest entries by creation time.
+     *
+     * @private
+     */
+    private evictOldestEntries;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/cache/strategies/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/cache/strategies/memory.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE7F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA2C;IAEpE;;;;OAIG;gBACS,MAAM,GAAE,iBAAsB;IAiB1C;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAcxD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAcrC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAMpB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAyB3B"}

package/dist/cache/strategies/redis.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Redis Cache Strategy
+ *
+ * Redis-based cache implementation for distributed caching.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Redis cache strategy implementation
+ * @version 1.0.0
+ */
+import type { CacheStrategy, CacheEntry, CacheStats, RedisCacheConfig } from '@plyaz/types';
+/**
+ * Redis cache strategy implementation.
+ * Provides distributed caching for multi-instance applications.
+ *
+ * @class RedisCacheStrategy
+ * @implements {CacheStrategy}
+ *
+ * @example
+ * ```typescript
+ * const cache = new RedisCacheStrategy({
+ *   url: 'redis://localhost:6379',
+ *   keyPrefix: 'app:cache:'
+ * });
+ *
+ * await cache.set('key', entry);
+ * const cached = await cache.get('key');
+ * ```
+ */
+export declare class RedisCacheStrategy implements CacheStrategy {
+    private config;
+    private client;
+    private stats;
+    private isConnected;
+    private readonly keyPrefix;
+    /**
+     * Creates a new Redis cache strategy.
+     *
+     * @param config - Redis cache configuration
+     */
+    constructor(config: RedisCacheConfig);
+    /**
+     * Stores a cache entry in Redis.
+     *
+     * @param key - Cache key
+     * @param entry - Cache entry to store
+     * @returns Promise that resolves when entry is stored
+     */
+    set<T>(key: string, entry: CacheEntry<T>): Promise<void>;
+    /**
+     * Retrieves a cache entry from Redis.
+     *
+     * @param key - Cache key
+     * @returns Promise that resolves to cache entry or null if not found
+     */
+    get<T>(key: string): Promise<CacheEntry<T> | null>;
+    /**
+     * Removes a cache entry from Redis.
+     *
+     * @param key - Cache key to remove
+     * @returns Promise that resolves when entry is removed
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clears all cache entries from Redis.
+     * This removes all keys with the configured prefix.
+     *
+     * @returns Promise that resolves when cache is cleared
+     */
+    clear(): Promise<void>;
+    /**
+     * Gets cache statistics.
+     *
+     * @returns Promise that resolves to cache statistics
+     */
+    getStats(): Promise<CacheStats>;
+    /**
+     * Disposes of the Redis cache and cleans up resources.
+     *
+     * @returns Promise that resolves when cleanup is complete
+     */
+    dispose(): Promise<void>;
+    /**
+     * Ensures Redis connection is established.
+     *
+     * @private
+     * @returns Promise that resolves when connected
+     */
+    private ensureConnected;
+    /**
+     * Creates an ioredis client.
+     *
+     * @private
+     * @returns Promise that resolves to ioredis client
+     */
+    private createIoRedisClient;
+    /**
+     * Builds a Redis key with the configured prefix.
+     *
+     * @private
+     * @param key - Base cache key
+     * @returns Redis key with prefix
+     */
+    private buildRedisKey;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/cache/strategies/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/cache/strategies/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG5F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAgB1C,OAAO,CAAC,MAAM;IAf1B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;OAIG;gBACiB,MAAM,EAAE,gBAAgB;IAO5C;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAuBxD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAqBrC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;;;;OAKG;YACW,eAAe;IAc7B;;;;;OAKG;YACW,mBAAmB;IA4BjC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAGtB"}

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

@@ -0,0 +1,49 @@
+/**
+ * Feature Flags Domain - Main Exports
+ *
+ * This module provides the main exports for the feature flags domain logic.
+ * This will be moved to @plyaz/core when the package structure is finalized.
+ *
+ * @fileoverview Main feature flags domain exports
+ * @version 1.0.0
+ */
+import type { FeatureFlagConfig, FeatureFlagOverrides } from '@plyaz/types';
+import type { FeatureFlagKey } from '../types';
+export { FeatureFlagProvider } from './provider';
+export { FeatureFlagProviderFactory } from './providers/factory';
+export type { ProviderType } from './providers/factory';
+export { MemoryFeatureFlagProvider } from './providers/memory';
+export { FileFeatureFlagProvider } from './providers/file';
+export { RedisFeatureFlagProvider } from './providers/redis';
+export { ApiFeatureFlagProvider } from './providers/api';
+export { DatabaseFeatureFlagProvider } from './providers/database';
+/**
+ * Default configuration for feature flags.
+ * Provides sensible defaults for most use cases.
+ */
+export declare const DEFAULT_FEATURE_FLAG_CONFIG: {
+    readonly provider: "memory";
+    readonly isCacheEnabled: true;
+    readonly cacheTtl: 300;
+    readonly refreshInterval: 0;
+    readonly shouldFallbackToDefaults: true;
+    readonly isLoggingEnabled: false;
+};
+/**
+ * Feature flag system initialization for different environments.
+ */
+export declare const FeatureFlagSystem: {
+    /**
+     * Initialize for frontend/client applications.
+     */
+    readonly initializeForFrontend: (config?: Partial<FeatureFlagConfig<FeatureFlagKey>>) => Promise<import("@plyaz/types").FeatureFlagProvider<"AUTH_GOOGLE" | "AUTH_DISCORD" | "AUTH_FACEBOOK" | "AUTH_GITHUB">>;
+    /**
+     * Initialize for backend/server applications.
+     */
+    readonly initializeForBackend: (config?: Partial<FeatureFlagConfig<FeatureFlagKey>>) => Promise<import("@plyaz/types").FeatureFlagProvider<"AUTH_GOOGLE" | "AUTH_DISCORD" | "AUTH_FACEBOOK" | "AUTH_GITHUB">>;
+    /**
+     * Initialize for testing environments.
+     */
+    readonly initializeForTesting: (overrides?: FeatureFlagOverrides<FeatureFlagKey>) => Promise<import("@plyaz/types").FeatureFlagProvider<"AUTH_GOOGLE" | "AUTH_DISCORD" | "AUTH_FACEBOOK" | "AUTH_GITHUB">>;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/featureFlags/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;CAOuB,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;8CACmC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAUhF;;OAEG;6CACkC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAU/E;;OAEG;gDACqC,oBAAoB,CAAC,cAAc,CAAC;CAepE,CAAC"}