feat(node-utils): introduces @edge-runtime/node-utils to run edge compliant code in Node.js environment

[feugy]

📖 What's in there?

Utility functions that we need for executing edge-related code on server side.

import { createServer } from 'node:http'
import { buildToNodeHandler } from '@edge-runtime/node-utils'

// build a transformer, using Node.js@18 globals, and a base url for URL constructor.
const transformToNode = buildToNodeHandler(global, { origin: 'http://example.com' })

const server = await createServer(transformToNode((req) => new Response(req.body)))
await server.listen()
const response = await fetch(`http://localhost:${server.address().port}`, {
  method: 'POST',
  body: 'hello world',
})
console.log(await response.text()) // is 'hello world'

🧪 How to try?

This will be used in Next.js and @vercel/node-bridge.
They are fully covered with unit tests, have a look a edge-to-node/handler.test.ts

Documentation is available here

[changeset-bot]

🦋 Changeset detected

Latest commit: cc38884

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 6 packages

Name	Type
@edge-runtime/node-utils	Patch
@edge-runtime/primitives	Patch
@edge-runtime/types	Patch
@edge-runtime/vm	Patch
@edge-runtime/jest-environment	Patch
edge-runtime	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated
edge-runtime	✅ Ready (Inspect)	Visit Preview	Dec 19, 2022 at 0:03AM (UTC)

[codecov-commenter]

Codecov Report

Merging #219 (1c7e52a) into main (fbf30d4) will increase coverage by 2.15%.
The diff coverage is 90.61%.

@@            Coverage Diff             @@
##             main     #219      +/-   ##
==========================================
+ Coverage   88.51%   90.67%   +2.15%     
==========================================
  Files          14       11       -3     
  Lines        1280      343     -937     
  Branches       67       34      -33     
==========================================
- Hits         1133      311     -822     
+ Misses        143       32     -111     
+ Partials        4        0       -4     

Impacted Files	Coverage Δ
packages/node-utils/src/edge-to-node/stream.ts	61.84% <61.84%> (ø)
packages/node-utils/src/node-to-edge/request.ts	91.30% <91.30%> (ø)
packages/node-utils/src/node-to-edge/headers.ts	95.23% <95.23%> (ø)
packages/node-utils/src/edge-to-node/handler.ts	100.00% <100.00%> (ø)
packages/node-utils/src/edge-to-node/headers.ts	100.00% <100.00%> (ø)
packages/node-utils/src/edge-to-node/index.ts	100.00% <100.00%> (ø)
packages/node-utils/src/index.ts	100.00% <100.00%> (ø)
packages/node-utils/src/node-to-edge/index.ts	100.00% <100.00%> (ø)
packages/node-utils/src/node-to-edge/stream.ts	100.00% <100.00%> (ø)
packages/node-utils/src/types.ts	100.00% <100.00%> (ø)
... and 13 more

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[nuta]

Nice! Will take a look further so leaving some nitpicks for now

[nuta]

LGTM! Left some nitpicks.