@nestarc/feature-flag 0.2.0 → 0.4.0

package/dist/admin/feature-flag-admin.dto.js

@@ -0,0 +1,116 @@
+"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.EvaluateFeatureFlagDto = exports.RemoveOverrideDto = exports.SetOverrideDto = exports.UpdateFeatureFlagDto = exports.CreateFeatureFlagDto = void 0;
+const class_validator_1 = require("class-validator");
+const targeting_attributes_validator_1 = require("./targeting-attributes.validator");
+class CreateFeatureFlagDto {
+}
+exports.CreateFeatureFlagDto = CreateFeatureFlagDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateFeatureFlagDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFeatureFlagDto.prototype, "description", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateFeatureFlagDto.prototype, "enabled", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], CreateFeatureFlagDto.prototype, "percentage", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], CreateFeatureFlagDto.prototype, "metadata", void 0);
+class UpdateFeatureFlagDto {
+}
+exports.UpdateFeatureFlagDto = UpdateFeatureFlagDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFeatureFlagDto.prototype, "description", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateFeatureFlagDto.prototype, "enabled", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], UpdateFeatureFlagDto.prototype, "percentage", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], UpdateFeatureFlagDto.prototype, "metadata", void 0);
+class SetOverrideDto {
+}
+exports.SetOverrideDto = SetOverrideDto;
+__decorate([
+    (0, targeting_attributes_validator_1.IsTargetingAttributes)(),
+    __metadata("design:type", Object)
+], SetOverrideDto.prototype, "attributes", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], SetOverrideDto.prototype, "enabled", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], SetOverrideDto.prototype, "priority", void 0);
+class RemoveOverrideDto {
+}
+exports.RemoveOverrideDto = RemoveOverrideDto;
+__decorate([
+    (0, targeting_attributes_validator_1.IsTargetingAttributes)(),
+    __metadata("design:type", Object)
+], RemoveOverrideDto.prototype, "attributes", void 0);
+class EvaluateFeatureFlagDto {
+}
+exports.EvaluateFeatureFlagDto = EvaluateFeatureFlagDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], EvaluateFeatureFlagDto.prototype, "context", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], EvaluateFeatureFlagDto.prototype, "defaultValue", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], EvaluateFeatureFlagDto.prototype, "trackExposure", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], EvaluateFeatureFlagDto.prototype, "includeContextInEvent", void 0);
+//# sourceMappingURL=feature-flag-admin.dto.js.map

package/dist/admin/feature-flag-admin.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-admin.dto.js","sourceRoot":"","sources":["../../src/admin/feature-flag-admin.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDASyB;AAIzB,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;AAGnC,MAAa,sBAAsB;CAgBlC;AAhBD,wDAgBC;AAbC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;uDACiB;AAI5B;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;4DACW;AAIvB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;6DACY;AAIxB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;qEACoB"}

package/dist/admin/targeting-attributes.validator.d.ts

@@ -0,0 +1,6 @@
+import { ValidationArguments, ValidationOptions, ValidatorConstraintInterface } from 'class-validator';
+export declare class IsTargetingAttributesConstraint implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean;
+    defaultMessage(_args: ValidationArguments): string;
+}
+export declare function IsTargetingAttributes(validationOptions?: ValidationOptions): (target: object, propertyName: string) => void;

package/dist/admin/targeting-attributes.validator.js

@@ -0,0 +1,36 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsTargetingAttributesConstraint = void 0;
+exports.IsTargetingAttributes = IsTargetingAttributes;
+const class_validator_1 = require("class-validator");
+const targeting_attributes_1 = require("../utils/targeting-attributes");
+let IsTargetingAttributesConstraint = class IsTargetingAttributesConstraint {
+    validate(value) {
+        return (0, targeting_attributes_1.isTargetingAttributes)(value, { allowEmpty: false });
+    }
+    defaultMessage(_args) {
+        return 'attributes must be a non-empty object with string, number, boolean, or null values';
+    }
+};
+exports.IsTargetingAttributesConstraint = IsTargetingAttributesConstraint;
+exports.IsTargetingAttributesConstraint = IsTargetingAttributesConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isTargetingAttributes', async: false })
+], IsTargetingAttributesConstraint);
+function IsTargetingAttributes(validationOptions) {
+    return function registerTargetingAttributesDecorator(target, propertyName) {
+        (0, class_validator_1.registerDecorator)({
+            target: target.constructor,
+            propertyName,
+            options: validationOptions,
+            constraints: [],
+            validator: IsTargetingAttributesConstraint,
+        });
+    };
+}
+//# sourceMappingURL=targeting-attributes.validator.js.map

package/dist/admin/targeting-attributes.validator.js.map

@@ -0,0 +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"}

package/dist/events/feature-flag.events.d.ts

@@ -1,6 +1,8 @@
 import { EvaluationContext } from '../interfaces/evaluation-context.interface';
+import { EvaluationReason, EvaluationSource } from '../interfaces/evaluation-details.interface';
 export declare const FeatureFlagEvents: {
     readonly EVALUATED: "feature-flag.evaluated";
+    readonly EXPOSED: "feature-flag.exposed";
     readonly CREATED: "feature-flag.created";
     readonly UPDATED: "feature-flag.updated";
     readonly ARCHIVED: "feature-flag.archived";
@@ -11,19 +13,49 @@ export declare const FeatureFlagEvents: {
 export interface FlagEvaluatedEvent {
     flagKey: string;
     result: boolean;
-    context: EvaluationContext;
-    source: 'user_override' | 'tenant_override' | 'env_override' | 'percentage' | 'global';
+    value?: boolean;
+    context?: EvaluationContext;
+    source: EvaluationSource;
+    reason?: EvaluationReason;
+    defaultUsed?: boolean;
+    errorCode?: string;
+    errorMessage?: string;
+    matchedOverrideId?: string;
+    bucket?: number;
+    targetingKey?: string;
     evaluationTimeMs: number;
 }
+export interface FlagExposedEvent {
+    flagKey: string;
+    value: boolean;
+    result: boolean;
+    source: EvaluationSource;
+    reason: EvaluationReason;
+    defaultUsed: boolean;
+    context?: EvaluationContext;
+    matchedOverrideId?: string;
+    bucket?: number;
+    targetingKey?: string;
+    evaluationTimeMs?: number;
+}
 export interface FlagMutationEvent {
     flagKey: string;
     action: 'created' | 'updated' | 'archived';
+    actorId?: string;
+    actorType?: string;
+    reason?: string;
+    requestId?: string;
+    correlationId?: string;
 }
 export interface FlagOverrideEvent {
     flagKey: string;
-    tenantId?: string | null;
-    userId?: string | null;
-    environment?: string | null;
-    enabled: boolean;
+    attributes: Record<string, string | number | boolean | null>;
+    enabled?: boolean;
+    priority?: number;
     action: 'set' | 'removed';
+    actorId?: string;
+    actorType?: string;
+    reason?: string;
+    requestId?: string;
+    correlationId?: string;
 }

package/dist/events/feature-flag.events.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeatureFlagEvents = void 0;
 exports.FeatureFlagEvents = {
     EVALUATED: 'feature-flag.evaluated',
+    EXPOSED: 'feature-flag.exposed',
     CREATED: 'feature-flag.created',
     UPDATED: 'feature-flag.updated',
     ARCHIVED: 'feature-flag.archived',

package/dist/events/feature-flag.events.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flag.events.js","sourceRoot":"","sources":["../../src/events/feature-flag.events.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAG;IAC/B,SAAS,EAAE,wBAAwB;IACnC,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,uBAAuB;IACjC,YAAY,EAAE,2BAA2B;IACzC,gBAAgB,EAAE,+BAA+B;IACjD,iBAAiB,EAAE,gCAAgC;CAC3C,CAAC"}
+{"version":3,"file":"feature-flag.events.js","sourceRoot":"","sources":["../../src/events/feature-flag.events.ts"],"names":[],"mappings":";;;AAMa,QAAA,iBAAiB,GAAG;IAC/B,SAAS,EAAE,wBAAwB;IACnC,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,uBAAuB;IACjC,YAAY,EAAE,2BAA2B;IACzC,gBAAgB,EAAE,+BAA+B;IACjD,iBAAiB,EAAE,gCAAgC;CAC3C,CAAC"}

package/dist/flag-registry.d.ts

@@ -0,0 +1,24 @@
+import { EvaluationContext } from './interfaces/evaluation-context.interface';
+import { BooleanEvaluationDetails, EvaluateBooleanOptions } from './interfaces/evaluation-details.interface';
+import { FeatureFlagGuardOptions } from './interfaces/feature-flag.interface';
+import { FeatureFlagLifecycleMetadata, FlagKey, FlagRegistry } from './interfaces/flag-registry.interface';
+import { FeatureFlagService } from './services/feature-flag.service';
+export interface TypedFeatureFlagClient<TFlags extends FlagRegistry> {
+    isEnabled<K extends FlagKey<TFlags>>(flagKey: K, context?: EvaluationContext, options?: EvaluateBooleanOptions): Promise<boolean>;
+    evaluateBoolean<K extends FlagKey<TFlags>>(flagKey: K, context?: EvaluationContext, options?: EvaluateBooleanOptions): Promise<BooleanEvaluationDetails>;
+    registry: TFlags;
+}
+export interface TypedFeatureFlagDecorators<TFlags extends FlagRegistry> {
+    FeatureFlag<K extends FlagKey<TFlags>>(flagKey: K, options?: FeatureFlagGuardOptions): ClassDecorator & MethodDecorator;
+}
+export type FlagLifecycleStatusName = 'active' | 'stale' | 'expired';
+export interface FlagLifecycleStatus extends FeatureFlagLifecycleMetadata {
+    status: FlagLifecycleStatusName;
+    tags: string[];
+    staleAt?: Date;
+    expiresAt?: Date;
+}
+export declare function defineFlags<const TFlags extends FlagRegistry>(flags: TFlags): TFlags;
+export declare function createFeatureFlagClient<TFlags extends FlagRegistry>(service: FeatureFlagService, registry: TFlags): TypedFeatureFlagClient<TFlags>;
+export declare function createFeatureFlagDecorators<TFlags extends FlagRegistry>(registry: TFlags): TypedFeatureFlagDecorators<TFlags>;
+export declare function getFlagLifecycleStatus(metadata: FeatureFlagLifecycleMetadata, now?: Date): FlagLifecycleStatus;

package/dist/flag-registry.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineFlags = defineFlags;
+exports.createFeatureFlagClient = createFeatureFlagClient;
+exports.createFeatureFlagDecorators = createFeatureFlagDecorators;
+exports.getFlagLifecycleStatus = getFlagLifecycleStatus;
+const feature_flag_decorator_1 = require("./decorators/feature-flag.decorator");
+function defineFlags(flags) {
+    return flags;
+}
+function createFeatureFlagClient(service, registry) {
+    return {
+        registry,
+        isEnabled: (flagKey, context, options) => service.isEnabled(flagKey, context, mergeRegistryOptions(registry[flagKey], options)),
+        evaluateBoolean: (flagKey, context, options) => service.evaluateBoolean(flagKey, context, mergeRegistryOptions(registry[flagKey], options)),
+    };
+}
+function createFeatureFlagDecorators(registry) {
+    return {
+        FeatureFlag: (flagKey, options = {}) => (0, feature_flag_decorator_1.FeatureFlag)(flagKey, {
+            defaultValue: registry[flagKey].defaultValue,
+            ...options,
+        }),
+    };
+}
+function getFlagLifecycleStatus(metadata, now = new Date()) {
+    const staleAt = parseLifecycleDate(metadata.staleAt);
+    const expiresAt = parseLifecycleDate(metadata.expiresAt);
+    const status = getLifecycleStatusName(now, staleAt, expiresAt);
+    return {
+        ...metadata,
+        tags: [...(metadata.tags ?? [])],
+        staleAt,
+        expiresAt,
+        status,
+    };
+}
+function mergeRegistryOptions(definition, options = {}) {
+    const merged = {
+        defaultValue: definition.defaultValue,
+    };
+    if (definition.trackExposure !== undefined) {
+        merged.trackExposure = definition.trackExposure;
+    }
+    return { ...merged, ...options };
+}
+function getLifecycleStatusName(now, staleAt, expiresAt) {
+    if (expiresAt && now >= expiresAt) {
+        return 'expired';
+    }
+    if (staleAt && now >= staleAt) {
+        return 'stale';
+    }
+    return 'active';
+}
+function parseLifecycleDate(value) {
+    if (!value) {
+        return undefined;
+    }
+    return value instanceof Date ? value : new Date(value);
+}
+//# sourceMappingURL=flag-registry.js.map

package/dist/flag-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-registry.js","sourceRoot":"","sources":["../src/flag-registry.ts"],"names":[],"mappings":";;AA8CA,kCAEC;AAED,0DAeC;AAED,kEAUC;AAED,wDAeC;AA9FD,gFAAkE;AA8ClE,SAAgB,WAAW,CAAoC,KAAa;IAC1E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,uBAAuB,CACrC,OAA2B,EAC3B,QAAgB;IAEhB,OAAO;QACL,QAAQ;QACR,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CACvC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QACvF,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAC7C,OAAO,CAAC,eAAe,CACrB,OAAO,EACP,OAAO,EACP,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CACjD;KACJ,CAAC;AACJ,CAAC;AAED,SAAgB,2BAA2B,CACzC,QAAgB;IAEhB,OAAO;QACL,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CACrC,IAAA,oCAAW,EAAC,OAAO,EAAE;YACnB,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,YAAY;YAC5C,GAAG,OAAO;SACX,CAAC;KACL,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CACpC,QAAsC,EACtC,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAE/D,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAChC,OAAO;QACP,SAAS;QACT,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,UAAgC,EAChC,UAAkC,EAAE;IAEpC,MAAM,MAAM,GAA2B;QACrC,YAAY,EAAE,UAAU,CAAC,YAAY;KACtC,CAAC;IAEF,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;IAClD,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,sBAAsB,CAC7B,GAAS,EACT,OAAc,EACd,SAAgB;IAEhB,IAAI,SAAS,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAgC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

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

@@ -35,7 +35,11 @@ let FeatureFlagGuard = class FeatureFlagGuard {
         const options = this.reflector.get(feature_flag_constants_1.FEATURE_FLAG_OPTIONS_KEY, handler) ??
             this.reflector.get(feature_flag_constants_1.FEATURE_FLAG_OPTIONS_KEY, classRef) ??
             {};
-        const enabled = await this.featureFlagService.isEnabled(flagKey);
+        const enabled = options.defaultValue === undefined
+            ? await this.featureFlagService.isEnabled(flagKey)
+            : await this.featureFlagService.isEnabled(flagKey, undefined, {
+                defaultValue: options.defaultValue,
+            });
         if (!enabled) {
             const statusCode = options.statusCode ?? 403;
             const body = options.fallback ?? { message: 'Feature not available' };

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

@@ -1 +1 @@
-{"version":3,"file":"feature-flag.guard.js","sourceRoot":"","sources":["../../src/guards/feature-flag.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0F;AAC1F,uCAAyC;AACzC,2EAAsE;AACtE,sEAImC;AAI5B,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,OAAO,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEpC,eAAe;QACf,MAAM,MAAM,GACV,IAAI,CAAC,SAAS,CAAC,GAAG,CAAU,gDAAuB,EAAE,OAAO,CAAC;YAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAU,gDAAuB,EAAE,QAAQ,CAAC,CAAC;QACjE,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC;QAExB,yDAAyD;QACzD,MAAM,OAAO,GACX,IAAI,CAAC,SAAS,CAAC,GAAG,CAAS,yCAAgB,EAAE,OAAO,CAAC;YACrD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAS,yCAAgB,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,OAAO,GACX,IAAI,CAAC,SAAS,CAAC,GAAG,CAA0B,iDAAwB,EAAE,OAAO,CAAC;YAC9E,IAAI,CAAC,SAAS,CAAC,GAAG,CAA0B,iDAAwB,EAAE,QAAQ,CAAC;YAC/E,EAAE,CAAC;QAEL,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEjE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;YAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;YACtE,MAAM,IAAI,sBAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AArCY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;qCAGmB,gBAAS;QACA,yCAAkB;GAH9C,gBAAgB,CAqC5B"}
+{"version":3,"file":"feature-flag.guard.js","sourceRoot":"","sources":["../../src/guards/feature-flag.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0F;AAC1F,uCAAyC;AACzC,2EAAsE;AACtE,sEAImC;AAI5B,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,OAAO,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEpC,eAAe;QACf,MAAM,MAAM,GACV,IAAI,CAAC,SAAS,CAAC,GAAG,CAAU,gDAAuB,EAAE,OAAO,CAAC;YAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAU,gDAAuB,EAAE,QAAQ,CAAC,CAAC;QACjE,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC;QAExB,yDAAyD;QACzD,MAAM,OAAO,GACX,IAAI,CAAC,SAAS,CAAC,GAAG,CAAS,yCAAgB,EAAE,OAAO,CAAC;YACrD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAS,yCAAgB,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,OAAO,GACX,IAAI,CAAC,SAAS,CAAC,GAAG,CAA0B,iDAAwB,EAAE,OAAO,CAAC;YAC9E,IAAI,CAAC,SAAS,CAAC,GAAG,CAA0B,iDAAwB,EAAE,QAAQ,CAAC;YAC/E,EAAE,CAAC;QAEL,MAAM,OAAO,GACX,OAAO,CAAC,YAAY,KAAK,SAAS;YAChC,CAAC,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC;YAClD,CAAC,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE;gBAC1D,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;QAET,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;YAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;YACtE,MAAM,IAAI,sBAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA1CY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;qCAGmB,gBAAS;QACA,yCAAkB;GAH9C,gBAAgB,CA0C5B"}

package/dist/index.d.ts

@@ -6,13 +6,16 @@ export { FeatureFlag } from './decorators/feature-flag.decorator';
 export { BypassFeatureFlag } from './decorators/bypass-feature-flag.decorator';
 export { FeatureFlagModuleOptions, FeatureFlagModuleAsyncOptions, FeatureFlagModuleOptionsFactory, } from './interfaces/feature-flag-options.interface';
 export { EvaluationContext } from './interfaces/evaluation-context.interface';
-export { CreateFeatureFlagInput, UpdateFeatureFlagInput, SetOverrideInput, RemoveOverrideInput, FeatureFlagGuardOptions, FeatureFlagWithOverrides, FlagOverride, } from './interfaces/feature-flag.interface';
-export { FeatureFlagEvents, FlagEvaluatedEvent, FlagMutationEvent, FlagOverrideEvent, } from './events/feature-flag.events';
+export { EvaluationSource, EvaluationReason, EvaluateBooleanOptions, BooleanEvaluationDetails, BucketBy, FlagEvaluatorOptions, } from './interfaces/evaluation-details.interface';
+export { FeatureFlagLifecycleMetadata, FeatureFlagType, FlagDefinition, FlagRegistry, FlagKey, } from './interfaces/flag-registry.interface';
+export { CreateFeatureFlagInput, UpdateFeatureFlagInput, SetOverrideInput, RemoveOverrideInput, TargetingAttributeValue, TargetingAttributes, FeatureFlagGuardOptions, FeatureFlagWithOverrides, FlagOverride, FlagMutationMetadata, } from './interfaces/feature-flag.interface';
+export { defineFlags, createFeatureFlagClient, createFeatureFlagDecorators, getFlagLifecycleStatus, TypedFeatureFlagClient, TypedFeatureFlagDecorators, FlagLifecycleStatus, FlagLifecycleStatusName, } from './flag-registry';
+export { FeatureFlagEvents, FlagEvaluatedEvent, FlagExposedEvent, FlagMutationEvent, FlagOverrideEvent, } from './events/feature-flag.events';
 export { FEATURE_FLAG_MODULE_OPTIONS, CACHE_ADAPTER, FEATURE_FLAG_REPOSITORY, TENANT_CONTEXT_PROVIDER, } from './feature-flag.constants';
 export type { CacheAdapter } from './interfaces/cache-adapter.interface';
 export { MemoryCacheAdapter } from './cache/memory-cache.adapter';
 export { RedisCacheAdapter, type RedisCacheAdapterOptions } from './cache/redis-cache.adapter';
-export type { FeatureFlagRepository, OverrideCriteria } from './interfaces/feature-flag-repository.interface';
+export type { FeatureFlagRepository, OverrideCriteria, UpdateOverrideInput, } from './interfaces/feature-flag-repository.interface';
 export { PrismaFeatureFlagRepository } from './repositories/prisma-feature-flag.repository';
 export type { TenantContextProvider } from './interfaces/tenant-context-provider.interface';
 export { FeatureFlagAdminModule } from './admin/feature-flag-admin.module';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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.getFlagLifecycleStatus = exports.createFeatureFlagDecorators = exports.createFeatureFlagClient = exports.defineFlags = 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; } });
@@ -17,6 +17,12 @@ var feature_flag_decorator_1 = require("./decorators/feature-flag.decorator");
 Object.defineProperty(exports, "FeatureFlag", { enumerable: true, get: function () { return feature_flag_decorator_1.FeatureFlag; } });
 var bypass_feature_flag_decorator_1 = require("./decorators/bypass-feature-flag.decorator");
 Object.defineProperty(exports, "BypassFeatureFlag", { enumerable: true, get: function () { return bypass_feature_flag_decorator_1.BypassFeatureFlag; } });
+// Registry helpers
+var flag_registry_1 = require("./flag-registry");
+Object.defineProperty(exports, "defineFlags", { enumerable: true, get: function () { return flag_registry_1.defineFlags; } });
+Object.defineProperty(exports, "createFeatureFlagClient", { enumerable: true, get: function () { return flag_registry_1.createFeatureFlagClient; } });
+Object.defineProperty(exports, "createFeatureFlagDecorators", { enumerable: true, get: function () { return flag_registry_1.createFeatureFlagDecorators; } });
+Object.defineProperty(exports, "getFlagLifecycleStatus", { enumerable: true, get: function () { return flag_registry_1.getFlagLifecycleStatus; } });
 // Events
 var feature_flag_events_1 = require("./events/feature-flag.events");
 Object.defineProperty(exports, "FeatureFlagEvents", { enumerable: true, get: function () { return feature_flag_events_1.FeatureFlagEvents; } });

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;AAmB1B,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;AAI1B,gGAA4F;AAAnF,6IAAA,2BAA2B,OAAA;AAKpC,eAAe;AACf,+EAA2E;AAAlE,mIAAA,sBAAsB,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;AAqC1B,mBAAmB;AACnB,iDASyB;AARvB,4GAAA,WAAW,OAAA;AACX,wHAAA,uBAAuB,OAAA;AACvB,4HAAA,2BAA2B,OAAA;AAC3B,uHAAA,sBAAsB,OAAA;AAOxB,SAAS;AACT,oEAMsC;AALpC,wHAAA,iBAAiB,OAAA;AAOnB,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/evaluation-context.interface.d.ts

@@ -1,8 +1,13 @@
+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;
+    /** Explicit stable key for percentage rollout bucketing */
+    targetingKey?: string | null;
+    /** Additional exact-match targeting attributes */
+    attributes?: TargetingAttributes;
 }

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

@@ -0,0 +1,29 @@
+export type EvaluationSource = 'override' | 'percentage' | 'global' | 'default';
+export type EvaluationReason = 'ARCHIVED' | 'OVERRIDE_MATCH' | 'PERCENTAGE_MATCH' | 'PERCENTAGE_MISS' | 'PERCENTAGE_NO_TARGETING_KEY' | 'GLOBAL' | 'FLAG_NOT_FOUND' | 'ERROR';
+export type BucketBy = 'userId' | 'tenantId' | 'environment' | 'targetingKey' | (string & {});
+export interface EvaluateBooleanOptions {
+    /** Invocation-level default used when the flag is missing or evaluation fails. */
+    defaultValue?: boolean;
+    /** Emit an exposure event for this evaluation. */
+    trackExposure?: boolean;
+    /** Include the full resolved context in evaluation/exposure events. */
+    includeContextInEvent?: boolean;
+}
+export interface BooleanEvaluationDetails {
+    flagKey: string;
+    value: boolean;
+    /** Backward-compatible alias for value. */
+    result: boolean;
+    source: EvaluationSource;
+    reason: EvaluationReason;
+    defaultUsed: boolean;
+    errorCode?: string;
+    errorMessage?: string;
+    matchedOverrideId?: string;
+    bucket?: number;
+    targetingKey?: string;
+    evaluationTimeMs?: number;
+}
+export interface FlagEvaluatorOptions {
+    bucketBy?: BucketBy;
+}

package/dist/interfaces/evaluation-details.interface.js

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

package/dist/interfaces/evaluation-details.interface.js.map

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

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

@@ -1,6 +1,7 @@
 import { ModuleMetadata, Type } from '@nestjs/common';
 import { Request } from 'express';
 import { CacheAdapter } from './cache-adapter.interface';
+import { FlagRegistry } from './flag-registry.interface';
 export interface FeatureFlagModuleOptions {
     /** Current environment (e.g., 'development', 'staging', 'production') */
     environment: string;
@@ -14,6 +15,8 @@ export interface FeatureFlagModuleOptions {
     emitEvents?: boolean;
     /** Custom cache adapter implementation. If not provided, an in-memory cache is used. */
     cacheAdapter?: CacheAdapter;
+    /** Optional type-safe flag registry used for defaults and evaluation metadata. */
+    flags?: FlagRegistry;
 }
 export interface FeatureFlagModuleOptionsFactory {
     createFeatureFlagOptions(): Promise<FeatureFlagModuleOptions & {

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

@@ -1,8 +1,10 @@
-import { CreateFeatureFlagInput, UpdateFeatureFlagInput, FeatureFlagWithOverrides } from './feature-flag.interface';
+import { CreateFeatureFlagInput, UpdateFeatureFlagInput, FeatureFlagWithOverrides, TargetingAttributes } from './feature-flag.interface';
 export interface OverrideCriteria {
-    tenantId: string | null;
-    userId: string | null;
-    environment: string | null;
+    attributes: TargetingAttributes;
+}
+export interface UpdateOverrideInput {
+    enabled: boolean;
+    priority: number;
 }
 export interface FeatureFlagRepository {
     createFlag(input: CreateFeatureFlagInput): Promise<FeatureFlagWithOverrides>;
@@ -14,7 +16,7 @@ export interface FeatureFlagRepository {
     findOverride(flagId: string, criteria: OverrideCriteria): Promise<{
         id: string;
     } | null>;
-    createOverride(flagId: string, criteria: OverrideCriteria, enabled: boolean): Promise<void>;
-    updateOverrideEnabled(id: string, enabled: boolean): Promise<void>;
+    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.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,16 +14,17 @@ 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 */
     statusCode?: number;
     /** Response body when flag is OFF */
     fallback?: Record<string, unknown>;
+    /** Invocation-level default when the guard cannot find or evaluate the flag. Default: false */
+    defaultValue?: boolean;
 }
 export interface FeatureFlagWithOverrides {
     id: string;
@@ -38,13 +41,19 @@ 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 {
-    tenantId?: string;
-    userId?: string;
-    environment?: string;
+    attributes: TargetingAttributes;
+}
+export interface FlagMutationMetadata {
+    actorId?: string;
+    actorType?: string;
+    reason?: string;
+    requestId?: string;
+    correlationId?: string;
 }

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

@@ -0,0 +1,17 @@
+import { BucketBy } from './evaluation-details.interface';
+export type FeatureFlagType = 'release' | 'experiment' | 'ops' | 'permission';
+export interface FeatureFlagLifecycleMetadata {
+    type?: FeatureFlagType;
+    owner?: string;
+    tags?: readonly string[];
+    expiresAt?: string | Date;
+    staleAt?: string | Date;
+}
+export interface FlagDefinition extends FeatureFlagLifecycleMetadata {
+    defaultValue: boolean;
+    description?: string;
+    bucketBy?: BucketBy;
+    trackExposure?: boolean;
+}
+export type FlagRegistry = Record<string, FlagDefinition>;
+export type FlagKey<TFlags extends FlagRegistry> = Extract<keyof TFlags, string>;

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

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

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

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

package/dist/openfeature.d.ts

@@ -0,0 +1,26 @@
+import { FeatureFlagService } from './services/feature-flag.service';
+export interface OpenFeatureBooleanProviderOptions {
+    name?: string;
+}
+export interface OpenFeatureEvaluationContext {
+    targetingKey?: unknown;
+    userId?: unknown;
+    tenantId?: unknown;
+    environment?: unknown;
+    [key: string]: unknown;
+}
+export interface OpenFeatureBooleanResolutionDetails {
+    value: boolean;
+    reason: string;
+    variant?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    flagMetadata: Record<string, unknown>;
+}
+export interface OpenFeatureBooleanProvider {
+    metadata: {
+        name: string;
+    };
+    resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, context: OpenFeatureEvaluationContext): Promise<OpenFeatureBooleanResolutionDetails>;
+}
+export declare function createOpenFeatureBooleanProvider(service: FeatureFlagService, options?: OpenFeatureBooleanProviderOptions): OpenFeatureBooleanProvider;