@plyaz/core 1.2.0 → 1.3.0

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

@@ -1,43 +1,55 @@
 /**
  * Database Feature Flag Provider
  *
- * Database-based provider with Drizzle ORM and Supabase integration.
- * Provides persistent storage with caching and transaction support.
+ * Database-based provider using DbService for persistent storage.
+ * Requires Core.initialize() to be called first with database config.
  *
  * @fileoverview Database provider for feature flags
  */
-import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue } from '@plyaz/types';
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue, CreateFlagRequest } from '@plyaz/types';
 import { FeatureFlagProvider } from '../provider';
 /**
- * Database-based feature flag provider with Drizzle ORM integration.
+ * Database-based feature flag provider with @plyaz/db integration.
+ *
+ * Uses DbService (configured via Core.initialize()) for database operations.
+ * No connection string needed here - DbService handles all connection details.
  *
  * @class DatabaseFeatureFlagProvider
  * @extends {FeatureFlagProvider}
  *
  * @example
  * ```typescript
+ * // First: Initialize Core with database config
+ * await Core.initialize({
+ *   db: { adapter: 'sql', sql: { connectionString: '...' } }
+ * });
+ *
+ * // Then: Create database provider
  * const provider = new DatabaseFeatureFlagProvider({
  *   provider: 'database',
- *   databaseConfig: {
- *     connectionString: process.env.SUPABASE_URL,
- *     tableName: 'feature_flags',
- *   },
  *   isCacheEnabled: true,
  *   cacheTtl: 300,
- * });
+ * }, FEATURES);
+ * await provider.initialize();
  * ```
  */
 export declare class DatabaseFeatureFlagProvider<FeatureFlagKey extends string> extends FeatureFlagProvider<FeatureFlagKey> {
-    private connectionManager;
-    private repository;
+    private _repository?;
+    private _tableConfig?;
+    private readonly logger;
+    /**
+     * Lazily get the repository, creating it on first access after DbService is initialized.
+     */
+    private get repository();
     /**
      * Creates a new database feature flag provider.
      *
-     * @param config - Provider configuration with database settings
+     * @param config - Provider configuration
+     * @param features - Default feature flag values
      */
     constructor(config: FeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>);
     /**
-     * Initialize database connection
+     * Initialize database connection via DbService
      */
     initialize(): Promise<void>;
     /**
@@ -55,53 +67,48 @@ export declare class DatabaseFeatureFlagProvider<FeatureFlagKey extends string>
      */
     dispose(): void;
     /**
-     * Validates the database provider configuration.
+     * Gets database provider status and configuration info.
      *
-     * @private
-     * @throws Error if configuration is invalid or incomplete
+     * @returns Database provider status information
      */
-    private validateConfig;
-    private validateProviderType;
-    private validateDatabaseConfig;
-    private validateConnectionString;
-    private logConfigurationStatus;
+    getDatabaseInfo(): {
+        tableName: string;
+        isImplemented: boolean;
+        dbServiceInitialized: boolean;
+    };
     /**
-     * Validates PostgreSQL URL format.
+     * Creates a new feature flag in the database.
      *
-     * @private
-     * @param url - URL to validate
-     * @returns True if valid PostgreSQL URL
+     * @param data - Flag creation data
+     * @returns The created feature flag
      */
-    private isValidPostgresUrl;
+    createFlag(data: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
     /**
-     * Validates MySQL URL format.
+     * Updates an existing feature flag in the database.
      *
-     * @private
-     * @param url - URL to validate
-     * @returns True if valid MySQL URL
+     * @param key - Flag key to update
+     * @param data - Partial flag data to update
+     * @returns The updated feature flag
      */
-    private isValidMysqlUrl;
+    updateFlag(key: FeatureFlagKey, data: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
     /**
-     * Masks sensitive parts of connection string for logging.
+     * Deletes a feature flag from the database.
      *
-     * @private
-     * @param connectionString - Original connection string
-     * @returns Masked connection string
+     * @param key - Flag key to delete
      */
-    private maskConnectionString;
+    deleteFlag(key: FeatureFlagKey): Promise<void>;
     /**
-     * Gets database provider status and configuration info.
+     * Gets all rules for a specific flag.
      *
-     * @returns Database provider status information
+     * @param key - Flag key to get rules for
+     * @returns Array of rules for the flag
      */
-    getDatabaseInfo(): {
-        connectionString?: string;
-        tableName?: string;
-        isImplemented: boolean;
-        requiredPackages: string[];
-        recommendedORM: string[];
-        documentationPath: string;
-        schemaPath: string;
-    };
+    getRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /**
+     * Gets all enabled rules across all flags.
+     *
+     * @returns Array of all enabled rules
+     */
+    getAllRules(): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
 }
 //# sourceMappingURL=database.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/database.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMlD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,2BAA2B,CACtC,cAAc,SAAS,MAAM,CAC7B,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC3C,OAAO,CAAC,iBAAiB,CAA2C;IACpE,OAAO,CAAC,UAAU,CAAuD;IAEzE;;;;OAIG;gBAED,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAQpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;;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;IAeF;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;;;;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"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/database.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMlD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,2BAA2B,CACtC,cAAc,SAAS,MAAM,CAC7B,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC3C,OAAO,CAAC,WAAW,CAAC,CAAgD;IACpE,OAAO,CAAC,YAAY,CAAC,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGpB;IAEH;;OAEG;IACH,OAAO,KAAK,UAAU,GAYrB;IAED;;;;;OAKG;gBAED,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAsBpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;;;;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;IAgBF;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;;;OAIG;IACH,eAAe,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,oBAAoB,EAAE,OAAO,CAAC;KAC/B;IAYD;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAQ/F;;;;;;OAMG;IACG,UAAU,CACd,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,GAC/C,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAQvC;;;;OAIG;IACG,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;IAK/E;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;CAIhE"}

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

@@ -1,46 +1,64 @@
 /**
- * Feature Flag Provider Factory
+ * Feature Flag Service Factory
  *
- * Factory class for creating and managing feature flag providers.
- * This will be moved to @plyaz/core when the package structure is finalized.
+ * Factory class for creating feature flag services with configured providers.
  *
- * @fileoverview Provider factory for feature flag system
+ * @fileoverview Service 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';
+import type { FeatureFlagConfig, FeatureFlagProvider, FeatureFlagValue, FeatureFlagProviderType } from '@plyaz/types/features';
+import { FeatureFlagService } from '../service';
 /**
- * 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.
+ * Feature flag service factory for creating service instances with providers.
  *
- * @class FeatureFlagProviderFactory
+ * @class FeatureFlagServiceFactory
  *
  * @example
  * ```typescript
- * const provider = FeatureFlagProviderFactory.create({
- *   provider: 'memory',
+ * // Create and initialize service
+ * const service = await FeatureFlagServiceFactory.createAndInitialize({
+ *   provider: 'database',
  *   isCacheEnabled: true,
  *   cacheTtl: 300,
- * });
+ * }, FEATURES);
+ *
+ * // Use the service
+ * const isEnabled = await service.isEnabled('MY_FEATURE');
+ * await service.createFlag({ key: 'NEW', value: true, name: 'New Flag' });
  * ```
  */
+export declare class FeatureFlagServiceFactory {
+    /**
+     * Creates a new feature flag service with the configured provider.
+     *
+     * @param config - Provider configuration
+     * @param features - Record of feature flag keys to their default values
+     * @returns Configured service instance (not yet initialized)
+     */
+    static createService<K extends string>(config: FeatureFlagConfig<K>, features: Record<K, FeatureFlagValue>): FeatureFlagService<K>;
+    /**
+     * Creates and initializes a feature flag service.
+     *
+     * @param config - Provider configuration
+     * @param features - Record of feature flag keys to their default values
+     * @returns Promise resolving to initialized service instance
+     */
+    static createAndInitialize<K extends string>(config: FeatureFlagConfig<K>, features: Record<K, FeatureFlagValue>): Promise<FeatureFlagService<K>>;
+    /**
+     * Creates a default service with memory provider.
+     *
+     * @param features - Record of feature flag keys to their default values
+     * @param overrides - Optional configuration overrides
+     * @returns Service instance
+     */
+    static createDefaultService<K extends string>(features: Record<K, FeatureFlagValue>, overrides?: Partial<FeatureFlagConfig<K>>): FeatureFlagService<K>;
+}
+/**
+ * Feature flag provider factory for creating provider instances directly.
+ * For most use cases, use FeatureFlagServiceFactory instead.
+ *
+ * @class FeatureFlagProviderFactory
+ */
 export declare class FeatureFlagProviderFactory {
     /**
      * Creates a new feature flag provider instance based on configuration.
@@ -64,20 +82,20 @@ export declare class FeatureFlagProviderFactory {
      *
      * @returns Array of supported provider names
      */
-    static getSupportedProviders(): ProviderType[];
+    static getSupportedProviders(): FeatureFlagProviderType[];
     /**
      * 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;
+    static isProviderSupported(providerType: string): providerType is FeatureFlagProviderType;
     /**
      * Gets provider information including implementation status.
      *
      * @returns Record of provider information
      */
-    static getProvidersInfo(): Record<ProviderType, {
+    static getProvidersInfo(): Record<FeatureFlagProviderType, {
         name: string;
         isImplemented: boolean;
         description: string;
@@ -137,5 +155,4 @@ export declare class FeatureFlagProviderFactory {
     private static validateApiConfig;
     private static validateDatabaseConfig;
 }
-export {};
 //# sourceMappingURL=factory.d.ts.map

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

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

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

@@ -7,7 +7,7 @@
  * @fileoverview File provider implementation for feature flags
  * @version 1.0.0
  */
-import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue } from '@plyaz/types';
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue, CreateFlagRequest } from '@plyaz/types';
 import { FeatureFlagProvider } from '../provider';
 /**
  * File-based feature flag provider supporting JSON and YAML formats.
@@ -36,6 +36,7 @@ export declare class FileFeatureFlagProvider<FeatureFlagKey extends string> exte
     private fileWatcher?;
     private lastFileContent?;
     private fileCheckInterval?;
+    private flags;
     private rules;
     /**
      * Creates a new file feature flag provider.
@@ -156,6 +157,52 @@ export declare class FileFeatureFlagProvider<FeatureFlagKey extends string> exte
      * @returns Promise that resolves when refresh is complete
      */
     refresh(): Promise<void>;
+    /**
+     * Creates a new feature flag and persists to file.
+     *
+     * @param data - Flag creation data
+     * @returns The created feature flag
+     */
+    createFlag(data: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Updates an existing feature flag and persists to file.
+     *
+     * @param key - Flag key to update
+     * @param data - Partial flag data to update
+     * @returns The updated feature flag
+     */
+    updateFlag(key: FeatureFlagKey, data: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Deletes a feature flag and persists to file.
+     *
+     * @param key - Flag key to delete
+     */
+    deleteFlag(key: FeatureFlagKey): Promise<void>;
+    /**
+     * Gets all rules for a specific flag.
+     *
+     * @param key - Flag key to get rules for
+     * @returns Array of rules for the flag
+     */
+    getRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /**
+     * Gets all enabled rules.
+     *
+     * @returns Array of all enabled rules
+     */
+    getAllRules(): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /**
+     * Persists current flags and rules to file.
+     *
+     * @private
+     */
+    private persistToFile;
+    /**
+     * Infers the flag type from its value.
+     *
+     * @private
+     */
+    private inferFlagType;
     /**
      * Updates the features object and writes to file.
      * This allows updating the FEATURES at runtime and persisting to file.

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

@@ -1 +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;AAkBlD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,uBAAuB,CAClC,cAAc,SAAS,MAAM,CAC7B,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC3C,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAC,CAAiC;IAC3D,OAAO,CAAC,KAAK,CAAyC;IAEtD;;;;;OAKG;gBAED,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAMpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;;;;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;IAuBF;;;;OAIG;YACW,gBAAgB;IAY9B;;;;OAIG;YACW,oBAAoB;IAoBlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAUjB;;;;;;OAMG;YACW,SAAS;IAWvB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,aAAa;IAkBrB;;;;;;OAMG;YACW,iBAAiB;IAwB/B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAyCxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAef;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0CxF;;;;OAIG;IACH,WAAW,IAAI;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,IAAI,CAAC;KACrB;CAuBF"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/file.ts"],"names":[],"mappings":"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"}

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

@@ -7,7 +7,7 @@
  * @fileoverview Memory provider implementation for feature flags
  * @version 1.0.0
  */
-import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue } from '@plyaz/types';
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue, CreateFlagRequest } from '@plyaz/types';
 import { FeatureFlagProvider } from '../provider';
 /**
  * Memory-based feature flag provider that loads flags from the FEATURES constant.
@@ -100,13 +100,39 @@ export declare class MemoryFeatureFlagProvider<FeatureFlagKey extends string> ex
      */
     removeRule(ruleId: string): void;
     /**
-     * Updates a flag in memory.
+     * Creates a new feature flag in memory.
      *
-     * @param flagOrKey - Either a complete flag object or a flag key
-     * @param value - The new value (only used when first param is a key)
-     * @param updateProps - Optional properties to update (only used when first param is a key)
+     * @param data - Flag creation data
+     * @returns The created feature flag
      */
-    updateFlag(flagOrKey: FeatureFlag<FeatureFlagKey> | FeatureFlagKey, value?: FeatureFlagValue, updateProps?: Partial<Pick<FeatureFlag<FeatureFlagKey>, 'name' | 'description' | 'isEnabled' | 'environment' | 'rolloutPercentage' | 'type'>>): Promise<void>;
+    createFlag(data: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Updates an existing feature flag in memory.
+     *
+     * @param key - Flag key to update
+     * @param data - Partial flag data to update
+     * @returns The updated feature flag
+     */
+    updateFlag(key: FeatureFlagKey, data: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Deletes a feature flag from memory.
+     *
+     * @param key - Flag key to delete
+     */
+    deleteFlag(key: FeatureFlagKey): Promise<void>;
+    /**
+     * Gets all rules for a specific flag.
+     *
+     * @param key - Flag key to get rules for
+     * @returns Array of rules for the flag
+     */
+    getRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /**
+     * Gets all enabled rules.
+     *
+     * @returns Array of all enabled rules
+     */
+    getAllRules(): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
     /**
      * Adds a new flag to memory at runtime.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/memory.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,yBAAyB,CACpC,cAAc,SAAS,MAAM,CAC7B,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,KAAK,CAAyC;IAEtD;;;;;OAKG;gBAED,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,EACzC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAMpD;;;;;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;IAyBF;;;;;;;;OAQG;IACH,OAAO,CAAC,6BAA6B;IAqBrC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,cAAc,CAAC,GAAG,IAAI;IAQpD;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAchC;;;;;;OAMG;IACG,UAAU,CACd,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,cAAc,EACvD,KAAK,CAAC,EAAE,gBAAgB,EACxB,WAAW,CAAC,EAAE,OAAO,CACnB,IAAI,CACF,WAAW,CAAC,cAAc,CAAC,EAC3B,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,CACpF,CACF,GACA,OAAO,CAAC,IAAI,CAAC;IAoDhB;;;;;;OAMG;IACH,OAAO,CACL,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,gBAAgB,EACvB,KAAK,CAAC,EAAE,OAAO,CACb,IAAI,CACF,WAAW,CAAC,cAAc,CAAC,EAC3B,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,CACpF,CACF,GACA,IAAI;IASP;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAcrC;;;;OAIG;IACH,eAAe,IAAI,WAAW,CAAC,cAAc,CAAC,EAAE;IAIhD;;;;OAIG;IACH,eAAe,IAAI,eAAe,CAAC,cAAc,CAAC,EAAE;IAIpD;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;OAIG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,OAAO,CAAC;KACxB;IAUD;;;;OAIG;IACH,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKxC"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/memory.ts"],"names":[],"mappings":"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"}

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

@@ -7,7 +7,7 @@
  * @fileoverview Redis provider implementation for feature flags
  * @version 1.0.0
  */
-import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue } from '@plyaz/types';
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue, CreateFlagRequest } from '@plyaz/types';
 import { FeatureFlagProvider } from '../provider';
 /**
  * Redis-based feature flag provider supporting distributed caching and storage.
@@ -76,5 +76,10 @@ export declare class RedisFeatureFlagProvider<FeatureFlagKey extends string> ext
         requiredImplementation: string[];
         recommendedPatterns: string[];
     };
+    createFlag(_data: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
+    updateFlag(_key: FeatureFlagKey, _data: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
+    deleteFlag(_key: FeatureFlagKey): Promise<void>;
+    getRules(_key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    getAllRules(): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
 }
 //# sourceMappingURL=redis.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/redis.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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,wBAAwB,CACnC,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;;;;;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;IAwCF;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAuBtB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACH,YAAY,IAAI;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B;CAoBF"}
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,wBAAwB,CACnC,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;IAUpD;;;;;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;IAOF;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACH,YAAY,IAAI;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B;IA0BK,UAAU,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAO1F,UAAU,CAEd,IAAI,EAAE,cAAc,EAEpB,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,GAChD,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAQjC,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;IAO1E,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;CAMhE"}

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

@@ -0,0 +1,112 @@
+/**
+ * Feature Flag Service
+ *
+ * Domain service that wraps the provider and provides a unified API
+ * for feature flag operations. This is the main entry point for
+ * feature flag functionality.
+ *
+ * @fileoverview Domain service for feature flags
+ * @version 1.0.0
+ */
+import type { FeatureFlagProvider, FeatureFlagConfig, FeatureFlagContext, FeatureFlagEvaluation, FeatureFlagValue, FeatureFlag, FeatureFlagRule, CreateFlagRequest } from '@plyaz/types';
+/**
+ * Feature Flag Service
+ *
+ * The main service for feature flag operations. Wraps the provider
+ * and adds logging, error handling, and lifecycle management.
+ *
+ * @example
+ * ```typescript
+ * // Create via factory
+ * const service = await FeatureFlagServiceFactory.createAndInitialize(config, FEATURES);
+ *
+ * // Use directly
+ * const isEnabled = await service.isEnabled('MY_FEATURE');
+ * const flag = await service.createFlag({ key: 'NEW_FLAG', value: true, name: 'New Flag' });
+ * ```
+ */
+export declare class FeatureFlagService<FeatureFlagKey extends string> {
+    private readonly provider;
+    private readonly config;
+    private readonly logger;
+    private isInitialized;
+    constructor(provider: FeatureFlagProvider<FeatureFlagKey>, config: FeatureFlagConfig<FeatureFlagKey>);
+    /**
+     * Initializes the service and underlying provider.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Disposes the service and underlying provider.
+     */
+    dispose(): void;
+    /**
+     * Refreshes the provider cache.
+     */
+    refresh(): Promise<void>;
+    /**
+     * Gets whether the service is initialized.
+     */
+    getIsInitialized(): boolean;
+    /**
+     * Gets the provider type.
+     */
+    getProviderType(): string;
+    /**
+     * Evaluates a feature flag.
+     */
+    getFlag(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<FeatureFlagEvaluation<FeatureFlagKey>>;
+    /**
+     * Gets all feature flag evaluations.
+     */
+    getAllFlags(context?: FeatureFlagContext): Promise<Record<string, FeatureFlagEvaluation<FeatureFlagKey>>>;
+    /**
+     * Checks if a feature flag is enabled.
+     */
+    isEnabled(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<boolean>;
+    /**
+     * Gets the value of a feature flag.
+     */
+    getValue<T = FeatureFlagValue>(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<T>;
+    /**
+     * Creates a new feature flag.
+     */
+    createFlag(data: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Updates an existing feature flag.
+     */
+    updateFlag(key: FeatureFlagKey, data: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Deletes a feature flag.
+     */
+    deleteFlag(key: FeatureFlagKey): Promise<void>;
+    /**
+     * Gets all rules for a specific flag.
+     */
+    getRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /**
+     * Gets all enabled rules.
+     */
+    getAllRules(): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /**
+     * Sets a runtime override for a flag.
+     */
+    setOverride(key: FeatureFlagKey, value: FeatureFlagValue): void;
+    /**
+     * Removes a runtime override for a flag.
+     */
+    removeOverride(key: FeatureFlagKey): void;
+    /**
+     * Clears all runtime overrides.
+     */
+    clearOverrides(): void;
+    /**
+     * Subscribes to flag changes.
+     */
+    subscribe(callback: () => void): () => void;
+    /**
+     * Gets the underlying provider instance.
+     * Use with caution - prefer service methods.
+     */
+    getProvider(): FeatureFlagProvider<FeatureFlagKey>;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/domain/featureFlags/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAkB,CAAC,cAAc,SAAS,MAAM;IASzD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IATzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGpB;IAEH,OAAO,CAAC,aAAa,CAAS;gBAGX,QAAQ,EAAE,mBAAmB,CAAC,cAAc,CAAC,EAC7C,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC;IAO5D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,eAAe,IAAI,MAAM;IAQzB;;OAEG;IACG,OAAO,CACX,GAAG,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAIjD;;OAEG;IACG,WAAW,CACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC,CAAC;IAIjE;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpF;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,gBAAgB,EACjC,GAAG,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC;IAQb;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAM/F;;OAEG;IACG,UAAU,CACd,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,GAC/C,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAMvC;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;IAI/E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;IAQ/D;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAK/D;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAKzC;;OAEG;IACH,cAAc,IAAI,IAAI;IAStB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQ3C;;;OAGG;IACH,WAAW,IAAI,mBAAmB,CAAC,cAAc,CAAC;CAGnD"}

package/dist/domain/index.d.ts

@@ -1,6 +1,8 @@
 /**
  * Domain Layer Exports
  */
+export * from './base';
 export * from './featureFlags';
+export * from './example';
 export type * from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,QAAQ,CAAC;AAGvB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,WAAW,CAAC;AAG1B,mBAAmB,SAAS,CAAC"}

package/dist/engine/featureFlags/engine.d.ts

@@ -27,6 +27,8 @@ import type { FeatureFlag, FeatureFlagRule, FeatureFlagContext, FeatureFlagEvalu
 export declare class FeatureFlagEngine<FeatureFlagKey extends string> {
     private defaults;
     private isLoggingEnabled;
+    /** Logger instance */
+    private readonly logger;
     /** Storage for active feature flags */
     private flags;
     /** Storage for targeting rules, organized by flag key */
@@ -54,6 +56,12 @@ export declare class FeatureFlagEngine<FeatureFlagKey extends string> {
      * @param rules - Array of feature flag rules
      */
     setRules(rules: FeatureFlagRule<FeatureFlagKey>[]): void;
+    /**
+     * Gets all targeting rules.
+     *
+     * @returns Array of all feature flag rules
+     */
+    getRules(): FeatureFlagRule<FeatureFlagKey>[];
     /**
      * Sets a manual override for a specific flag.
      * Overrides take precedence over all other evaluation logic.