@frontmcp/plugin-feature-flags 1.8.7 → 1.9.1-rc.1

package/esm/index.mjs

@@ -1,3 +1,6 @@
+var __frontmcpModule = typeof process !== "undefined" && typeof process.getBuiltinModule === "function" ? process.getBuiltinModule("module") : undefined;
+const require = __frontmcpModule ? __frontmcpModule.createRequire(import.meta.url || 'file:///') : undefined;
+// __frontmcpCreateRequire
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -356,6 +359,7 @@ var FeatureFlagAccessor = class {
   adapter;
   ctx;
   config;
+  /** The adapter's answers by flag key: `undefined` when it has none (an unknown flag). */
   cache = /* @__PURE__ */ new Map();
   constructor(adapter, ctx, config) {
     this.adapter = adapter;
@@ -364,27 +368,41 @@ var FeatureFlagAccessor = class {
   }
   /**
    * Check if a feature flag is enabled.
+   *
+   * `defaultValue` (else the plugin's `defaultValue`, else `false`) is the answer when the adapter
+   * throws or has no answer for the flag: a key the static adapter was not given, or one a custom
+   * adapter's `evaluateFlags()` omits. A flag the adapter answers keeps its answer, `false` included.
+   * It used to apply only when the adapter threw, so `isEnabled('unknown', true)` was `false` (#678).
    */
   async isEnabled(flagKey, defaultValue) {
+    const answer = await this.evaluate(flagKey);
+    return answer ?? defaultValue ?? this.config.defaultValue ?? false;
+  }
+  /**
+   * The adapter's answer for one flag, or `undefined` when it has none or throws. Asked through
+   * `evaluateFlags()`, as the execution gates ask, which is how an adapter says it does not know a
+   * flag; `isEnabled()` answers `false` for it. A successful answer is cached per `cacheStrategy`.
+   */
+  async evaluate(flagKey) {
     const cacheStrategy = this.config.cacheStrategy ?? "none";
     const cacheTtlMs = this.config.cacheTtlMs ?? 3e4;
     if (cacheStrategy !== "none") {
       const cached = this.cache.get(flagKey);
       if (cached && Date.now() < cached.expiresAt) {
-        return cached.value;
+        return cached.answer;
       }
     }
-    const context = this.buildContext();
-    let result;
+    let answer;
     try {
-      result = await this.adapter.isEnabled(flagKey, context);
+      const results = await this.adapter.evaluateFlags([flagKey], this.buildContext());
+      answer = results.has(flagKey) ? results.get(flagKey) === true : void 0;
     } catch {
-      result = defaultValue ?? this.config.defaultValue ?? false;
+      return void 0;
     }
     if (cacheStrategy !== "none") {
-      this.cache.set(flagKey, { value: result, expiresAt: Date.now() + cacheTtlMs });
+      this.cache.set(flagKey, { answer, expiresAt: Date.now() + cacheTtlMs });
     }
-    return result;
+    return answer;
   }
   /**
    * Get a feature flag variant (for multi-variate flags).
@@ -434,6 +452,21 @@ var GetPromptHook = FlowHooksOf("prompts:get-prompt");
 var CompleteHook = FlowHooksOf("completion:complete");
 var FilterSkillsHook = FlowHooksOf("skills:filter");
 var SUPPORTED_ADAPTERS = ["static", "splitio", "launchdarkly", "unleash", "custom"];
+var REQUIRED_ADAPTER_METHODS = ["isEnabled", "getVariant", "evaluateFlags"];
+function assertCustomAdapter(adapterInstance) {
+  let problem;
+  if (typeof adapterInstance !== "object" || adapterInstance === null) {
+    problem = `got ${adapterInstance === void 0 ? "undefined" : JSON.stringify(adapterInstance)}`;
+  } else {
+    const instance = adapterInstance;
+    const missing = REQUIRED_ADAPTER_METHODS.filter((method) => typeof instance[method] !== "function");
+    if (missing.length > 0) problem = `missing ${missing.map((m) => `${m}()`).join(", ")}`;
+  }
+  if (problem === void 0) return;
+  throw new FeatureFlagConfigurationError(
+    `FeatureFlagPlugin.init({ adapter: 'custom' }) requires an \`adapterInstance\` option: an object implementing FeatureFlagAdapter (${REQUIRED_ADAPTER_METHODS.map((m) => `${m}()`).join(", ")}); ${problem}.`
+  );
+}
 var FeatureFlagPlugin = class extends DynamicPlugin {
   options;
   constructor(options) {
@@ -689,6 +722,7 @@ __publicField(FeatureFlagPlugin, "dynamicProviders", (options) => {
       });
       break;
     case "custom":
+      assertCustomAdapter(options.adapterInstance);
       providers.push({
         name: "feature-flags:adapter:custom",
         provide: FeatureFlagAdapterToken,

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-feature-flags",
-  "version": "1.8.7",
+  "version": "1.9.1-rc.1",
   "description": "Feature flag plugin for FrontMCP - dynamically gate MCP capabilities behind feature flags",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -49,7 +49,7 @@
     }
   },
   "dependencies": {
-    "@frontmcp/sdk": "1.8.7"
+    "@frontmcp/sdk": "1.9.1-rc.1"
   },
   "peerDependencies": {
     "@launchdarkly/node-server-sdk": "^9.0.0 || ^10.0.0",

package/feature-flag.plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flag.plugin.d.ts","sourceRoot":"","sources":["../src/feature-flag.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAYb,KAAK,SAAS,EAGd,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAOvB,OAAO,KAAK,EAEV,wBAAwB,EACxB,6BAA6B,EAE9B,MAAM,sBAAsB,CAAC;AAe9B;;;;;;;;;;;;;;;;;;GAkBG;AAeH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa,CAAC,wBAAwB,EAAE,6BAA6B,CAAC;IACnH,OAAO,EAAE,wBAAwB,CAAC;gBAEtB,OAAO,EAAE,6BAA6B;IAKlD;;OAEG;IACH,OAAgB,gBAAgB,GAAI,SAAS,6BAA6B,KAAG,YAAY,EAAE,CAiGzF;IAMF;;;OAGG;IAEG,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,kBAAkB,CAAC;IAqB5D;;OAEG;IAEG,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,0BAA0B,CAAC;IAoBxE;;;;OAIG;IAEG,2BAA2B,CAAC,OAAO,EAAE,SAAS,CAAC,mCAAmC,CAAC;IAoBzF;;OAEG;IAEG,iBAAiB,CAAC,OAAO,EAAE,GAAG;IAsBpC;;;;;;;;OAQG;IAEG,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC;IAsBtD;;;OAGG;IAEG,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,iBAAiB,CAAC;IAI7D;;;;;;OAMG;IAEG,gBAAgB,CAAC,OAAO,EAAE,GAAG;IAInC;;;;;OAKG;IAEG,aAAa,CAAC,OAAO,EAAE,GAAG;IAIhC;;;;;OAKG;IAEG,cAAc,CAAC,OAAO,EAAE,GAAG;IAMjC;;;;;OAKG;YACW,kBAAkB;IA+BhC;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;YACW,iBAAiB;IAQ/B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAWrB"}
+{"version":3,"file":"feature-flag.plugin.d.ts","sourceRoot":"","sources":["../src/feature-flag.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAYb,KAAK,SAAS,EAGd,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAOvB,OAAO,KAAK,EAEV,wBAAwB,EACxB,6BAA6B,EAE9B,MAAM,sBAAsB,CAAC;AAwC9B;;;;;;;;;;;;;;;;;;GAkBG;AAeH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa,CAAC,wBAAwB,EAAE,6BAA6B,CAAC;IACnH,OAAO,EAAE,wBAAwB,CAAC;gBAEtB,OAAO,EAAE,6BAA6B;IAKlD;;OAEG;IACH,OAAgB,gBAAgB,GAAI,SAAS,6BAA6B,KAAG,YAAY,EAAE,CAkGzF;IAMF;;;OAGG;IAEG,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,kBAAkB,CAAC;IAqB5D;;OAEG;IAEG,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,0BAA0B,CAAC;IAoBxE;;;;OAIG;IAEG,2BAA2B,CAAC,OAAO,EAAE,SAAS,CAAC,mCAAmC,CAAC;IAoBzF;;OAEG;IAEG,iBAAiB,CAAC,OAAO,EAAE,GAAG;IAsBpC;;;;;;;;OAQG;IAEG,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC;IAsBtD;;;OAGG;IAEG,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,iBAAiB,CAAC;IAI7D;;;;;;OAMG;IAEG,gBAAgB,CAAC,OAAO,EAAE,GAAG;IAInC;;;;;OAKG;IAEG,aAAa,CAAC,OAAO,EAAE,GAAG;IAIhC;;;;;OAKG;IAEG,cAAc,CAAC,OAAO,EAAE,GAAG;IAMjC;;;;;OAKG;YACW,kBAAkB;IA+BhC;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;YACW,iBAAiB;IAQ/B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAWrB"}

package/feature-flag.types.d.ts

@@ -27,6 +27,11 @@ export type UserIdResolver = (ctx: FrontMcpContext) => string | undefined;
 export type AttributesResolver = (ctx: FrontMcpContext) => Record<string, unknown>;
 /** Shared base options for all adapter configurations. */
 interface FeatureFlagBaseOptions {
+    /**
+     * What `this.featureFlags.isEnabled()` answers when the adapter throws or has no answer for the
+     * flag and the call passes no `defaultValue` of its own. Gates use their ref's `defaultValue`.
+     * @default false
+     */
     defaultValue?: boolean;
     cacheStrategy?: FeatureFlagCacheStrategy;
     cacheTtlMs?: number;

package/feature-flag.types.d.ts.map

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

package/index.js

@@ -358,6 +358,7 @@ var FeatureFlagAccessor = class {
   adapter;
   ctx;
   config;
+  /** The adapter's answers by flag key: `undefined` when it has none (an unknown flag). */
   cache = /* @__PURE__ */ new Map();
   constructor(adapter, ctx, config) {
     this.adapter = adapter;
@@ -366,27 +367,41 @@ var FeatureFlagAccessor = class {
   }
   /**
    * Check if a feature flag is enabled.
+   *
+   * `defaultValue` (else the plugin's `defaultValue`, else `false`) is the answer when the adapter
+   * throws or has no answer for the flag: a key the static adapter was not given, or one a custom
+   * adapter's `evaluateFlags()` omits. A flag the adapter answers keeps its answer, `false` included.
+   * It used to apply only when the adapter threw, so `isEnabled('unknown', true)` was `false` (#678).
    */
   async isEnabled(flagKey, defaultValue) {
+    const answer = await this.evaluate(flagKey);
+    return answer ?? defaultValue ?? this.config.defaultValue ?? false;
+  }
+  /**
+   * The adapter's answer for one flag, or `undefined` when it has none or throws. Asked through
+   * `evaluateFlags()`, as the execution gates ask, which is how an adapter says it does not know a
+   * flag; `isEnabled()` answers `false` for it. A successful answer is cached per `cacheStrategy`.
+   */
+  async evaluate(flagKey) {
     const cacheStrategy = this.config.cacheStrategy ?? "none";
     const cacheTtlMs = this.config.cacheTtlMs ?? 3e4;
     if (cacheStrategy !== "none") {
       const cached = this.cache.get(flagKey);
       if (cached && Date.now() < cached.expiresAt) {
-        return cached.value;
+        return cached.answer;
       }
     }
-    const context = this.buildContext();
-    let result;
+    let answer;
     try {
-      result = await this.adapter.isEnabled(flagKey, context);
+      const results = await this.adapter.evaluateFlags([flagKey], this.buildContext());
+      answer = results.has(flagKey) ? results.get(flagKey) === true : void 0;
     } catch {
-      result = defaultValue ?? this.config.defaultValue ?? false;
+      return void 0;
     }
     if (cacheStrategy !== "none") {
-      this.cache.set(flagKey, { value: result, expiresAt: Date.now() + cacheTtlMs });
+      this.cache.set(flagKey, { answer, expiresAt: Date.now() + cacheTtlMs });
     }
-    return result;
+    return answer;
   }
   /**
    * Get a feature flag variant (for multi-variate flags).
@@ -436,6 +451,21 @@ var GetPromptHook = (0, import_sdk4.FlowHooksOf)("prompts:get-prompt");
 var CompleteHook = (0, import_sdk4.FlowHooksOf)("completion:complete");
 var FilterSkillsHook = (0, import_sdk4.FlowHooksOf)("skills:filter");
 var SUPPORTED_ADAPTERS = ["static", "splitio", "launchdarkly", "unleash", "custom"];
+var REQUIRED_ADAPTER_METHODS = ["isEnabled", "getVariant", "evaluateFlags"];
+function assertCustomAdapter(adapterInstance) {
+  let problem;
+  if (typeof adapterInstance !== "object" || adapterInstance === null) {
+    problem = `got ${adapterInstance === void 0 ? "undefined" : JSON.stringify(adapterInstance)}`;
+  } else {
+    const instance = adapterInstance;
+    const missing = REQUIRED_ADAPTER_METHODS.filter((method) => typeof instance[method] !== "function");
+    if (missing.length > 0) problem = `missing ${missing.map((m) => `${m}()`).join(", ")}`;
+  }
+  if (problem === void 0) return;
+  throw new FeatureFlagConfigurationError(
+    `FeatureFlagPlugin.init({ adapter: 'custom' }) requires an \`adapterInstance\` option: an object implementing FeatureFlagAdapter (${REQUIRED_ADAPTER_METHODS.map((m) => `${m}()`).join(", ")}); ${problem}.`
+  );
+}
 var FeatureFlagPlugin = class extends import_sdk4.DynamicPlugin {
   options;
   constructor(options) {
@@ -691,6 +721,7 @@ __publicField(FeatureFlagPlugin, "dynamicProviders", (options) => {
       });
       break;
     case "custom":
+      assertCustomAdapter(options.adapterInstance);
       providers.push({
         name: "feature-flags:adapter:custom",
         provide: FeatureFlagAdapterToken,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-feature-flags",
-  "version": "1.8.7",
+  "version": "1.9.1-rc.1",
   "description": "Feature flag plugin for FrontMCP - dynamically gate MCP capabilities behind feature flags",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -49,7 +49,7 @@
     }
   },
   "dependencies": {
-    "@frontmcp/sdk": "1.8.7"
+    "@frontmcp/sdk": "1.9.1-rc.1"
   },
   "peerDependencies": {
     "@launchdarkly/node-server-sdk": "^9.0.0 || ^10.0.0",

package/providers/feature-flag-accessor.provider.d.ts

@@ -9,12 +9,24 @@ export declare class FeatureFlagAccessor {
     private readonly adapter;
     private readonly ctx;
     private readonly config;
+    /** The adapter's answers by flag key: `undefined` when it has none (an unknown flag). */
     private readonly cache;
     constructor(adapter: FeatureFlagAdapter, ctx: FrontMcpContext, config: FeatureFlagPluginOptions);
     /**
      * Check if a feature flag is enabled.
+     *
+     * `defaultValue` (else the plugin's `defaultValue`, else `false`) is the answer when the adapter
+     * throws or has no answer for the flag: a key the static adapter was not given, or one a custom
+     * adapter's `evaluateFlags()` omits. A flag the adapter answers keeps its answer, `false` included.
+     * It used to apply only when the adapter threw, so `isEnabled('unknown', true)` was `false` (#678).
      */
     isEnabled(flagKey: string, defaultValue?: boolean): Promise<boolean>;
+    /**
+     * The adapter's answer for one flag, or `undefined` when it has none or throws. Asked through
+     * `evaluateFlags()`, as the execution gates ask, which is how an adapter says it does not know a
+     * flag; `isEnabled()` answers `false` for it. A successful answer is cached per `cacheStrategy`.
+     */
+    private evaluate;
     /**
      * Get a feature flag variant (for multi-variate flags).
      */

package/providers/feature-flag-accessor.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flag-accessor.provider.d.ts","sourceRoot":"","sources":["../../src/providers/feature-flag-accessor.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA2B,MAAM,eAAe,CAAC;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,KAAK,EAEV,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,qBAKa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4D;gBAEtE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,wBAAwB;IAM/F;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA4B1E;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAK9D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKtE;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAOvD;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,wBAAwB,GAC/B,mBAAmB,CAErB"}
+{"version":3,"file":"feature-flag-accessor.provider.d.ts","sourceRoot":"","sources":["../../src/providers/feature-flag-accessor.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA2B,MAAM,eAAe,CAAC;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,KAAK,EAEV,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,qBAKa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,yFAAyF;IACzF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyE;gBAEnF,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,wBAAwB;IAM/F;;;;;;;OAOG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAK1E;;;;OAIG;YACW,QAAQ;IA0BtB;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAK9D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKtE;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAOvD;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,wBAAwB,GAC/B,mBAAmB,CAErB"}