alknet/tasks/napi/serve-function.md at 596c89ce24ac5974512a57ccd0380bde81818af8

Files

glm-5.1 596c89ce24 refactor!: rebrand wraith to alknet

Rename all crates, CLI commands, constants, type names, doc comments,
and documentation from wraith to alknet. Includes wire-protocol changes:
ALPN wraith-ssh -> alknet-ssh, reserved destination prefix wraith- ->
alknet-, SSH auth username wraith -> alknet.

2026-06-05 10:04:32 +00:00

2.3 KiB

Raw Blame History

id, name, status, depends_on, scope, risk, impact, level

name

status

depends_on

scope

risk

impact

level

napi/serve-function

Implement NAPI serve() — server with connection events returning Duplex streams

completed

napi/project-setup

server/serve-loop

moderate

high

component

implementation

Description

Implement the NAPI serve() function per ADR-016. Returns a AlknetServer object with a close() method and onConnection event emitter. Each incoming SSH connection produces a Duplex stream.

The function accepts AlknetServeOptions and returns Promise<AlknetServer>. The NAPI layer handles transport binding, SSH server setup, and connection handling.

Acceptance Criteria

#[napi] function serve(options: AlknetServeOptions) -> Result<AlknetServer> in crates/alknet-napi/src/serve.rs
AlknetServeOptions struct with napi fields: transport, hostKey, authorizedKeys, certAuthority, tlsCert, tlsKey, acmeDomain, listen, irohRelay
AlknetServer napi class with close() -> Promise<void> and onConnection(callback) event registration
Each incoming connection produces a Duplex stream via the onConnection callback
ConnectionInfo struct passed with each connection: remoteAddr, transportKind
Key material: hostKey, authorizedKeys accept file path (string) or Buffer (in-memory)
Server starts transport acceptor, authenticates connections, emits stream events
close() triggers graceful shutdown
TypeScript type matches napi-and-pubsub.md spec
Integration test: JS serve() + connect() round-trip works

References

docs/architecture/napi-and-pubsub.md — NAPI serve() spec, AlknetServer interface
docs/architecture/decisions/016-napi-expose-connect-and-serve.md — both connect() and serve()
docs/architecture/server.md — server configuration

Notes

TCP transport fully implemented. TLS/iroh transports return helpful "not yet supported" errors. AlknetServerStream provides read/write/close. ConnectionInfo includes remoteAddr and transportKind.

Summary

Implemented NAPI serve() in crates/alknet-napi/src/serve.rs: AlknetServeOptions, AlknetServer with close()/onConnection(), AlknetServerStream (Duplex read/write/close), ConnectionInfo. TCP transport works end-to-end. 241 tests pass, clippy clean.

2.3 KiB Raw Blame History