@plyaz/core 1.2.0 → 1.2.1

package/dist/domain/example/validators/ExampleValidator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Example Validator
+ *
+ * Demonstrates extending BaseValidator for a domain entity.
+ * Uses schemas and types from @plyaz/types/examples.
+ */
+import { BaseValidator } from '../../base';
+import type { CreateExampleDTO, UpdateExampleDTO, PatchExampleDTO, DeleteExampleDTO, QueryExampleDTO } from '@plyaz/types/examples';
+/**
+ * Example Validator implementation
+ *
+ * Supports all HTTP operations:
+ * - create (POST)
+ * - update (PUT)
+ * - patch (PATCH)
+ * - delete (DELETE)
+ * - query (GET)
+ */
+declare class ExampleValidatorClass extends BaseValidator<CreateExampleDTO, UpdateExampleDTO, PatchExampleDTO, DeleteExampleDTO, QueryExampleDTO> {
+    constructor();
+    /**
+     * Custom validation: check if name is not reserved
+     * Use for business logic validation beyond schema validation
+     */
+    validateNameNotReserved(name: string): boolean;
+    /**
+     * Custom validation: check if amount is within budget
+     */
+    validateAmountWithinBudget(amount: number, budget: number): boolean;
+}
+export { ExampleValidatorClass };
+export declare const ExampleValidator: ExampleValidatorClass;
+//# sourceMappingURL=ExampleValidator.d.ts.map

package/dist/domain/example/validators/ExampleValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExampleValidator.d.ts","sourceRoot":"","sources":["../../../../src/domain/example/validators/ExampleValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQ3C,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;GASG;AACH,cAAM,qBAAsB,SAAQ,aAAa,CAC/C,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,CAChB;;IAWC;;;OAGG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK9C;;OAEG;IACH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAGpE;AAGD,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAGjC,eAAO,MAAM,gBAAgB,uBAA8B,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * Feature Flag Domain Service (Frontend)
+ *
+ * Frontend-specific domain service for feature flag management.
+ * Implements FeatureFlagServiceInterface for clean dependency injection.
+ *
+ * @example
+ * ```tsx
+ * // With ServiceRegistry (auto-initialization)
+ * await ServiceRegistry.initialize({
+ *   services: [{ service: FeatureFlagDomainService, config: { cacheTtl: 300 } }],
+ * });
+ * const service = ServiceRegistry.get<FeatureFlagServiceInterface>('featureFlags');
+ *
+ * // Manual creation with provider
+ * const service = new FeatureFlagDomainService({
+ *   provider,
+ *   store: useFeatureFlagStore.getState(),
+ * });
+ * await service.fetchAndSyncAll({ userId: user.id });
+ * ```
+ */
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagContext, FeatureFlagValue, FeatureFlagEvaluation, CreateFlagRequest } from '@plyaz/types';
+import { BaseFrontendDomainService } from '../base';
+import type { CoreFrontendFeatureFlagEventType, CoreFeatureFlagStore, CoreFeatureFlagServiceConfig, CoreFeatureFlagServiceInitConfig, CoreFeatureFlagServiceInterface, CoreServiceCreateOptions } from '@plyaz/types/core';
+/**
+ * Feature Flag Domain Service (Frontend)
+ *
+ * Frontend-specific domain service for feature flag management.
+ * Implements FeatureFlagServiceInterface for clean dependency injection.
+ *
+ * @example
+ * ```tsx
+ * // With ServiceRegistry (auto-initialization)
+ * await ServiceRegistry.initialize({
+ *   services: [{ service: FeatureFlagDomainService, config: { cacheTtl: 300 } }],
+ * });
+ * const service = ServiceRegistry.get<FeatureFlagServiceInterface>('featureFlags');
+ *
+ * // Manual creation with provider
+ * const service = new FeatureFlagDomainService({
+ *   provider,
+ *   store: useFeatureFlagStore.getState(),
+ * });
+ * await service.fetchAndSyncAll({ userId: user.id });
+ * ```
+ */
+export declare class FrontendFeatureFlagDomainService extends BaseFrontendDomainService<CoreFeatureFlagServiceConfig, CoreFeatureFlagStore, Record<string, FeatureFlagValue>> implements CoreFeatureFlagServiceInterface {
+    static readonly serviceKey: "featureFlags";
+    /** Build API client for feature flags */
+    private static buildApiClient;
+    /** Build feature flag provider */
+    private static buildProvider;
+    /**
+     * Factory method for ServiceRegistry auto-initialization.
+     */
+    static create(config: CoreFeatureFlagServiceInitConfig, options?: CoreServiceCreateOptions): Promise<FrontendFeatureFlagDomainService>;
+    /**
+     * Event prefix for all events emitted by this service
+     * Required by BaseFrontendDomainService
+     */
+    protected eventPrefix: string;
+    private readonly provider;
+    constructor(config: CoreFeatureFlagServiceConfig);
+    isAvailable(): boolean;
+    dispose(): void;
+    refresh(): Promise<void>;
+    evaluate<TKey extends string = string>(key: TKey, context?: FeatureFlagContext): Promise<FeatureFlagEvaluation<TKey>>;
+    isEnabled<TKey extends string = string>(key: TKey, context?: FeatureFlagContext): Promise<boolean>;
+    getValue<T = FeatureFlagValue, TKey extends string = string>(key: TKey, context?: FeatureFlagContext): Promise<T>;
+    evaluateAll<TKey extends string = string>(context?: FeatureFlagContext): Promise<Record<string, FeatureFlagEvaluation<TKey>>>;
+    fetchAndSyncAll(context?: FeatureFlagContext): Promise<Record<string, FeatureFlagValue>>;
+    createFlag<TKey extends string = string>(data: CreateFlagRequest<TKey>): Promise<FeatureFlag<TKey>>;
+    updateFlag<TKey extends string = string>(key: TKey, data: Partial<CreateFlagRequest<TKey>>): Promise<FeatureFlag<TKey>>;
+    deleteFlag<TKey extends string = string>(key: TKey): Promise<void>;
+    getRules<TKey extends string = string>(key: TKey): Promise<FeatureFlagRule<TKey>[]>;
+    getAllRules<TKey extends string = string>(): Promise<FeatureFlagRule<TKey>[]>;
+    setOverride<TKey extends string = string>(key: TKey, value: FeatureFlagValue): void;
+    removeOverride<TKey extends string = string>(key: TKey): void;
+    clearOverrides(): void;
+    subscribe(callback: () => void): () => void;
+    on(event: CoreFrontendFeatureFlagEventType, handler: (data: unknown) => void): () => void;
+    protected syncToStores(flags: Record<string, FeatureFlagValue>, replace?: boolean): void;
+    private toValues;
+}
+//# sourceMappingURL=FrontendFeatureFlagDomainService.d.ts.map

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

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

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

@@ -2,21 +2,25 @@
  * 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 { createFeatureFlagService, FEATURE_FLAG_SERVICE } from './module';
+export { FeatureFlagService } from './service';
+export { FrontendFeatureFlagDomainService } from './FrontendFeatureFlagDomainService';
+export { FeatureFlagServiceFactory } from './providers/factory';
 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';
+export { FeatureFlagDatabaseRepository } from '@models/featureFlags';
+export * from './mappers';
 /**
  * Default configuration for feature flags.
  * Provides sensible defaults for most use cases.
@@ -31,19 +35,20 @@ export declare const DEFAULT_FEATURE_FLAG_CONFIG: {
 };
 /**
  * Feature flag system initialization for different environments.
+ * Returns a FeatureFlagService instance for all 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">>;
+    readonly initializeForFrontend: (config?: Partial<FeatureFlagConfig<FeatureFlagKey>>) => Promise<import("./service").FeatureFlagService<"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">>;
+    readonly initializeForBackend: (config?: Partial<FeatureFlagConfig<FeatureFlagKey>>) => Promise<import("./service").FeatureFlagService<"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">>;
+    readonly initializeForTesting: (overrides?: FeatureFlagOverrides<FeatureFlagKey>) => Promise<import("./service").FeatureFlagService<"AUTH_GOOGLE" | "AUTH_DISCORD" | "AUTH_FACEBOOK" | "AUTH_GITHUB">>;
 };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/featureFlags/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAG1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAGtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGjE,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;AAGnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAGrE,cAAc,WAAW,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;CAOuB,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;8CACmC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAQhF;;OAEG;6CACkC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAQ/E;;OAEG;gDACqC,oBAAoB,CAAC,cAAc,CAAC;CAkBpE,CAAC"}

package/dist/domain/featureFlags/mappers/FeatureFlagMapper.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Feature Flag Mapper
+ *
+ * Handles transformation between different feature flag data representations:
+ * - API Response (DTO) → Domain Entity
+ * - Domain Entity → Store State
+ * - Domain → API Request (DTO)
+ *
+ * @fileoverview Feature flag data mapper
+ * @version 1.0.0
+ */
+import { BaseMapper } from '../../base/BaseMapper';
+import type { FeatureFlag, FeatureFlagValue, FeatureFlagRule, FeatureFlagEvaluation, CreateFlagRequest, FetchFeatureFlagDataResponse, FeatureFlagStoreState, FeatureFlagResponseDTO, FeatureFlagRuleDTO, FeatureFlagEvaluationDTO, FetchAllFlagsResponseDTO } from '@plyaz/types/features';
+export type { FeatureFlagResponseDTO, FeatureFlagRuleDTO, FeatureFlagEvaluationDTO, FetchAllFlagsResponseDTO, } from '@plyaz/types/features';
+/**
+ * Feature Flag Mapper
+ *
+ * Transforms feature flag data between API, domain, and store representations.
+ */
+export declare class FeatureFlagMapper extends BaseMapper<FeatureFlag<string>, FeatureFlagResponseDTO, unknown, unknown, Partial<unknown>, unknown, Partial<FeatureFlagStoreState>> {
+    /**
+     * Transform API response DTO to domain entity
+     */
+    toDomain(dto: FeatureFlagResponseDTO): FeatureFlag<string>;
+    /**
+     * Transform domain entity to API request DTO
+     */
+    toCreateDTO(entity: Partial<FeatureFlag<string>>): CreateFlagRequest<string>;
+    /**
+     * Transform domain entity to patch request DTO
+     */
+    toPatchDTO(entity: Partial<FeatureFlag<string>>): Partial<CreateFlagRequest<string>>;
+    /**
+     * Transform API rule DTO to domain rule
+     */
+    toRuleDomain(dto: FeatureFlagRuleDTO): FeatureFlagRule<string>;
+    /**
+     * Transform API evaluation DTO to domain evaluation
+     */
+    toEvaluationDomain(dto: FeatureFlagEvaluationDTO): FeatureFlagEvaluation<string>;
+    /**
+     * Transform API fetch response to domain response
+     */
+    toFetchDataResponse(dto: FetchAllFlagsResponseDTO): FetchFeatureFlagDataResponse<string>;
+    /**
+     * Transform single domain flag to partial store state format
+     * Returns partial state that can be merged with existing store state
+     */
+    toStoreState(flag: FeatureFlag<string>): Partial<FeatureFlagStoreState>;
+    /**
+     * Transform domain flags array to store state format
+     */
+    toStoreStateList(flags: FeatureFlag<string>[]): Partial<FeatureFlagStoreState>;
+    /**
+     * Transform evaluation results to store flags format
+     */
+    evaluationsToStoreFlags(evaluations: Record<string, FeatureFlagEvaluation<string>>): Record<string, FeatureFlagValue>;
+    /**
+     * Transform simple flags record to domain flags array
+     * (for providers that return simple key-value pairs)
+     */
+    simpleFlagsToDomain(flags: Record<string, FeatureFlagValue>, environment?: string): FeatureFlag<string>[];
+    /**
+     * Infer flag type from value
+     */
+    private inferType;
+}
+/**
+ * Singleton instance for convenience
+ */
+export declare const featureFlagMapper: FeatureFlagMapper;
+//# sourceMappingURL=FeatureFlagMapper.d.ts.map

package/dist/domain/featureFlags/mappers/FeatureFlagMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagMapper.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/mappers/FeatureFlagMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,EAGrB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,UAAU,CAC/C,WAAW,CAAC,MAAM,CAAC,EACnB,sBAAsB,EACtB,OAAO,EACP,OAAO,EACP,OAAO,CAAC,OAAO,CAAC,EAChB,OAAO,EACP,OAAO,CAAC,qBAAqB,CAAC,CAC/B;IACC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,sBAAsB,GAAG,WAAW,CAAC,MAAM,CAAC;IAmB1D;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAY5E;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAapF;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,kBAAkB,GAAG,eAAe,CAAC,MAAM,CAAC;IAkB9D;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,wBAAwB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IAYhF;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,wBAAwB,GAAG,4BAA4B,CAAC,MAAM,CAAC;IAOxF;;;OAGG;IACM,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAahF;;OAEG;IACM,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAsBvF;;OAEG;IACH,uBAAuB,CACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,GACzD,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAUnC;;;OAGG;IACH,mBAAmB,CACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACvC,WAAW,GAAE,MAAqB,GACjC,WAAW,CAAC,MAAM,CAAC,EAAE;IAkBxB;;OAEG;IACH,OAAO,CAAC,SAAS;CAMlB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Feature Flag Mappers
+ *
+ * @fileoverview Mapper exports for feature flags
+ * @version 1.0.0
+ */
+export { FeatureFlagMapper, featureFlagMapper, type FeatureFlagResponseDTO, type FeatureFlagRuleDTO, type FeatureFlagEvaluationDTO, type FetchAllFlagsResponseDTO, } from './FeatureFlagMapper';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/mappers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Feature Flag Module - Shared Service Factory
+ *
+ * Provides the service factory used by the NestJS FeatureFlagModule.
+ * For NestJS usage, import from '@plyaz/core/backend/featureFlags'.
+ */
+import type { CoreFeatureFlagModuleConfig } from '@plyaz/types/core';
+import type { FeatureFlagService } from './service';
+import type { FeatureFlagKey } from '../types';
+/**
+ * Injection token for NestJS DI
+ */
+export declare const FEATURE_FLAG_SERVICE = "FEATURE_FLAG_SERVICE";
+/**
+ * Creates the FeatureFlagService
+ * Used by NestJS FeatureFlagModule internally
+ */
+export declare function createFeatureFlagService(config?: CoreFeatureFlagModuleConfig): Promise<FeatureFlagService<FeatureFlagKey>>;
+export { FeatureFlagService } from './service';
+//# sourceMappingURL=module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/domain/featureFlags/module.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAwG/C;;GAEG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,GAAE,2BAA2C,GAClD,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAM7C;AAGD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

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

@@ -7,7 +7,7 @@
  * @fileoverview Core feature flag provider implementation
  * @version 1.0.0
  */
-import type { FeatureFlagProvider as IFeatureFlagProvider, FeatureFlagConfig, FeatureFlagContext, FeatureFlagEvaluation, FeatureFlagValue, FetchFeatureFlagDataResponse } from '@plyaz/types';
+import type { FeatureFlagProvider as IFeatureFlagProvider, FeatureFlagConfig, FeatureFlagContext, FeatureFlagEvaluation, FeatureFlagValue, FetchFeatureFlagDataResponse, FeatureFlag, FeatureFlagRule, CreateFlagRequest } from '@plyaz/types';
 import { FeatureFlagEngine } from '@engine/featureFlags/engine';
 import { CacheManager } from '@base/cache/index';
 /**
@@ -134,6 +134,45 @@ export declare abstract class FeatureFlagProvider<FeatureFlagKey extends string>
      * Disposes of the provider, cleaning up resources.
      */
     dispose(): void;
+    /**
+     * Creates a new feature flag.
+     * Abstract - each provider implements based on its storage backend.
+     *
+     * @param data - Flag creation data
+     * @returns The created feature flag
+     */
+    abstract createFlag(data: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Updates an existing feature flag.
+     * Abstract - each provider implements based on its storage backend.
+     *
+     * @param key - Flag key to update
+     * @param data - Partial flag data to update
+     * @returns The updated feature flag
+     */
+    abstract updateFlag(key: FeatureFlagKey, data: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Deletes a feature flag.
+     * Abstract - each provider implements based on its storage backend.
+     *
+     * @param key - Flag key to delete
+     */
+    abstract deleteFlag(key: FeatureFlagKey): Promise<void>;
+    /**
+     * Gets all rules for a specific flag.
+     * Abstract - each provider implements based on its storage backend.
+     *
+     * @param key - Flag key to get rules for
+     * @returns Array of rules for the flag
+     */
+    abstract getRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /**
+     * Gets all enabled rules across all flags.
+     * Abstract - each provider implements based on its storage backend.
+     *
+     * @returns Array of all enabled rules
+     */
+    abstract getAllRules(): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
     /**
      * Optional method to sync features at runtime.
      * This is useful for providers that can update their features dynamically.

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

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

@@ -1,47 +1,65 @@
 /**
- * API Feature Flag Provider (Stub)
+ * API Feature Flag Provider
  *
- * API-based provider stub that requires @plyaz/api package implementation.
- * This will be moved to @plyaz/core when the package structure is finalized.
+ * Provider adapter that uses @plyaz/api services with an injected API client
+ * to fetch feature flags from a remote API. This provider extends the base
+ * FeatureFlagProvider and implements fetchData() using the API services.
  *
- * @fileoverview API provider stub for feature flags
- * @version 1.0.0
+ * @fileoverview API provider adapter for feature flags
+ * @version 2.0.0
  */
-import type { FeatureFlag, FeatureFlagRule, FeatureFlagConfig, FeatureFlagValue } from '@plyaz/types';
+import type { FeatureFlag, FeatureFlagRule, FeatureFlagValue, CreateFlagRequest } from '@plyaz/types';
 import { FeatureFlagProvider } from '../provider';
+import type { ServiceOptions } from '@plyaz/types/api';
+import type { ApiFeatureFlagConfig as _ApiFeatureFlagConfig } from '@plyaz/types/features';
+type ApiClientType = NonNullable<ServiceOptions['apiClient']>;
 /**
- * API-based feature flag provider requiring @plyaz/api implementation.
+ * API-based feature flag provider
+ *
+ * Uses @plyaz/api services with an injected API client to communicate with the backend.
+ * Pass your configured API client via the config.
  *
  * @class ApiFeatureFlagProvider
  * @extends {FeatureFlagProvider}
  *
  * @example
  * ```typescript
- * // This will throw an error until @plyaz/api is implemented
+ * // Get client from ApiClientService
+ * const apiClient = ApiClientService.getClient();
+ *
  * const provider = new ApiFeatureFlagProvider({
  *   provider: 'api',
- *   apiEndpoint: 'https://api.plyaz.co.uk',
- *   apiKey: process.env.FEATURE_FLAG_API_KEY,
+ *   apiClient,
  *   isCacheEnabled: true,
  *   cacheTtl: 300,
- * });
+ * }, FEATURES);
+ *
+ * await provider.initialize();
+ * const isEnabled = await provider.isEnabled('new-feature');
  * ```
  */
 export declare class ApiFeatureFlagProvider<FeatureFlagKey extends string> extends FeatureFlagProvider<FeatureFlagKey> {
+    protected readonly apiClient: ApiClientType;
     /**
      * Creates a new API feature flag provider.
      *
-     * @param config - Provider configuration with API settings
-     * @throws Error indicating that @plyaz/api implementation is required
+     * @param config - Provider configuration with API client
+     * @param features - Record of feature flag keys to default values
+     */
+    constructor(config: _ApiFeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>);
+    /**
+     * Get service options with injected client
      */
-    constructor(config: FeatureFlagConfig<FeatureFlagKey>, features: Record<FeatureFlagKey, FeatureFlagValue>);
+    private getServiceOptions;
+    /** Wrap error in CorePackageError if not already a package error */
+    private wrapError;
+    /** Transform API response to flags/rules */
+    private transformResponse;
     /**
-     * Fetches flags and rules from the API endpoint.
-     * Currently throws an error as the API implementation is not ready.
+     * Fetches flags and rules from the API endpoint using @plyaz/api services.
      *
      * @protected
-     * @returns Promise that rejects with implementation error
-     * @throws Error indicating missing API implementation
+     * @returns Promise resolving to flags and rules data
      */
     protected fetchData(): Promise<{
         flags: FeatureFlag<FeatureFlagKey>[];
@@ -51,28 +69,35 @@ export declare class ApiFeatureFlagProvider<FeatureFlagKey extends string> exten
      * 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;
+        hasApiClient: boolean;
     };
+    /**
+     * Creates a new feature flag via API
+     */
+    createFlag(data: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Updates a feature flag via API
+     */
+    updateFlag(key: FeatureFlagKey, data: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /**
+     * Deletes a feature flag via API
+     */
+    deleteFlag(key: FeatureFlagKey): Promise<void>;
+    /**
+     * Gets rules for a specific flag via API
+     */
+    getRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /**
+     * Gets all rules via API
+     * Note: This requires fetching rules for all flags individually or a dedicated endpoint
+     */
+    getAllRules(): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
 }
+export {};
 //# sourceMappingURL=api.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/domain/featureFlags/providers/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAUlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,IAAI,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG3F,KAAK,aAAa,GAAG,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;AAU9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,sBAAsB,CACjC,cAAc,SAAS,MAAM,CAC7B,SAAQ,mBAAmB,CAAC,cAAc,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAE5C;;;;;OAKG;gBAED,MAAM,EAAE,qBAAqB,CAAC,cAAc,CAAC,EAC7C,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAepD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB,oEAAoE;IACpE,OAAO,CAAC,SAAS;IAajB,4CAA4C;IAC5C,OAAO,CAAC,iBAAiB;IAUzB;;;;;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;IAsBF;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,UAAU,IAAI;QACZ,YAAY,EAAE,OAAO,CAAC;KACvB;IAUD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAoB/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;IAcvC;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;IAa/E;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;CAKhE"}