@nestarc/feature-flag 0.1.0 → 0.3.0

package/dist/services/feature-flag.service.js

@@ -14,46 +14,46 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeatureFlagService = void 0;
 const common_1 = require("@nestjs/common");
-const core_1 = require("@nestjs/core");
 const feature_flag_constants_1 = require("../feature-flag.constants");
-const flag_cache_service_1 = require("./flag-cache.service");
 const flag_evaluator_service_1 = require("./flag-evaluator.service");
-const flag_context_1 = require("./flag-context");
+const flag_context_resolver_1 = require("./flag-context-resolver");
+const flag_event_publisher_1 = require("./flag-event-publisher");
 const feature_flag_events_1 = require("../events/feature-flag.events");
+const targeting_attributes_1 = require("../utils/targeting-attributes");
+const CACHE_INVALIDATION_FAILED = 'feature-flag.cache.invalidation-failed';
 let FeatureFlagService = class FeatureFlagService {
-    constructor(options, prisma, cache, evaluator, flagContext, moduleRef, eventEmitter) {
+    constructor(options, repository, cacheAdapter, evaluator, contextResolver, eventPublisher) {
         this.options = options;
-        this.prisma = prisma;
-        this.cache = cache;
+        this.repository = repository;
+        this.cacheAdapter = cacheAdapter;
         this.evaluator = evaluator;
-        this.flagContext = flagContext;
-        this.moduleRef = moduleRef;
-        this.eventEmitter = eventEmitter;
+        this.contextResolver = contextResolver;
+        this.eventPublisher = eventPublisher;
+    }
+    get cacheTtlMs() {
+        return this.options.cacheTtlMs ?? 30_000;
     }
     async isEnabled(flagKey, explicitContext) {
         const flag = await this.resolveFlag(flagKey);
         if (!flag) {
             return this.options.defaultOnMissing ?? false;
         }
-        const context = this.buildContext(explicitContext);
+        const context = this.contextResolver.resolve(explicitContext);
         const startTime = Date.now();
         const { result, source } = this.evaluator.evaluate(flag, context);
         const evaluationTimeMs = Date.now() - startTime;
-        if (this.options.emitEvents && this.eventEmitter) {
-            const event = {
-                flagKey,
-                result,
-                context,
-                source,
-                evaluationTimeMs,
-            };
-            this.eventEmitter.emit(feature_flag_events_1.FeatureFlagEvents.EVALUATED, event);
-        }
+        this.eventPublisher.emit(feature_flag_events_1.FeatureFlagEvents.EVALUATED, {
+            flagKey,
+            result,
+            context,
+            source,
+            evaluationTimeMs,
+        });
         return result;
     }
     async evaluateAll(explicitContext) {
         const flags = await this.resolveAllFlags();
-        const context = this.buildContext(explicitContext);
+        const context = this.contextResolver.resolve(explicitContext);
         const result = {};
         for (const flag of flags) {
             result[flag.key] = this.evaluator.evaluate(flag, context).result;
@@ -61,148 +61,133 @@ let FeatureFlagService = class FeatureFlagService {
         return result;
     }
     async create(input) {
-        const flag = await this.prisma.featureFlag.create({
-            data: {
-                key: input.key,
-                description: input.description,
-                enabled: input.enabled ?? false,
-                percentage: input.percentage ?? 0,
-                metadata: input.metadata ?? {},
-            },
-            include: { overrides: true },
-        });
-        this.cache.invalidate();
-        if (this.options.emitEvents && this.eventEmitter) {
-            this.eventEmitter.emit(feature_flag_events_1.FeatureFlagEvents.CREATED, { flagKey: input.key, action: 'created' });
-        }
+        const flag = await this.repository.createFlag(input);
+        await this.safeInvalidateCache();
+        this.eventPublisher.emit(feature_flag_events_1.FeatureFlagEvents.CREATED, { flagKey: input.key, action: 'created' });
         return flag;
     }
     async update(key, input) {
-        const flag = 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 },
-        });
-        this.cache.invalidate(key);
-        if (this.options.emitEvents && this.eventEmitter) {
-            this.eventEmitter.emit(feature_flag_events_1.FeatureFlagEvents.UPDATED, { flagKey: key, action: 'updated' });
-        }
+        const flag = await this.repository.updateFlag(key, input);
+        await this.safeInvalidateCache(key);
+        this.eventPublisher.emit(feature_flag_events_1.FeatureFlagEvents.UPDATED, { flagKey: key, action: 'updated' });
         return flag;
     }
     async archive(key) {
-        const flag = await this.prisma.featureFlag.update({
-            where: { key },
-            data: { archivedAt: new Date() },
-            include: { overrides: true },
-        });
-        this.cache.invalidate(key);
-        if (this.options.emitEvents && this.eventEmitter) {
-            this.eventEmitter.emit(feature_flag_events_1.FeatureFlagEvents.ARCHIVED, { flagKey: key, action: 'archived' });
-        }
+        const flag = await this.repository.archiveFlag(key);
+        await this.safeInvalidateCache(key);
+        this.eventPublisher.emit(feature_flag_events_1.FeatureFlagEvents.ARCHIVED, { flagKey: key, action: 'archived' });
         return flag;
     }
     async setOverride(key, input) {
-        const flag = await this.prisma.featureFlag.findUnique({ where: { key } });
-        if (!flag) {
-            throw new Error(`Feature flag "${key}" not found`);
+        const attributes = this.normalizeOverrideAttributes(input.attributes);
+        const priority = input.priority ?? 0;
+        const flagId = await this.repository.findFlagIdByKey(key);
+        if (!flagId) {
+            throw new common_1.NotFoundException(`Feature flag "${key}" not found`);
         }
-        const where = {
-            flagId: flag.id,
-            tenantId: input.tenantId ?? null,
-            userId: input.userId ?? null,
-            environment: input.environment ?? null,
-        };
-        const existing = await this.prisma.featureFlagOverride.findFirst({ where });
+        const criteria = { attributes };
+        const existing = await this.repository.findOverride(flagId, criteria);
         if (existing) {
-            await this.prisma.featureFlagOverride.update({
-                where: { id: existing.id },
-                data: { enabled: input.enabled },
+            await this.repository.updateOverride(existing.id, {
+                enabled: input.enabled,
+                priority,
             });
         }
         else {
-            await this.prisma.featureFlagOverride.create({
-                data: { ...where, enabled: input.enabled },
-            });
-        }
-        this.cache.invalidate(key);
-        if (this.options.emitEvents && this.eventEmitter) {
-            this.eventEmitter.emit(feature_flag_events_1.FeatureFlagEvents.OVERRIDE_SET, {
-                flagKey: key,
-                ...input,
-                action: 'set',
-            });
+            await this.repository.createOverride(flagId, criteria, input.enabled, priority);
         }
+        await this.safeInvalidateCache(key);
+        this.eventPublisher.emit(feature_flag_events_1.FeatureFlagEvents.OVERRIDE_SET, {
+            flagKey: key,
+            attributes,
+            enabled: input.enabled,
+            priority,
+            action: 'set',
+        });
     }
     async findAll() {
-        return this.prisma.featureFlag.findMany({
-            where: { archivedAt: null },
-            include: { overrides: true },
-            orderBy: { createdAt: 'desc' },
+        return this.repository.findAllActiveFlags();
+    }
+    async invalidateCache() {
+        await this.cacheAdapter.invalidate();
+        this.eventPublisher.emit(feature_flag_events_1.FeatureFlagEvents.CACHE_INVALIDATED, {});
+    }
+    async findByKey(key) {
+        const flag = await this.repository.findFlagByKey(key);
+        if (!flag) {
+            throw new common_1.NotFoundException(`Feature flag "${key}" not found`);
+        }
+        return flag;
+    }
+    async removeOverride(key, input) {
+        const attributes = this.normalizeOverrideAttributes(input.attributes);
+        const flagId = await this.repository.findFlagIdByKey(key);
+        if (!flagId) {
+            throw new common_1.NotFoundException(`Feature flag "${key}" not found`);
+        }
+        const criteria = { attributes };
+        const existing = await this.repository.findOverride(flagId, criteria);
+        if (existing) {
+            await this.repository.deleteOverride(existing.id);
+        }
+        await this.safeInvalidateCache(key);
+        this.eventPublisher.emit(feature_flag_events_1.FeatureFlagEvents.OVERRIDE_REMOVED, {
+            flagKey: key,
+            attributes,
+            action: 'removed',
         });
     }
-    invalidateCache() {
-        this.cache.invalidate();
-        if (this.options.emitEvents && this.eventEmitter) {
-            this.eventEmitter.emit(feature_flag_events_1.FeatureFlagEvents.CACHE_INVALIDATED, {});
+    normalizeOverrideAttributes(input) {
+        try {
+            return (0, targeting_attributes_1.normalizeTargetingAttributes)(input, { allowEmpty: false });
+        }
+        catch (error) {
+            throw new common_1.BadRequestException(String(error instanceof Error ? error.message : error));
+        }
+    }
+    /**
+     * 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).
+     */
+    async safeInvalidateCache(key) {
+        try {
+            await this.cacheAdapter.invalidate(key);
+        }
+        catch (error) {
+            this.eventPublisher.emit(CACHE_INVALIDATION_FAILED, {
+                key: key ?? '__all__',
+                error: String(error),
+            });
         }
     }
     async resolveFlag(key) {
-        const cached = this.cache.get(key);
+        const cached = await this.cacheAdapter.get(key);
         if (cached)
             return cached;
-        const flag = await this.prisma.featureFlag.findUnique({
-            where: { key },
-            include: { overrides: true },
-        });
+        const flag = await this.repository.findFlagByKey(key);
         if (flag) {
-            this.cache.set(key, flag);
+            await this.cacheAdapter.set(key, flag, this.cacheTtlMs);
         }
         return flag;
     }
     async resolveAllFlags() {
-        const cached = this.cache.getAll();
+        const cached = await this.cacheAdapter.getAll();
         if (cached)
             return cached;
-        const flags = await this.prisma.featureFlag.findMany({
-            where: { archivedAt: null },
-            include: { overrides: true },
-        });
-        this.cache.setAll(flags);
+        const flags = await this.repository.findAllActiveFlags();
+        await this.cacheAdapter.setAll(flags, this.cacheTtlMs);
         return flags;
     }
-    buildContext(explicit) {
-        return {
-            userId: explicit?.userId !== undefined ? explicit.userId : this.flagContext.getUserId(),
-            tenantId: explicit?.tenantId !== undefined ? explicit.tenantId : this.getTenantId(),
-            environment: explicit?.environment !== undefined ? explicit.environment : this.options.environment,
-        };
-    }
-    getTenantId() {
-        try {
-            const { TenancyService } = require('@nestarc/tenancy');
-            const tenancyService = this.moduleRef.get(TenancyService, { strict: false });
-            return tenancyService?.getCurrentTenant() ?? null;
-        }
-        catch {
-            return null;
-        }
-    }
 };
 exports.FeatureFlagService = FeatureFlagService;
 exports.FeatureFlagService = FeatureFlagService = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, common_1.Inject)(feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS)),
-    __param(1, (0, common_1.Inject)('PRISMA_SERVICE')),
-    __param(6, (0, common_1.Optional)()),
-    __param(6, (0, common_1.Inject)('EVENT_EMITTER')),
-    __metadata("design:paramtypes", [Object, Object, flag_cache_service_1.FlagCacheService,
-        flag_evaluator_service_1.FlagEvaluatorService,
-        flag_context_1.FlagContext,
-        core_1.ModuleRef, Object])
+    __param(1, (0, common_1.Inject)(feature_flag_constants_1.FEATURE_FLAG_REPOSITORY)),
+    __param(2, (0, common_1.Inject)(feature_flag_constants_1.CACHE_ADAPTER)),
+    __metadata("design:paramtypes", [Object, Object, Object, flag_evaluator_service_1.FlagEvaluatorService,
+        flag_context_resolver_1.FlagContextResolver,
+        flag_event_publisher_1.FlagEventPublisher])
 ], FeatureFlagService);
 //# sourceMappingURL=feature-flag.service.js.map

package/dist/services/feature-flag.service.js.map

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

package/dist/services/flag-context-resolver.d.ts

@@ -0,0 +1,11 @@
+import { FeatureFlagModuleOptions } from '../interfaces/feature-flag-options.interface';
+import { EvaluationContext } from '../interfaces/evaluation-context.interface';
+import { TenantContextProvider } from '../interfaces/tenant-context-provider.interface';
+import { FlagContext } from './flag-context';
+export declare class FlagContextResolver {
+    private readonly options;
+    private readonly flagContext;
+    private readonly tenantProvider;
+    constructor(options: FeatureFlagModuleOptions, flagContext: FlagContext, tenantProvider: TenantContextProvider);
+    resolve(explicit?: EvaluationContext): EvaluationContext;
+}

package/dist/services/flag-context-resolver.js

@@ -0,0 +1,51 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlagContextResolver = void 0;
+const common_1 = require("@nestjs/common");
+const feature_flag_constants_1 = require("../feature-flag.constants");
+const flag_context_1 = require("./flag-context");
+let FlagContextResolver = class FlagContextResolver {
+    constructor(options, flagContext, tenantProvider) {
+        this.options = options;
+        this.flagContext = flagContext;
+        this.tenantProvider = tenantProvider;
+    }
+    resolve(explicit) {
+        const userId = explicit?.userId !== undefined ? explicit.userId : this.flagContext.getUserId();
+        const tenantId = explicit?.tenantId !== undefined
+            ? explicit.tenantId
+            : this.tenantProvider.getCurrentTenantId();
+        const environment = explicit?.environment !== undefined ? explicit.environment : this.options.environment;
+        return {
+            userId,
+            tenantId,
+            environment,
+            attributes: {
+                ...(explicit?.attributes ?? {}),
+                ...(userId !== undefined && { userId }),
+                ...(tenantId !== undefined && { tenantId }),
+                ...(environment !== undefined && { environment }),
+            },
+        };
+    }
+};
+exports.FlagContextResolver = FlagContextResolver;
+exports.FlagContextResolver = FlagContextResolver = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS)),
+    __param(2, (0, common_1.Inject)(feature_flag_constants_1.TENANT_CONTEXT_PROVIDER)),
+    __metadata("design:paramtypes", [Object, flag_context_1.FlagContext, Object])
+], FlagContextResolver);
+//# sourceMappingURL=flag-context-resolver.js.map

package/dist/services/flag-context-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-context-resolver.js","sourceRoot":"","sources":["../../src/services/flag-context-resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoD;AACpD,sEAAiG;AAIjG,iDAA6C;AAGtC,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,YACwD,OAAiC,EACtE,WAAwB,EACS,cAAqC;QAFjC,YAAO,GAAP,OAAO,CAA0B;QACtE,gBAAW,GAAX,WAAW,CAAa;QACS,mBAAc,GAAd,cAAc,CAAuB;IACtF,CAAC;IAEJ,OAAO,CAAC,QAA4B;QAClC,MAAM,MAAM,GACV,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAClF,MAAM,QAAQ,GACZ,QAAQ,EAAE,QAAQ,KAAK,SAAS;YAC9B,CAAC,CAAC,QAAQ,CAAC,QAAQ;YACnB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC;QAC/C,MAAM,WAAW,GACf,QAAQ,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAExF,OAAO;YACL,MAAM;YACN,QAAQ;YACR,WAAW;YACX,UAAU,EAAE;gBACV,GAAG,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC;gBAC/B,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;gBACvC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC3C,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;aAClD;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA7BY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,oDAA2B,CAAC,CAAA;IAEnC,WAAA,IAAA,eAAM,EAAC,gDAAuB,CAAC,CAAA;6CADF,0BAAW;GAHhC,mBAAmB,CA6B/B"}

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

@@ -8,5 +8,6 @@ export interface EvaluationResult {
 }
 export declare class FlagEvaluatorService {
     evaluate(flag: FeatureFlagWithOverrides, context: EvaluationContext): EvaluationResult;
+    private findMatchingOverride;
 }
 export {};

package/dist/services/flag-evaluator.service.js

@@ -9,38 +9,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlagEvaluatorService = void 0;
 const common_1 = require("@nestjs/common");
 const hash_1 = require("../utils/hash");
+const targeting_attributes_1 = require("../utils/targeting-attributes");
 let FlagEvaluatorService = class FlagEvaluatorService {
     evaluate(flag, context) {
-        // 1. Archived → always false
         if (flag.archivedAt) {
             return { result: false, source: 'global' };
         }
-        // 2. User override (most specific)
-        if (context.userId) {
-            const userOverride = flag.overrides.find((o) => o.userId === context.userId &&
-                (o.tenantId === null || o.tenantId === context.tenantId) &&
-                (o.environment === null || o.environment === context.environment));
-            if (userOverride) {
-                return { result: userOverride.enabled, source: 'user_override' };
-            }
-        }
-        // 3. Tenant override
-        if (context.tenantId) {
-            const tenantOverride = flag.overrides.find((o) => o.tenantId === context.tenantId &&
-                o.userId === null &&
-                (o.environment === null || o.environment === context.environment));
-            if (tenantOverride) {
-                return { result: tenantOverride.enabled, source: 'tenant_override' };
-            }
-        }
-        // 4. Environment override
-        if (context.environment) {
-            const envOverride = flag.overrides.find((o) => o.environment === context.environment && o.tenantId === null && o.userId === null);
-            if (envOverride) {
-                return { result: envOverride.enabled, source: 'env_override' };
-            }
+        const override = this.findMatchingOverride(flag.overrides, context);
+        if (override) {
+            return { result: override.enabled, source: 'override' };
         }
-        // 5. Percentage rollout
         if (flag.percentage > 0) {
             if (flag.percentage === 100) {
                 return { result: true, source: 'percentage' };
@@ -52,12 +30,36 @@ let FlagEvaluatorService = class FlagEvaluatorService {
             const bucket = (0, hash_1.murmurhash3)(flag.key + hashKey) % 100;
             return { result: bucket < flag.percentage, source: 'percentage' };
         }
-        // 6. Global default
         return { result: flag.enabled, source: 'global' };
     }
+    findMatchingOverride(overrides, context) {
+        const contextAttributes = context.attributes ?? {};
+        return (overrides
+            .filter((override) => (0, targeting_attributes_1.matchesTargetingAttributes)(override.attributes, contextAttributes))
+            .sort(compareOverrides)[0] ?? null);
+    }
 };
 exports.FlagEvaluatorService = FlagEvaluatorService;
 exports.FlagEvaluatorService = FlagEvaluatorService = __decorate([
     (0, common_1.Injectable)()
 ], FlagEvaluatorService);
+function compareOverrides(a, b) {
+    const specificityDelta = Object.keys(b.attributes).length - Object.keys(a.attributes).length;
+    if (specificityDelta !== 0) {
+        return specificityDelta;
+    }
+    const priorityDelta = b.priority - a.priority;
+    if (priorityDelta !== 0) {
+        return priorityDelta;
+    }
+    const createdAtDelta = getOverrideCreatedAtTime(a) - getOverrideCreatedAtTime(b);
+    if (createdAtDelta !== 0) {
+        return createdAtDelta;
+    }
+    return a.id.localeCompare(b.id);
+}
+function getOverrideCreatedAtTime(override) {
+    const createdAt = override.createdAt;
+    return createdAt instanceof Date ? createdAt.getTime() : new Date(createdAt).getTime();
+}
 //# sourceMappingURL=flag-evaluator.service.js.map

package/dist/services/flag-evaluator.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"flag-evaluator.service.js","sourceRoot":"","sources":["../../src/services/flag-evaluator.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flag-evaluator.service.js","sourceRoot":"","sources":["../../src/services/flag-evaluator.service.ts"],"names":[],"mappings":"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"}

package/dist/services/flag-event-publisher.d.ts

@@ -0,0 +1,7 @@
+import { FeatureFlagModuleOptions } from '../interfaces/feature-flag-options.interface';
+export declare class FlagEventPublisher {
+    private readonly options;
+    private readonly eventEmitter?;
+    constructor(options: FeatureFlagModuleOptions, eventEmitter?: any | undefined);
+    emit(event: string, payload: Record<string, unknown>): void;
+}

package/dist/services/flag-event-publisher.js

@@ -0,0 +1,37 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlagEventPublisher = void 0;
+const common_1 = require("@nestjs/common");
+const feature_flag_constants_1 = require("../feature-flag.constants");
+let FlagEventPublisher = class FlagEventPublisher {
+    constructor(options, eventEmitter) {
+        this.options = options;
+        this.eventEmitter = eventEmitter;
+    }
+    emit(event, payload) {
+        if (this.options.emitEvents && this.eventEmitter) {
+            this.eventEmitter.emit(event, payload);
+        }
+    }
+};
+exports.FlagEventPublisher = FlagEventPublisher;
+exports.FlagEventPublisher = FlagEventPublisher = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS)),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)('EVENT_EMITTER')),
+    __metadata("design:paramtypes", [Object, Object])
+], FlagEventPublisher);
+//# sourceMappingURL=flag-event-publisher.js.map

package/dist/services/flag-event-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-event-publisher.js","sourceRoot":"","sources":["../../src/services/flag-event-publisher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8D;AAC9D,sEAAwE;AAIjE,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YACwD,OAAiC,EACjC,YAAkB;QADlB,YAAO,GAAP,OAAO,CAA0B;QACjC,iBAAY,GAAZ,YAAY,CAAM;IACvE,CAAC;IAEJ,IAAI,CAAC,KAAa,EAAE,OAAgC;QAClD,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;CACF,CAAA;AAXY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,oDAA2B,CAAC,CAAA;IACnC,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,eAAe,CAAC,CAAA;;GAH3B,kBAAkB,CAW9B"}

package/dist/testing/test-feature-flag.module.js

@@ -10,6 +10,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestFeatureFlagModule = void 0;
 const common_1 = require("@nestjs/common");
 const feature_flag_service_1 = require("../services/feature-flag.service");
+function makeStubFlag(partial = {}) {
+    return {
+        id: partial.id ?? 'stub-id',
+        key: partial.key ?? 'STUB',
+        description: partial.description ?? null,
+        enabled: partial.enabled ?? false,
+        percentage: partial.percentage ?? 0,
+        metadata: partial.metadata ?? {},
+        archivedAt: partial.archivedAt ?? null,
+        createdAt: partial.createdAt ?? new Date('2026-01-01'),
+        updatedAt: partial.updatedAt ?? new Date('2026-01-01'),
+        overrides: partial.overrides ?? [],
+    };
+}
 let TestFeatureFlagModule = TestFeatureFlagModule_1 = class TestFeatureFlagModule {
     static register(flags) {
         return {
@@ -21,12 +35,19 @@ let TestFeatureFlagModule = TestFeatureFlagModule_1 = class TestFeatureFlagModul
                     useValue: {
                         isEnabled: async (key) => flags?.[key] ?? false,
                         evaluateAll: async () => flags ?? {},
-                        create: async () => ({}),
-                        update: async () => ({}),
-                        archive: async () => ({}),
+                        create: async (input) => makeStubFlag({ key: input.key, enabled: input.enabled ?? false }),
+                        update: async (key, input) => makeStubFlag({ key, ...input }),
+                        archive: async (key) => makeStubFlag({ key, archivedAt: new Date() }),
                         setOverride: async () => { },
-                        findAll: async () => [],
-                        invalidateCache: () => { },
+                        removeOverride: async () => { },
+                        findAll: async () => Object.entries(flags ?? {}).map(([key, enabled]) => makeStubFlag({ key, enabled })),
+                        findByKey: async (key) => {
+                            if (flags && key in flags) {
+                                return makeStubFlag({ key, enabled: flags[key] });
+                            }
+                            throw new common_1.NotFoundException(`Feature flag "${key}" not found`);
+                        },
+                        invalidateCache: async () => { },
                     },
                 },
             ],