@nestarc/feature-flag 0.1.0 → 0.3.0

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FEATURE_FLAG_MODULE_OPTIONS = exports.FeatureFlagEvents = exports.BypassFeatureFlag = exports.FeatureFlag = exports.FeatureFlagGuard = exports.FlagContext = exports.FeatureFlagService = exports.FeatureFlagModule = void 0;
+exports.FeatureFlagAdminModule = exports.PrismaFeatureFlagRepository = exports.RedisCacheAdapter = exports.MemoryCacheAdapter = exports.TENANT_CONTEXT_PROVIDER = exports.FEATURE_FLAG_REPOSITORY = exports.CACHE_ADAPTER = exports.FEATURE_FLAG_MODULE_OPTIONS = exports.FeatureFlagEvents = exports.BypassFeatureFlag = exports.FeatureFlag = exports.FeatureFlagGuard = exports.FlagContext = exports.FeatureFlagService = exports.FeatureFlagModule = void 0;
 // Module
 var feature_flag_module_1 = require("./feature-flag.module");
 Object.defineProperty(exports, "FeatureFlagModule", { enumerable: true, get: function () { return feature_flag_module_1.FeatureFlagModule; } });
@@ -23,4 +23,16 @@ Object.defineProperty(exports, "FeatureFlagEvents", { enumerable: true, get: fun
 // Constants
 var feature_flag_constants_1 = require("./feature-flag.constants");
 Object.defineProperty(exports, "FEATURE_FLAG_MODULE_OPTIONS", { enumerable: true, get: function () { return feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS; } });
+Object.defineProperty(exports, "CACHE_ADAPTER", { enumerable: true, get: function () { return feature_flag_constants_1.CACHE_ADAPTER; } });
+Object.defineProperty(exports, "FEATURE_FLAG_REPOSITORY", { enumerable: true, get: function () { return feature_flag_constants_1.FEATURE_FLAG_REPOSITORY; } });
+Object.defineProperty(exports, "TENANT_CONTEXT_PROVIDER", { enumerable: true, get: function () { return feature_flag_constants_1.TENANT_CONTEXT_PROVIDER; } });
+var memory_cache_adapter_1 = require("./cache/memory-cache.adapter");
+Object.defineProperty(exports, "MemoryCacheAdapter", { enumerable: true, get: function () { return memory_cache_adapter_1.MemoryCacheAdapter; } });
+var redis_cache_adapter_1 = require("./cache/redis-cache.adapter");
+Object.defineProperty(exports, "RedisCacheAdapter", { enumerable: true, get: function () { return redis_cache_adapter_1.RedisCacheAdapter; } });
+var prisma_feature_flag_repository_1 = require("./repositories/prisma-feature-flag.repository");
+Object.defineProperty(exports, "PrismaFeatureFlagRepository", { enumerable: true, get: function () { return prisma_feature_flag_repository_1.PrismaFeatureFlagRepository; } });
+// Admin module
+var feature_flag_admin_module_1 = require("./admin/feature-flag-admin.module");
+Object.defineProperty(exports, "FeatureFlagAdminModule", { enumerable: true, get: function () { return feature_flag_admin_module_1.FeatureFlagAdminModule; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,SAAS;AACT,6DAA2H;AAAlH,wHAAA,iBAAiB,OAAA;AAE1B,WAAW;AACX,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAC3B,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AAEpB,QAAQ;AACR,kEAA+D;AAAtD,sHAAA,gBAAgB,OAAA;AAEzB,aAAa;AACb,8EAAkE;AAAzD,qHAAA,WAAW,OAAA;AACpB,4FAA+E;AAAtE,kIAAA,iBAAiB,OAAA;AAkB1B,SAAS;AACT,oEAKsC;AAJpC,wHAAA,iBAAiB,OAAA;AAMnB,YAAY;AACZ,mEAAuE;AAA9D,qIAAA,2BAA2B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,SAAS;AACT,6DAA2H;AAAlH,wHAAA,iBAAiB,OAAA;AAE1B,WAAW;AACX,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAC3B,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AAEpB,QAAQ;AACR,kEAA+D;AAAtD,sHAAA,gBAAgB,OAAA;AAEzB,aAAa;AACb,8EAAkE;AAAzD,qHAAA,WAAW,OAAA;AACpB,4FAA+E;AAAtE,kIAAA,iBAAiB,OAAA;AAqB1B,SAAS;AACT,oEAKsC;AAJpC,wHAAA,iBAAiB,OAAA;AAMnB,YAAY;AACZ,mEAKkC;AAJhC,qIAAA,2BAA2B,OAAA;AAC3B,uHAAA,aAAa,OAAA;AACb,iIAAA,uBAAuB,OAAA;AACvB,iIAAA,uBAAuB,OAAA;AAKzB,qEAAkE;AAAzD,0HAAA,kBAAkB,OAAA;AAC3B,mEAA+F;AAAtF,wHAAA,iBAAiB,OAAA;AAQ1B,gGAA4F;AAAnF,6IAAA,2BAA2B,OAAA;AAKpC,eAAe;AACf,+EAA2E;AAAlE,mIAAA,sBAAsB,OAAA"}

package/dist/interfaces/cache-adapter.interface.d.ts

@@ -0,0 +1,9 @@
+import { FeatureFlagWithOverrides } from './feature-flag.interface';
+export interface CacheAdapter {
+    get(key: string): Promise<FeatureFlagWithOverrides | null>;
+    set(key: string, data: FeatureFlagWithOverrides, ttlMs: number): Promise<void>;
+    getAll(): Promise<FeatureFlagWithOverrides[] | null>;
+    setAll(data: FeatureFlagWithOverrides[], ttlMs: number): Promise<void>;
+    invalidate(key?: string): Promise<void>;
+    onModuleDestroy?(): Promise<void>;
+}

package/dist/interfaces/cache-adapter.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cache-adapter.interface.js.map

package/dist/interfaces/cache-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-adapter.interface.js","sourceRoot":"","sources":["../../src/interfaces/cache-adapter.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/evaluation-context.interface.d.ts

@@ -1,8 +1,11 @@
+import { TargetingAttributes } from './feature-flag.interface';
 export interface EvaluationContext {
-    /** User ID — used for user overrides and percentage hash */
+    /** User ID - used for user-scoped targeting and percentage hash */
     userId?: string | null;
-    /** Tenant ID — used for tenant overrides. Ignored if tenancy is not installed */
+    /** Tenant ID - used for tenant-scoped targeting. Ignored if tenancy is not installed */
     tenantId?: string | null;
-    /** Environment — auto-injected from module options. Can be explicitly overridden */
+    /** Environment - auto-injected from module options. Can be explicitly overridden */
     environment?: string;
+    /** Additional exact-match targeting attributes */
+    attributes?: TargetingAttributes;
 }

package/dist/interfaces/feature-flag-options.interface.d.ts

@@ -1,5 +1,6 @@
 import { ModuleMetadata, Type } from '@nestjs/common';
 import { Request } from 'express';
+import { CacheAdapter } from './cache-adapter.interface';
 export interface FeatureFlagModuleOptions {
     /** Current environment (e.g., 'development', 'staging', 'production') */
     environment: string;
@@ -11,6 +12,8 @@ export interface FeatureFlagModuleOptions {
     defaultOnMissing?: boolean;
     /** Emit evaluation events via @nestjs/event-emitter. Default: false */
     emitEvents?: boolean;
+    /** Custom cache adapter implementation. If not provided, an in-memory cache is used. */
+    cacheAdapter?: CacheAdapter;
 }
 export interface FeatureFlagModuleOptionsFactory {
     createFeatureFlagOptions(): Promise<FeatureFlagModuleOptions & {

package/dist/interfaces/feature-flag-repository.interface.d.ts

@@ -0,0 +1,22 @@
+import { CreateFeatureFlagInput, UpdateFeatureFlagInput, FeatureFlagWithOverrides, TargetingAttributes } from './feature-flag.interface';
+export interface OverrideCriteria {
+    attributes: TargetingAttributes;
+}
+export interface UpdateOverrideInput {
+    enabled: boolean;
+    priority: number;
+}
+export interface FeatureFlagRepository {
+    createFlag(input: CreateFeatureFlagInput): Promise<FeatureFlagWithOverrides>;
+    updateFlag(key: string, input: UpdateFeatureFlagInput): Promise<FeatureFlagWithOverrides>;
+    archiveFlag(key: string): Promise<FeatureFlagWithOverrides>;
+    findFlagByKey(key: string): Promise<FeatureFlagWithOverrides | null>;
+    findFlagIdByKey(key: string): Promise<string | null>;
+    findAllActiveFlags(): Promise<FeatureFlagWithOverrides[]>;
+    findOverride(flagId: string, criteria: OverrideCriteria): Promise<{
+        id: string;
+    } | null>;
+    createOverride(flagId: string, criteria: OverrideCriteria, enabled: boolean, priority: number): Promise<void>;
+    updateOverride(id: string, input: UpdateOverrideInput): Promise<void>;
+    deleteOverride(id: string): Promise<void>;
+}

package/dist/interfaces/feature-flag-repository.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=feature-flag-repository.interface.js.map

package/dist/interfaces/feature-flag-repository.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-repository.interface.js","sourceRoot":"","sources":["../../src/interfaces/feature-flag-repository.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/feature-flag.interface.d.ts

@@ -1,3 +1,5 @@
+export type TargetingAttributeValue = string | number | boolean | null;
+export type TargetingAttributes = Record<string, TargetingAttributeValue>;
 export interface CreateFeatureFlagInput {
     key: string;
     description?: string;
@@ -12,10 +14,9 @@ export interface UpdateFeatureFlagInput {
     metadata?: Record<string, unknown>;
 }
 export interface SetOverrideInput {
-    tenantId?: string;
-    userId?: string;
-    environment?: string;
+    attributes: TargetingAttributes;
     enabled: boolean;
+    priority?: number;
 }
 export interface FeatureFlagGuardOptions {
     /** HTTP status code when flag is OFF. Default: 403 */
@@ -38,8 +39,12 @@ export interface FeatureFlagWithOverrides {
 export interface FlagOverride {
     id: string;
     flagId: string;
-    tenantId: string | null;
-    userId: string | null;
-    environment: string | null;
+    attributes: TargetingAttributes;
+    priority: number;
     enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RemoveOverrideInput {
+    attributes: TargetingAttributes;
 }

package/dist/interfaces/tenant-context-provider.interface.d.ts

@@ -0,0 +1,3 @@
+export interface TenantContextProvider {
+    getCurrentTenantId(): string | null;
+}

package/dist/interfaces/tenant-context-provider.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tenant-context-provider.interface.js.map

package/dist/interfaces/tenant-context-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-context-provider.interface.js","sourceRoot":"","sources":["../../src/interfaces/tenant-context-provider.interface.ts"],"names":[],"mappings":""}

package/dist/repositories/prisma-feature-flag.repository.d.ts

@@ -0,0 +1,18 @@
+import { FeatureFlagRepository, OverrideCriteria, UpdateOverrideInput } from '../interfaces/feature-flag-repository.interface';
+import { CreateFeatureFlagInput, UpdateFeatureFlagInput, FeatureFlagWithOverrides } from '../interfaces/feature-flag.interface';
+export declare class PrismaFeatureFlagRepository implements FeatureFlagRepository {
+    private readonly prisma;
+    constructor(prisma: any);
+    createFlag(input: CreateFeatureFlagInput): Promise<FeatureFlagWithOverrides>;
+    updateFlag(key: string, input: UpdateFeatureFlagInput): Promise<FeatureFlagWithOverrides>;
+    archiveFlag(key: string): Promise<FeatureFlagWithOverrides>;
+    findFlagByKey(key: string): Promise<FeatureFlagWithOverrides | null>;
+    findFlagIdByKey(key: string): Promise<string | null>;
+    findAllActiveFlags(): Promise<FeatureFlagWithOverrides[]>;
+    findOverride(flagId: string, criteria: OverrideCriteria): Promise<{
+        id: string;
+    } | null>;
+    createOverride(flagId: string, criteria: OverrideCriteria, enabled: boolean, priority: number): Promise<void>;
+    updateOverride(id: string, input: UpdateOverrideInput): Promise<void>;
+    deleteOverride(id: string): Promise<void>;
+}

package/dist/repositories/prisma-feature-flag.repository.js

@@ -0,0 +1,161 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaFeatureFlagRepository = void 0;
+const common_1 = require("@nestjs/common");
+function isPrismaError(error, code) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === code);
+}
+let PrismaFeatureFlagRepository = class PrismaFeatureFlagRepository {
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    async createFlag(input) {
+        const percentage = input.percentage ?? 0;
+        if (percentage < 0 || percentage > 100) {
+            throw new common_1.BadRequestException(`percentage must be between 0 and 100, got ${percentage}`);
+        }
+        try {
+            return await this.prisma.featureFlag.create({
+                data: {
+                    key: input.key,
+                    description: input.description,
+                    enabled: input.enabled ?? false,
+                    percentage,
+                    metadata: input.metadata ?? {},
+                },
+                include: { overrides: true },
+            });
+        }
+        catch (error) {
+            if (isPrismaError(error, 'P2002')) {
+                throw new common_1.ConflictException(`Feature flag "${input.key}" already exists`);
+            }
+            throw error;
+        }
+    }
+    async updateFlag(key, input) {
+        if (input.percentage !== undefined && (input.percentage < 0 || input.percentage > 100)) {
+            throw new common_1.BadRequestException(`percentage must be between 0 and 100, got ${input.percentage}`);
+        }
+        try {
+            return await this.prisma.featureFlag.update({
+                where: { key },
+                data: {
+                    ...(input.description !== undefined && { description: input.description }),
+                    ...(input.enabled !== undefined && { enabled: input.enabled }),
+                    ...(input.percentage !== undefined && { percentage: input.percentage }),
+                    ...(input.metadata !== undefined && { metadata: input.metadata }),
+                },
+                include: { overrides: true },
+            });
+        }
+        catch (error) {
+            if (isPrismaError(error, 'P2025')) {
+                throw new common_1.NotFoundException(`Feature flag "${key}" not found`);
+            }
+            throw error;
+        }
+    }
+    async archiveFlag(key) {
+        try {
+            return await this.prisma.featureFlag.update({
+                where: { key },
+                data: { archivedAt: new Date() },
+                include: { overrides: true },
+            });
+        }
+        catch (error) {
+            if (isPrismaError(error, 'P2025')) {
+                throw new common_1.NotFoundException(`Feature flag "${key}" not found`);
+            }
+            throw error;
+        }
+    }
+    async findFlagByKey(key) {
+        return this.prisma.featureFlag.findUnique({
+            where: { key },
+            include: { overrides: true },
+        });
+    }
+    async findFlagIdByKey(key) {
+        const flag = await this.prisma.featureFlag.findUnique({ where: { key } });
+        return flag?.id ?? null;
+    }
+    async findAllActiveFlags() {
+        return this.prisma.featureFlag.findMany({
+            where: { archivedAt: null },
+            include: { overrides: true },
+            orderBy: { createdAt: 'desc' },
+        });
+    }
+    async findOverride(flagId, criteria) {
+        return this.prisma.featureFlagOverride.findFirst({
+            where: {
+                flagId,
+                attributes: { equals: criteria.attributes },
+            },
+            select: { id: true },
+        });
+    }
+    async createOverride(flagId, criteria, enabled, priority) {
+        try {
+            await this.prisma.featureFlagOverride.create({
+                data: {
+                    flagId,
+                    attributes: criteria.attributes,
+                    priority,
+                    enabled,
+                },
+            });
+        }
+        catch (error) {
+            if (isPrismaError(error, 'P2002')) {
+                const existing = await this.findOverride(flagId, criteria);
+                if (existing) {
+                    await this.updateOverride(existing.id, { enabled, priority });
+                    return;
+                }
+            }
+            throw error;
+        }
+    }
+    async updateOverride(id, input) {
+        await this.prisma.featureFlagOverride.update({
+            where: { id },
+            data: {
+                enabled: input.enabled,
+                priority: input.priority,
+            },
+        });
+    }
+    async deleteOverride(id) {
+        try {
+            await this.prisma.featureFlagOverride.delete({ where: { id } });
+        }
+        catch (error) {
+            if (isPrismaError(error, 'P2025')) {
+                // Already deleted by a concurrent request — idempotent
+                return;
+            }
+            throw error;
+        }
+    }
+};
+exports.PrismaFeatureFlagRepository = PrismaFeatureFlagRepository;
+exports.PrismaFeatureFlagRepository = PrismaFeatureFlagRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Object])
+], PrismaFeatureFlagRepository);
+//# sourceMappingURL=prisma-feature-flag.repository.js.map

package/dist/repositories/prisma-feature-flag.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-feature-flag.repository.js","sourceRoot":"","sources":["../../src/repositories/prisma-feature-flag.repository.ts"],"names":[],"mappings":"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"}

package/dist/services/default-tenant-context-provider.d.ts

@@ -0,0 +1,7 @@
+import { ModuleRef } from '@nestjs/core';
+import { TenantContextProvider } from '../interfaces/tenant-context-provider.interface';
+export declare class DefaultTenantContextProvider implements TenantContextProvider {
+    private readonly moduleRef;
+    constructor(moduleRef: ModuleRef);
+    getCurrentTenantId(): string | null;
+}

package/dist/services/default-tenant-context-provider.js

@@ -0,0 +1,35 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultTenantContextProvider = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+let DefaultTenantContextProvider = class DefaultTenantContextProvider {
+    constructor(moduleRef) {
+        this.moduleRef = moduleRef;
+    }
+    getCurrentTenantId() {
+        try {
+            const { TenancyService } = require('@nestarc/tenancy');
+            const tenancyService = this.moduleRef.get(TenancyService, { strict: false });
+            return tenancyService?.getCurrentTenant() ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+};
+exports.DefaultTenantContextProvider = DefaultTenantContextProvider;
+exports.DefaultTenantContextProvider = DefaultTenantContextProvider = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ModuleRef])
+], DefaultTenantContextProvider);
+//# sourceMappingURL=default-tenant-context-provider.js.map

package/dist/services/default-tenant-context-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-tenant-context-provider.js","sourceRoot":"","sources":["../../src/services/default-tenant-context-provider.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,uCAAyC;AAIlC,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACvC,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,kBAAkB;QAChB,IAAI,CAAC;YACH,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;YACvD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7E,OAAO,cAAc,EAAE,gBAAgB,EAAE,IAAI,IAAI,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAA;AAZY,oEAA4B;uCAA5B,4BAA4B;IADxC,IAAA,mBAAU,GAAE;qCAE6B,gBAAS;GADtC,4BAA4B,CAYxC"}

package/dist/services/feature-flag.service.d.ts

@@ -1,19 +1,20 @@
-import { ModuleRef } from '@nestjs/core';
 import { FeatureFlagModuleOptions } from '../interfaces/feature-flag-options.interface';
-import { CreateFeatureFlagInput, UpdateFeatureFlagInput, SetOverrideInput, FeatureFlagWithOverrides } from '../interfaces/feature-flag.interface';
+import { CreateFeatureFlagInput, UpdateFeatureFlagInput, SetOverrideInput, RemoveOverrideInput, FeatureFlagWithOverrides } from '../interfaces/feature-flag.interface';
 import { EvaluationContext } from '../interfaces/evaluation-context.interface';
-import { FlagCacheService } from './flag-cache.service';
+import { CacheAdapter } from '../interfaces/cache-adapter.interface';
+import { FeatureFlagRepository } from '../interfaces/feature-flag-repository.interface';
 import { FlagEvaluatorService } from './flag-evaluator.service';
-import { FlagContext } from './flag-context';
+import { FlagContextResolver } from './flag-context-resolver';
+import { FlagEventPublisher } from './flag-event-publisher';
 export declare class FeatureFlagService {
     private readonly options;
-    private readonly prisma;
-    private readonly cache;
+    private readonly repository;
+    private readonly cacheAdapter;
     private readonly evaluator;
-    private readonly flagContext;
-    private readonly moduleRef;
-    private readonly eventEmitter?;
-    constructor(options: FeatureFlagModuleOptions, prisma: any, cache: FlagCacheService, evaluator: FlagEvaluatorService, flagContext: FlagContext, moduleRef: ModuleRef, eventEmitter?: any | undefined);
+    private readonly contextResolver;
+    private readonly eventPublisher;
+    constructor(options: FeatureFlagModuleOptions, repository: FeatureFlagRepository, cacheAdapter: CacheAdapter, evaluator: FlagEvaluatorService, contextResolver: FlagContextResolver, eventPublisher: FlagEventPublisher);
+    private get cacheTtlMs();
     isEnabled(flagKey: string, explicitContext?: EvaluationContext): Promise<boolean>;
     evaluateAll(explicitContext?: EvaluationContext): Promise<Record<string, boolean>>;
     create(input: CreateFeatureFlagInput): Promise<FeatureFlagWithOverrides>;
@@ -21,9 +22,16 @@ export declare class FeatureFlagService {
     archive(key: string): Promise<FeatureFlagWithOverrides>;
     setOverride(key: string, input: SetOverrideInput): Promise<void>;
     findAll(): Promise<FeatureFlagWithOverrides[]>;
-    invalidateCache(): void;
+    invalidateCache(): Promise<void>;
+    findByKey(key: string): Promise<FeatureFlagWithOverrides>;
+    removeOverride(key: string, input: RemoveOverrideInput): Promise<void>;
+    private normalizeOverrideAttributes;
+    /**
+     * Best-effort cache invalidation for mutation paths.
+     * DB write already succeeded — cache failure should not fail the caller.
+     * Stale entries self-heal via TTL (default 30s).
+     */
+    private safeInvalidateCache;
     private resolveFlag;
     private resolveAllFlags;
-    private buildContext;
-    private getTenantId;
 }