Expand description
MessagePack codec for the Triplox HTTP/2 wire protocol.
Each HTTP body is a single msgpack value. DataType primitives map to native msgpack types (bool, int, float, str, bin, array, map). Triplox-specific types use ext type codes:
| Ext code | Type | Payload |
|---|---|---|
| -1 | Instant | msgpack Timestamp (4/8/12 bytes, nanosecond) |
| 1 | BigInt | 16 bytes, big-endian i128 |
| 2 | Uuid | 16 bytes, RFC 4122 raw |
| 3 | Keyword | UTF-8 “ns/name” (no leading :) |
Tagged unions (EntityRef, TxOp, QueryArg) use {"kind": "<variant>", ...} maps.
Structs§
- Error
Response Body - Execute
Request - Open
DbRequest - Query
Request - Query
Response - Subscribe
Request - TxResult
Response
Enums§
- Subscription
Frame - One frame in a subscription response stream. Frames are bare, self-delimiting
msgpack maps tagged by a
kinddiscriminator.
Constants§
Functions§
- data_
type_ from_ value - decode_
error_ body - decode_
execute_ request - decode_
open_ db_ request - decode_
query_ request - decode_
query_ response - decode_
subscribe_ request - decode_
subscription_ frame - Decode one subscription frame from a complete msgpack value buffer.
- decode_
tx_ key - decode_
tx_ result_ response - encode_
error_ body - Encode an ErrorResponse body.
- encode_
execute_ request - Encode an Execute request:
{"ops": [TxOp, ...]}. - encode_
open_ db_ request - Encode an OpenDb request:
{"tx_id": int|nil, "system_time": Timestamp|nil}. - encode_
query_ request - Encode a Query request:
{"tx_key": TxKey, "query": str, "args": [QueryArg, ...]}. - encode_
query_ response - Encode a query response:
{"columns": [...], "rows": [[...], ...]}. - encode_
subscribe_ request - Encode a Subscribe request:
{"tx_key": TxKey|nil, "query": str, "args": [QueryArg, ...]}. - encode_
subscription_ frame - Encode one subscription frame as a bare msgpack map.
- encode_
tx_ key - Encode a bare
TxKeybody:{"tx_id": int, "system_time": Timestamp}. Used for both the DbOpened and submit/execute responses. - encode_
tx_ result_ response - Encode a TxResult response.
- entity_
ref_ from_ value - query_
arg_ from_ value - read_
data_ type - subscription_
frame_ from_ value - Build a subscription frame from an already-parsed msgpack value (used by the streaming decoder).
- tx_
op_ from_ value - write_
data_ type - write_
entity_ ref - write_
query_ arg - write_
tx_ op