feat(qwp): add browser and Node.js QWP client - #62

Open

glasstiger wants to merge 177 commits into

mainfrom

Commits on Aug 17, 2026

chore: add pull request review skill
glasstiger
committed
417ccbd
fix: omit nullish column values
glasstiger
committed
b3fdbaa
chore: update pull request review skill
glasstiger
committed
8d2629f
feat(qwp): add browser-safe protocol core
glasstiger
committed
757fe17
feat(qwp): add websocket ingress sessions
glasstiger
committed
f233db2
feat(qwp): add egress query sessions
glasstiger
committed
a44587d
test(qwp): add authenticated browser e2e
glasstiger
committed
253994b
feat(qwp): support durable acknowledgements
glasstiger
committed
eaa1705
feat(qwp): negotiate server batch limits
glasstiger
committed
22cd5fd
feat(qwp): classify websocket upgrade failures
glasstiger
committed
e2adc3b
feat(qwp): apply websocket send backpressure
glasstiger
committed
6352720
feat(qwp): add reconnect failover and replay
glasstiger
committed
75c4484
feat(qwp): add typed query binds
glasstiger
committed
c98135a
ci(qwp): dispatch Enterprise durable ack e2e
glasstiger
committed
020d5d5
feat(qwp): add high-level sender API
glasstiger
committed
dd775a7
feat(qwp): complete ingress symbol dictionary deltas
glasstiger
committed
e7e3953
feat(qwp): harden resource cleanup and timeouts
glasstiger
committed
c321750
feat(qwp): add zstd egress decompression
glasstiger
committed
331e6a4
feat(qwp): complete compression negotiation and tuning
glasstiger
committed
d14f754
feat(qwp): negotiate durable ACKs in browsers
glasstiger
committed
a337486
feat(qwp): automate egress credit and timeouts
glasstiger
committed
c27e72e

Commits on Aug 18, 2026

feat(qwp): split ingress batches to server cap
glasstiger
committed
05f6c98
feat(qwp): bootstrap browser authentication sessions
glasstiger
committed
49975c6
feat(qwp): add transactional sender mode
glasstiger
committed
d5b6454
feat(qwp): add ingress observability metrics
glasstiger
committed
62f9bf5
docs(qwp): document public API and migration
glasstiger
committed
a635a5c
fix(qwp): discard recovered deferred transaction tails
glasstiger
committed
0a9c0bc
fix(qwp): trim cumulative durable transaction ACKs
glasstiger
committed
0098ed3
feat(qwp): add offline store-and-forward publishing
glasstiger
committed
7f96403
fix(qwp): lock replay directories exclusively
glasstiger
committed
c8f9135
fix(qwp): bound egress cancellation draining
glasstiger
committed
eff6f14
fix(qwp): bound egress buffering by default
glasstiger
committed
69f5eaf
fix(qwp): detect poisoned ingress replays
glasstiger
committed
ffd7e7d
fix(qwp): preserve replay journal liveness
glasstiger
committed
777f8ca
feat(qwp): add topology-aware endpoint routing
glasstiger
committed
88b2139
feat(qwp): add pooled client facade
glasstiger
committed
b765899
feat(qwp): drain orphaned replay slots
glasstiger
committed
3a7a431
feat(qwp): expose ingress ack watermarks
glasstiger
committed
402e98e
feat(qwp): add store-forward durability policies
glasstiger
committed
3a48971
feat(qwp): add byte-based auto flush
glasstiger
committed
9652483
feat(qwp): drain ingress on sender close
glasstiger
committed
0d9c23b
feat(qwp): add reusable egress column views
glasstiger
committed
3b96563
fix(qwp): reconcile durable symbol dictionary on publish failure
glasstiger
committed
9cfc95d
fix(qwp): fall back when symbol persistence fails
glasstiger
committed
5a8c71b
fix(qwp): preserve borrowed resources during client close
glasstiger
committed
85e9e66
feat(qwp): negotiate browser caps and compression
glasstiger
committed
6e0f83b
feat(qwp): align store-forward retry policies
glasstiger
committed
4d63635
fix(qwp): retire drained symbol dictionaries
glasstiger
committed
806e7a0
feat(qwp): bound egress result batches
glasstiger
committed
209c7e8
feat(qwp): add reusable egress row views
glasstiger
committed
c298ec7
fix(qwp): omit unsupported query flags
glasstiger
committed
58bf575
fix(qwp): re-encode queries after failover
glasstiger
committed
a7e5611
feat(qwp): expose failover server info
glasstiger
committed
1e27bc4
feat(qwp): reap aged pooled connections
glasstiger
committed
3fbe982
fix(qwp): close borrowed query sessions
glasstiger
committed
4a57aa3
feat(qwp): split Node connection timeouts
glasstiger
committed
61fcd14
feat(qwp): jitter reconnect backoff
glasstiger
committed
9c72dd3
feat(qwp): unify Node client configuration
glasstiger
committed
30f0c2f
docs(qwp): correct browser compression negotiation
glasstiger
committed
564cc68
fix(qwp): rotate endpoints after not-writable nack
glasstiger
committed
6bb56e9
fix(qwp): recover persistent replay slots
glasstiger
committed
387f646
fix(qwp): align egress failover with Java client
glasstiger
committed
5e0b243
feat(qwp): enable ingress reconnect by default
glasstiger
committed
818379f
fix(qwp): align unified config with Java client
glasstiger
committed
49f7a9e
feat(qwp): isolate observability callbacks
glasstiger
committed
d5d9d9a
feat(qwp): add segmented replay and UDP ingress
glasstiger
committed
e975044
fix(qwp): retain rows until local publication
glasstiger
committed
c302d81
fix(qwp): retry durable ack capability gaps
glasstiger
committed
ba9cee6
fix(qwp): rebuild recoverable symbol sidecars
glasstiger
committed
2d834ff
fix(qwp): report asynchronous sender failures
glasstiger
committed
3b54005
feat(qwp): expose current egress server info
glasstiger
committed
40b6013

Commits on Aug 19, 2026

feat(qwp): unify browser cluster configuration
glasstiger
committed
745054f
feat(qwp): add fixed-segment replay store
glasstiger
committed
f3b7739
feat(qwp): adopt cross-client SFA persistence format
glasstiger
committed
514da34
fix(qwp): coordinate SFA ownership across clients
glasstiger
committed
3a9b092
fix(qwp): align identifier handling with Java
glasstiger
committed
ef07a22
fix(qwp): bound in-memory replay
glasstiger
committed
948f1c1
fix(qwp): align flush publication semantics
glasstiger
committed
1d881d8
fix(qwp): recover idle pooled SFA slots
glasstiger
committed
8b737d8
fix(qwp): share failover health across drainers
glasstiger
committed
42722cc
feat(qwp): unify Sender WebSocket configuration
glasstiger
committed
43debcf
perf(qwp): decode result views ahead
glasstiger
committed
1267de2
fix(qwp): align egress flow control defaults
glasstiger
committed
a39865d
perf(qwp): streamline store-and-forward persistence
glasstiger
committed
61cb47f
test(qwp): add performance benchmark suite
glasstiger
committed
5579c5e

Commits on Aug 20, 2026

feat(qwp): add compiled object-row table writers

glasstiger
and
claude
committed
9d751bd
feat(qwp): complete compiled writer column types

glasstiger
and
claude
committed
b8a57b3
fix(qwp): release the table selection on failed rows

glasstiger
and
claude
committed
b90d56e
Merge remote-tracking branch 'origin/main' into ia_node_qwp
glasstiger
committed
6170522
chore(qwp): extend the review skill to QWP

glasstiger
and
claude
committed
55afb31
feat(qwp): make the native locking module optional and lazily loaded

glasstiger
and
claude
committed
b963ab9
fix(qwp): share the writer column brand across bundles

glasstiger
and
claude
committed
9b31c06
fix(qwp): discard the row when a symbol value cannot be converted

glasstiger
and
claude
committed
2b871aa
fix(qwp): allocate frame sequences only for journalled frames

glasstiger
and
claude
committed
bf93367
fix(qwp): retry background segment maintenance instead of latching

glasstiger
and
claude
committed
a42fec5
fix(qwp): retry orphan slots that fail to drain transiently

glasstiger
and
claude
committed
e42368a
fix(qwp): release rows that cannot fit the negotiated batch cap

glasstiger
and
claude
committed
436d841
fix(qwp): encode DATE columns as timestamps on ingress

glasstiger
and
claude
committed
b3f13a4
fix(qwp): trim the ingress wire log as cumulative ACKs arrive

glasstiger
and
claude
committed
91c9603
Revert "fix(qwp): encode DATE columns as timestamps on ingress"

glasstiger
and
claude
committed
47ade10
fix(qwp): roll back the schema a discarded row introduced

glasstiger
and
claude
committed
4540b84
fix(qwp): parse ws/wss connect strings with one schema

glasstiger
and
claude
committed
70776f4
fix(qwp): match the Java close-flush timeout and always bound close()

glasstiger
and
claude
committed
7629fbd
fix(qwp): retry an over-cap frame instead of failing the sender

glasstiger
and
claude
committed
a644688
fix(qwp): discard an over-cap batch on close, not on flush

glasstiger
and
claude
committed
4717b60
docs: describe null and undefined column values

glasstiger
and
claude
committed
f05f9ae
docs(qwp): add a configuration-string key reference

glasstiger
and
claude
committed
2e8e514
ci: enforce the browser, benchmark, and export-map gates

glasstiger
and
claude
committed
de9fac4
test(qwp): close the mutation-proven coverage gaps

glasstiger
and
claude
committed
7997f0b

Commits on Aug 21, 2026

fix(qwp): store a UUID passed as bytes in canonical order

glasstiger
and
claude
committed
ca78e94
fix(qwp): walk failover endpoints on an opaque upgrade error

glasstiger
and
claude
committed
bd65a05
fix(qwp): keep UDP rows staged when a datagram cannot be encoded

glasstiger
and
claude
committed
e13f250
fix(qwp): lock a decimal column's scale and keep its width stable

glasstiger
and
claude
committed
21d6145
fix(qwp): bound egress recovery from an undecodable response

glasstiger
and
claude
committed
00dae53
fix(qwp): report journal bytes abandoned by torn-tail recovery

glasstiger
and
claude
committed
0a236d8
fix(qwp): retry a transient journal read instead of latching the sender

glasstiger
and
claude
committed
c7be5bb
fix(qwp): drop a frame's wire slot when a reconnect lands during its read

glasstiger
and
claude
committed
a5f261a
fix(qwp): reject instead of throwing when flushing a closed sender

glasstiger
and
claude
committed
3b5a746
fix(qwp): cancel a connect still negotiating when close() is called

glasstiger
and
claude
committed
bd4a224
fix(qwp): close the UDP socket when bind fails

glasstiger
and
claude
committed
df1d952
docs(qwp): state the auto-flush defaults and correct auto_flush_bytes

glasstiger
and
claude
committed
0092879
refactor(qwp): drop the unreachable resolved-sender constructor branch

glasstiger
and
claude
committed
da1132b
fix(qwp): keep compiled-writer row typing across published bundles

glasstiger
and
claude
committed
2ac6907
ci: typecheck a consumer against the built declaration files

glasstiger
and
claude
committed
822da58
test(qwp): pin which published classes can be named in a type position

glasstiger
and
claude
committed
4756867
build(qwp): emit src/qwp/** as shared chunks instead of per-entry copies

glasstiger
and
claude
committed
aabde6e
test(qwp): cover failover in a real browser

glasstiger
and
claude
committed
2399426
ci: allow the build workflow to be dispatched manually

glasstiger
and
claude
committed
a543a4f
refactor(qwp): replace the native slot lock with a pure-JS directory lock

glasstiger
and
claude
committed
5225cdd
fix(tcp): derive the JWK public point from the configured private key

glasstiger
and
claude
committed
68be1cc
test(qwp): drop browser tests that need a live QuestDB

glasstiger
and
claude
committed
3360f67
ci: type-check test/** and fix what that surfaces

glasstiger
and
claude
committed
0a11537
fix(ci): keep test/dist-types out of the test type-check

glasstiger
and
claude
committed
a11f2dd
fix(ci): make the build-artifact gate runnable

glasstiger
and
claude
committed
3b494f5
fix(qwp): attach socket listeners before an aborted signal closes them

glasstiger
and
claude
committed
93cbad4
fix(qwp): prove advisory-lock ownership with an acquisition token

glasstiger
and
claude
committed
5f305bf
fix(qwp): stop writing to a journal whose slot lock was reclaimed

glasstiger
and
claude
committed
8870a28
fix: validate a column call even when its value is nullish

glasstiger
and
claude
committed
7aaf8df
fix(qwp): accept nullish words in long256Column

glasstiger
and
claude
committed
be17047
fix(qwp): reject symbol IDs and encode options that cannot be honoured

glasstiger
and
claude
committed
1981bf2
fix(qwp): bound decoded identifiers in bytes, not code units

glasstiger
and
claude
committed
597991c
fix: make the QWP entry points reachable for docs and node10 consumers

glasstiger
and
claude
committed
c754bfb
fix(qwp): stop close() from leaving connects and writes behind

glasstiger
and
claude
committed
0606437

Commits on Aug 22, 2026

test(qwp): cover store-and-forward exclusion across real processes

glasstiger
and
claude
committed
390c1bc

Commits on Aug 23, 2026

fix(qwp): reject geohash and decimal values that cannot be encoded

glasstiger
and
claude
committed
ce3ae47
fix(qwp): retry a transient journal fault raised while applying an ACK

glasstiger
and
claude
committed
d7c90dc
fix(qwp): quarantine an orphan slot whose head the server rejects

glasstiger
and
claude
committed
6e8951b
fix(qwp): bound the grid a RESULT_BATCH declares, not only each dimension

glasstiger
and
claude
committed
a9a1948
fix(qwp): close segment handles when the hot spare cannot be discarded

glasstiger
and
claude
committed
89f0ee6
docs: generate the QWP entry points typedoc.json already declares

glasstiger
and
claude
committed
18b2877
fix: discard a row that cannot be closed instead of wedging the sender

glasstiger
and
claude
committed
81bb837
fix(qwp): keep auto-flush accurate when reset() lands during a flush

glasstiger
and
claude
committed
0a1fccf
fix(qwp): let an explicit connect_timeout bound the WebSocket upgrade

glasstiger
and
claude
committed
5f2f692
perf(qwp): decompress a RESULT_BATCH in place, not through a shifting window

glasstiger
and
claude
committed
4ea0f38

Commits on Aug 24, 2026

fix(qwp): retry a transient upgrade rejection instead of failing terminal

glasstiger
and
claude
committed
6417967
fix(qwp): stop a transient owner-record read from latching the slot lock

glasstiger
and
claude
committed
12f32f1
fix(qwp): make the ACK watermark durable before the manifest that trims it

glasstiger
and
claude
committed
6c3de06
fix(qwp): keep a reclaimed journal from deleting the new owner's files

glasstiger
and
claude
committed
6d02085
fix(qwp): retry a recoverable slot before quarantining it

glasstiger
and
claude
committed
ff32123
perf(qwp): split UDP datagrams without re-encoding the batch each time

glasstiger
and
claude
committed
45a380a
fix(qwp): keep a QWP logger supplied without a top-level one

glasstiger
and
claude
committed
68b06b4
fix(qwp): make the zstd over-run marker impossible to spell by accident

glasstiger
and
claude
committed
de38f5a
fix(qwp): validate a column call even when its value is nullish

glasstiger
and
claude
committed
266438f
fix(qwp): apply target and zone to ingress, not only egress

glasstiger
and
claude
committed
0843b0e
fix(qwp): let close() abort a connect that holds a store-and-forward lock

glasstiger
and
claude
committed
26a190d
test(qwp): stop the auto-flush row trigger racing the interval trigger

glasstiger
and
claude
committed
a645bf3
docs: name the client after JavaScript, not Node.js

glasstiger
and
claude
committed
8f5a475
ci: point the Enterprise dispatch at the renamed e2e pipeline

glasstiger
and
claude
committed
d9e0893
fix(qwp): keep an async observability callback from crashing the host

glasstiger
and
claude
committed
88311dd
test(qwp): assert wss:// verifies certificates and preserves credentials

glasstiger
and
claude
committed
e3f7475
fix(qwp): validate nullish dateColumn and fixed-width decimal calls

glasstiger
and
claude
committed
c4fc77d

Commits on Aug 25, 2026

perf(qwp): drop the per-cell column-key rebuild on the ingest path

glasstiger
and
claude
committed
5745581
fix(qwp): send an all-nullish compiled-writer row instead of rejecting it

glasstiger
and
claude
committed
8d2cf79
fix(qwp): point the udp-only relocation hint at udp, not http/tcp/udp

glasstiger
and
claude
committed
fcebb9c
fix(qwp): count rows a reset-interrupted flush already published

glasstiger
and
claude
committed
e0b3611
fix(qwp): keep a parked append waiting through a self-healing trim fault

glasstiger
and
claude
committed
687913b
test(qwp): count only payload bytes in the sfa-multiprocess marker check

glasstiger
and
claude
committed
c61f26e