@zudojs/feature-flags 0.0.1

package/dist/featureFlags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/featureFlags/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @zudojs/feature-flags
+ *
+ * Feature flag system with deterministic rollouts, rule engine, providers, and evaluation context.
+ *
+ * @module index
+ */
+export type { FeatureFlagValue, FeatureFlagState, FeatureFlagVisibility, FeatureFlagOperator, FeatureFlagStaticRule, FeatureFlagUserRule, FeatureFlagTenantRule, FeatureFlagAttributeRule, FeatureFlagPercentageRule, FeatureFlagScheduleRule, FeatureFlagVariantRule, FeatureFlagVariant, FeatureFlagRule, FeatureFlagContext, FeatureFlagMetadata, FeatureFlag, FeatureFlagEvaluationReason, FeatureFlagEvaluation, FeatureFlagProvider, FeatureFlagChangeListener, Unsubscribe, } from "./featureFlagTypes/index.js";
+export { FeatureFlagError } from "./featureFlagErrors/featureFlagError.base.js";
+export type { FeatureFlagErrorOptions } from "./featureFlagErrors/featureFlagError.base.js";
+export { FeatureFlagNotFoundError, FeatureFlagProviderError, FeatureFlagEvaluationError, FeatureFlagRuleError, FeatureFlagDependencyError, FeatureFlagConfigurationError, FeatureFlagTypeError, } from "./featureFlagErrors/featureFlagError.types.js";
+export { hashString } from "./rollout/rolloutHashing.js";
+export { getBucket, isInRollout } from "./rollout/rolloutBucketing.js";
+export { createMemoryProvider } from "./provider/providerMemory.core.js";
+export { createEnvironmentProvider } from "./provider/providerEnvironment.core.js";
+export type { EnvironmentProviderOptions } from "./provider/providerEnvironment.core.js";
+export { createCompositeProvider } from "./provider/providerComposite.core.js";
+export { createCachedProvider } from "./provider/providerCached.core.js";
+export type { CachedProviderOptions } from "./provider/providerCached.core.js";
+export { resolvePath, matchAttribute } from "./evaluator/evaluatorAttribute.js";
+export { evaluateRule } from "./evaluator/evaluatorRule.core.js";
+export type { RuleEvaluationResult } from "./evaluator/evaluatorRule.core.js";
+export { evaluateFlag } from "./evaluator/evaluator.core.js";
+export { createFeatureFlagRegistry } from "./registry/registry.core.js";
+export type { FeatureFlagRegistry } from "./registry/registry.core.js";
+export { createFeatureFlags } from "./featureFlags/featureFlags.core.js";
+export type { FeatureFlagsOptions } from "./featureFlags/featureFlags.core.js";
+export { isPlainObject, valuesEqual } from "./utils/utils.helper.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,2BAA2B,EAC3B,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,GACZ,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAChF,YAAY,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAC5F,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,+CAA+C,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,YAAY,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAG/E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG/E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * @zudojs/feature-flags
+ *
+ * Feature flag system with deterministic rollouts, rule engine, providers, and evaluation context.
+ *
+ * @module index
+ */
+// ─── Errors ───────────────────────────────────────────────────────────────
+export { FeatureFlagError } from "./featureFlagErrors/featureFlagError.base.js";
+export { FeatureFlagNotFoundError, FeatureFlagProviderError, FeatureFlagEvaluationError, FeatureFlagRuleError, FeatureFlagDependencyError, FeatureFlagConfigurationError, FeatureFlagTypeError, } from "./featureFlagErrors/featureFlagError.types.js";
+// ─── Rollout ──────────────────────────────────────────────────────────────
+export { hashString } from "./rollout/rolloutHashing.js";
+export { getBucket, isInRollout } from "./rollout/rolloutBucketing.js";
+// ─── Providers ────────────────────────────────────────────────────────────
+export { createMemoryProvider } from "./provider/providerMemory.core.js";
+export { createEnvironmentProvider } from "./provider/providerEnvironment.core.js";
+export { createCompositeProvider } from "./provider/providerComposite.core.js";
+export { createCachedProvider } from "./provider/providerCached.core.js";
+// ─── Evaluator ────────────────────────────────────────────────────────────
+export { resolvePath, matchAttribute } from "./evaluator/evaluatorAttribute.js";
+export { evaluateRule } from "./evaluator/evaluatorRule.core.js";
+export { evaluateFlag } from "./evaluator/evaluator.core.js";
+// ─── Registry ─────────────────────────────────────────────────────────────
+export { createFeatureFlagRegistry } from "./registry/registry.core.js";
+// ─── FeatureFlags ─────────────────────────────────────────────────────────
+export { createFeatureFlags } from "./featureFlags/featureFlags.core.js";
+// ─── Utils ────────────────────────────────────────────────────────────────
+export { isPlainObject, valuesEqual } from "./utils/utils.helper.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH,6EAA6E;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAEhF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,+CAA+C,CAAC;AAEvD,6EAA6E;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEvE,6EAA6E;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzE,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,6EAA6E;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,6EAA6E;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,6EAA6E;AAC7E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/provider/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Feature flag providers — supply flag definitions from any source.
+ *
+ * @module provider
+ */
+export { createMemoryProvider } from "./providerMemory.core.js";
+export { createEnvironmentProvider } from "./providerEnvironment.core.js";
+export type { EnvironmentProviderOptions } from "./providerEnvironment.core.js";
+export { createCompositeProvider } from "./providerComposite.core.js";
+export { createCachedProvider } from "./providerCached.core.js";
+export type { CachedProviderOptions } from "./providerCached.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,YAAY,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/provider/index.js

@@ -0,0 +1,10 @@
+/**
+ * Feature flag providers — supply flag definitions from any source.
+ *
+ * @module provider
+ */
+export { createMemoryProvider } from "./providerMemory.core.js";
+export { createEnvironmentProvider } from "./providerEnvironment.core.js";
+export { createCompositeProvider } from "./providerComposite.core.js";
+export { createCachedProvider } from "./providerCached.core.js";
+//# sourceMappingURL=index.js.map

package/dist/provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/provider/providerCached.core.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Cached feature flag provider.
+ *
+ * Wraps a remote provider with in-memory caching to avoid per-request network calls.
+ *
+ * @module provider/providerCached
+ */
+import type { FeatureFlagProvider } from "../featureFlagTypes/featureFlagProvider.js";
+/** Options for the cached provider. */
+export interface CachedProviderOptions {
+    /** Time-to-live in milliseconds (default: 30,000). */
+    readonly ttl?: number;
+}
+/**
+ * Create a cached feature flag provider.
+ *
+ * @param inner - The upstream provider to cache.
+ * @param options - Caching options.
+ * @returns A FeatureFlagProvider with in-memory TTL caching.
+ */
+export declare function createCachedProvider(inner: FeatureFlagProvider, options?: CachedProviderOptions): FeatureFlagProvider;
+//# sourceMappingURL=providerCached.core.d.ts.map

package/dist/provider/providerCached.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerCached.core.d.ts","sourceRoot":"","sources":["../../src/provider/providerCached.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAEtF,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,qBAA0B,GAClC,mBAAmB,CAmCrB"}

package/dist/provider/providerCached.core.js

@@ -0,0 +1,45 @@
+/**
+ * Cached feature flag provider.
+ *
+ * Wraps a remote provider with in-memory caching to avoid per-request network calls.
+ *
+ * @module provider/providerCached
+ */
+/**
+ * Create a cached feature flag provider.
+ *
+ * @param inner - The upstream provider to cache.
+ * @param options - Caching options.
+ * @returns A FeatureFlagProvider with in-memory TTL caching.
+ */
+export function createCachedProvider(inner, options = {}) {
+    const ttl = options.ttl ?? 30_000;
+    const flagCache = new Map();
+    let listCache;
+    function isExpired(entry) {
+        return Date.now() > entry.expiresAt;
+    }
+    return {
+        async get(key) {
+            const cached = flagCache.get(key);
+            if (cached && !isExpired(cached))
+                return cached.value;
+            const flag = await inner.get(key);
+            flagCache.set(key, { value: flag, expiresAt: Date.now() + ttl });
+            return flag;
+        },
+        async getAll() {
+            if (listCache && !isExpired(listCache))
+                return listCache.flags;
+            const flags = await inner.getAll();
+            listCache = { flags, expiresAt: Date.now() + ttl };
+            return flags;
+        },
+        async refresh() {
+            flagCache.clear();
+            listCache = undefined;
+            await inner.refresh?.();
+        },
+    };
+}
+//# sourceMappingURL=providerCached.core.js.map

package/dist/provider/providerCached.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerCached.core.js","sourceRoot":"","sources":["../../src/provider/providerCached.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA0B,EAC1B,OAAO,GAA0B,EAAE;IAEnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAChD,IAAI,SAES,CAAC;IAEd,SAAS,SAAS,CAAC,KAA4B;QAC7C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC;YAEtD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,MAAM;YACV,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC,KAAK,CAAC;YAE/D,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,SAAS,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,OAAO;YACX,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,SAAS,GAAG,SAAS,CAAC;YACtB,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/provider/providerComposite.core.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Composite feature flag provider.
+ *
+ * Chains multiple providers with first-match-wins resolution.
+ *
+ * @module provider/providerComposite
+ */
+import type { FeatureFlagProvider } from "../featureFlagTypes/featureFlagProvider.js";
+/**
+ * Create a composite provider that queries providers in order.
+ *
+ * The first provider to return a flag wins. `getAll()` merges all flags
+ * with earlier providers taking priority.
+ *
+ * @param providers - Providers to chain, in priority order.
+ * @returns A composite FeatureFlagProvider.
+ */
+export declare function createCompositeProvider(providers: readonly FeatureFlagProvider[]): FeatureFlagProvider;
+//# sourceMappingURL=providerComposite.core.d.ts.map

package/dist/provider/providerComposite.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerComposite.core.d.ts","sourceRoot":"","sources":["../../src/provider/providerComposite.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAEtF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,mBAAmB,EAAE,GACxC,mBAAmB,CAiCrB"}

package/dist/provider/providerComposite.core.js

@@ -0,0 +1,48 @@
+/**
+ * Composite feature flag provider.
+ *
+ * Chains multiple providers with first-match-wins resolution.
+ *
+ * @module provider/providerComposite
+ */
+/**
+ * Create a composite provider that queries providers in order.
+ *
+ * The first provider to return a flag wins. `getAll()` merges all flags
+ * with earlier providers taking priority.
+ *
+ * @param providers - Providers to chain, in priority order.
+ * @returns A composite FeatureFlagProvider.
+ */
+export function createCompositeProvider(providers) {
+    return {
+        async get(key) {
+            for (const provider of providers) {
+                const flag = await provider.get(key);
+                if (flag)
+                    return flag;
+            }
+            return undefined;
+        },
+        async getAll() {
+            const seen = new Set();
+            const result = [];
+            for (const provider of providers) {
+                const flags = await provider.getAll();
+                for (const flag of flags) {
+                    if (!seen.has(flag.key)) {
+                        seen.add(flag.key);
+                        result.push(flag);
+                    }
+                }
+            }
+            return result;
+        },
+        async refresh() {
+            for (const provider of providers) {
+                await provider.refresh?.();
+            }
+        },
+    };
+}
+//# sourceMappingURL=providerComposite.core.js.map

package/dist/provider/providerComposite.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerComposite.core.js","sourceRoot":"","sources":["../../src/provider/providerComposite.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAyC;IAEzC,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACrC,IAAI,IAAI;oBAAE,OAAO,IAAI,CAAC;YACxB,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,MAAM;YACV,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,MAAM,MAAM,GAAkB,EAAE,CAAC;YAEjC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBACnB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,OAAO;YACX,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/provider/providerEnvironment.core.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Environment-variable feature flag provider.
+ *
+ * Reads feature flags from environment variables with a configurable prefix.
+ *
+ * Example: FEATURE_NEW_UI=true → key "NEW_UI" with value true.
+ *
+ * @module provider/providerEnvironment
+ */
+import type { FeatureFlagProvider } from "../featureFlagTypes/featureFlagProvider.js";
+/** Options for the environment provider. */
+export interface EnvironmentProviderOptions {
+    /** Prefix for environment variable names (default: "FEATURE_"). */
+    readonly prefix?: string;
+    /** Process env object to read from (default: process.env). */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+}
+/**
+ * Create an environment-variable feature flag provider.
+ *
+ * @param options - Configuration options.
+ * @returns A FeatureFlagProvider that reads from environment variables.
+ */
+export declare function createEnvironmentProvider(options?: EnvironmentProviderOptions): FeatureFlagProvider;
+//# sourceMappingURL=providerEnvironment.core.d.ts.map

package/dist/provider/providerEnvironment.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerEnvironment.core.d.ts","sourceRoot":"","sources":["../../src/provider/providerEnvironment.core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAEtF,4CAA4C;AAC5C,MAAM,WAAW,0BAA0B;IACzC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CAC7D;AAeD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAuCrB"}

package/dist/provider/providerEnvironment.core.js

@@ -0,0 +1,63 @@
+/**
+ * Environment-variable feature flag provider.
+ *
+ * Reads feature flags from environment variables with a configurable prefix.
+ *
+ * Example: FEATURE_NEW_UI=true → key "NEW_UI" with value true.
+ *
+ * @module provider/providerEnvironment
+ */
+/**
+ * Parse a string value into a feature flag value.
+ */
+function parseEnvValue(raw) {
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    const num = Number(raw);
+    if (!Number.isNaN(num))
+        return num;
+    return raw;
+}
+/**
+ * Create an environment-variable feature flag provider.
+ *
+ * @param options - Configuration options.
+ * @returns A FeatureFlagProvider that reads from environment variables.
+ */
+export function createEnvironmentProvider(options = {}) {
+    const prefix = options.prefix ?? "FEATURE_";
+    const env = options.env ?? (typeof process !== "undefined" ? process.env : {});
+    function readFlags() {
+        const flags = [];
+        for (const [key, value] of Object.entries(env)) {
+            if (key.startsWith(prefix) && value !== undefined) {
+                const flagKey = key.slice(prefix.length);
+                flags.push({
+                    key: flagKey,
+                    enabled: true,
+                    defaultValue: parseEnvValue(value),
+                });
+            }
+        }
+        return flags;
+    }
+    let cached;
+    return {
+        async get(key) {
+            if (!cached)
+                cached = readFlags();
+            return cached.find((f) => f.key === key);
+        },
+        async getAll() {
+            if (!cached)
+                cached = readFlags();
+            return cached;
+        },
+        async refresh() {
+            cached = readFlags();
+        },
+    };
+}
+//# sourceMappingURL=providerEnvironment.core.js.map

package/dist/provider/providerEnvironment.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerEnvironment.core.js","sourceRoot":"","sources":["../../src/provider/providerEnvironment.core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;GAEG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAEnC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAO,GAA+B,EAAE;IAExC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;IAC5C,MAAM,GAAG,GACP,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAErE,SAAS,SAAS;QAChB,MAAM,KAAK,GAAkB,EAAE,CAAC;QAEhC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAClD,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC;oBACT,GAAG,EAAE,OAAO;oBACZ,OAAO,EAAE,IAAI;oBACb,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,MAA0C,CAAC;IAE/C,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,IAAI,CAAC,MAAM;gBAAE,MAAM,GAAG,SAAS,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAC3C,CAAC;QAED,KAAK,CAAC,MAAM;YACV,IAAI,CAAC,MAAM;gBAAE,MAAM,GAAG,SAAS,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,OAAO;YACX,MAAM,GAAG,SAAS,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/provider/providerMemory.core.d.ts

@@ -0,0 +1,17 @@
+/**
+ * In-memory feature flag provider.
+ *
+ * Stores flags in a Map for O(1) lookup. Ideal for local apps and testing.
+ *
+ * @module provider/providerMemory
+ */
+import type { FeatureFlag } from "../featureFlagTypes/featureFlag.interface.js";
+import type { FeatureFlagProvider } from "../featureFlagTypes/featureFlagProvider.js";
+/**
+ * Create an in-memory feature flag provider.
+ *
+ * @param flags - Initial flag definitions.
+ * @returns A FeatureFlagProvider backed by a Map.
+ */
+export declare function createMemoryProvider(flags?: readonly FeatureFlag[]): FeatureFlagProvider;
+//# sourceMappingURL=providerMemory.core.d.ts.map

package/dist/provider/providerMemory.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerMemory.core.d.ts","sourceRoot":"","sources":["../../src/provider/providerMemory.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAEtF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,GAAE,SAAS,WAAW,EAAO,GACjC,mBAAmB,CA6BrB"}

package/dist/provider/providerMemory.core.js

@@ -0,0 +1,36 @@
+/**
+ * In-memory feature flag provider.
+ *
+ * Stores flags in a Map for O(1) lookup. Ideal for local apps and testing.
+ *
+ * @module provider/providerMemory
+ */
+/**
+ * Create an in-memory feature flag provider.
+ *
+ * @param flags - Initial flag definitions.
+ * @returns A FeatureFlagProvider backed by a Map.
+ */
+export function createMemoryProvider(flags = []) {
+    const store = new Map();
+    for (const flag of flags) {
+        store.set(flag.key, Object.freeze({ ...flag }));
+    }
+    return {
+        async get(key) {
+            return store.get(key);
+        },
+        async getAll() {
+            return [...store.values()];
+        },
+        /** Add or update a flag at runtime. */
+        set(flag) {
+            store.set(flag.key, Object.freeze({ ...flag }));
+        },
+        /** Remove a flag by key. */
+        delete(key) {
+            return store.delete(key);
+        },
+    };
+}
+//# sourceMappingURL=providerMemory.core.js.map

package/dist/provider/providerMemory.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerMemory.core.js","sourceRoot":"","sources":["../../src/provider/providerMemory.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAK,GAA2B,EAAE;IAElC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,MAAM;YACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,CAAC;QAED,uCAAuC;QACvC,GAAG,CAAC,IAAiB;YACnB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,4BAA4B;QAC5B,MAAM,CAAC,GAAW;YAChB,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;KAIF,CAAC;AACJ,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Feature flag registry — central store for flag definitions.
+ *
+ * @module registry
+ */
+export { createFeatureFlagRegistry } from "./registry.core.js";
+export type { FeatureFlagRegistry } from "./registry.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,7 @@
+/**
+ * Feature flag registry — central store for flag definitions.
+ *
+ * @module registry
+ */
+export { createFeatureFlagRegistry } from "./registry.core.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/registry.core.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Feature flag registry.
+ *
+ * Central store for flag definitions with O(1) lookup by key.
+ *
+ * @module registry/registry
+ */
+import type { FeatureFlag } from "../featureFlagTypes/featureFlag.interface.js";
+/** A feature flag registry with O(1) lookup. */
+export interface FeatureFlagRegistry {
+    /** Get a flag by key. */
+    get(key: string): FeatureFlag | undefined;
+    /** Get all flags. */
+    getAll(): readonly FeatureFlag[];
+    /** Register a flag (adds or replaces). */
+    set(flag: FeatureFlag): void;
+    /** Register multiple flags. */
+    setAll(flags: readonly FeatureFlag[]): void;
+    /** Remove a flag by key. */
+    delete(key: string): boolean;
+    /** Check if a flag exists. */
+    has(key: string): boolean;
+    /** Number of registered flags. */
+    readonly size: number;
+}
+/**
+ * Create an in-memory feature flag registry.
+ *
+ * Uses a Map for O(1) key lookup.
+ *
+ * @param flags - Initial flags to register.
+ * @returns A FeatureFlagRegistry instance.
+ */
+export declare function createFeatureFlagRegistry(flags?: readonly FeatureFlag[]): FeatureFlagRegistry;
+//# sourceMappingURL=registry.core.d.ts.map

package/dist/registry/registry.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.core.d.ts","sourceRoot":"","sources":["../../src/registry/registry.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAEhF,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1C,qBAAqB;IACrB,MAAM,IAAI,SAAS,WAAW,EAAE,CAAC;IACjC,0CAA0C;IAC1C,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,MAAM,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IAC5C,4BAA4B;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,8BAA8B;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,GAAE,SAAS,WAAW,EAAO,GACjC,mBAAmB,CAsCrB"}

package/dist/registry/registry.core.js

@@ -0,0 +1,47 @@
+/**
+ * Feature flag registry.
+ *
+ * Central store for flag definitions with O(1) lookup by key.
+ *
+ * @module registry/registry
+ */
+/**
+ * Create an in-memory feature flag registry.
+ *
+ * Uses a Map for O(1) key lookup.
+ *
+ * @param flags - Initial flags to register.
+ * @returns A FeatureFlagRegistry instance.
+ */
+export function createFeatureFlagRegistry(flags = []) {
+    const store = new Map();
+    for (const flag of flags) {
+        store.set(flag.key, Object.freeze({ ...flag }));
+    }
+    return {
+        get(key) {
+            return store.get(key);
+        },
+        getAll() {
+            return [...store.values()];
+        },
+        set(flag) {
+            store.set(flag.key, Object.freeze({ ...flag }));
+        },
+        setAll(flags) {
+            for (const flag of flags) {
+                store.set(flag.key, Object.freeze({ ...flag }));
+            }
+        },
+        delete(key) {
+            return store.delete(key);
+        },
+        has(key) {
+            return store.has(key);
+        },
+        get size() {
+            return store.size;
+        },
+    };
+}
+//# sourceMappingURL=registry.core.js.map

package/dist/registry/registry.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.core.js","sourceRoot":"","sources":["../../src/registry/registry.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAK,GAA2B,EAAE;IAElC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO;QACL,GAAG,CAAC,GAAW;YACb,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,MAAM;YACJ,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,CAAC;QAED,GAAG,CAAC,IAAiB;YACnB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,CAAC,KAA6B;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,MAAM,CAAC,GAAW;YAChB,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAED,GAAG,CAAC,GAAW;YACb,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,IAAI;YACN,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/rollout/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Deterministic rollout infrastructure — hashing and bucketing.
+ *
+ * @module rollout
+ */
+export { hashString } from "./rolloutHashing.js";
+export { getBucket, isInRollout } from "./rolloutBucketing.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/rollout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rollout/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/rollout/index.js

@@ -0,0 +1,8 @@
+/**
+ * Deterministic rollout infrastructure — hashing and bucketing.
+ *
+ * @module rollout
+ */
+export { hashString } from "./rolloutHashing.js";
+export { getBucket, isInRollout } from "./rolloutBucketing.js";
+//# sourceMappingURL=index.js.map

package/dist/rollout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rollout/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/rollout/rolloutBucketing.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Deterministic bucketing for percentage rollouts.
+ *
+ * Maps a (flag key, subject) pair to a bucket in [0, buckets).
+ * Supports sub-percent precision with 10,000 buckets.
+ *
+ * @module rollout/rolloutBucketing
+ */
+/**
+ * Compute a deterministic bucket for a flag rollout.
+ *
+ * @param key - The feature flag key.
+ * @param subject - The subject identifier (e.g. userId, tenantId).
+ * @param buckets - Total number of buckets (default 10,000).
+ * @returns A bucket number in [0, buckets).
+ */
+export declare function getBucket(key: string, subject: string, buckets?: number): number;
+/**
+ * Check whether a subject falls within a percentage rollout.
+ *
+ * @param key - The feature flag key.
+ * @param subject - The subject identifier.
+ * @param percentage - Percentage from 0 to 100 (supports decimals like 25.5).
+ * @returns Whether the subject is in the rollout.
+ */
+export declare function isInRollout(key: string, subject: string, percentage: number): boolean;
+//# sourceMappingURL=rolloutBucketing.d.ts.map

package/dist/rollout/rolloutBucketing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolloutBucketing.d.ts","sourceRoot":"","sources":["../../src/rollout/rolloutBucketing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAwB,GAChC,MAAM,CAGR;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAQT"}