@vercel/flags-core 1.10.3 → 1.11.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @vercel/flags-core
 
+## 1.11.0
+
+### Minor Changes
+
+- [#539](https://github.com/vercel/flags/pull/539) [`24983f9`](https://github.com/vercel/flags/commit/24983f90eec9789fbed1a7a556d41070218aecb6) Thanks [@vincent-derks](https://github.com/vincent-derks)! - Prepare for upcoming Vercel Flags Project Connections with a new `projectId` option.
+
 ## 1.10.3
 
 ### 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-2P2UTT7O.js → chunk-755SFCGD.js}

@@ -576,7 +576,7 @@ function bulkEvaluate(flags, shared) {
 }
 
 // package.json
-var version = "1.10.3";
+var version = "1.11.0";
 
 // src/lib/report-value.ts
 function internalReportValue(key, value, data) {
@@ -1080,6 +1080,10 @@ import { getVercelOidcToken } from "@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 {
@@ -1146,7 +1150,21 @@ function getProjectIdFromOidcToken(oidcToken) {
 var Authentication = class {
   sdkKey;
   sourceProjectId;
-  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(
@@ -3721,8 +3739,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 } = createClientOptions ?? {};
-    const auth = new Authentication(sdkKeyOrConnectionString);
+    const { experimental_reportExposures, projectId, ...controllerOptions } = createClientOptions ?? {};
+    const auth = new Authentication(sdkKeyOrConnectionString, { projectId });
     const waitUntil3 = controllerOptions.waitUntil ?? defaults.waitUntil;
     const controller = new Controller({
       auth,
@@ -3787,4 +3805,4 @@ export {
   resetDefaultFlagsClient,
   createClient
 };
-//# sourceMappingURL=chunk-2P2UTT7O.js.map
+//# sourceMappingURL=chunk-755SFCGD.js.map