feat: load edge functions bootstrap from module (#6496)

* feat: load edge functions bootstrap from module

* chore: add test

* refactor: update error logging

* chore: update `@netlify/edge-functions`

package.json

@@ -77,6 +77,7 @@
     "@netlify/build-info": "7.13.2",
     "@netlify/config": "20.12.1",
     "@netlify/edge-bundler": "11.3.0",
+    "@netlify/edge-functions": "2.5.1",
     "@netlify/local-functions-proxy": "1.1.1",
     "@netlify/zip-it-and-ship-it": "9.31.1",
     "@octokit/rest": "19.0.13",

src/commands/deploy/deploy.ts

@@ -597,7 +597,7 @@ const bundleEdgeFunctions = async (options, command: BaseCommand) => {
     packagePath: command.workspacePackage,
     buffer: true,
     featureFlags: edgeFunctionsFeatureFlags,
-    edgeFunctionsBootstrapURL: getBootstrapURL(),
+    edgeFunctionsBootstrapURL: await getBootstrapURL(),
   })
 
   if (!success) {

src/lib/build.ts

@@ -30,7 +30,7 @@ import { featureFlags as edgeFunctionsFeatureFlags } from './edge-functions/cons
  * @param {*} config.deployHandler
  * @returns {BuildConfig}
  */
-export const getBuildOptions = ({
+export const getBuildOptions = async ({
   // @ts-expect-error TS(7031) FIXME: Binding element 'cachedConfig' implicitly has an '... Remove this comment to see the full error message
   cachedConfig,
   // @ts-expect-error TS(7031) FIXME: Binding element 'currentDir' implicitly has an 'an... Remove this comment to see the full error message
@@ -89,7 +89,7 @@ export const getBuildOptions = ({
       functionsBundlingManifest: true,
     },
     eventHandlers,
-    edgeFunctionsBootstrapURL: getBootstrapURL(),
+    edgeFunctionsBootstrapURL: await getBootstrapURL(),
   }
 }
 

src/lib/edge-functions/bootstrap.ts

@@ -1,5 +1,24 @@
 import { env } from 'process'
 
-const latestBootstrapURL = 'https://65f9b38dc160de0008d35515--edge.netlify.com/bootstrap/index-combined.ts'
+import { getURL } from '@netlify/edge-functions/version'
 
-export const getBootstrapURL = () => env.NETLIFY_EDGE_BOOTSTRAP || latestBootstrapURL
+import { warn } from '../../utils/command-helpers.js'
+
+export const FALLBACK_BOOTSTRAP_URL = 'https://edge.netlify.com/bootstrap/index-combined.ts'
+
+export const getBootstrapURL = async () => {
+  if (env.NETLIFY_EDGE_BOOTSTRAP) {
+    return env.NETLIFY_EDGE_BOOTSTRAP
+  }
+
+  try {
+    return await getURL()
+  } catch (error) {
+    warn(`Could not load latest version of Edge Functions environment: ${(error as NodeJS.ErrnoException)?.message}`)
+
+    // If there was an error getting the bootstrap URL from the module, let's
+    // use the latest version of the bootstrap. This is not ideal, but better
+    // than failing to serve requests with edge functions.
+    return FALLBACK_BOOTSTRAP_URL
+  }
+}

src/lib/edge-functions/proxy.ts

@@ -227,7 +227,7 @@ const prepareServer = async ({
     const runIsolate = await bundler.serve({
       ...getDownloadUpdateFunctions(),
       basePath: projectDir,
-      bootstrapURL: getBootstrapURL(),
+      bootstrapURL: await getBootstrapURL(),
       debug,
       distImportMapPath: join(projectDir, distImportMapPath),
       featureFlags,

src/utils/run-build.ts

@@ -84,7 +84,7 @@ export const runNetlifyBuild = async ({
     cwd: cachedConfig.buildDir,
     quiet: options.quiet,
     saveConfig: options.saveConfig,
-    edgeFunctionsBootstrapURL: getBootstrapURL(),
+    edgeFunctionsBootstrapURL: await getBootstrapURL(),
   }
 
   const devCommand = async (settingsOverrides = {}) => {

tests/unit/lib/edge-functions/bootstrap.test.js

@@ -0,0 +1,32 @@
+import { env } from 'process'
+
+import { describe, expect, test } from 'vitest'
+
+import { getBootstrapURL, FALLBACK_BOOTSTRAP_URL } from '../../../../dist/lib/edge-functions/bootstrap.js'
+
+describe('`getBootstrapURL()`', () => {
+  test('Returns the URL in the `NETLIFY_EDGE_BOOTSTRAP` URL, if set', async () => {
+    const mockBootstrapURL = 'https://edge.netlify/bootstrap.ts'
+
+    env.NETLIFY_EDGE_BOOTSTRAP = mockBootstrapURL
+
+    const bootstrapURL = await getBootstrapURL()
+
+    delete env.NETLIFY_EDGE_BOOTSTRAP
+
+    expect(bootstrapURL).toEqual(mockBootstrapURL)
+  })
+
+  test('Returns a publicly accessible URL', async () => {
+    const bootstrapURL = await getBootstrapURL()
+
+    // We shouldn't get the fallback URL, because that means we couldn't get
+    // the URL from the `@netlify/edge-functions` module.
+    expect(bootstrapURL).not.toBe(FALLBACK_BOOTSTRAP_URL)
+
+    const res = await fetch(bootstrapURL)
+
+    expect(res.status).toBe(200)
+    expect(res.headers.get('content-type').startsWith('application/typescript')).toBe(true)
+  })
+})