Mark node: as external for Node.js compatibility

.changeset/pretty-geese-drum.md

@@ -0,0 +1,6 @@
+---
+'@sveltejs/adapter-cloudflare-workers': patch
+'@sveltejs/adapter-cloudflare': patch
+---
+
+fix: add `options.nodeCompat` to allow Node.js compatibility

documentation/docs/25-build-and-deploy/60-adapter-cloudflare.md

@@ -28,7 +28,8 @@ export default {
 			routes: {
 				include: ['/*'],
 				exclude: ['<all>']
-			}
+			},
+			nodeCompat: undefined
 		})
 	}
 };
@@ -45,6 +46,8 @@ The `routes` option allows you to customise the [`_routes.json`](https://develop
 	- `<prerendered>` contains a list of prerendered pages
 	- `<all>` (the default) contains all of the above
 
+The `nodeCompat` option allows you to enable [Node.js compatibility](https://developers.cloudflare.com/workers/runtime-apis/nodejs/), and defaults to `undefined` mean `disabled`. If `nodeCompat` is `true`, you will also need to [Enable Node.js from the Cloudflare dashboard](https://developers.cloudflare.com/workers/runtime-apis/nodejs/#enable-nodejs-from-the-cloudflare-dashboard).
+
 You can have up to 100 `include` and `exclude` rules combined. Generally you can omit the `routes` options, but if (for example) your `<prerendered>` paths exceed that limit, you may find it helpful to manually create an `exclude` list that includes `'/articles/*'` instead of the auto-generated `['/articles/foo', '/articles/bar', '/articles/baz', ...]`.
 
 ## Deployment

documentation/docs/25-build-and-deploy/70-adapter-cloudflare-workers.md

@@ -77,6 +77,22 @@ export default {
 };
 ```
 
+If you would like to enable [Node.js compatibility](https://developers.cloudflare.com/workers/runtime-apis/nodejs/#enable-nodejs-from-the-cloudflare-dashboard), you can do like so:
+
+```js
+// @errors: 2307
+/// file: svelte.config.js
+import adapter from '@sveltejs/adapter-cloudflare-workers';
+
+export default {
+	kit: {
+		adapter: adapter({ nodeCompat: true })
+	}
+};
+```
+
+You will also need to [Enable Node.js with Workers](https://developers.cloudflare.com/workers/runtime-apis/nodejs/#enable-nodejs-with-workers).
+
 ## Bindings
 
 The [`env`](https://developers.cloudflare.com/workers/runtime-apis/fetch-event#parameters) object contains your project's [bindings](https://developers.cloudflare.com/workers/platform/environment-variables/), which consist of KV/DO namespaces, etc. It is passed to SvelteKit via the `platform` property, along with `context` and `caches`, meaning that you can access it in hooks and endpoints:

packages/adapter-cloudflare-workers/index.d.ts

@@ -1,4 +1,14 @@
 import { Adapter } from '@sveltejs/kit';
 import './ambient.js';
 
-export default function plugin(options: { config?: string }): Adapter;
+export default function plugin(options?: AdapterOptions): Adapter;
+
+export interface AdapterOptions {
+	config?: string;
+	/**
+	 * Enable Node.js compatibility
+	 * https://developers.cloudflare.com/workers/runtime-apis/nodejs/
+	 * @default undefined
+	 */
+	nodeCompat?: boolean;
+}

packages/adapter-cloudflare-workers/index.js

@@ -15,12 +15,12 @@ import { fileURLToPath } from 'node:url';
  */
 
 /** @type {import('.').default} */
-export default function ({ config = 'wrangler.toml' } = {}) {
+export default function (options = { config: 'wrangler.toml' }) {
 	return {
 		name: '@sveltejs/adapter-cloudflare-workers',
 
 		async adapt(builder) {
-			const { main, site } = validate_config(builder, config);
+			const { main, site } = validate_config(builder, options.config);
 
 			const files = fileURLToPath(new URL('./files', import.meta.url).href);
 			const tmp = builder.getBuildDirectory('cloudflare-workers-tmp');
@@ -62,7 +62,11 @@ export default function ({ config = 'wrangler.toml' } = {}) {
 				entryPoints: [`${tmp}/entry.js`],
 				outfile: main,
 				bundle: true,
-				external: ['__STATIC_CONTENT_MANIFEST', 'cloudflare:*'],
+				external: [
+					'__STATIC_CONTENT_MANIFEST',
+					'cloudflare:*',
+					...(options.nodeCompat ? ['node:*'] : [])
+				],
 				format: 'esm',
 				loader: {
 					'.wasm': 'copy'

packages/adapter-cloudflare/index.d.ts

@@ -30,6 +30,12 @@ export interface AdapterOptions {
 		 */
 		exclude?: string[];
 	};
+	/**
+	 * Enable Node.js compatibility
+	 * https://developers.cloudflare.com/workers/runtime-apis/nodejs/
+	 * @default undefined
+	 */
+	nodeCompat?: boolean;
 }
 
 export interface RoutesJSONSpec {

packages/adapter-cloudflare/index.js

@@ -58,7 +58,7 @@ export default function (options = {}) {
 				loader: {
 					'.wasm': 'copy'
 				},
-				external: ['cloudflare:*']
+				external: ['cloudflare:*', ...(options.nodeCompat ? ['node:*'] : [])]
 			});
 		}
 	};