node:net: implement BlockList and SocketAddress classes

Summary

node:net has gained substantial Socket/Server and IP-classification coverage, but the data-structure classes net.BlockList and net.SocketAddress are still absent from the manifest/runtime surface.

These APIs are deterministic and do not require live network I/O, so they are good candidates for focused Node parity coverage separate from the socket lifecycle trackers.

Evidence

docs/runtime-parity-gaps.md still lists the complete BlockList surface as missing: new net.BlockList(), addAddress, addRange, addSubnet, check, fromJSON, toJSON, rules, and BlockList.isBlockList(value).
The same gap table lists the SocketAddress surface as missing: new net.SocketAddress([options]), address, family, flowlabel, port, and SocketAddress.parse(input).
test-files/test_parity_net.ts has generated probes for both classes, including constructing a BlockList, adding address/range/subnet rules, checking addresses, serializing rules, calling BlockList.isBlockList, constructing SocketAddress, reading its fields, and calling SocketAddress.parse.
Source search across crates/perry-api-manifest, crates/perry-codegen, crates/perry-stdlib/src/net, and crates/perry-runtime finds no BlockList, SocketAddress, addAddress, addRange, addSubnet, isBlockList, or SocketAddress.parse implementation entries outside the generated parity probe.
Existing net manifest/native-table rows cover Socket/Server operations, IP classification helpers, and Happy-Eyeballs defaults, but not these two classes.

I did not run a fresh local parity command because this checkout does not have a target/release/perry binary; this issue is based on committed parity metadata and source inspection.

Non-duplicates checked

net.isIP / net.isIPv4 / net.isIPv6 / net.getDefaultAutoSelectFamily return undefined #811 covered net.isIP / isIPv4 / isIPv6 / auto-select-family defaults.
node:net createServer: dotted form fails codegen, named-import form returns undefined at runtime #1123, node:net Socket/Server: connection lifecycle hangs + server.address()/listen/on gaps (75 radar runtime-fails, 24% parity) #1852, node:net follow-up: 30 lifecycle/edge-event gaps (server.address, reset-while-connecting, callback ordering) #2131, and node:http: Socket EventEmitter introspection methods (.listeners, .eventNames, .removeListener) on http-internal sockets #2211 cover Socket/Server creation, lifecycle, EventEmitter, and introspection gaps.
Searches for net BlockList SocketAddress and PRs with the same terms did not find an open or closed tracker for these classes.

Expected behavior

Implement Node-compatible deterministic behavior for:

new net.BlockList() with rule storage, addAddress, addRange, addSubnet, check, toJSON, fromJSON, rules, and static BlockList.isBlockList.
new net.SocketAddress(options) with validated address, family, flowlabel, and port fields.
SocketAddress.parse(input) for supported IPv4/IPv6 address string forms.

Focused parity tests can avoid live sockets and should be stable in CI.

Fresh local runtime evidence on current baseline confirms this remains active:

aed3a2b1b985 chore: complete stream tasklist reconciliation (#3790)

perl -e 'alarm shift; exec @ARGV' 120 ./run_parity_tests.sh --filter test_parity_net

Report:

/private/tmp/perry-node-compat-main/test-parity/reports/parity_report_20260531_141005.json

Node exposes both deterministic classes:

class net.BlockList typeof: function
new net.BlockList typeof: object
blockList.addAddress: ok
blockList.addRange: ok
blockList.addSubnet: ok
blockList.check('127.0.0.1'): true
blockList.check('8.8.8.8'): false
blockList.toJSON isArray: true
blockList.rules isArray: true
BlockList.isBlockList(bl): true
BlockList.isBlockList({}): false
class net.SocketAddress typeof: function
new net.SocketAddress typeof: object
socketAddress.address: 127.0.0.1
socketAddress.family: ipv4
socketAddress.flowlabel typeof: number
socketAddress.port: 0
SocketAddress.parse typeof: object

Perry still reports missing/nonfunctional class surface before the run later reaches the separate #3850 crash:

class net.BlockList typeof: undefined
new net.BlockList typeof: object
BlockList error: addAddress is not a function
class net.SocketAddress typeof: undefined
new net.SocketAddress typeof: object
socketAddress.address: undefined
socketAddress.family: undefined
socketAddress.flowlabel typeof: undefined
socketAddress.port: undefined
SocketAddress.parse typeof: undefined

I'm taking this as part of a focused node:net compatibility PR cut with #2546 and #2548.

Intended PR cut:

implement deterministic net.BlockList and net.SocketAddress constructor/static/instance behavior with focused parity coverage
add net.Server observable connection state and limit surface from node:net: implement Server connection count and max-connection limit surface #2546
add net.Socket Type of Service getter/setter state and validation from node:net: implement Socket Type of Service APIs #2548

I'll keep this scoped to the existing node:net manifest/codegen/runtime/test paths and avoid unrelated stream, HTTP, TLS, or broad transport rewrites.

Implemented in draft PR #4057: #4057

Opened draft PR #4069 for this grouped node:net work: #4069

The PR implements BlockList / SocketAddress handles, constructors, validation, JSON/rules helpers, and a targeted Node 25 parity fixture.

Navigation Menu

Repository navigation

node:net: implement BlockList and SocketAddress classes #2508

Summary

Evidence

Non-duplicates checked

Expected behavior

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

node:net: implement BlockList and SocketAddress classes #2508

Description

Summary

Evidence

Non-duplicates checked

Expected behavior

Activity

andrewtdiz commented on May 31, 2026

andrewtdiz commented on Jun 2, 2026

andrewtdiz commented on Jun 2, 2026

andrewtdiz commented on Jun 2, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions