@vercel/flags-core 1.10.2 → 1.11.0-31e6462-20261026142820

package/CHANGELOG.md

@@ -1,13 +1,15 @@
 # @vercel/flags-core
 
-## 1.10.2
+## 1.11.0-31e6462-20261026142820
+
+### Minor Changes
+
+- [#539](https://github.com/vercel/flags/pull/539) [`fc7da82`](https://github.com/vercel/flags/commit/fc7da82d4cffb9d4662335e984e09fec22ba4a6b) Thanks [@vincent-derks](https://github.com/vincent-derks)! - Add a `projectId` option to read the flags of a connected project.
 
 ### Patch Changes
 
 - [#567](https://github.com/vercel/flags/pull/567) [`5f738f0`](https://github.com/vercel/flags/commit/5f738f08f182838d0efb13fd3efb89751d48cb0a) Thanks [@vincent-derks](https://github.com/vincent-derks)! - Improve guidance for authorization errors.
 
-- [#573](https://github.com/vercel/flags/pull/573) [`e2a1a39`](https://github.com/vercel/flags/commit/e2a1a394e3de4b271c8305bae6cbcf053814ab70) Thanks [@luismeyer](https://github.com/luismeyer)! - Read embedded flag definitions when the client is created, using the SDK key or `VERCEL_PROJECT_ID` in OIDC mode.
-
 ## 1.10.1
 
 ### Patch Changes

package/README.md

@@ -33,6 +33,18 @@ export default app;
 
 Outside Vercel, pass an SDK key explicitly: `createClient(process.env.FLAGS)`.
 
+### Read a connected project's flags
+
+Grant your project access from the source project's **Flags → Connections** page, then create a client with the source project's ID:
+
+```ts
+const sharedClient = createClient({ projectId: 'prj_source' });
+```
+
+The client uses your project's OIDC token. Both projects must belong to the same team. Connections apply across environments; the token selects the source environment, with custom environments mapped to preview. Run `vercel env pull` in your project for local development. The `projectId` option cannot be combined with an SDK key.
+
+See [Project Connections](https://vercel.com/docs/flags/vercel-flags/project-connections) for permissions and setup.
+
 ## Header-driven reads on Vercel
 
 When `VERCEL=1`, the client defaults to `vercel: true`. Initialization loads provided

package/dist/{chunk-WVS63L4A.cjs → chunk-J73HQYK2.cjs}

@@ -559,7 +559,7 @@ function bulkEvaluate(flags, shared) {
 }
 
 // package.json
-var version = "1.10.2";
+var version = "1.11.0-31e6462-20261026142820";
 
 // src/lib/report-value.ts
 function internalReportValue(key, value, data) {
@@ -1063,6 +1063,10 @@ var _oidc = require('@vercel/oidc');
 
 // src/utils/sdk-keys.ts
 var SDK_KEY_REGEX = /^vf_(?:server|client)_/;
+var PROJECT_ID_REGEX = /^[A-Za-z0-9_]{1,64}$/;
+function isValidProjectId(value) {
+  return PROJECT_ID_REGEX.test(value);
+}
 function parseSdkKeyFromFlagsConnectionString(text) {
   if (SDK_KEY_REGEX.test(text)) return text;
   try {
@@ -1120,7 +1124,21 @@ function getProjectIdFromOidcToken(oidcToken) {
 var Authentication = class {
   
   
-  constructor(sdkKeyOrConnectionString) {
+  constructor(sdkKeyOrConnectionString, options = {}) {
+    if (options.projectId !== void 0) {
+      if (typeof options.projectId !== "string" || !isValidProjectId(options.projectId)) {
+        throw new Error(
+          `@vercel/flags-core: Invalid projectId "${options.projectId}". Expected a project id like "prj_\u2026" (letters, digits and underscores, up to 64 characters)`
+        );
+      }
+      if (sdkKeyOrConnectionString !== void 0) {
+        throw new Error(
+          "@vercel/flags-core: projectId cannot be combined with an SDK key. Connected projects are read with the OIDC token of this deployment."
+        );
+      }
+      this.sourceProjectId = options.projectId;
+      return;
+    }
     if (sdkKeyOrConnectionString !== void 0) {
       if (typeof sdkKeyOrConnectionString !== "string") {
         throw new Error(
@@ -1142,24 +1160,13 @@ var Authentication = class {
     }
     return await getOidcToken();
   }
-  getStaticBundledDefinitionsLookup() {
+  async resolveBundledDefinitionsLookup() {
     if (this.sdkKey) {
       return { type: "sdk-key", sdkKey: this.sdkKey };
     }
     if (this.sourceProjectId) {
       return { type: "project-id", projectId: this.sourceProjectId };
     }
-    const projectId = process.env.VERCEL_PROJECT_ID;
-    if (projectId) {
-      return { type: "project-id", projectId };
-    }
-    return void 0;
-  }
-  async resolveBundledDefinitionsLookup() {
-    const lookup = this.getStaticBundledDefinitionsLookup();
-    if (lookup) {
-      return lookup;
-    }
     const oidcToken = await this.resolveToken();
     return {
       type: "project-id",
@@ -1669,13 +1676,6 @@ var BundledSource = class {
     }
     return void 0;
   }
-  /**
-   * Starts reading bundled definitions without waiting for the result.
-   */
-  preload() {
-    this.getResult().catch(() => {
-    });
-  }
   getResult() {
     if (!this.promise) {
       this.promise = this.options.readBundledDefinitions(this.options.auth);
@@ -2871,9 +2871,6 @@ var Controller = (_class10 = class {
       auth: this.options.auth,
       readBundledDefinitions
     });
-    if (!this.options.datafile && this.options.auth.getStaticBundledDefinitionsLookup()) {
-      this.bundledSource.preload();
-    }
     this.wireSourceEvents();
     if (this.options.datafile) {
       this.cache.seed(tagData({ ...this.options.datafile }, "provided"));
@@ -3683,8 +3680,8 @@ function make(createRawClient, defaults) {
     const optionsOnly = typeof sdkKeyOrConnectionStringOrOptions === "object" && sdkKeyOrConnectionStringOrOptions !== null;
     const sdkKeyOrConnectionString = optionsOnly ? void 0 : sdkKeyOrConnectionStringOrOptions;
     const createClientOptions = optionsOnly ? sdkKeyOrConnectionStringOrOptions : options;
-    const { experimental_reportExposures, ...controllerOptions } = _nullishCoalesce(createClientOptions, () => ( {}));
-    const auth = new Authentication(sdkKeyOrConnectionString);
+    const { experimental_reportExposures, projectId, ...controllerOptions } = _nullishCoalesce(createClientOptions, () => ( {}));
+    const auth = new Authentication(sdkKeyOrConnectionString, { projectId });
     const waitUntil2 = _nullishCoalesce(controllerOptions.waitUntil, () => ( defaults.waitUntil));
     const controller = new Controller({
       auth,
@@ -3775,4 +3772,4 @@ var { flagsClient, resetDefaultFlagsClient, createClient } = make(
 
 
 exports.ResolutionReason = ResolutionReason; exports.evaluate = evaluate; exports.FallbackNotFoundError = FallbackNotFoundError; exports.FallbackEntryNotFoundError = FallbackEntryNotFoundError; exports.Controller = Controller; exports.flagsClient = flagsClient; exports.resetDefaultFlagsClient = resetDefaultFlagsClient; exports.createClient = createClient;
-//# sourceMappingURL=chunk-WVS63L4A.cjs.map
+//# sourceMappingURL=chunk-J73HQYK2.cjs.map