luasocket/docs, branch feat/sse

Address PR review: pass raw socket to headers callback, use ok/err return convention

2026-09-01T05:54:16+00:00

Rename response_headers to headers_callback, pass the raw connection as a 4th argument (for use cases like WebSocket upgrade handoff), and switch its return contract to the idiomatic ok/err shape used elsewhere in this file: truthy ok continues (optionally swapping in a new sink), falsy ok closes the connection and propagates the callback's error via socket.protect instead of faking a success return. Claude-Session: https://claude.ai/code/session_01S4imKCU4hxDg96DXj9hxSB

Add Lua 5.5 support (#473)

2026-08-31T15:21:20+00:00

Merge pull request #472 from lunarmodules/feat/url-hosttype

2026-08-31T08:08:19+00:00

feat(url): classify host as name/ipv4/ipv6 in parse and build

Merge pull request #470 from lunarmodules/header-canon

2026-08-31T08:03:24+00:00

feat(headers): dynamically create cononicalized headers

Merge pull request #463 from lunarmodules/feat/receive-limit

2026-08-31T07:57:58+00:00

feat(receive): add maxsize argument to bound memory usage

chore(docs): add docs for SO_EXCLUSIVEADDRUSE and others

2026-08-31T07:52:00+00:00

Adds docs for the option, but also adds the docs for other options present in the code but missing from the docs.

feat(url): classify host as name/ipv4/ipv6 in parse and build

2026-08-30T13:34:15+00:00

parse() now sets hosttype ("name"/"ipv4"/"ipv6") plus a matching hostname/ipv4/ipv6 field alongside host. build() accepts those same fields when host is absent, erroring if more than one is set. classify_host is exported for standalone use; it classifies by shape (colon present -> ipv6, dotted-quad shape -> ipv4) rather than validating the address.

feat(headers): dynamically create cononicalized headers

2026-08-29T17:43:26+00:00

Instead of a static list dynamically add entries in proper casing. Also allowing to add non-standard ones through `setcanonic`. closes #442 fixes #440

chore(docs): some cleanup

2026-08-17T05:39:55+00:00

feat(receive): add maxsize argument to bound memory usage

2026-07-30T20:06:04+00:00

client:receive("*l") and receive("*a") are unbounded: a peer that never sends a newline, or never closes, makes LuaSocket buffer until the process runs out of memory (e.g. src/http.lua reading response headers in a loop). Add an optional maxsize argument that caps the payload a single call may accumulate, including prefix. - Hoist all argument validation ahead of timeout_markstart() so bad calls (maxsize < 1, #prefix >= maxsize, numeric pattern > maxsize) raise before any I/O and leave the socket untouched. - recvline/recvall take a budget and return a new internal BUF_OVERSIZED code, surfaced to Lua as the "oversized" error alongside "timeout"/"closed", with the partial held in the 3rd return value. - recvraw is left untouched: argument checks make the cap unreachable for numeric patterns. - Preserve three invariants: a timeout partial is always shorter than maxsize (safe to retry as prefix), completion beats the cap for *a, and no bytes are lost or skipped on overflow. - tcp.c, unixstream.c and serial.c all share this code path unchanged. Adds test coverage (argument errors, *l/*a boundaries, timeout/close at the cap, the drain idiom, numeric patterns, unix-stream mirror) and documents the new argument, error, and recovery idioms in docs/tcp.html.