Cannot find module 'cloudflare:email'

[scruffymongrel]

Astro Info

Astro                    v4.16.12
Node                     v22.2.0
System                   macOS (arm64)
Package Manager          pnpm
Output                   hybrid
Adapter                  @astrojs/cloudflare
Integrations             @astrojs/tailwind

If this issue only occurs in one browser, which browser is a problem?

No response

Describe the Bug

I'm trying to import { EmailMessage } from 'cloudflare:email' in an Astro page.

Normally this kinda import would be used in Workers just fine, but Astro seems unable to do the magic...

When I request the page, I get the following stack trace:

Error: Failed to load url cloudflare:email (resolved id: cloudflare:email) in /REDACTED_PATH/src/pages/for/enterprise.astro. Does the file exist?
    at loadAndTransform (file:///REDACTED_PATH/node_modules/.pnpm/[email protected]_@[email protected]/node_modules/vite/dist/node/chunks/dep-CB_7IfJ-.js:51920:17)
    at async instantiateModule (file:///REDACTED_PATH/node_modules/.pnpm/[email protected]_@[email protected]/node_modules/vite/dist/node/chunks/dep-CB_7IfJ-.js:52874:44)

I'm using the following astro.config.js:

import { defineConfig } from 'astro/config'
import tailwind from '@astrojs/tailwind'

import cloudflare from '@astrojs/cloudflare'

export default defineConfig({
  adapter: cloudflare({
    imageService: 'passthrough',
    platformProxy: {
      enabled: true
    }
  }),
  integrations: [tailwind()],
  output: 'hybrid',
  vite: {
    ssr: {
      external: ['cloudflare:email']
    }
  }
})

What's the expected result?

I would like for the page to render without error.

Link to Minimal Reproducible Example

https://stackblitz.com/edit/github-6doees

Participation

• I am willing to submit a pull request for this issue.

[bluwy]

I don't think this is meant to be supported in dev, but maybe @alexanderniebuhr has a better idea of this.

[alexanderniebuhr]

Yeah we don't have support for this in dev unless Cloudflare has a solution for local support?

[bluwy]

Yeah I don't think Cloudflare provides local support for that. I wonder if it's worth providing a better error message when a cloudflare builtin is encountered, if not maybe we can close this.

[alexanderniebuhr]

As you can see in this table, email bindings are not support for local dev: https://developers.cloudflare.com/workers/testing/local-development/#supported-resource-bindings-in-different-environments

[scruffymongrel]

Aha, thanks for the link!

Does that mean I can expect import { EmailMessage } from 'cloudflare:email' to work in production (inside an Astro page)?

[pthurmond-vmlyr]

So I am seeing this very same problem in Cloudflare in a branch build (not the main/production branch). I haven't tested on prod. But its the Cloudflare env. I can't even finish the build on Cloudflare. How do I fix that?

[pthurmond-vmlyr]

I should clarify that I am doing this under /src/pages/api/contact.ts. So the error is because Astro is, understandably, including this path in its build process.

[pthurmond-vmlyr]

Ok, I figured it out. Go into "astro.config.mjs". Then add the following entry for Vite...

vite: { build: { rollupOptions: { external: [ 'cloudflare:email', 'mimetext' ] } } },

Obviously this can be done alongside other rules. I have my build settings alongside my resolve rules. But this solved it for me.

[alexanderniebuhr]

@pthurmond-vmlyr Thanks for the update. Given the following code in the latest release, you shouldn't need to do the manual entry. Can you try again and post a repository for us to look into?