@nestarc/feature-flag 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/README.md +252 -87
  2. package/dist/admin/admin-options.interface.d.ts +5 -0
  3. package/dist/admin/admin-options.interface.js +3 -0
  4. package/dist/admin/admin-options.interface.js.map +1 -0
  5. package/dist/admin/feature-flag-admin.controller.d.ts +14 -0
  6. package/dist/admin/feature-flag-admin.controller.js +106 -0
  7. package/dist/admin/feature-flag-admin.controller.js.map +1 -0
  8. package/dist/admin/feature-flag-admin.dto.d.ts +22 -0
  9. package/dist/admin/feature-flag-admin.dto.js +93 -0
  10. package/dist/admin/feature-flag-admin.dto.js.map +1 -0
  11. package/dist/admin/feature-flag-admin.module.d.ts +5 -0
  12. package/dist/admin/feature-flag-admin.module.js +33 -0
  13. package/dist/admin/feature-flag-admin.module.js.map +1 -0
  14. package/dist/admin/targeting-attributes.validator.d.ts +6 -0
  15. package/dist/admin/targeting-attributes.validator.js +36 -0
  16. package/dist/admin/targeting-attributes.validator.js.map +1 -0
  17. package/dist/cache/memory-cache.adapter.d.ts +11 -0
  18. package/dist/{services/flag-cache.service.js → cache/memory-cache.adapter.js} +18 -31
  19. package/dist/cache/memory-cache.adapter.js.map +1 -0
  20. package/dist/cache/redis-cache.adapter.d.ts +26 -0
  21. package/dist/cache/redis-cache.adapter.js +102 -0
  22. package/dist/cache/redis-cache.adapter.js.map +1 -0
  23. package/dist/events/feature-flag.events.d.ts +4 -5
  24. package/dist/feature-flag.constants.d.ts +3 -0
  25. package/dist/feature-flag.constants.js +4 -1
  26. package/dist/feature-flag.constants.js.map +1 -1
  27. package/dist/feature-flag.module.js +49 -10
  28. package/dist/feature-flag.module.js.map +1 -1
  29. package/dist/index.d.ts +10 -2
  30. package/dist/index.js +13 -1
  31. package/dist/index.js.map +1 -1
  32. package/dist/interfaces/cache-adapter.interface.d.ts +9 -0
  33. package/dist/interfaces/cache-adapter.interface.js +3 -0
  34. package/dist/interfaces/cache-adapter.interface.js.map +1 -0
  35. package/dist/interfaces/evaluation-context.interface.d.ts +6 -3
  36. package/dist/interfaces/feature-flag-options.interface.d.ts +3 -0
  37. package/dist/interfaces/feature-flag-repository.interface.d.ts +22 -0
  38. package/dist/interfaces/feature-flag-repository.interface.js +3 -0
  39. package/dist/interfaces/feature-flag-repository.interface.js.map +1 -0
  40. package/dist/interfaces/feature-flag.interface.d.ts +11 -6
  41. package/dist/interfaces/tenant-context-provider.interface.d.ts +3 -0
  42. package/dist/interfaces/tenant-context-provider.interface.js +3 -0
  43. package/dist/interfaces/tenant-context-provider.interface.js.map +1 -0
  44. package/dist/repositories/prisma-feature-flag.repository.d.ts +18 -0
  45. package/dist/repositories/prisma-feature-flag.repository.js +161 -0
  46. package/dist/repositories/prisma-feature-flag.repository.js.map +1 -0
  47. package/dist/services/default-tenant-context-provider.d.ts +7 -0
  48. package/dist/services/default-tenant-context-provider.js +35 -0
  49. package/dist/services/default-tenant-context-provider.js.map +1 -0
  50. package/dist/services/feature-flag.service.d.ts +21 -13
  51. package/dist/services/feature-flag.service.js +111 -126
  52. package/dist/services/feature-flag.service.js.map +1 -1
  53. package/dist/services/flag-context-resolver.d.ts +11 -0
  54. package/dist/services/flag-context-resolver.js +51 -0
  55. package/dist/services/flag-context-resolver.js.map +1 -0
  56. package/dist/services/flag-evaluator.service.d.ts +1 -0
  57. package/dist/services/flag-evaluator.service.js +29 -27
  58. package/dist/services/flag-evaluator.service.js.map +1 -1
  59. package/dist/services/flag-event-publisher.d.ts +7 -0
  60. package/dist/services/flag-event-publisher.js +37 -0
  61. package/dist/services/flag-event-publisher.js.map +1 -0
  62. package/dist/testing/test-feature-flag.module.js +26 -5
  63. package/dist/testing/test-feature-flag.module.js.map +1 -1
  64. package/dist/utils/targeting-attributes.d.ts +9 -0
  65. package/dist/utils/targeting-attributes.js +44 -0
  66. package/dist/utils/targeting-attributes.js.map +1 -0
  67. package/package.json +20 -3
  68. package/prisma/migrations/20260512000000_attribute_targeting/migration.sql +59 -0
  69. package/prisma/schema.prisma +7 -9
  70. package/dist/services/flag-cache.service.d.ts +0 -13
  71. package/dist/services/flag-cache.service.js.map +0 -1
@@ -0,0 +1,93 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.RemoveOverrideDto = exports.SetOverrideDto = exports.UpdateFeatureFlagDto = exports.CreateFeatureFlagDto = void 0;
13
+ const class_validator_1 = require("class-validator");
14
+ const targeting_attributes_validator_1 = require("./targeting-attributes.validator");
15
+ class CreateFeatureFlagDto {
16
+ }
17
+ exports.CreateFeatureFlagDto = CreateFeatureFlagDto;
18
+ __decorate([
19
+ (0, class_validator_1.IsString)(),
20
+ (0, class_validator_1.IsNotEmpty)(),
21
+ __metadata("design:type", String)
22
+ ], CreateFeatureFlagDto.prototype, "key", void 0);
23
+ __decorate([
24
+ (0, class_validator_1.IsOptional)(),
25
+ (0, class_validator_1.IsString)(),
26
+ __metadata("design:type", String)
27
+ ], CreateFeatureFlagDto.prototype, "description", void 0);
28
+ __decorate([
29
+ (0, class_validator_1.IsOptional)(),
30
+ (0, class_validator_1.IsBoolean)(),
31
+ __metadata("design:type", Boolean)
32
+ ], CreateFeatureFlagDto.prototype, "enabled", void 0);
33
+ __decorate([
34
+ (0, class_validator_1.IsOptional)(),
35
+ (0, class_validator_1.IsInt)(),
36
+ (0, class_validator_1.Min)(0),
37
+ (0, class_validator_1.Max)(100),
38
+ __metadata("design:type", Number)
39
+ ], CreateFeatureFlagDto.prototype, "percentage", void 0);
40
+ __decorate([
41
+ (0, class_validator_1.IsOptional)(),
42
+ (0, class_validator_1.IsObject)(),
43
+ __metadata("design:type", Object)
44
+ ], CreateFeatureFlagDto.prototype, "metadata", void 0);
45
+ class UpdateFeatureFlagDto {
46
+ }
47
+ exports.UpdateFeatureFlagDto = UpdateFeatureFlagDto;
48
+ __decorate([
49
+ (0, class_validator_1.IsOptional)(),
50
+ (0, class_validator_1.IsString)(),
51
+ __metadata("design:type", String)
52
+ ], UpdateFeatureFlagDto.prototype, "description", void 0);
53
+ __decorate([
54
+ (0, class_validator_1.IsOptional)(),
55
+ (0, class_validator_1.IsBoolean)(),
56
+ __metadata("design:type", Boolean)
57
+ ], UpdateFeatureFlagDto.prototype, "enabled", void 0);
58
+ __decorate([
59
+ (0, class_validator_1.IsOptional)(),
60
+ (0, class_validator_1.IsInt)(),
61
+ (0, class_validator_1.Min)(0),
62
+ (0, class_validator_1.Max)(100),
63
+ __metadata("design:type", Number)
64
+ ], UpdateFeatureFlagDto.prototype, "percentage", void 0);
65
+ __decorate([
66
+ (0, class_validator_1.IsOptional)(),
67
+ (0, class_validator_1.IsObject)(),
68
+ __metadata("design:type", Object)
69
+ ], UpdateFeatureFlagDto.prototype, "metadata", void 0);
70
+ class SetOverrideDto {
71
+ }
72
+ exports.SetOverrideDto = SetOverrideDto;
73
+ __decorate([
74
+ (0, targeting_attributes_validator_1.IsTargetingAttributes)(),
75
+ __metadata("design:type", Object)
76
+ ], SetOverrideDto.prototype, "attributes", void 0);
77
+ __decorate([
78
+ (0, class_validator_1.IsBoolean)(),
79
+ __metadata("design:type", Boolean)
80
+ ], SetOverrideDto.prototype, "enabled", void 0);
81
+ __decorate([
82
+ (0, class_validator_1.IsOptional)(),
83
+ (0, class_validator_1.IsInt)(),
84
+ __metadata("design:type", Number)
85
+ ], SetOverrideDto.prototype, "priority", void 0);
86
+ class RemoveOverrideDto {
87
+ }
88
+ exports.RemoveOverrideDto = RemoveOverrideDto;
89
+ __decorate([
90
+ (0, targeting_attributes_validator_1.IsTargetingAttributes)(),
91
+ __metadata("design:type", Object)
92
+ ], RemoveOverrideDto.prototype, "attributes", void 0);
93
+ //# sourceMappingURL=feature-flag-admin.dto.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feature-flag-admin.dto.js","sourceRoot":"","sources":["../../src/admin/feature-flag-admin.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDASyB;AAEzB,qFAAyE;AAEzE,MAAa,oBAAoB;CAsBhC;AAtBD,oDAsBC;AAnBC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;iDACA;AAIb;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;yDACU;AAIrB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;qDACM;AAMlB;IAJC,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;IACP,IAAA,qBAAG,EAAC,CAAC,CAAC;IACN,IAAA,qBAAG,EAAC,GAAG,CAAC;;wDACW;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;sDACwB;AAGrC,MAAa,oBAAoB;CAkBhC;AAlBD,oDAkBC;AAfC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;yDACU;AAIrB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;qDACM;AAMlB;IAJC,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;IACP,IAAA,qBAAG,EAAC,CAAC,CAAC;IACN,IAAA,qBAAG,EAAC,GAAG,CAAC;;wDACW;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;sDACwB;AAGrC,MAAa,cAAc;CAU1B;AAVD,wCAUC;AARC;IADC,IAAA,sDAAqB,GAAE;;kDACS;AAGjC;IADC,IAAA,2BAAS,GAAE;;+CACM;AAIlB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;;gDACU;AAGpB,MAAa,iBAAiB;CAG7B;AAHD,8CAGC;AADC;IADC,IAAA,sDAAqB,GAAE;;qDACS"}
@@ -0,0 +1,5 @@
1
+ import { DynamicModule } from '@nestjs/common';
2
+ import { FeatureFlagAdminOptions } from './admin-options.interface';
3
+ export declare class FeatureFlagAdminModule {
4
+ static register(options: FeatureFlagAdminOptions): DynamicModule;
5
+ }
@@ -0,0 +1,33 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var FeatureFlagAdminModule_1;
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.FeatureFlagAdminModule = void 0;
11
+ const common_1 = require("@nestjs/common");
12
+ const feature_flag_admin_controller_1 = require("./feature-flag-admin.controller");
13
+ let FeatureFlagAdminModule = FeatureFlagAdminModule_1 = class FeatureFlagAdminModule {
14
+ static register(options) {
15
+ if (!options.guard) {
16
+ throw new Error('FeatureFlagAdminModule requires a guard. ' +
17
+ 'Pass your auth guard via register({ guard: MyGuard }).');
18
+ }
19
+ const path = options.path ?? 'feature-flags';
20
+ Reflect.defineMetadata('path', path, feature_flag_admin_controller_1.FeatureFlagAdminController);
21
+ Reflect.defineMetadata('__guards__', [options.guard], feature_flag_admin_controller_1.FeatureFlagAdminController);
22
+ return {
23
+ module: FeatureFlagAdminModule_1,
24
+ controllers: [feature_flag_admin_controller_1.FeatureFlagAdminController],
25
+ providers: [options.guard],
26
+ };
27
+ }
28
+ };
29
+ exports.FeatureFlagAdminModule = FeatureFlagAdminModule;
30
+ exports.FeatureFlagAdminModule = FeatureFlagAdminModule = FeatureFlagAdminModule_1 = __decorate([
31
+ (0, common_1.Module)({})
32
+ ], FeatureFlagAdminModule);
33
+ //# sourceMappingURL=feature-flag-admin.module.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feature-flag-admin.module.js","sourceRoot":"","sources":["../../src/admin/feature-flag-admin.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,mFAA6E;AAItE,IAAM,sBAAsB,8BAA5B,MAAM,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,OAAgC;QAC9C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,2CAA2C;gBAC3C,wDAAwD,CACzD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC;QAE7C,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,0DAA0B,CAAC,CAAC;QACjE,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,0DAA0B,CAAC,CAAC;QAElF,OAAO;YACL,MAAM,EAAE,wBAAsB;YAC9B,WAAW,EAAE,CAAC,0DAA0B,CAAC;YACzC,SAAS,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SAC3B,CAAC;IACJ,CAAC;CACF,CAAA;AApBY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,sBAAsB,CAoBlC"}
@@ -0,0 +1,6 @@
1
+ import { ValidationArguments, ValidationOptions, ValidatorConstraintInterface } from 'class-validator';
2
+ export declare class IsTargetingAttributesConstraint implements ValidatorConstraintInterface {
3
+ validate(value: unknown): boolean;
4
+ defaultMessage(_args: ValidationArguments): string;
5
+ }
6
+ export declare function IsTargetingAttributes(validationOptions?: ValidationOptions): (target: object, propertyName: string) => void;
@@ -0,0 +1,36 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.IsTargetingAttributesConstraint = void 0;
10
+ exports.IsTargetingAttributes = IsTargetingAttributes;
11
+ const class_validator_1 = require("class-validator");
12
+ const targeting_attributes_1 = require("../utils/targeting-attributes");
13
+ let IsTargetingAttributesConstraint = class IsTargetingAttributesConstraint {
14
+ validate(value) {
15
+ return (0, targeting_attributes_1.isTargetingAttributes)(value, { allowEmpty: false });
16
+ }
17
+ defaultMessage(_args) {
18
+ return 'attributes must be a non-empty object with string, number, boolean, or null values';
19
+ }
20
+ };
21
+ exports.IsTargetingAttributesConstraint = IsTargetingAttributesConstraint;
22
+ exports.IsTargetingAttributesConstraint = IsTargetingAttributesConstraint = __decorate([
23
+ (0, class_validator_1.ValidatorConstraint)({ name: 'isTargetingAttributes', async: false })
24
+ ], IsTargetingAttributesConstraint);
25
+ function IsTargetingAttributes(validationOptions) {
26
+ return function registerTargetingAttributesDecorator(target, propertyName) {
27
+ (0, class_validator_1.registerDecorator)({
28
+ target: target.constructor,
29
+ propertyName,
30
+ options: validationOptions,
31
+ constraints: [],
32
+ validator: IsTargetingAttributesConstraint,
33
+ });
34
+ };
35
+ }
36
+ //# sourceMappingURL=targeting-attributes.validator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"targeting-attributes.validator.js","sourceRoot":"","sources":["../../src/admin/targeting-attributes.validator.ts"],"names":[],"mappings":";;;;;;;;;AAoBA,sDAUC;AA9BD,qDAMyB;AACzB,wEAAsE;AAG/D,IAAM,+BAA+B,GAArC,MAAM,+BAA+B;IAC1C,QAAQ,CAAC,KAAc;QACrB,OAAO,IAAA,4CAAqB,EAAC,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,cAAc,CAAC,KAA0B;QACvC,OAAO,oFAAoF,CAAC;IAC9F,CAAC;CACF,CAAA;AARY,0EAA+B;0CAA/B,+BAA+B;IAD3C,IAAA,qCAAmB,EAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;GACxD,+BAA+B,CAQ3C;AAED,SAAgB,qBAAqB,CAAC,iBAAqC;IACzE,OAAO,SAAS,oCAAoC,CAAC,MAAc,EAAE,YAAoB;QACvF,IAAA,mCAAiB,EAAC;YAChB,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY;YACZ,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,+BAA+B;SAC3C,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,11 @@
1
+ import { CacheAdapter } from '../interfaces/cache-adapter.interface';
2
+ import { FeatureFlagWithOverrides } from '../interfaces/feature-flag.interface';
3
+ export declare class MemoryCacheAdapter implements CacheAdapter {
4
+ private cache;
5
+ private allFlagsCache;
6
+ get(key: string): Promise<FeatureFlagWithOverrides | null>;
7
+ set(key: string, data: FeatureFlagWithOverrides, ttlMs: number): Promise<void>;
8
+ getAll(): Promise<FeatureFlagWithOverrides[] | null>;
9
+ setAll(data: FeatureFlagWithOverrides[], ttlMs: number): Promise<void>;
10
+ invalidate(key?: string): Promise<void>;
11
+ }
@@ -5,23 +5,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
5
5
  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;
6
6
  return c > 3 && r && Object.defineProperty(target, key, r), r;
7
7
  };
8
- var __metadata = (this && this.__metadata) || function (k, v) {
9
- if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
- };
11
- var __param = (this && this.__param) || function (paramIndex, decorator) {
12
- return function (target, key) { decorator(target, key, paramIndex); }
13
- };
14
8
  Object.defineProperty(exports, "__esModule", { value: true });
15
- exports.FlagCacheService = void 0;
9
+ exports.MemoryCacheAdapter = void 0;
16
10
  const common_1 = require("@nestjs/common");
17
- const feature_flag_constants_1 = require("../feature-flag.constants");
18
- let FlagCacheService = class FlagCacheService {
19
- constructor(options) {
20
- this.options = options;
11
+ let MemoryCacheAdapter = class MemoryCacheAdapter {
12
+ constructor() {
21
13
  this.cache = new Map();
22
14
  this.allFlagsCache = null;
23
15
  }
24
- get(key) {
16
+ async get(key) {
25
17
  const entry = this.cache.get(key);
26
18
  if (!entry)
27
19
  return null;
@@ -31,13 +23,12 @@ let FlagCacheService = class FlagCacheService {
31
23
  }
32
24
  return entry.data;
33
25
  }
34
- set(key, data) {
35
- const ttl = this.options.cacheTtlMs ?? 30_000;
36
- if (ttl === 0)
26
+ async set(key, data, ttlMs) {
27
+ if (ttlMs === 0)
37
28
  return;
38
- this.cache.set(key, { data, expiresAt: Date.now() + ttl });
29
+ this.cache.set(key, { data, expiresAt: Date.now() + ttlMs });
39
30
  }
40
- getAll() {
31
+ async getAll() {
41
32
  if (!this.allFlagsCache)
42
33
  return null;
43
34
  if (Date.now() > this.allFlagsCache.expiresAt) {
@@ -46,27 +37,23 @@ let FlagCacheService = class FlagCacheService {
46
37
  }
47
38
  return this.allFlagsCache.data;
48
39
  }
49
- setAll(data) {
50
- const ttl = this.options.cacheTtlMs ?? 30_000;
51
- if (ttl === 0)
40
+ async setAll(data, ttlMs) {
41
+ if (ttlMs === 0)
52
42
  return;
53
- this.allFlagsCache = { data, expiresAt: Date.now() + ttl };
43
+ this.allFlagsCache = { data, expiresAt: Date.now() + ttlMs };
54
44
  }
55
- invalidate(key) {
45
+ async invalidate(key) {
56
46
  if (key) {
57
47
  this.cache.delete(key);
58
- this.allFlagsCache = null;
59
48
  }
60
49
  else {
61
50
  this.cache.clear();
62
- this.allFlagsCache = null;
63
51
  }
52
+ this.allFlagsCache = null;
64
53
  }
65
54
  };
66
- exports.FlagCacheService = FlagCacheService;
67
- exports.FlagCacheService = FlagCacheService = __decorate([
68
- (0, common_1.Injectable)(),
69
- __param(0, (0, common_1.Inject)(feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS)),
70
- __metadata("design:paramtypes", [Object])
71
- ], FlagCacheService);
72
- //# sourceMappingURL=flag-cache.service.js.map
55
+ exports.MemoryCacheAdapter = MemoryCacheAdapter;
56
+ exports.MemoryCacheAdapter = MemoryCacheAdapter = __decorate([
57
+ (0, common_1.Injectable)()
58
+ ], MemoryCacheAdapter);
59
+ //# sourceMappingURL=memory-cache.adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-cache.adapter.js","sourceRoot":"","sources":["../../src/cache/memory-cache.adapter.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAUrC,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAAxB;QACG,UAAK,GAAG,IAAI,GAAG,EAAgD,CAAC;QAChE,kBAAa,GAAkD,IAAI,CAAC;IAuC9E,CAAC;IArCC,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,IAA8B,EAAE,KAAa;QAClE,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;YAC9C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAgC,EAAE,KAAa;QAC1D,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO;QACxB,IAAI,CAAC,aAAa,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAY;QAC3B,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;CACF,CAAA;AAzCY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;GACA,kBAAkB,CAyC9B"}
@@ -0,0 +1,26 @@
1
+ import type { Redis } from 'ioredis';
2
+ import { CacheAdapter } from '../interfaces/cache-adapter.interface';
3
+ import { FeatureFlagWithOverrides } from '../interfaces/feature-flag.interface';
4
+ export interface RedisCacheAdapterOptions {
5
+ client: Redis;
6
+ subscriber?: Redis;
7
+ keyPrefix?: string;
8
+ channel?: string;
9
+ }
10
+ export declare class RedisCacheAdapter implements CacheAdapter {
11
+ private readonly client;
12
+ private readonly subscriber;
13
+ private readonly keyPrefix;
14
+ private readonly channel;
15
+ private readonly ownsSubscriber;
16
+ constructor(options: RedisCacheAdapterOptions);
17
+ private setupSubscription;
18
+ get(key: string): Promise<FeatureFlagWithOverrides | null>;
19
+ set(key: string, data: FeatureFlagWithOverrides, ttlMs: number): Promise<void>;
20
+ getAll(): Promise<FeatureFlagWithOverrides[] | null>;
21
+ setAll(data: FeatureFlagWithOverrides[], ttlMs: number): Promise<void>;
22
+ invalidate(key?: string): Promise<void>;
23
+ onModuleDestroy(): Promise<void>;
24
+ private prefixedKey;
25
+ private flushLocal;
26
+ }
@@ -0,0 +1,102 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.RedisCacheAdapter = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ let RedisCacheAdapter = class RedisCacheAdapter {
15
+ constructor(options) {
16
+ this.client = options.client;
17
+ this.keyPrefix = options.keyPrefix ?? 'feature-flag:';
18
+ this.channel = options.channel ?? 'feature-flag:invalidate';
19
+ if (options.subscriber) {
20
+ this.subscriber = options.subscriber;
21
+ this.ownsSubscriber = false;
22
+ }
23
+ else {
24
+ this.subscriber = this.client.duplicate();
25
+ this.ownsSubscriber = true;
26
+ }
27
+ this.setupSubscription();
28
+ }
29
+ setupSubscription() {
30
+ this.subscriber.subscribe(this.channel);
31
+ this.subscriber.on('message', (ch, message) => {
32
+ if (ch !== this.channel)
33
+ return;
34
+ if (message === '__all__') {
35
+ this.flushLocal();
36
+ }
37
+ else {
38
+ this.client.del(this.prefixedKey(message));
39
+ this.client.del(this.prefixedKey('__all__'));
40
+ }
41
+ });
42
+ }
43
+ async get(key) {
44
+ const raw = await this.client.get(this.prefixedKey(key));
45
+ if (!raw)
46
+ return null;
47
+ return JSON.parse(raw);
48
+ }
49
+ async set(key, data, ttlMs) {
50
+ if (ttlMs === 0)
51
+ return;
52
+ await this.client.set(this.prefixedKey(key), JSON.stringify(data), 'PX', ttlMs);
53
+ }
54
+ async getAll() {
55
+ const raw = await this.client.get(this.prefixedKey('__all__'));
56
+ if (!raw)
57
+ return null;
58
+ return JSON.parse(raw);
59
+ }
60
+ async setAll(data, ttlMs) {
61
+ if (ttlMs === 0)
62
+ return;
63
+ await this.client.set(this.prefixedKey('__all__'), JSON.stringify(data), 'PX', ttlMs);
64
+ }
65
+ async invalidate(key) {
66
+ if (key) {
67
+ await this.client.del(this.prefixedKey(key));
68
+ await this.client.del(this.prefixedKey('__all__'));
69
+ await this.client.publish(this.channel, key);
70
+ }
71
+ else {
72
+ await this.flushLocal();
73
+ await this.client.publish(this.channel, '__all__');
74
+ }
75
+ }
76
+ async onModuleDestroy() {
77
+ await this.subscriber.unsubscribe(this.channel);
78
+ if (this.ownsSubscriber) {
79
+ await this.subscriber.quit();
80
+ }
81
+ }
82
+ prefixedKey(key) {
83
+ return `${this.keyPrefix}${key}`;
84
+ }
85
+ async flushLocal() {
86
+ const pattern = `${this.keyPrefix}*`;
87
+ let cursor = '0';
88
+ do {
89
+ const [nextCursor, keys] = await this.client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
90
+ cursor = nextCursor;
91
+ if (keys.length > 0) {
92
+ await this.client.del(...keys);
93
+ }
94
+ } while (cursor !== '0');
95
+ }
96
+ };
97
+ exports.RedisCacheAdapter = RedisCacheAdapter;
98
+ exports.RedisCacheAdapter = RedisCacheAdapter = __decorate([
99
+ (0, common_1.Injectable)(),
100
+ __metadata("design:paramtypes", [Object])
101
+ ], RedisCacheAdapter);
102
+ //# sourceMappingURL=redis-cache.adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redis-cache.adapter.js","sourceRoot":"","sources":["../../src/cache/redis-cache.adapter.ts"],"names":[],"mappings":"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"}
@@ -12,7 +12,7 @@ export interface FlagEvaluatedEvent {
12
12
  flagKey: string;
13
13
  result: boolean;
14
14
  context: EvaluationContext;
15
- source: 'user_override' | 'tenant_override' | 'env_override' | 'percentage' | 'global';
15
+ source: 'override' | 'percentage' | 'global';
16
16
  evaluationTimeMs: number;
17
17
  }
18
18
  export interface FlagMutationEvent {
@@ -21,9 +21,8 @@ export interface FlagMutationEvent {
21
21
  }
22
22
  export interface FlagOverrideEvent {
23
23
  flagKey: string;
24
- tenantId?: string | null;
25
- userId?: string | null;
26
- environment?: string | null;
27
- enabled: boolean;
24
+ attributes: Record<string, string | number | boolean | null>;
25
+ enabled?: boolean;
26
+ priority?: number;
28
27
  action: 'set' | 'removed';
29
28
  }
@@ -3,3 +3,6 @@ export declare const DEFAULT_CACHE_TTL_MS = 30000;
3
3
  export declare const FEATURE_FLAG_KEY = "FEATURE_FLAG_KEY";
4
4
  export declare const FEATURE_FLAG_OPTIONS_KEY = "FEATURE_FLAG_OPTIONS_KEY";
5
5
  export declare const BYPASS_FEATURE_FLAG_KEY = "BYPASS_FEATURE_FLAG_KEY";
6
+ export declare const CACHE_ADAPTER: unique symbol;
7
+ export declare const FEATURE_FLAG_REPOSITORY: unique symbol;
8
+ export declare const TENANT_CONTEXT_PROVIDER: unique symbol;
@@ -1,9 +1,12 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.BYPASS_FEATURE_FLAG_KEY = exports.FEATURE_FLAG_OPTIONS_KEY = exports.FEATURE_FLAG_KEY = exports.DEFAULT_CACHE_TTL_MS = exports.FEATURE_FLAG_MODULE_OPTIONS = void 0;
3
+ exports.TENANT_CONTEXT_PROVIDER = exports.FEATURE_FLAG_REPOSITORY = exports.CACHE_ADAPTER = exports.BYPASS_FEATURE_FLAG_KEY = exports.FEATURE_FLAG_OPTIONS_KEY = exports.FEATURE_FLAG_KEY = exports.DEFAULT_CACHE_TTL_MS = exports.FEATURE_FLAG_MODULE_OPTIONS = void 0;
4
4
  exports.FEATURE_FLAG_MODULE_OPTIONS = Symbol('FEATURE_FLAG_MODULE_OPTIONS');
5
5
  exports.DEFAULT_CACHE_TTL_MS = 30_000;
6
6
  exports.FEATURE_FLAG_KEY = 'FEATURE_FLAG_KEY';
7
7
  exports.FEATURE_FLAG_OPTIONS_KEY = 'FEATURE_FLAG_OPTIONS_KEY';
8
8
  exports.BYPASS_FEATURE_FLAG_KEY = 'BYPASS_FEATURE_FLAG_KEY';
9
+ exports.CACHE_ADAPTER = Symbol('CACHE_ADAPTER');
10
+ exports.FEATURE_FLAG_REPOSITORY = Symbol('FEATURE_FLAG_REPOSITORY');
11
+ exports.TENANT_CONTEXT_PROVIDER = Symbol('TENANT_CONTEXT_PROVIDER');
9
12
  //# sourceMappingURL=feature-flag.constants.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"feature-flag.constants.js","sourceRoot":"","sources":["../src/feature-flag.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,2BAA2B,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC;AAEpE,QAAA,oBAAoB,GAAG,MAAM,CAAC;AAE9B,QAAA,gBAAgB,GAAG,kBAAkB,CAAC;AACtC,QAAA,wBAAwB,GAAG,0BAA0B,CAAC;AACtD,QAAA,uBAAuB,GAAG,yBAAyB,CAAC"}
1
+ {"version":3,"file":"feature-flag.constants.js","sourceRoot":"","sources":["../src/feature-flag.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,2BAA2B,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC;AAEpE,QAAA,oBAAoB,GAAG,MAAM,CAAC;AAE9B,QAAA,gBAAgB,GAAG,kBAAkB,CAAC;AACtC,QAAA,wBAAwB,GAAG,0BAA0B,CAAC;AACtD,QAAA,uBAAuB,GAAG,yBAAyB,CAAC;AAEpD,QAAA,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AACxC,QAAA,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAC5D,QAAA,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC"}
@@ -12,16 +12,21 @@ const common_1 = require("@nestjs/common");
12
12
  const core_1 = require("@nestjs/core");
13
13
  const feature_flag_constants_1 = require("./feature-flag.constants");
14
14
  const feature_flag_service_1 = require("./services/feature-flag.service");
15
- const flag_cache_service_1 = require("./services/flag-cache.service");
15
+ const memory_cache_adapter_1 = require("./cache/memory-cache.adapter");
16
+ const prisma_feature_flag_repository_1 = require("./repositories/prisma-feature-flag.repository");
17
+ const default_tenant_context_provider_1 = require("./services/default-tenant-context-provider");
16
18
  const flag_evaluator_service_1 = require("./services/flag-evaluator.service");
17
19
  const flag_context_1 = require("./services/flag-context");
20
+ const flag_context_resolver_1 = require("./services/flag-context-resolver");
21
+ const flag_event_publisher_1 = require("./services/flag-event-publisher");
18
22
  const feature_flag_guard_1 = require("./guards/feature-flag.guard");
19
23
  const flag_context_middleware_1 = require("./middleware/flag-context.middleware");
20
24
  const FULL_OPTIONS = Symbol('FEATURE_FLAG_FULL_OPTIONS');
21
25
  const coreProviders = [
22
- flag_cache_service_1.FlagCacheService,
23
26
  flag_evaluator_service_1.FlagEvaluatorService,
24
27
  flag_context_1.FlagContext,
28
+ flag_context_resolver_1.FlagContextResolver,
29
+ flag_event_publisher_1.FlagEventPublisher,
25
30
  feature_flag_guard_1.FeatureFlagGuard,
26
31
  feature_flag_service_1.FeatureFlagService,
27
32
  ];
@@ -48,11 +53,29 @@ let FeatureFlagModule = FeatureFlagModule_1 = class FeatureFlagModule {
48
53
  global: true,
49
54
  providers: [
50
55
  { provide: feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS, useValue: moduleOptions },
51
- { provide: 'PRISMA_SERVICE', useValue: prisma },
52
56
  eventProvider,
57
+ {
58
+ provide: feature_flag_constants_1.CACHE_ADAPTER,
59
+ useValue: options.cacheAdapter ?? new memory_cache_adapter_1.MemoryCacheAdapter(),
60
+ },
61
+ {
62
+ provide: feature_flag_constants_1.FEATURE_FLAG_REPOSITORY,
63
+ useValue: new prisma_feature_flag_repository_1.PrismaFeatureFlagRepository(prisma),
64
+ },
65
+ {
66
+ provide: feature_flag_constants_1.TENANT_CONTEXT_PROVIDER,
67
+ useClass: default_tenant_context_provider_1.DefaultTenantContextProvider,
68
+ },
53
69
  ...coreProviders,
54
70
  ],
55
- exports: [feature_flag_service_1.FeatureFlagService, flag_context_1.FlagContext, feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS],
71
+ exports: [
72
+ feature_flag_service_1.FeatureFlagService,
73
+ flag_context_1.FlagContext,
74
+ feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS,
75
+ feature_flag_constants_1.CACHE_ADAPTER,
76
+ feature_flag_constants_1.FEATURE_FLAG_REPOSITORY,
77
+ feature_flag_constants_1.TENANT_CONTEXT_PROVIDER,
78
+ ],
56
79
  };
57
80
  }
58
81
  static forRootAsync(options) {
@@ -68,11 +91,6 @@ let FeatureFlagModule = FeatureFlagModule_1 = class FeatureFlagModule {
68
91
  useFactory: ({ prisma: _, ...moduleOptions }) => moduleOptions,
69
92
  inject: [FULL_OPTIONS],
70
93
  },
71
- {
72
- provide: 'PRISMA_SERVICE',
73
- useFactory: (full) => full.prisma,
74
- inject: [FULL_OPTIONS],
75
- },
76
94
  {
77
95
  provide: 'EVENT_EMITTER',
78
96
  useFactory: (full, moduleRef) => {
@@ -88,9 +106,30 @@ let FeatureFlagModule = FeatureFlagModule_1 = class FeatureFlagModule {
88
106
  },
89
107
  inject: [FULL_OPTIONS, core_1.ModuleRef],
90
108
  },
109
+ {
110
+ provide: feature_flag_constants_1.CACHE_ADAPTER,
111
+ useFactory: (full) => full.cacheAdapter ?? new memory_cache_adapter_1.MemoryCacheAdapter(),
112
+ inject: [FULL_OPTIONS],
113
+ },
114
+ {
115
+ provide: feature_flag_constants_1.FEATURE_FLAG_REPOSITORY,
116
+ useFactory: (full) => new prisma_feature_flag_repository_1.PrismaFeatureFlagRepository(full.prisma),
117
+ inject: [FULL_OPTIONS],
118
+ },
119
+ {
120
+ provide: feature_flag_constants_1.TENANT_CONTEXT_PROVIDER,
121
+ useClass: default_tenant_context_provider_1.DefaultTenantContextProvider,
122
+ },
91
123
  ...coreProviders,
92
124
  ],
93
- exports: [feature_flag_service_1.FeatureFlagService, flag_context_1.FlagContext, feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS],
125
+ exports: [
126
+ feature_flag_service_1.FeatureFlagService,
127
+ flag_context_1.FlagContext,
128
+ feature_flag_constants_1.FEATURE_FLAG_MODULE_OPTIONS,
129
+ feature_flag_constants_1.CACHE_ADAPTER,
130
+ feature_flag_constants_1.FEATURE_FLAG_REPOSITORY,
131
+ feature_flag_constants_1.TENANT_CONTEXT_PROVIDER,
132
+ ],
94
133
  };
95
134
  }
96
135
  static createAsyncProviders(options) {
@@ -1 +1 @@
1
- {"version":3,"file":"feature-flag.module.js","sourceRoot":"","sources":["../src/feature-flag.module.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"feature-flag.module.js","sourceRoot":"","sources":["../src/feature-flag.module.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -6,6 +6,14 @@ export { FeatureFlag } from './decorators/feature-flag.decorator';
6
6
  export { BypassFeatureFlag } from './decorators/bypass-feature-flag.decorator';
7
7
  export { FeatureFlagModuleOptions, FeatureFlagModuleAsyncOptions, FeatureFlagModuleOptionsFactory, } from './interfaces/feature-flag-options.interface';
8
8
  export { EvaluationContext } from './interfaces/evaluation-context.interface';
9
- export { CreateFeatureFlagInput, UpdateFeatureFlagInput, SetOverrideInput, FeatureFlagGuardOptions, FeatureFlagWithOverrides, FlagOverride, } from './interfaces/feature-flag.interface';
9
+ export { CreateFeatureFlagInput, UpdateFeatureFlagInput, SetOverrideInput, RemoveOverrideInput, TargetingAttributeValue, TargetingAttributes, FeatureFlagGuardOptions, FeatureFlagWithOverrides, FlagOverride, } from './interfaces/feature-flag.interface';
10
10
  export { FeatureFlagEvents, FlagEvaluatedEvent, FlagMutationEvent, FlagOverrideEvent, } from './events/feature-flag.events';
11
- export { FEATURE_FLAG_MODULE_OPTIONS } from './feature-flag.constants';
11
+ export { FEATURE_FLAG_MODULE_OPTIONS, CACHE_ADAPTER, FEATURE_FLAG_REPOSITORY, TENANT_CONTEXT_PROVIDER, } from './feature-flag.constants';
12
+ export type { CacheAdapter } from './interfaces/cache-adapter.interface';
13
+ export { MemoryCacheAdapter } from './cache/memory-cache.adapter';
14
+ export { RedisCacheAdapter, type RedisCacheAdapterOptions } from './cache/redis-cache.adapter';
15
+ export type { FeatureFlagRepository, OverrideCriteria, UpdateOverrideInput, } from './interfaces/feature-flag-repository.interface';
16
+ export { PrismaFeatureFlagRepository } from './repositories/prisma-feature-flag.repository';
17
+ export type { TenantContextProvider } from './interfaces/tenant-context-provider.interface';
18
+ export { FeatureFlagAdminModule } from './admin/feature-flag-admin.module';
19
+ export type { FeatureFlagAdminOptions } from './admin/admin-options.interface';