Refactor edge-config to prepare for Next.js support

This change refactors the edge-config implementation in preparation for supporting Next.js specific builds. The key goal is to prepare the function interfaces where we intend to push the "use cache" boundaries for Next.js support so they are stringly typed. This is to help with optimizing a fast path for "use cache" that can avoid some serialization.

One concession in this refactor is we need to move from a closure for the dev-only SWR edge config fetcher. The problem with this architecture is the function created in the closure won't be accessible to the the individual methods (like get) when they are behind a "use cache" because functions are not serializable. The technique now employed is a lazy created SWR deduper that is keyed off the connection string. This implementation does not consider garbage collection when clients are collected because 1) this is dev only and dev servers don't live very long and 2) this library does not typically require creating arbitrarily many clients since connections are typically stable for the lifetime of a deployment. We could use a FinalizationRegistry but that would limit support to runtimes that provide this and require some careful conditional requiring which just adds bundling complexity.

Author: gnoff

packages/edge-config/src/index copy.ts

@@ -0,0 +1,7 @@
+{
+  "extends": "tsconfig/base.json",
+  "compilerOptions": {
+    "resolveJsonModule": true
+  },
+  "include": ["src"]
+}

packages/edge-config/src/index.ts

@@ -1,7 +1,13 @@
 {
   "extends": "tsconfig/base.json",
   "compilerOptions": {
-    "resolveJsonModule": true
+    "resolveJsonModule": true,
+    "paths": {
+      "@vercel/edge-config/host-config": [
+        "./src/host-config/default.ts",
+        "./src/host-config/next-js.ts"
+      ]
+    }
   },
   "include": ["src"]
 }

packages/edge-config/src/methods.ts

@@ -1,14 +1,16 @@
 import { defineConfig } from 'tsup';
 
 // eslint-disable-next-line import/no-default-export -- [@vercel/style-guide@5 migration]
-export default defineConfig({
-  entry: ['src/index.ts'],
-  format: ['esm', 'cjs'],
-  splitting: true,
-  sourcemap: true,
-  minify: false,
-  clean: true,
-  skipNodeModulesBundle: true,
-  dts: true,
-  external: ['node_modules'],
-});
+export default [
+  defineConfig({
+    entry: ['src/index.ts'],
+    format: ['esm', 'cjs'],
+    splitting: true,
+    sourcemap: true,
+    minify: false,
+    clean: true,
+    skipNodeModulesBundle: true,
+    dts: true,
+    external: ['node_modules'],
+  }),
+];

packages/edge-config/tsconfig.build.json

@@ -28,7 +28,7 @@
     "got": "^14.4.6",
     "kysely": "^0.27.5",
     "ms": "^2.1.3",
-    "next": "^15.2.0",
+    "next": "15.2.5",
     "postcss": "^8.5.3",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",

packages/edge-config/tsconfig.json

@@ -29,7 +29,8 @@
     "**/*.ts",
     "**/*.tsx",
     ".next/types/**/*.ts",
-    "src/app/vercel/blob/script.mts"
+    "src/app/vercel/blob/script.mts",
+    ".next/dev/types/**/*.ts"
   ],
   "exclude": ["node_modules"]
 }