experimental: embed edge config during build

.changeset/legal-walls-relate.md

@@ -0,0 +1,5 @@
+---
+'@vercel/edge-config': minor
+---
+
+use consistent edge config version during builds

.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": ["Bash(pnpm jest:*)"],
+    "deny": [],
+    "ask": []
+  }
+}

.gitignore

@@ -10,3 +10,6 @@ npm-debug.log
 .turbo
 .DS_Store
 .vscode
+.claude
+
+packages/edge-config/DEVELOPMENT.md

CLAUDE.md

@@ -0,0 +1,89 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Architecture
+
+This is a pnpm monorepo containing the Vercel Storage packages:
+
+- `@vercel/blob` - Fast object storage client
+- `@vercel/kv` - Redis-compatible key-value store client
+- `@vercel/edge-config` - Ultra-low latency edge data client
+- `@vercel/postgres` - PostgreSQL database client
+- `@vercel/postgres-kysely` - Kysely ORM wrapper for @vercel/postgres
+
+The packages are designed to work in multiple JavaScript environments:
+
+- Node.js (serverless and server environments)
+- Edge runtime (Vercel Edge Functions)
+- Browser environments
+
+Each package includes environment-specific implementations and comprehensive test coverage across all supported runtimes.
+
+## Common Commands
+
+### Development & Testing
+
+- `pnpm build` - Build all packages using Turbo
+- `pnpm test` - Run all tests across packages
+- `pnpm lint` - Lint all packages with ESLint (max warnings: 0)
+- `pnpm type-check` - TypeScript type checking across packages
+- `pnpm prettier-check` - Check code formatting
+- `pnpm prettier-fix` - Fix code formatting
+
+### Package-specific Commands
+
+Run commands in specific packages using `-F` flag:
+
+- `pnpm -F @vercel/blob test` - Test blob package only
+- `pnpm -F @vercel/blob build` - Build blob package only
+
+### Testing Strategy
+
+Each package includes multi-environment testing:
+
+- `test:node` - Node.js environment tests
+- `test:edge` - Edge runtime environment tests
+- `test:browser` - Browser environment tests (for applicable packages)
+- `test:common` - Tests that run in multiple environments
+
+### Integration Testing
+
+- `pnpm run-integration` - Start the Next.js integration test suite
+- `pnpm integration-test` - Run Playwright integration tests
+
+## Key Files & Structure
+
+### Package Structure
+
+Each package follows consistent structure:
+
+- `src/` - Source TypeScript files
+- `dist/` - Built output (CJS + ESM)
+- `tsconfig.json` - TypeScript configuration extending workspace config
+- `tsup.config.js` - Build configuration
+- Individual test files with environment suffixes (`.node.test.ts`, `.edge.test.ts`, etc.)
+
+### Workspace Configuration
+
+- `pnpm-workspace.yaml` - Defines workspace packages
+- `turbo.json` - Task orchestration and caching
+- `tooling/` - Shared ESLint and TypeScript configurations
+- `test/next/` - Integration test suite using Next.js + Playwright
+
+### Environment Handling
+
+Packages use different strategies for multi-environment support:
+
+- Browser-specific shims (e.g., `crypto-browser.js`, `stream-browser.js`)
+- Conditional exports in package.json for different environments
+- Environment-specific test suites using different Jest environments
+
+## Development Notes
+
+- Uses TypeScript with strict configuration
+- ESLint extends @vercel/style-guide with zero warnings policy
+- Jest for unit testing with @edge-runtime/jest-environment for edge testing
+- Playwright for integration testing
+- Changesets for version management and releases
+- All packages support both CommonJS and ES modules via dual build

packages/edge-config/.gitignore

@@ -0,0 +1 @@
+stores/ecfg_*.json

packages/edge-config/.node-version

@@ -0,0 +1 @@
+22

packages/edge-config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/edge-config",
-  "version": "1.4.0",
+  "version": "2.0.0-beta.802",
   "description": "Ultra-low latency data at the edge",
   "homepage": "https://vercel.com",
   "repository": {
@@ -12,13 +12,23 @@
   "sideEffects": false,
   "type": "module",
   "exports": {
-    "import": "./dist/index.js",
-    "require": "./dist/index.cjs"
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./stores": {
+      "import": "./stores",
+      "require": "./stores"
+    }
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
+  "bin": {
+    "edge-config": "./dist/cli.js"
+  },
   "files": [
-    "dist"
+    "dist",
+    "stores"
   ],
   "scripts": {
     "build": "tsup",
@@ -41,7 +51,8 @@
     "testEnvironment": "node"
   },
   "dependencies": {
-    "@vercel/edge-config-fs": "workspace:*"
+    "@vercel/functions": "^2.2.5",
+    "eventsource-client": "1.2.0"
   },
   "devDependencies": {
     "@changesets/cli": "2.28.1",

packages/edge-config/src/cli.ts

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+/*
+ * Reads all connected Edge Configs and emits them to the stores folder
+ * that can be accessed at runtime by the mockable-import function.
+ *
+ * Attaches the updatedAt timestamp from the header to the emitted file, since
+ * the endpoint does not currently include it in the response body.
+ */
+
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import type { Connection, EmbeddedEdgeConfig } from './types';
+import { parseConnectionString } from './utils';
+
+// Get the directory where this CLI script is located
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Write to the stores folder relative to the package root
+// This works both in development and when installed as a dependency
+const getStoresDir = (): string => {
+  // In development: packages/edge-config/src/cli.ts -> packages/edge-config/stores/
+  // When installed: node_modules/@vercel/edge-config/dist/cli.cjs -> node_modules/@vercel/edge-config/stores/
+  return join(__dirname, '..', 'stores');
+};
+
+async function main(): Promise<void> {
+  const connections = Object.values(process.env).reduce<Connection[]>(
+    (acc, value) => {
+      if (typeof value !== 'string') return acc;
+      const data = parseConnectionString(value);
+
+      if (data) {
+        acc.push(data);
+      }
+
+      return acc;
+    },
+    [],
+  );
+
+  const storesDir = getStoresDir();
+  // eslint-disable-next-line no-console -- This is a CLI tool
+  console.log(`Creating stores directory: ${storesDir}`);
+  await mkdir(storesDir, { recursive: true });
+
+  await Promise.all(
+    connections.map(async (connection) => {
+      const { data, updatedAt } = await fetch(connection.baseUrl, {
+        headers: {
+          authorization: `Bearer ${connection.token}`,
+          // consistentRead
+          'x-edge-config-min-updated-at': `${Number.MAX_SAFE_INTEGER}`,
+        },
+      }).then(async (res) => {
+        const ts = res.headers.get('x-edge-config-updated-at');
+
+        return {
+          data: (await res.json()) as EmbeddedEdgeConfig,
+          updatedAt: ts ? Number(ts) : undefined,
+        };
+      });
+
+      const outputPath = join(storesDir, `${connection.id}.json`);
+      await writeFile(outputPath, JSON.stringify({ ...data, updatedAt }));
+      // eslint-disable-next-line no-console -- This is a CLI tool
+      console.log(`Emitted Edge Config for ${connection.id} to: ${outputPath}`);
+    }),
+  );
+}
+
+main().catch((error) => {
+  // eslint-disable-next-line no-console -- This is a CLI tool
+  console.error('@vercel/edge-config: prepare failed', error);
+  process.exit(1);
+});