nest-feature-flags 1.0.0

package/.eslintrc.js

@@ -0,0 +1,25 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: 'tsconfig.json',
+    tsconfigRootDir: __dirname,
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint/eslint-plugin'],
+  extends: [
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+  },
+  ignorePatterns: ['.eslintrc.js'],
+  rules: {
+    '@typescript-eslint/interface-name-prefix': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'warn',
+  },
+};

package/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "semi": true,
+  "endOfLine": "lf"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alireza Aminzadeh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,153 @@
+# nest-feature-flags
+
+[![npm version](https://badge.fury.io/js/nest-feature-flags.svg)](https://www.npmjs.com/package/nest-feature-flags)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Professional feature flag management system for NestJS with A/B testing, gradual rollouts, user targeting, and real-time updates.
+
+## 🚀 Features
+
+- **Feature Toggles** - Enable/disable features instantly
+- **Gradual Rollouts** - Percentage-based feature releases
+- **A/B Testing** - Run experiments with user segmentation
+- **User Targeting** - Target specific users or groups
+- **Real-time Updates** - Changes reflect immediately
+- **Type-Safe** - Full TypeScript support
+- **Production-Ready** - Built for enterprise applications
+
+## 📦 Installation
+
+```bash
+npm install nest-feature-flags
+```
+
+## 🔧 Quick Start
+
+### 1. Import Module
+
+```typescript
+import { Module } from '@nestjs/common';
+import { FeatureFlagsModule } from 'nest-feature-flags';
+
+@Module({
+  imports: [
+    FeatureFlagsModule.forRoot({
+      flags: {
+        'new-ui': { enabled: true },
+        'beta-feature': { enabled: false },
+        'gradual-rollout': { enabled: true, percentage: 50 },
+      },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### 2. Use in Services
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { FeatureFlagService } from 'nest-feature-flags';
+
+@Injectable()
+export class MyService {
+  constructor(private featureFlags: FeatureFlagService) {}
+
+  async doSomething(userId: string) {
+    if (await this.featureFlags.isEnabled('new-ui', { userId })) {
+      return 'New UI experience';
+    }
+    return 'Classic UI';
+  }
+}
+```
+
+### 3. Use Guards
+
+```typescript
+import { Controller, Get, UseGuards } from '@nestjs/common';
+import { FeatureFlagGuard, RequireFeature } from 'nest-feature-flags';
+
+@Controller('beta')
+export class BetaController {
+  @Get()
+  @UseGuards(FeatureFlagGuard)
+  @RequireFeature('beta-feature')
+  async betaEndpoint() {
+    return { message: 'Beta feature active!' };
+  }
+}
+```
+
+## 📖 Documentation
+
+### Feature Flag Configuration
+
+```typescript
+{
+  'flag-name': {
+    enabled: true,              // Master switch
+    percentage: 50,             // Gradual rollout (0-100)
+    userIds: ['user1', 'user2'], // Specific users
+    groups: ['beta-testers'],    // User groups
+    startDate: new Date(),       // Schedule activation
+    endDate: new Date(),         // Schedule deactivation
+  }
+}
+```
+
+### Advanced Usage
+
+#### Percentage-based Rollout
+
+```typescript
+FeatureFlagsModule.forRoot({
+  flags: {
+    'new-checkout': {
+      enabled: true,
+      percentage: 25, // 25% of users see this
+    },
+  },
+});
+```
+
+#### User Targeting
+
+```typescript
+const isEnabled = await featureFlags.isEnabled('premium-feature', {
+  userId: 'user123',
+  groups: ['premium', 'beta'],
+});
+```
+
+#### A/B Testing
+
+```typescript
+const variant = await featureFlags.getVariant('experiment-1', {
+  userId: 'user123',
+  variants: ['control', 'variant-a', 'variant-b'],
+});
+```
+
+## 🎯 Use Cases
+
+- **Canary Releases** - Roll out features gradually
+- **A/B Testing** - Test different implementations
+- **Beta Programs** - Limit features to beta users
+- **Kill Switches** - Disable features instantly
+- **Scheduled Releases** - Launch features at specific times
+
+## 👤 Author
+
+**Alireza Aminzadeh**
+- Email: alireza.aminzadeh@hotmail.com
+- GitHub: [@syeedalireza](https://github.com/syeedalireza)
+- NPM: [@syeedalireza](https://www.npmjs.com/~syeedalireza)
+
+## 📄 License
+
+MIT License - see [LICENSE](./LICENSE) file
+
+---
+
+**Built with ❤️ for the NestJS community**

package/dist/decorators/feature-flag.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const FEATURE_FLAG_KEY = "feature_flag_key";
+export declare const RequireFeature: (flagKey: string) => import("@nestjs/common").CustomDecorator<string>;

package/dist/decorators/feature-flag.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequireFeature = exports.FEATURE_FLAG_KEY = void 0;
+const common_1 = require("@nestjs/common");
+exports.FEATURE_FLAG_KEY = 'feature_flag_key';
+const RequireFeature = (flagKey) => (0, common_1.SetMetadata)(exports.FEATURE_FLAG_KEY, flagKey);
+exports.RequireFeature = RequireFeature;
+//# sourceMappingURL=feature-flag.decorator.js.map

package/dist/decorators/feature-flag.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.decorator.js","sourceRoot":"","sources":["../../src/decorators/feature-flag.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAEhC,QAAA,gBAAgB,GAAG,kBAAkB,CAAC;AAK5C,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAA,oBAAW,EAAC,wBAAgB,EAAE,OAAO,CAAC,CAAC;AAA7E,QAAA,cAAc,kBAA+D"}

package/dist/feature-flags.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule } from '@nestjs/common';
+import { FeatureFlagsModuleOptions, FeatureFlagsModuleAsyncOptions } from './interfaces/feature-flag-options.interface';
+export declare class FeatureFlagsModule {
+    static forRoot(options: FeatureFlagsModuleOptions): DynamicModule;
+    static forRootAsync(options: FeatureFlagsModuleAsyncOptions): DynamicModule;
+}

package/dist/feature-flags.module.js

@@ -0,0 +1,53 @@
+"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 FeatureFlagsModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagsModule = void 0;
+const common_1 = require("@nestjs/common");
+const feature_flag_service_1 = require("./services/feature-flag.service");
+const feature_flag_guard_1 = require("./guards/feature-flag.guard");
+let FeatureFlagsModule = FeatureFlagsModule_1 = class FeatureFlagsModule {
+    static forRoot(options) {
+        return {
+            module: FeatureFlagsModule_1,
+            providers: [
+                {
+                    provide: feature_flag_service_1.OPTIONS_TOKEN,
+                    useValue: options,
+                },
+                feature_flag_service_1.FeatureFlagService,
+                feature_flag_guard_1.FeatureFlagGuard,
+            ],
+            exports: [feature_flag_service_1.FeatureFlagService, feature_flag_guard_1.FeatureFlagGuard],
+            global: true,
+        };
+    }
+    static forRootAsync(options) {
+        return {
+            module: FeatureFlagsModule_1,
+            imports: options.imports || [],
+            providers: [
+                {
+                    provide: feature_flag_service_1.OPTIONS_TOKEN,
+                    useFactory: options.useFactory,
+                    inject: options.inject || [],
+                },
+                feature_flag_service_1.FeatureFlagService,
+                feature_flag_guard_1.FeatureFlagGuard,
+            ],
+            exports: [feature_flag_service_1.FeatureFlagService, feature_flag_guard_1.FeatureFlagGuard],
+            global: true,
+        };
+    }
+};
+exports.FeatureFlagsModule = FeatureFlagsModule;
+exports.FeatureFlagsModule = FeatureFlagsModule = FeatureFlagsModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], FeatureFlagsModule);
+//# sourceMappingURL=feature-flags.module.js.map

package/dist/feature-flags.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.module.js","sourceRoot":"","sources":["../src/feature-flags.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA+D;AAE/D,0EAAoF;AACpF,oEAA+D;AAIxD,IAAM,kBAAkB,0BAAxB,MAAM,kBAAkB;IAC7B,MAAM,CAAC,OAAO,CAAC,OAAkC;QAC/C,OAAO;YACL,MAAM,EAAE,oBAAkB;YAC1B,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,oCAAa;oBACtB,QAAQ,EAAE,OAAO;iBAClB;gBACD,yCAAkB;gBAClB,qCAAgB;aACjB;YACD,OAAO,EAAE,CAAC,yCAAkB,EAAE,qCAAgB,CAAC;YAC/C,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAuC;QACzD,OAAO;YACL,MAAM,EAAE,oBAAkB;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,oCAAa;oBACtB,UAAU,EAAE,OAAO,CAAC,UAAW;oBAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;iBAC7B;gBACD,yCAAkB;gBAClB,qCAAgB;aACjB;YACD,OAAO,EAAE,CAAC,yCAAkB,EAAE,qCAAgB,CAAC;YAC/C,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AAlCY,gDAAkB;6BAAlB,kBAAkB;IAF9B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,kBAAkB,CAkC9B"}

package/dist/guards/feature-flag.guard.d.ts

@@ -0,0 +1,9 @@
+import { CanActivate, ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { FeatureFlagService } from '../services/feature-flag.service';
+export declare class FeatureFlagGuard implements CanActivate {
+    private readonly reflector;
+    private readonly featureFlagService;
+    constructor(reflector: Reflector, featureFlagService: FeatureFlagService);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+}

package/dist/guards/feature-flag.guard.js

@@ -0,0 +1,46 @@
+"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.FeatureFlagGuard = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const feature_flag_service_1 = require("../services/feature-flag.service");
+const feature_flag_decorator_1 = require("../decorators/feature-flag.decorator");
+let FeatureFlagGuard = class FeatureFlagGuard {
+    constructor(reflector, featureFlagService) {
+        this.reflector = reflector;
+        this.featureFlagService = featureFlagService;
+    }
+    async canActivate(context) {
+        const flagKey = this.reflector.get(feature_flag_decorator_1.FEATURE_FLAG_KEY, context.getHandler());
+        if (!flagKey) {
+            return true;
+        }
+        const request = context.switchToHttp().getRequest();
+        const userId = request.user?.id || request.userId;
+        const groups = request.user?.groups || [];
+        const enabled = await this.featureFlagService.isEnabled(flagKey, {
+            userId,
+            groups,
+        });
+        if (!enabled) {
+            throw new common_1.ForbiddenException(`Feature '${flagKey}' is not available`);
+        }
+        return true;
+    }
+};
+exports.FeatureFlagGuard = FeatureFlagGuard;
+exports.FeatureFlagGuard = FeatureFlagGuard = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.Reflector,
+        feature_flag_service_1.FeatureFlagService])
+], FeatureFlagGuard);
+//# sourceMappingURL=feature-flag.guard.js.map

package/dist/guards/feature-flag.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.guard.js","sourceRoot":"","sources":["../../src/guards/feature-flag.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA+F;AAC/F,uCAAyC;AACzC,2EAAsE;AACtE,iFAAwE;AAGjE,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YACmB,SAAoB,EACpB,kBAAsC;QADtC,cAAS,GAAT,SAAS,CAAW;QACpB,uBAAkB,GAAlB,kBAAkB,CAAoB;IACtD,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,OAAyB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAS,yCAAgB,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAEnF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;QAE1C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE;YAC/D,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,2BAAkB,CAAC,YAAY,OAAO,oBAAoB,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA5BY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;qCAGmB,gBAAS;QACA,yCAAkB;GAH9C,gBAAgB,CA4B5B"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './feature-flags.module';
+export * from './services/feature-flag.service';
+export * from './guards/feature-flag.guard';
+export * from './decorators/feature-flag.decorator';
+export * from './interfaces/feature-flag.interface';
+export * from './interfaces/feature-flag-options.interface';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./feature-flags.module"), exports);
+__exportStar(require("./services/feature-flag.service"), exports);
+__exportStar(require("./guards/feature-flag.guard"), exports);
+__exportStar(require("./decorators/feature-flag.decorator"), exports);
+__exportStar(require("./interfaces/feature-flag.interface"), exports);
+__exportStar(require("./interfaces/feature-flag-options.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,yDAAuC;AAGvC,kEAAgD;AAGhD,8DAA4C;AAC5C,sEAAoD;AAGpD,sEAAoD;AACpD,8EAA4D"}

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

@@ -0,0 +1,10 @@
+import { ModuleMetadata } from '@nestjs/common';
+import { FeatureFlag } from './feature-flag.interface';
+export interface FeatureFlagsModuleOptions {
+    flags: Record<string, FeatureFlag>;
+    defaultValue?: boolean;
+}
+export interface FeatureFlagsModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useFactory?: (...args: any[]) => Promise<FeatureFlagsModuleOptions> | FeatureFlagsModuleOptions;
+    inject?: any[];
+}

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

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

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

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

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

@@ -0,0 +1,20 @@
+export interface FeatureFlag {
+    enabled: boolean;
+    percentage?: number;
+    userIds?: string[];
+    groups?: string[];
+    startDate?: Date;
+    endDate?: Date;
+    description?: string;
+}
+export interface FeatureFlagContext {
+    userId?: string;
+    groups?: string[];
+    attributes?: Record<string, any>;
+}
+export interface FeatureFlagResult {
+    key: string;
+    enabled: boolean;
+    reason: string;
+    variant?: string;
+}

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

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

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

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

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

@@ -0,0 +1,12 @@
+import { FeatureFlag, FeatureFlagContext, FeatureFlagResult } from '../interfaces/feature-flag.interface';
+import { FeatureFlagsModuleOptions } from '../interfaces/feature-flag-options.interface';
+declare const OPTIONS_TOKEN = "FEATURE_FLAGS_OPTIONS";
+export declare class FeatureFlagService {
+    private readonly options;
+    constructor(options: FeatureFlagsModuleOptions);
+    isEnabled(key: string, context?: FeatureFlagContext): Promise<boolean>;
+    evaluate(key: string, context?: FeatureFlagContext): Promise<FeatureFlagResult>;
+    getAllFlags(): Record<string, FeatureFlag>;
+    private hashUserId;
+}
+export { OPTIONS_TOKEN };

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

@@ -0,0 +1,86 @@
+"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.OPTIONS_TOKEN = exports.FeatureFlagService = void 0;
+const common_1 = require("@nestjs/common");
+const OPTIONS_TOKEN = 'FEATURE_FLAGS_OPTIONS';
+exports.OPTIONS_TOKEN = OPTIONS_TOKEN;
+let FeatureFlagService = class FeatureFlagService {
+    constructor(options) {
+        this.options = options;
+    }
+    async isEnabled(key, context) {
+        const result = await this.evaluate(key, context);
+        return result.enabled;
+    }
+    async evaluate(key, context) {
+        const flag = this.options.flags[key];
+        if (!flag) {
+            return {
+                key,
+                enabled: this.options.defaultValue ?? false,
+                reason: 'Flag not found',
+            };
+        }
+        if (!flag.enabled) {
+            return { key, enabled: false, reason: 'Flag disabled' };
+        }
+        const now = new Date();
+        if (flag.startDate && now < flag.startDate) {
+            return { key, enabled: false, reason: 'Not started yet' };
+        }
+        if (flag.endDate && now > flag.endDate) {
+            return { key, enabled: false, reason: 'Expired' };
+        }
+        if (context?.userId && flag.userIds?.includes(context.userId)) {
+            return { key, enabled: true, reason: 'User targeted' };
+        }
+        if (context?.groups && flag.groups) {
+            const hasGroup = context.groups.some(g => flag.groups.includes(g));
+            if (hasGroup) {
+                return { key, enabled: true, reason: 'Group targeted' };
+            }
+        }
+        if (flag.percentage !== undefined) {
+            const hash = this.hashUserId(context?.userId || 'anonymous');
+            const userPercentage = hash % 100;
+            const enabled = userPercentage < flag.percentage;
+            return {
+                key,
+                enabled,
+                reason: enabled ? 'In percentage rollout' : 'Not in percentage rollout',
+            };
+        }
+        return { key, enabled: true, reason: 'Fully enabled' };
+    }
+    getAllFlags() {
+        return this.options.flags;
+    }
+    hashUserId(userId) {
+        let hash = 0;
+        for (let i = 0; i < userId.length; i++) {
+            const char = userId.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash);
+    }
+};
+exports.FeatureFlagService = FeatureFlagService;
+exports.FeatureFlagService = FeatureFlagService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(OPTIONS_TOKEN)),
+    __metadata("design:paramtypes", [Object])
+], FeatureFlagService);
+//# sourceMappingURL=feature-flag.service.js.map

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

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