@flags-sdk/vercel 0.1.8 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @flags-sdk/vercel
 
+## 1.0.0
+
+### Major Changes
+
+- c71729b: See http://vercel.com/docs/flags/vercel-flags for more information.
+
+### Patch Changes
+
+- Updated dependencies [795dfd4]
+- Updated dependencies [c71729b]
+  - flags@4.0.3
+  - @vercel/flags-core@1.0.0
+
 ## 0.1.8
 
 ### Patch Changes

package/README.md

@@ -1 +1,28 @@
 # `@flags-sdk/vercel`
+
+The [Vercel adapter](https://flags-sdk.dev/providers/vercel) for the [Flags SDK](https://flags-sdk.dev/) connects your feature flags to [Vercel Flags](https://vercel.com/docs/flags/vercel-flags), the feature flag platform built into Vercel. Manage flags, define targeting rules, roll out gradually, and run experiments directly from the Vercel Dashboard.
+
+## Installation
+
+```bash
+npm i flags @flags-sdk/vercel @vercel/flags-core
+```
+
+## Usage
+
+```ts
+import { flag } from 'flags/next';
+import { vercelAdapter } from '@flags-sdk/vercel';
+
+export const exampleFlag = flag({
+  key: 'example-flag',
+  adapter: vercelAdapter(),
+});
+```
+
+## Documentation
+
+- [Getting Started with Vercel Flags](https://vercel.com/docs/flags/vercel-flags/quickstart)
+- [Vercel Flags](https://vercel.com/docs/flags/vercel-flags)
+- [@flags-sdk/vercel](https://flags-sdk.dev/providers/vercel)
+- [Flags SDK](https://flags-sdk.dev/)

package/dist/index.cjs

@@ -3,27 +3,15 @@
 
 
 
-
 var _flagscore = require('@vercel/flags-core');
-function createVercelAdapter(connectionStringOrFlagsClient) {
-  const flagsClient = typeof connectionStringOrFlagsClient === "string" ? _flagscore.createClientFromConnectionString.call(void 0, connectionStringOrFlagsClient) : connectionStringOrFlagsClient;
+function createVercelAdapter(sdkKeyOrFlagsClient) {
+  const flagsClient2 = typeof sdkKeyOrFlagsClient === "string" ? _flagscore.createClient.call(void 0, sdkKeyOrFlagsClient) : sdkKeyOrFlagsClient;
   return function vercelAdapter2() {
     return {
-      origin: {
-        provider: "vercel",
-        projectId: flagsClient.dataSource.projectId,
-        env: flagsClient.environment
-      },
+      origin: flagsClient2.origin,
       config: { reportValue: false },
       async decide({ key, entities, headers }) {
-        const evaluationResultPromise = _flagscore.store.run(headers, async () => {
-          return flagsClient.evaluate(
-            key,
-            void 0,
-            entities
-          );
-        });
-        const evaluationResult = await evaluationResultPromise;
+        const evaluationResult = await flagsClient2.evaluate(key, void 0, entities);
         if (evaluationResult.value === void 0) {
           throw new Error(
             evaluationResult.reason === _flagscore.Reason.ERROR && evaluationResult.errorMessage ? `flags: Could not evaluate flag "${key}". ${evaluationResult.errorMessage}` : `flags: Could not evaluate flag "${key}"`
@@ -40,13 +28,64 @@ function resetDefaultVercelAdapter() {
 }
 function vercelAdapter() {
   if (!defaultVercelAdapter) {
-    defaultVercelAdapter = createVercelAdapter(_flagscore.getDefaultFlagsClient.call(void 0, ));
+    defaultVercelAdapter = createVercelAdapter(_flagscore.flagsClient);
   }
   return defaultVercelAdapter();
 }
+var flagsClients = /* @__PURE__ */ new Map();
+function getOrCreateClient(sdkKey) {
+  let client = flagsClients.get(sdkKey);
+  if (!client) {
+    client = _flagscore.createClient.call(void 0, sdkKey);
+    flagsClients.set(sdkKey, client);
+  }
+  return client;
+}
+function isVercelOrigin(origin) {
+  return typeof origin === "object" && origin !== null && "provider" in origin && origin.provider === "vercel" && "sdkKey" in origin && typeof origin.sdkKey === "string";
+}
+async function getProviderData(flags) {
+  const flagDefs = Object.values(flags).filter((i) => !Array.isArray(i));
+  const sdkKeys = /* @__PURE__ */ new Set();
+  for (const d of flagDefs) {
+    if (isVercelOrigin(d.origin)) {
+      sdkKeys.add(d.origin.sdkKey);
+    }
+  }
+  const projectIdBySdkKey = /* @__PURE__ */ new Map();
+  await Promise.all(
+    Array.from(sdkKeys).map(async (sdkKey) => {
+      const client = getOrCreateClient(sdkKey);
+      try {
+        const fallback = await client.getFallbackDatafile();
+        projectIdBySdkKey.set(sdkKey, fallback.projectId);
+      } catch (e) {
+        const datafile = await client.getDatafile();
+        projectIdBySdkKey.set(sdkKey, datafile.projectId);
+      }
+    })
+  );
+  const definitions = flagDefs.reduce((acc, d) => {
+    if (!isVercelOrigin(d.origin)) return acc;
+    const projectId = projectIdBySdkKey.get(d.origin.sdkKey);
+    acc[d.key] = {
+      options: d.options,
+      origin: {
+        provider: "vercel",
+        projectId
+      },
+      description: d.description,
+      defaultValue: d.defaultValue,
+      declaredInCode: true
+    };
+    return acc;
+  }, {});
+  return { definitions, hints: [] };
+}
+
 
 
 
 
-exports.createVercelAdapter = createVercelAdapter; exports.resetDefaultVercelAdapter = resetDefaultVercelAdapter; exports.vercelAdapter = vercelAdapter;
+exports.createVercelAdapter = createVercelAdapter; exports.getProviderData = getProviderData; exports.resetDefaultVercelAdapter = resetDefaultVercelAdapter; exports.vercelAdapter = vercelAdapter;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["vercelAdapter"],"mappings":";AAAA;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWA,SAAS,oBAEd,+BACA;AACA,QAAM,cACJ,OAAO,kCAAkC,WACrC,iCAAiC,6BAA6B,IAC9D;AAEN,SAAO,SAASA,iBAGd;AACA,WAAO;AAAA,MACL,QAAQ;AAAA,QACN,UAAU;AAAA,QACV,WAAW,YAAY,WAAW;AAAA,QAClC,KAAK,YAAY;AAAA,MACnB;AAAA,MACA,QAAQ,EAAE,aAAa,MAAM;AAAA,MAC7B,MAAM,OAAO,EAAE,KAAK,UAAU,QAAQ,GAAuB;AAC3D,cAAM,0BAA0B,MAAM,IAAI,SAAS,YAAY;AAC7D,iBAAO,YAAY;AAAA,YACjB;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF,CAAC;AAED,cAAM,mBAAmB,MAAM;AAC/B,YAAI,iBAAiB,UAAU,QAAW;AAExC,gBAAM,IAAI;AAAA,YACR,iBAAiB,WAAW,OAAO,SACjC,iBAAiB,eACf,mCAAmC,GAAG,MAAM,iBAAiB,YAAY,KACzE,mCAAmC,GAAG;AAAA,UAC5C;AAAA,QACF;AAIA,eAAO,iBAAiB;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAI;AAKG,SAAS,4BAA4B;AAC1C,yBAAuB;AACzB;AAOO,SAAS,gBAGd;AACA,MAAI,CAAC,sBAAsB;AACzB,2BAAuB,oBAAoB,sBAAsB,CAAC;AAAA,EACpE;AAEA,SAAO,qBAA8C;AACvD","sourcesContent":["import {\n  createClientFromConnectionString,\n  type FlagsClient,\n  getDefaultFlagsClient,\n  Reason,\n  store,\n} from '@vercel/flags-core';\nimport type { Adapter, FlagDeclaration } from 'flags';\n\nexport type VercelAdapterDeclaration<ValueType, EntitiesType> = Omit<\n  FlagDeclaration<ValueType, EntitiesType>,\n  'decide' | 'origin'\n>;\n\n/**\n * Allows creating a custom Vercel adapter for feature flags\n */\nexport function createVercelAdapter(\n  // usually a connection string, but can also be a pre-configured FlagsClient\n  connectionStringOrFlagsClient: string | FlagsClient,\n) {\n  const flagsClient =\n    typeof connectionStringOrFlagsClient === 'string'\n      ? createClientFromConnectionString(connectionStringOrFlagsClient)\n      : connectionStringOrFlagsClient;\n\n  return function vercelAdapter<ValueType, EntitiesType>(): Adapter<\n    ValueType,\n    EntitiesType\n  > {\n    return {\n      origin: {\n        provider: 'vercel',\n        projectId: flagsClient.dataSource.projectId,\n        env: flagsClient.environment,\n      },\n      config: { reportValue: false },\n      async decide({ key, entities, headers }): Promise<ValueType> {\n        const evaluationResultPromise = store.run(headers, async () => {\n          return flagsClient.evaluate<ValueType, EntitiesType>(\n            key,\n            undefined,\n            entities,\n          );\n        });\n\n        const evaluationResult = await evaluationResultPromise;\n        if (evaluationResult.value === undefined) {\n          // if there was no defaultValue we need to throw\n          throw new Error(\n            evaluationResult.reason === Reason.ERROR &&\n              evaluationResult.errorMessage\n              ? `flags: Could not evaluate flag \"${key}\". ${evaluationResult.errorMessage}`\n              : `flags: Could not evaluate flag \"${key}\"`,\n          );\n        }\n\n        // runs when the flag evaluates successfully or\n        // when there was an error but the defaultValue was set\n        return evaluationResult.value;\n      },\n    };\n  };\n}\n\nlet defaultVercelAdapter: ReturnType<typeof createVercelAdapter> | undefined;\n\n/**\n * Internal function for testing purposes\n */\nexport function resetDefaultVercelAdapter() {\n  defaultVercelAdapter = undefined;\n}\n\n/**\n * A default Vercel adapter for feature flags\n *\n */\n// This is initialized lazily to avoid warning when it is not actually used and env vars are missing.\nexport function vercelAdapter<ValueType, EntitiesType>(): Adapter<\n  ValueType,\n  EntitiesType\n> {\n  if (!defaultVercelAdapter) {\n    defaultVercelAdapter = createVercelAdapter(getDefaultFlagsClient());\n  }\n\n  return defaultVercelAdapter<ValueType, EntitiesType>();\n}\n"]}
+{"version":3,"sources":["/home/runner/work/flags/flags/packages/adapter-vercel/dist/index.cjs","../src/index.ts"],"names":["flagsClient","vercelAdapter"],"mappings":"AAAA;ACAA;AACE;AAEA;AACA;AAAA,+CACK;AAkBA,SAAS,mBAAA,CAEd,mBAAA,EACA;AACA,EAAA,MAAMA,aAAAA,EACJ,OAAO,oBAAA,IAAwB,SAAA,EAC3B,qCAAA,mBAAgC,EAAA,EAChC,mBAAA;AAEN,EAAA,OAAO,SAASC,cAAAA,CAAAA,EAGd;AACA,IAAA,OAAO;AAAA,MACL,MAAA,EAAQD,YAAAA,CAAY,MAAA;AAAA,MACpB,MAAA,EAAQ,EAAE,WAAA,EAAa,MAAM,CAAA;AAAA,MAC7B,MAAM,MAAA,CAAO,EAAE,GAAA,EAAK,QAAA,EAAU,QAAQ,CAAA,EAAuB;AAC3D,QAAA,MAAM,iBAAA,EAAmB,MAAMA,YAAAA,CAAY,QAAA,CAGzC,GAAA,EAAK,KAAA,CAAA,EAAW,QAAQ,CAAA;AAE1B,QAAA,GAAA,CAAI,gBAAA,CAAiB,MAAA,IAAU,KAAA,CAAA,EAAW;AAExC,UAAA,MAAM,IAAI,KAAA;AAAA,YACR,gBAAA,CAAiB,OAAA,IAAW,iBAAA,CAAO,MAAA,GACjC,gBAAA,CAAiB,aAAA,EACf,CAAA,gCAAA,EAAmC,GAAG,CAAA,GAAA,EAAM,gBAAA,CAAiB,YAAY,CAAA,EAAA;AAE/E,UAAA;AACF,QAAA;AAIwB,QAAA;AAC1B,MAAA;AACF,IAAA;AACF,EAAA;AACF;AAEI;AAKwC;AACnB,EAAA;AACzB;AAUE;AAC2B,EAAA;AAC6B,IAAA;AACxD,EAAA;AAEqD,EAAA;AACvD;AAEkD;AAEM;AAClB,EAAA;AACvB,EAAA;AACiB,IAAA;AACG,IAAA;AACjC,EAAA;AACO,EAAA;AACT;AAIoD;AAOM,EAAA;AAE1D;AAQyB;AAGyC,EAAA;AAGhC,EAAA;AACN,EAAA;AACM,IAAA;AACD,MAAA;AAC7B,IAAA;AACF,EAAA;AAEkD,EAAA;AACpC,EAAA;AAC8B,IAAA;AACD,MAAA;AACnC,MAAA;AACgD,QAAA;AACF,QAAA;AAC1C,MAAA;AACoC,QAAA;AACM,QAAA;AAClD,MAAA;AACD,IAAA;AACH,EAAA;AAEqE,EAAA;AAC7B,IAAA;AAEiB,IAAA;AAC1C,IAAA;AACA,MAAA;AACH,MAAA;AACI,QAAA;AACV,QAAA;AACF,MAAA;AACe,MAAA;AACC,MAAA;AACA,MAAA;AAClB,IAAA;AAEO,IAAA;AACJ,EAAA;AAE2B,EAAA;AAClC;ADhFkK;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/flags/flags/packages/adapter-vercel/dist/index.cjs","sourcesContent":[null,"import {\n  createClient,\n  type FlagsClient,\n  flagsClient,\n  Reason,\n} from '@vercel/flags-core';\nimport type {\n  Adapter,\n  FlagDeclaration,\n  FlagDefinitionsType,\n  FlagDefinitionType,\n  ProviderData,\n} from 'flags';\nimport type { KeyedFlagDefinitionType } from 'flags/next';\n\nexport type VercelAdapterDeclaration<ValueType, EntitiesType> = Omit<\n  FlagDeclaration<ValueType, EntitiesType>,\n  'decide' | 'origin'\n>;\n\n/**\n * Allows creating a custom Vercel adapter for feature flags\n */\nexport function createVercelAdapter(\n  // usually a connection string, but can also be a pre-configured FlagsClient\n  sdkKeyOrFlagsClient: string | FlagsClient,\n) {\n  const flagsClient =\n    typeof sdkKeyOrFlagsClient === 'string'\n      ? createClient(sdkKeyOrFlagsClient)\n      : sdkKeyOrFlagsClient;\n\n  return function vercelAdapter<ValueType, EntitiesType>(): Adapter<\n    ValueType,\n    EntitiesType\n  > {\n    return {\n      origin: flagsClient.origin,\n      config: { reportValue: false },\n      async decide({ key, entities, headers }): Promise<ValueType> {\n        const evaluationResult = await flagsClient.evaluate<\n          ValueType,\n          EntitiesType\n        >(key, undefined, entities);\n\n        if (evaluationResult.value === undefined) {\n          // if there was no defaultValue we need to throw\n          throw new Error(\n            evaluationResult.reason === Reason.ERROR &&\n              evaluationResult.errorMessage\n              ? `flags: Could not evaluate flag \"${key}\". ${evaluationResult.errorMessage}`\n              : `flags: Could not evaluate flag \"${key}\"`,\n          );\n        }\n\n        // runs when the flag evaluates successfully or\n        // when there was an error but the defaultValue was set\n        return evaluationResult.value;\n      },\n    };\n  };\n}\n\nlet defaultVercelAdapter: ReturnType<typeof createVercelAdapter> | undefined;\n\n/**\n * Internal function for testing purposes\n */\nexport function resetDefaultVercelAdapter() {\n  defaultVercelAdapter = undefined;\n}\n\n/**\n * A default Vercel adapter for feature flags\n *\n */\n// This is initialized lazily to avoid warning when it is not actually used and env vars are missing.\nexport function vercelAdapter<ValueType, EntitiesType>(): Adapter<\n  ValueType,\n  EntitiesType\n> {\n  if (!defaultVercelAdapter) {\n    defaultVercelAdapter = createVercelAdapter(flagsClient);\n  }\n\n  return defaultVercelAdapter<ValueType, EntitiesType>();\n}\n\nconst flagsClients = new Map<string, FlagsClient>();\n\nfunction getOrCreateClient(sdkKey: string): FlagsClient {\n  let client = flagsClients.get(sdkKey);\n  if (!client) {\n    client = createClient(sdkKey);\n    flagsClients.set(sdkKey, client);\n  }\n  return client;\n}\n\nfunction isVercelOrigin(\n  origin: unknown,\n): origin is { provider: 'vercel'; sdkKey: string } {\n  return (\n    typeof origin === 'object' &&\n    origin !== null &&\n    'provider' in origin &&\n    (origin as Record<string, unknown>).provider === 'vercel' &&\n    'sdkKey' in origin &&\n    typeof (origin as Record<string, unknown>).sdkKey === 'string'\n  );\n}\n\nexport async function getProviderData(\n  flags: Record<\n    string,\n    // accept an unknown array\n    KeyedFlagDefinitionType | readonly unknown[]\n  >,\n): Promise<ProviderData> {\n  const flagDefs = Object.values(flags)\n    // filter out precomputed arrays\n    .filter((i): i is KeyedFlagDefinitionType => !Array.isArray(i));\n\n  // Collect unique sdkKeys and resolve their projectIds\n  const sdkKeys = new Set<string>();\n  for (const d of flagDefs) {\n    if (isVercelOrigin(d.origin)) {\n      sdkKeys.add(d.origin.sdkKey);\n    }\n  }\n\n  const projectIdBySdkKey = new Map<string, string>();\n  await Promise.all(\n    Array.from(sdkKeys).map(async (sdkKey) => {\n      const client = getOrCreateClient(sdkKey);\n      try {\n        const fallback = await client.getFallbackDatafile();\n        projectIdBySdkKey.set(sdkKey, fallback.projectId);\n      } catch {\n        const datafile = await client.getDatafile();\n        projectIdBySdkKey.set(sdkKey, datafile.projectId);\n      }\n    }),\n  );\n\n  const definitions = flagDefs.reduce<FlagDefinitionsType>((acc, d) => {\n    if (!isVercelOrigin(d.origin)) return acc;\n\n    const projectId = projectIdBySdkKey.get(d.origin.sdkKey)!;\n    acc[d.key] = {\n      options: d.options,\n      origin: {\n        provider: 'vercel',\n        projectId,\n      },\n      description: d.description,\n      defaultValue: d.defaultValue,\n      declaredInCode: true,\n    } satisfies FlagDefinitionType;\n\n    return acc;\n  }, {});\n\n  return { definitions, hints: [] };\n}\n"]}

package/dist/index.d.cts

@@ -1,11 +1,12 @@
 import { FlagsClient } from '@vercel/flags-core';
-import { FlagDeclaration, Adapter } from 'flags';
+import { FlagDeclaration, Adapter, ProviderData } from 'flags';
+import { KeyedFlagDefinitionType } from 'flags/next';
 
 type VercelAdapterDeclaration<ValueType, EntitiesType> = Omit<FlagDeclaration<ValueType, EntitiesType>, 'decide' | 'origin'>;
 /**
  * Allows creating a custom Vercel adapter for feature flags
  */
-declare function createVercelAdapter(connectionStringOrFlagsClient: string | FlagsClient): <ValueType, EntitiesType>() => Adapter<ValueType, EntitiesType>;
+declare function createVercelAdapter(sdkKeyOrFlagsClient: string | FlagsClient): <ValueType, EntitiesType>() => Adapter<ValueType, EntitiesType>;
 /**
  * Internal function for testing purposes
  */
@@ -15,5 +16,6 @@ declare function resetDefaultVercelAdapter(): void;
  *
  */
 declare function vercelAdapter<ValueType, EntitiesType>(): Adapter<ValueType, EntitiesType>;
+declare function getProviderData(flags: Record<string, KeyedFlagDefinitionType | readonly unknown[]>): Promise<ProviderData>;
 
-export { type VercelAdapterDeclaration, createVercelAdapter, resetDefaultVercelAdapter, vercelAdapter };
+export { type VercelAdapterDeclaration, createVercelAdapter, getProviderData, resetDefaultVercelAdapter, vercelAdapter };

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import { FlagsClient } from '@vercel/flags-core';
-import { FlagDeclaration, Adapter } from 'flags';
+import { FlagDeclaration, Adapter, ProviderData } from 'flags';
+import { KeyedFlagDefinitionType } from 'flags/next';
 
 type VercelAdapterDeclaration<ValueType, EntitiesType> = Omit<FlagDeclaration<ValueType, EntitiesType>, 'decide' | 'origin'>;
 /**
  * Allows creating a custom Vercel adapter for feature flags
  */
-declare function createVercelAdapter(connectionStringOrFlagsClient: string | FlagsClient): <ValueType, EntitiesType>() => Adapter<ValueType, EntitiesType>;
+declare function createVercelAdapter(sdkKeyOrFlagsClient: string | FlagsClient): <ValueType, EntitiesType>() => Adapter<ValueType, EntitiesType>;
 /**
  * Internal function for testing purposes
  */
@@ -15,5 +16,6 @@ declare function resetDefaultVercelAdapter(): void;
  *
  */
 declare function vercelAdapter<ValueType, EntitiesType>(): Adapter<ValueType, EntitiesType>;
+declare function getProviderData(flags: Record<string, KeyedFlagDefinitionType | readonly unknown[]>): Promise<ProviderData>;
 
-export { type VercelAdapterDeclaration, createVercelAdapter, resetDefaultVercelAdapter, vercelAdapter };
+export { type VercelAdapterDeclaration, createVercelAdapter, getProviderData, resetDefaultVercelAdapter, vercelAdapter };

package/dist/index.js

@@ -1,29 +1,17 @@
 // src/index.ts
 import {
-  createClientFromConnectionString,
-  getDefaultFlagsClient,
-  Reason,
-  store
+  createClient,
+  flagsClient,
+  Reason
 } from "@vercel/flags-core";
-function createVercelAdapter(connectionStringOrFlagsClient) {
-  const flagsClient = typeof connectionStringOrFlagsClient === "string" ? createClientFromConnectionString(connectionStringOrFlagsClient) : connectionStringOrFlagsClient;
+function createVercelAdapter(sdkKeyOrFlagsClient) {
+  const flagsClient2 = typeof sdkKeyOrFlagsClient === "string" ? createClient(sdkKeyOrFlagsClient) : sdkKeyOrFlagsClient;
   return function vercelAdapter2() {
     return {
-      origin: {
-        provider: "vercel",
-        projectId: flagsClient.dataSource.projectId,
-        env: flagsClient.environment
-      },
+      origin: flagsClient2.origin,
       config: { reportValue: false },
       async decide({ key, entities, headers }) {
-        const evaluationResultPromise = store.run(headers, async () => {
-          return flagsClient.evaluate(
-            key,
-            void 0,
-            entities
-          );
-        });
-        const evaluationResult = await evaluationResultPromise;
+        const evaluationResult = await flagsClient2.evaluate(key, void 0, entities);
         if (evaluationResult.value === void 0) {
           throw new Error(
             evaluationResult.reason === Reason.ERROR && evaluationResult.errorMessage ? `flags: Could not evaluate flag "${key}". ${evaluationResult.errorMessage}` : `flags: Could not evaluate flag "${key}"`
@@ -40,12 +28,63 @@ function resetDefaultVercelAdapter() {
 }
 function vercelAdapter() {
   if (!defaultVercelAdapter) {
-    defaultVercelAdapter = createVercelAdapter(getDefaultFlagsClient());
+    defaultVercelAdapter = createVercelAdapter(flagsClient);
   }
   return defaultVercelAdapter();
 }
+var flagsClients = /* @__PURE__ */ new Map();
+function getOrCreateClient(sdkKey) {
+  let client = flagsClients.get(sdkKey);
+  if (!client) {
+    client = createClient(sdkKey);
+    flagsClients.set(sdkKey, client);
+  }
+  return client;
+}
+function isVercelOrigin(origin) {
+  return typeof origin === "object" && origin !== null && "provider" in origin && origin.provider === "vercel" && "sdkKey" in origin && typeof origin.sdkKey === "string";
+}
+async function getProviderData(flags) {
+  const flagDefs = Object.values(flags).filter((i) => !Array.isArray(i));
+  const sdkKeys = /* @__PURE__ */ new Set();
+  for (const d of flagDefs) {
+    if (isVercelOrigin(d.origin)) {
+      sdkKeys.add(d.origin.sdkKey);
+    }
+  }
+  const projectIdBySdkKey = /* @__PURE__ */ new Map();
+  await Promise.all(
+    Array.from(sdkKeys).map(async (sdkKey) => {
+      const client = getOrCreateClient(sdkKey);
+      try {
+        const fallback = await client.getFallbackDatafile();
+        projectIdBySdkKey.set(sdkKey, fallback.projectId);
+      } catch {
+        const datafile = await client.getDatafile();
+        projectIdBySdkKey.set(sdkKey, datafile.projectId);
+      }
+    })
+  );
+  const definitions = flagDefs.reduce((acc, d) => {
+    if (!isVercelOrigin(d.origin)) return acc;
+    const projectId = projectIdBySdkKey.get(d.origin.sdkKey);
+    acc[d.key] = {
+      options: d.options,
+      origin: {
+        provider: "vercel",
+        projectId
+      },
+      description: d.description,
+      defaultValue: d.defaultValue,
+      declaredInCode: true
+    };
+    return acc;
+  }, {});
+  return { definitions, hints: [] };
+}
 export {
   createVercelAdapter,
+  getProviderData,
   resetDefaultVercelAdapter,
   vercelAdapter
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  createClientFromConnectionString,\n  type FlagsClient,\n  getDefaultFlagsClient,\n  Reason,\n  store,\n} from '@vercel/flags-core';\nimport type { Adapter, FlagDeclaration } from 'flags';\n\nexport type VercelAdapterDeclaration<ValueType, EntitiesType> = Omit<\n  FlagDeclaration<ValueType, EntitiesType>,\n  'decide' | 'origin'\n>;\n\n/**\n * Allows creating a custom Vercel adapter for feature flags\n */\nexport function createVercelAdapter(\n  // usually a connection string, but can also be a pre-configured FlagsClient\n  connectionStringOrFlagsClient: string | FlagsClient,\n) {\n  const flagsClient =\n    typeof connectionStringOrFlagsClient === 'string'\n      ? createClientFromConnectionString(connectionStringOrFlagsClient)\n      : connectionStringOrFlagsClient;\n\n  return function vercelAdapter<ValueType, EntitiesType>(): Adapter<\n    ValueType,\n    EntitiesType\n  > {\n    return {\n      origin: {\n        provider: 'vercel',\n        projectId: flagsClient.dataSource.projectId,\n        env: flagsClient.environment,\n      },\n      config: { reportValue: false },\n      async decide({ key, entities, headers }): Promise<ValueType> {\n        const evaluationResultPromise = store.run(headers, async () => {\n          return flagsClient.evaluate<ValueType, EntitiesType>(\n            key,\n            undefined,\n            entities,\n          );\n        });\n\n        const evaluationResult = await evaluationResultPromise;\n        if (evaluationResult.value === undefined) {\n          // if there was no defaultValue we need to throw\n          throw new Error(\n            evaluationResult.reason === Reason.ERROR &&\n              evaluationResult.errorMessage\n              ? `flags: Could not evaluate flag \"${key}\". ${evaluationResult.errorMessage}`\n              : `flags: Could not evaluate flag \"${key}\"`,\n          );\n        }\n\n        // runs when the flag evaluates successfully or\n        // when there was an error but the defaultValue was set\n        return evaluationResult.value;\n      },\n    };\n  };\n}\n\nlet defaultVercelAdapter: ReturnType<typeof createVercelAdapter> | undefined;\n\n/**\n * Internal function for testing purposes\n */\nexport function resetDefaultVercelAdapter() {\n  defaultVercelAdapter = undefined;\n}\n\n/**\n * A default Vercel adapter for feature flags\n *\n */\n// This is initialized lazily to avoid warning when it is not actually used and env vars are missing.\nexport function vercelAdapter<ValueType, EntitiesType>(): Adapter<\n  ValueType,\n  EntitiesType\n> {\n  if (!defaultVercelAdapter) {\n    defaultVercelAdapter = createVercelAdapter(getDefaultFlagsClient());\n  }\n\n  return defaultVercelAdapter<ValueType, EntitiesType>();\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWA,SAAS,oBAEd,+BACA;AACA,QAAM,cACJ,OAAO,kCAAkC,WACrC,iCAAiC,6BAA6B,IAC9D;AAEN,SAAO,SAASA,iBAGd;AACA,WAAO;AAAA,MACL,QAAQ;AAAA,QACN,UAAU;AAAA,QACV,WAAW,YAAY,WAAW;AAAA,QAClC,KAAK,YAAY;AAAA,MACnB;AAAA,MACA,QAAQ,EAAE,aAAa,MAAM;AAAA,MAC7B,MAAM,OAAO,EAAE,KAAK,UAAU,QAAQ,GAAuB;AAC3D,cAAM,0BAA0B,MAAM,IAAI,SAAS,YAAY;AAC7D,iBAAO,YAAY;AAAA,YACjB;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF,CAAC;AAED,cAAM,mBAAmB,MAAM;AAC/B,YAAI,iBAAiB,UAAU,QAAW;AAExC,gBAAM,IAAI;AAAA,YACR,iBAAiB,WAAW,OAAO,SACjC,iBAAiB,eACf,mCAAmC,GAAG,MAAM,iBAAiB,YAAY,KACzE,mCAAmC,GAAG;AAAA,UAC5C;AAAA,QACF;AAIA,eAAO,iBAAiB;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAI;AAKG,SAAS,4BAA4B;AAC1C,yBAAuB;AACzB;AAOO,SAAS,gBAGd;AACA,MAAI,CAAC,sBAAsB;AACzB,2BAAuB,oBAAoB,sBAAsB,CAAC;AAAA,EACpE;AAEA,SAAO,qBAA8C;AACvD;","names":["vercelAdapter"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  createClient,\n  type FlagsClient,\n  flagsClient,\n  Reason,\n} from '@vercel/flags-core';\nimport type {\n  Adapter,\n  FlagDeclaration,\n  FlagDefinitionsType,\n  FlagDefinitionType,\n  ProviderData,\n} from 'flags';\nimport type { KeyedFlagDefinitionType } from 'flags/next';\n\nexport type VercelAdapterDeclaration<ValueType, EntitiesType> = Omit<\n  FlagDeclaration<ValueType, EntitiesType>,\n  'decide' | 'origin'\n>;\n\n/**\n * Allows creating a custom Vercel adapter for feature flags\n */\nexport function createVercelAdapter(\n  // usually a connection string, but can also be a pre-configured FlagsClient\n  sdkKeyOrFlagsClient: string | FlagsClient,\n) {\n  const flagsClient =\n    typeof sdkKeyOrFlagsClient === 'string'\n      ? createClient(sdkKeyOrFlagsClient)\n      : sdkKeyOrFlagsClient;\n\n  return function vercelAdapter<ValueType, EntitiesType>(): Adapter<\n    ValueType,\n    EntitiesType\n  > {\n    return {\n      origin: flagsClient.origin,\n      config: { reportValue: false },\n      async decide({ key, entities, headers }): Promise<ValueType> {\n        const evaluationResult = await flagsClient.evaluate<\n          ValueType,\n          EntitiesType\n        >(key, undefined, entities);\n\n        if (evaluationResult.value === undefined) {\n          // if there was no defaultValue we need to throw\n          throw new Error(\n            evaluationResult.reason === Reason.ERROR &&\n              evaluationResult.errorMessage\n              ? `flags: Could not evaluate flag \"${key}\". ${evaluationResult.errorMessage}`\n              : `flags: Could not evaluate flag \"${key}\"`,\n          );\n        }\n\n        // runs when the flag evaluates successfully or\n        // when there was an error but the defaultValue was set\n        return evaluationResult.value;\n      },\n    };\n  };\n}\n\nlet defaultVercelAdapter: ReturnType<typeof createVercelAdapter> | undefined;\n\n/**\n * Internal function for testing purposes\n */\nexport function resetDefaultVercelAdapter() {\n  defaultVercelAdapter = undefined;\n}\n\n/**\n * A default Vercel adapter for feature flags\n *\n */\n// This is initialized lazily to avoid warning when it is not actually used and env vars are missing.\nexport function vercelAdapter<ValueType, EntitiesType>(): Adapter<\n  ValueType,\n  EntitiesType\n> {\n  if (!defaultVercelAdapter) {\n    defaultVercelAdapter = createVercelAdapter(flagsClient);\n  }\n\n  return defaultVercelAdapter<ValueType, EntitiesType>();\n}\n\nconst flagsClients = new Map<string, FlagsClient>();\n\nfunction getOrCreateClient(sdkKey: string): FlagsClient {\n  let client = flagsClients.get(sdkKey);\n  if (!client) {\n    client = createClient(sdkKey);\n    flagsClients.set(sdkKey, client);\n  }\n  return client;\n}\n\nfunction isVercelOrigin(\n  origin: unknown,\n): origin is { provider: 'vercel'; sdkKey: string } {\n  return (\n    typeof origin === 'object' &&\n    origin !== null &&\n    'provider' in origin &&\n    (origin as Record<string, unknown>).provider === 'vercel' &&\n    'sdkKey' in origin &&\n    typeof (origin as Record<string, unknown>).sdkKey === 'string'\n  );\n}\n\nexport async function getProviderData(\n  flags: Record<\n    string,\n    // accept an unknown array\n    KeyedFlagDefinitionType | readonly unknown[]\n  >,\n): Promise<ProviderData> {\n  const flagDefs = Object.values(flags)\n    // filter out precomputed arrays\n    .filter((i): i is KeyedFlagDefinitionType => !Array.isArray(i));\n\n  // Collect unique sdkKeys and resolve their projectIds\n  const sdkKeys = new Set<string>();\n  for (const d of flagDefs) {\n    if (isVercelOrigin(d.origin)) {\n      sdkKeys.add(d.origin.sdkKey);\n    }\n  }\n\n  const projectIdBySdkKey = new Map<string, string>();\n  await Promise.all(\n    Array.from(sdkKeys).map(async (sdkKey) => {\n      const client = getOrCreateClient(sdkKey);\n      try {\n        const fallback = await client.getFallbackDatafile();\n        projectIdBySdkKey.set(sdkKey, fallback.projectId);\n      } catch {\n        const datafile = await client.getDatafile();\n        projectIdBySdkKey.set(sdkKey, datafile.projectId);\n      }\n    }),\n  );\n\n  const definitions = flagDefs.reduce<FlagDefinitionsType>((acc, d) => {\n    if (!isVercelOrigin(d.origin)) return acc;\n\n    const projectId = projectIdBySdkKey.get(d.origin.sdkKey)!;\n    acc[d.key] = {\n      options: d.options,\n      origin: {\n        provider: 'vercel',\n        projectId,\n      },\n      description: d.description,\n      defaultValue: d.defaultValue,\n      declaredInCode: true,\n    } satisfies FlagDefinitionType;\n\n    return acc;\n  }, {});\n\n  return { definitions, hints: [] };\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AAkBA,SAAS,oBAEd,qBACA;AACA,QAAMA,eACJ,OAAO,wBAAwB,WAC3B,aAAa,mBAAmB,IAChC;AAEN,SAAO,SAASC,iBAGd;AACA,WAAO;AAAA,MACL,QAAQD,aAAY;AAAA,MACpB,QAAQ,EAAE,aAAa,MAAM;AAAA,MAC7B,MAAM,OAAO,EAAE,KAAK,UAAU,QAAQ,GAAuB;AAC3D,cAAM,mBAAmB,MAAMA,aAAY,SAGzC,KAAK,QAAW,QAAQ;AAE1B,YAAI,iBAAiB,UAAU,QAAW;AAExC,gBAAM,IAAI;AAAA,YACR,iBAAiB,WAAW,OAAO,SACjC,iBAAiB,eACf,mCAAmC,GAAG,MAAM,iBAAiB,YAAY,KACzE,mCAAmC,GAAG;AAAA,UAC5C;AAAA,QACF;AAIA,eAAO,iBAAiB;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAI;AAKG,SAAS,4BAA4B;AAC1C,yBAAuB;AACzB;AAOO,SAAS,gBAGd;AACA,MAAI,CAAC,sBAAsB;AACzB,2BAAuB,oBAAoB,WAAW;AAAA,EACxD;AAEA,SAAO,qBAA8C;AACvD;AAEA,IAAM,eAAe,oBAAI,IAAyB;AAElD,SAAS,kBAAkB,QAA6B;AACtD,MAAI,SAAS,aAAa,IAAI,MAAM;AACpC,MAAI,CAAC,QAAQ;AACX,aAAS,aAAa,MAAM;AAC5B,iBAAa,IAAI,QAAQ,MAAM;AAAA,EACjC;AACA,SAAO;AACT;AAEA,SAAS,eACP,QACkD;AAClD,SACE,OAAO,WAAW,YAClB,WAAW,QACX,cAAc,UACb,OAAmC,aAAa,YACjD,YAAY,UACZ,OAAQ,OAAmC,WAAW;AAE1D;AAEA,eAAsB,gBACpB,OAKuB;AACvB,QAAM,WAAW,OAAO,OAAO,KAAK,EAEjC,OAAO,CAAC,MAAoC,CAAC,MAAM,QAAQ,CAAC,CAAC;AAGhE,QAAM,UAAU,oBAAI,IAAY;AAChC,aAAW,KAAK,UAAU;AACxB,QAAI,eAAe,EAAE,MAAM,GAAG;AAC5B,cAAQ,IAAI,EAAE,OAAO,MAAM;AAAA,IAC7B;AAAA,EACF;AAEA,QAAM,oBAAoB,oBAAI,IAAoB;AAClD,QAAM,QAAQ;AAAA,IACZ,MAAM,KAAK,OAAO,EAAE,IAAI,OAAO,WAAW;AACxC,YAAM,SAAS,kBAAkB,MAAM;AACvC,UAAI;AACF,cAAM,WAAW,MAAM,OAAO,oBAAoB;AAClD,0BAAkB,IAAI,QAAQ,SAAS,SAAS;AAAA,MAClD,QAAQ;AACN,cAAM,WAAW,MAAM,OAAO,YAAY;AAC1C,0BAAkB,IAAI,QAAQ,SAAS,SAAS;AAAA,MAClD;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,cAAc,SAAS,OAA4B,CAAC,KAAK,MAAM;AACnE,QAAI,CAAC,eAAe,EAAE,MAAM,EAAG,QAAO;AAEtC,UAAM,YAAY,kBAAkB,IAAI,EAAE,OAAO,MAAM;AACvD,QAAI,EAAE,GAAG,IAAI;AAAA,MACX,SAAS,EAAE;AAAA,MACX,QAAQ;AAAA,QACN,UAAU;AAAA,QACV;AAAA,MACF;AAAA,MACA,aAAa,EAAE;AAAA,MACf,cAAc,EAAE;AAAA,MAChB,gBAAgB;AAAA,IAClB;AAEA,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,aAAa,OAAO,CAAC,EAAE;AAClC;","names":["flagsClient","vercelAdapter"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flags-sdk/vercel",
-  "version": "0.1.8",
+  "version": "1.0.0",
   "description": "",
   "keywords": [],
   "license": "MIT",
@@ -26,24 +26,21 @@
     "dist",
     "CHANGELOG.md"
   ],
-  "dependencies": {
-    "jose": "5.2.1",
-    "js-xxhash": "4.0.0",
-    "@vercel/edge-config": "^1.4.3",
-    "@vercel/flags-core": "0.1.8"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/node": "20.11.17",
     "msw": "2.6.4",
-    "next": "15.0.3",
-    "tsup": "8.0.1",
+    "next": "16.1.5",
+    "tsup": "8.5.1",
     "typescript": "5.6.3",
-    "vite": "6.0.3",
-    "vitest": "2.1.8",
-    "flags": "4.0.2"
+    "vite": "6.4.1",
+    "vitest": "2.1.9",
+    "@vercel/flags-core": "1.0.0",
+    "flags": "4.0.3"
   },
   "peerDependencies": {
-    "flags": "*"
+    "flags": "*",
+    "@vercel/flags-core": "1.0.0"
   },
   "publishConfig": {
     "access": "public"