Skip to content

Add projectId option to read a connected project's flags - #539

Draft
vincent-derks wants to merge 3 commits into
vincentderks/prepare-connected-sourcesfrom
vincentderks/connected-project-id-option
Draft

vincent-derks wants to merge 3 commits into
vincentderks/prepare-connected-sourcesfrom
vincentderks/connected-project-id-option

Conversation

@vincent-derks

@vincent-derks vincent-derks commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Do not merge before the dashboard flow for project connections exists. Once released this is public API on a public repo. Stacked on #540.

A consumer project reads another project's flags by naming it:

import { createVercelAdapter } from '@flags-sdk/vercel';

const marketingAdapter = createVercelAdapter({ projectId: 'prj_…' });

createClient({ projectId }) on @vercel/flags-core does the same. Reads use this deployment's OIDC token plus X-Vercel-Flags-Project-Id; the project must have been connected on the source side. Combining projectId with an SDK key throws, as does an id outside [A-Za-z0-9_]{1,64}.

Tests: option on core and adapter (header and origin, invalid id, combined with an SDK key), and the source-header behaviour on stream, polling, ingest, bundled lookup and 401 messages.

@vercel

vercel Bot commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
flags-playground Ready Ready Preview, v0 Sep 30, 2026 4:50pm UTC
flags-sdk-dev Ready Ready Preview, v0 Sep 30, 2026 4:50pm UTC
flags-sdk-snippets Ready Ready Preview, v0 Sep 30, 2026 4:50pm UTC
flags-sdk-sveltekit-snippets Ready Ready Preview, v0 Sep 30, 2026 4:50pm UTC
shirt-shop Ready Ready Preview, v0 Sep 30, 2026 4:50pm UTC
shirt-shop-api Ready Ready Preview, v0 Sep 30, 2026 4:50pm UTC

…ources' into vincentderks/connected-project-id-option

# Conflicts:
#	packages/vercel-flags-core/CLAUDE.md
#	packages/vercel-flags-core/src/black-box.test.ts

This branch was successfully deployed

6 active deployments
Preview – flags-sdk-dev — d674c718 Deployed Sep 30, 2026 by vercel[bot]
Preview – flags-sdk-snippets — d674c718 Deployed Sep 30, 2026 by vercel[bot]
Preview – flags-playground — d674c718 Deployed Sep 30, 2026 by vercel[bot]
Preview – flags-sdk-sveltekit-snippets — d674c718 Deployed Sep 30, 2026 by vercel[bot]
Preview – shirt-shop-api — d674c718 Deployed Sep 30, 2026 by vercel[bot]
Preview – shirt-shop — d674c718 Deployed Sep 30, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant