@clickhouse/client 1.22.0 → 1.23.0-head.c8dc8d8.1

package/dist/result_set.js.map

@@ -1 +1 @@
-{"version":3,"file":"result_set.js","sourceRoot":"","sources":["../src/result_set.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"result_set.js","sourceRoot":"","sources":["../src/result_set.ts"],"names":[],"mappings":"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"}

package/dist/utils/encoder.d.ts

@@ -1,4 +1,4 @@
-import type { DataFormat, InsertValues, JSONHandling, ValuesEncoder } from "@clickhouse/client-common";
+import type { DataFormat, InsertValues, JSONHandling, ValuesEncoder } from "../common/index";
 import Stream from "stream";
 export declare class NodeValuesEncoder implements ValuesEncoder<Stream.Readable> {
     private readonly json;

package/dist/utils/encoder.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeValuesEncoder = void 0;
-const client_common_1 = require("@clickhouse/client-common");
+const index_1 = require("../common/index");
 const stream_1 = __importDefault(require("stream"));
 const stream_2 = require("./stream");
 class NodeValuesEncoder {
@@ -19,17 +19,17 @@ class NodeValuesEncoder {
                 return values;
             }
             // JSON* formats streams
-            return stream_1.default.pipeline(values, (0, stream_2.mapStream)((value) => (0, client_common_1.encodeJSON)(value, format, this.json.stringify)), pipelineCb);
+            return stream_1.default.pipeline(values, (0, stream_2.mapStream)((value) => (0, index_1.encodeJSON)(value, format, this.json.stringify)), pipelineCb);
         }
         // JSON* arrays
         if (Array.isArray(values)) {
             return values
-                .map((value) => (0, client_common_1.encodeJSON)(value, format, this.json.stringify))
+                .map((value) => (0, index_1.encodeJSON)(value, format, this.json.stringify))
                 .join("");
         }
         // JSON & JSONObjectEachRow format input
         if (typeof values === "object") {
-            return (0, client_common_1.encodeJSON)(values, format, this.json.stringify);
+            return (0, index_1.encodeJSON)(values, format, this.json.stringify);
         }
         throw new Error(`Cannot encode values of type ${typeof values} with ${format} format`);
     }
@@ -41,7 +41,7 @@ class NodeValuesEncoder {
                 `got: ${typeof values}`);
         }
         if ((0, stream_2.isStream)(values)) {
-            if ((0, client_common_1.isSupportedRawFormat)(format)) {
+            if ((0, index_1.isSupportedRawFormat)(format)) {
                 if (values.readableObjectMode) {
                     throw new Error(`Insert for ${format} expected Readable Stream with disabled object mode.`);
                 }

package/dist/utils/encoder.js.map

@@ -1 +1 @@
-{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/utils/encoder.ts"],"names":[],"mappings":";;;;;;AAMA,6DAA6E;AAC7E,oDAA4B;AAC5B,qCAA+C;AAE/C,MAAa,iBAAiB;IACX,IAAI,CAAe;IAEpC,YAAY,gBAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IAED,YAAY,CACV,MAAwC,EACxC,MAAkB;QAElB,IAAI,IAAA,iBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;YACrB,yEAAyE;YACzE,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,wBAAwB;YACxB,OAAO,gBAAM,CAAC,QAAQ,CACpB,MAAM,EACN,IAAA,kBAAS,EAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,0BAAU,EAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EACpE,UAAU,CACX,CAAC;QACJ,CAAC;QACD,eAAe;QACf,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM;iBACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,0BAAU,EAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;iBAC9D,IAAI,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;QACD,wCAAwC;QACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAA,0BAAU,EAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gCAAgC,OAAO,MAAM,SAAS,MAAM,SAAS,CACtE,CAAC;IACJ,CAAC;IAED,oBAAoB,CAClB,MAAwC,EACxC,MAAkB;QAElB,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACtB,CAAC,IAAA,iBAAQ,EAAC,MAAM,CAAC;YACjB,OAAO,MAAM,KAAK,QAAQ,EAC1B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,gFAAgF;gBAC9E,QAAQ,OAAO,MAAM,EAAE,CAC1B,CAAC;QACJ,CAAC;QAED,IAAI,IAAA,iBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;YACrB,IAAI,IAAA,oCAAoB,EAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CACb,cAAc,MAAM,sDAAsD,CAC3E,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,cAAc,MAAM,qDAAqD,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnED,8CAmEC;AAED,SAAS,UAAU,CAAC,GAAiC;IACnD,IAAI,GAAG,EAAE,CAAC;QACR,4BAA4B;QAC5B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/utils/encoder.ts"],"names":[],"mappings":";;;;;;AAMA,2CAAmE;AACnE,oDAA4B;AAC5B,qCAA+C;AAE/C,MAAa,iBAAiB;IACX,IAAI,CAAe;IAEpC,YAAY,gBAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IAED,YAAY,CACV,MAAwC,EACxC,MAAkB;QAElB,IAAI,IAAA,iBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;YACrB,yEAAyE;YACzE,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,wBAAwB;YACxB,OAAO,gBAAM,CAAC,QAAQ,CACpB,MAAM,EACN,IAAA,kBAAS,EAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,kBAAU,EAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EACpE,UAAU,CACX,CAAC;QACJ,CAAC;QACD,eAAe;QACf,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM;iBACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,kBAAU,EAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;iBAC9D,IAAI,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;QACD,wCAAwC;QACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAA,kBAAU,EAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gCAAgC,OAAO,MAAM,SAAS,MAAM,SAAS,CACtE,CAAC;IACJ,CAAC;IAED,oBAAoB,CAClB,MAAwC,EACxC,MAAkB;QAElB,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACtB,CAAC,IAAA,iBAAQ,EAAC,MAAM,CAAC;YACjB,OAAO,MAAM,KAAK,QAAQ,EAC1B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,gFAAgF;gBAC9E,QAAQ,OAAO,MAAM,EAAE,CAC1B,CAAC;QACJ,CAAC;QAED,IAAI,IAAA,iBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;YACrB,IAAI,IAAA,4BAAoB,EAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CACb,cAAc,MAAM,sDAAsD,CAC3E,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,cAAc,MAAM,qDAAqD,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnED,8CAmEC;AAED,SAAS,UAAU,CAAC,GAAiC;IACnD,IAAI,GAAG,EAAE,CAAC;QACR,4BAA4B;QAC5B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "1.22.0";
+declare const _default: "1.23.0-head.c8dc8d8.1";
 export default _default;

package/dist/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = "1.22.0";
+exports.default = "1.23.0-head.c8dc8d8.1";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;AAAA,kBAAe,QAAQ,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;AAAA,kBAAe,uBAAuB,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@clickhouse/client",
   "description": "Official JS client for ClickHouse DB - Node.js implementation",
   "homepage": "https://clickhouse.com",
-  "version": "1.22.0",
+  "version": "1.23.0-head.c8dc8d8.1",
   "license": "Apache-2.0",
   "keywords": [
     "clickhouse",
@@ -32,20 +32,22 @@
       {
         "name": "clickhouse-js-node-troubleshooting",
         "path": "./skills/clickhouse-js-node-troubleshooting"
+      },
+      {
+        "name": "clickhouse-js-node-rowbinary-parser",
+        "path": "./skills/clickhouse-js-node-rowbinary-parser"
       }
     ]
   },
   "scripts": {
     "pack": "npm pack",
-    "prepack": "rm -rf skills && cp ../../README.md ../../LICENSE . && cp -r ../../skills .",
+    "prepack": "rm -rf skills && cp ../../README.md ../../LICENSE . && cp -r ../../skills . && RBP=skills/clickhouse-js-node-rowbinary-parser && rm -rf $RBP/tests $RBP/node_modules $RBP/dist $RBP/package.json $RBP/package-lock.json $RBP/tsconfig.json $RBP/tsconfig.build.json $RBP/vitest.config.ts $RBP/.gitignore $RBP/LICENSE $RBP/eval_result*.md",
     "typecheck": "tsc --noEmit",
     "lint": "eslint --max-warnings=0 .",
     "lint:fix": "eslint . --fix",
     "build": "rm -rf dist; tsc"
   },
-  "dependencies": {
-    "@clickhouse/client-common": "1.22.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "simdjson": "^0.9.2"
   }

package/skills/clickhouse-js-node-rowbinary-parser/EXAMPLES.md

@@ -0,0 +1,48 @@
+# RowBinary reader examples
+
+Six end-to-end examples. Each `src/examples/*.ts` exports TWO readers for the
+same row — `readXRow` (built from the generic combinator API; easiest to read)
+and `readXRowFast` (the optimized, monomorphized form: leaf reads inlined,
+combinators flattened to straight-line loops, `advance()` coalesced over
+fixed-width runs — still streaming-safe). The matching `tests/X.example.test.ts`
+runs the full create → populate → read-back round trip against a live ClickHouse
+server (verified, not illustrative), and `tests/X.bench.ts` decodes a large
+`numbers()`-generated buffer with both readers (equivalence-checked before
+timing) to measure the speedup.
+
+To use one: find the example whose column types match your result, open its
+reader, and adapt it. `readRows(readXRow)` drives a row reader over a whole
+result; `streamRowBatches(chunks, readXRow)` drives it over a chunked HTTP stream.
+
+| Example           | SQL schema (the trigger)                                                                                                                                                                                                      | Speedup             | Reader · Test                                                                                                                                   |
+| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| **orders**        | `id UInt8, uid UUID, price Decimal64(2), status Enum8(...)`                                                                                                                                                                   | **~3.4x**           | [`src/examples/orders.ts`](src/examples/orders.ts) · [`tests/orders.example.test.ts`](tests/orders.example.test.ts)                             |
+| **carts**         | `cart_id UInt32, items Array(Tuple(sku String, qty UInt16)), discounts Array(Nullable(Int32))`                                                                                                                                | **~2.0x**           | [`src/examples/carts.ts`](src/examples/carts.ts) · [`tests/carts.example.test.ts`](tests/carts.example.test.ts)                                 |
+| **telemetry**     | `host String, tags Map(String,String), cpu Array(Float64), region Nullable(String), window Tuple(start UInt32, count UInt16)`                                                                                                 | **~1.4x**           | [`src/examples/telemetry.ts`](src/examples/telemetry.ts) · [`tests/telemetry.example.test.ts`](tests/telemetry.example.test.ts)                 |
+| **observability** | `id UInt64, ts DateTime64(3), level Enum8, trace_id UUID, payload Variant(String,Int64,Float64), tags Map(LowCardinality(String),String), metrics Array(Tuple(LowCardinality(String),Float64)), attrs Array(Nullable(Int64))` | **~1.4x**           | [`src/examples/observability.ts`](src/examples/observability.ts) · [`tests/observability.example.test.ts`](tests/observability.example.test.ts) |
+| **profiles**      | `id UInt32, tags Array(String), score Nullable(Int32)`                                                                                                                                                                        | **~1.3x**           | [`src/examples/profiles.ts`](src/examples/profiles.ts) · [`tests/profiles.example.test.ts`](tests/profiles.example.test.ts)                     |
+| **events**        | `id UInt64, name String, ts DateTime('UTC')`                                                                                                                                                                                  | **~1.05x — on par** | [`src/examples/events.ts`](src/examples/events.ts) · [`tests/events.example.test.ts`](tests/events.example.test.ts)                             |
+
+Speedups: Node 24 / V8, decoding a 20k-row buffer — read the ratio, not the
+absolute hz, and run `npm run bench` for your own numbers. Two independent levers
+drive them: **composite monomorphization** (removes per-row combinator closures —
+`carts` / `telemetry` / `observability`) and **per-row formatting** (`orders` is
+all-scalar yet the biggest win, almost entirely from the `formatUUIDTable` swap).
+A flat scalar row with no hot formatter (`events`) is within noise, so prefer the
+clearer API reader there. When in doubt, benchmark — the `*.bench.ts` files are
+the template.
+
+The readers live under `src/examples/` and are excluded from the published build
+(`tsconfig.build.json`): reference material and test fixtures, type-checked by the
+base `tsconfig.json` and run by the suite, not part of the package's public API.
+
+## Columnar decode (struct-of-arrays) — the ~4x numeric path
+
+The examples above produce one object per row (array-of-structs). For a
+**numeric, fixed-width result the consumer reads column-wise** (aggregate / scan
+/ filter / plot, or hand off to a Worker / WASM kernel), decode the same
+row-major bytes directly into **one typed array per column** in the same single
+pass — no per-row object, no `Date`, no number boxing. That removes the
+allocation that dominates a numeric decode for a **measured ~4.2x**.
+
+See example: [`decodeIotColumnar`](src/examples/iot.ts).

package/skills/clickhouse-js-node-rowbinary-parser/README.md

@@ -0,0 +1,248 @@
+# ClickHouse Node.js RowBinary Parser Generator
+
+**If JS had a -O3 compiler flag, this skill would be it.** (for RowBinary parsing)
+
+A skill and a library that lets a coding agent generate bespoke RowBinary parsers on the first pass from the column type definitions of a ClickHouse response. The [spirit](#the-spirit) behind the approach.
+
+**Reader only** for now. Today this covers reading (decoding) RowBinary streams. A matching RowBinary writer (encoding) is planned.
+
+## Status
+
+- ✅ Sonnet 4.6: 60% -> 94.0% pass rate
+- ✅ Opus 4.8: 71% -> 94.7% pass rate
+- ✅ Haiku 4.5: 52% -> 86.0% pass rate
+- ✅ Composer 2.5 Fast: 3x parser performance
+- ✅ 469/469 tests
+- ✅ type-checked
+- ✅ benchmarked
+
+## Example
+
+Take a small orders result:
+
+```sql
+SELECT id, uid, price, status FROM orders
+--  id     UInt8
+--  uid    UUID
+--  price  Decimal64(2)
+--  status Enum8('new' = 1, 'shipped' = 2, 'done' = 3)
+```
+
+**The API-only reader** — what you write by composing the library's combinators. Correct, clear, and a fine default:
+
+```ts
+const readOrderRow: Reader<OrderRow> = (s) => ({
+  id: readUInt8(s),
+  uid: formatUUID(readUUID(s)),
+  price: readDecimal64(2)(s),
+  status: readEnum8(s),
+});
+```
+
+**The optimized reader the skill generates** — same row, monomorphized to
+straight-line code. The whole row is fixed-width (1 + 16 + 8 + 1 = 26 bytes), so
+the four separate bounds checks coalesce into one `advance(s, 26)` and every leaf
+read happens at a constant offset; the per-field combinators are gone:
+
+```ts
+const readOrderRowFast: Reader<OrderRow> = (s) => {
+  const { buf, view } = s;
+  const o = advance(s, 26); // one bounds check for the whole 26-byte row
+  const id = buf[o]!;
+  const uid = formatUUIDTable(buf.subarray(o + 1, o + 17));
+  const price: DecimalValue = [view.getBigInt64(o + 17, true), 2];
+  const status = view.getInt8(o + 25);
+  return { id, uid, price, status };
+};
+```
+
+Same values, same streaming-safety — **~3.4x** faster.
+
+## How to use
+
+As a library (comes with the skill):
+
+```bash
+npm install @clickhouse/rowbinary
+npx skills-npm setup
+```
+
+As a skill only:
+
+```bash
+npx skills add ClickHouse/clickhouse-js/skills/clickhouse-js-node-rowbinary-parser
+```
+
+```console
+> Hey, Claude, tell me what the rowbinary parser skill can do for me.
+> A lot! It generates custom, high-performance RowBinary parsers…
+> Super, generate a parser for the queries in app/src/model.ts.
+< Reading skill clickhouse-js-node-rowbinary-parser…
+```
+
+## Why it's worth it
+
+Four pillars — speed, correctness, judgment, and lifting smaller models:
+
+- **~2–3x faster code than the straightforward decoder.** The skill emits
+  monomorphized, flattened, straight-line code — inlined reads, bounds checks
+  coalesced across adjacent fixed-width columns, the right array layout — measured
+  at ~1.3–3.4x over the _same logic written with the plain combinator API_
+  (`npm run bench`). This is why
+  - inlined JIT friendly code
+  - benchmarked hot paths
+  - minimal allocations
+  - v8 and Node.js specific optimizations
+- **Correct on the gotchas that otherwise quietly break.** UUID byte
+  order, `Variant`'s sort-by-type-name discriminant, `DateTime64` sub-second
+  precision, signed-high-word wide integers, faithful decimals, `Dynamic`/`JSON`
+  self-description, transparent wrappers, opaque `AggregateFunction` — each
+  encoded with a live, server-verified test ([details below](#correctness-on-the-gotcha-heavy-types)).
+- **Judgment, not just code.** The skill carries the working knowledge to make
+  the right call _before_ writing a line, so the agent neither over- nor
+  under-engineers:
+  - **Is RowBinary even right?** For string-heavy results read as text, a `JSON*`
+    format + V8's native `JSON.parse` (plus `gzip`/`zstd`) can beat a JS RowBinary
+    decoder — reach for RowBinary when the data is numeric / wide-integer /
+    binary-blob heavy.
+  - **Whole buffer or stream?** Drop the `advance()` bounds checks for a complete
+    in-memory buffer (faster); keep them for a chunked HTTP response that must
+    survive rows straddling chunk boundaries.
+  - **Drop the portability scaffolding.** RowBinary is little-endian and the
+    target is x86/ARM, so the skill steers away from big-endian / byte-swap
+    "portability" code a cautious one-shot pass tends to add.
+- **Improves smaller models' performance.** Because the skill hands over the
+  hard-won answers up front, it lifts a weaker model the most. In a 24-eval
+  with-skill vs no-skill benchmark, the skill [raised](eval_result_sonnet.md) **Sonnet 4.6** from 60.4% to
+  **94.0%** (+34pp) — bringing it level with skill-equipped **Opus 4.8** (94.7%),
+  which itself [gained](eval_result.md) +23pp (71.5% → 94.7%). Composer 2.5 Fast
+  [got](eval_result_composer.md) a 3x parser performance boost, Haiku 4.5
+  [raised](eval_result_haiku.md) from 52% to 86% — the skill closes
+  most of the model-capability gap on this task.
+
+## What it does
+
+Given the columns of a query result — their names and ClickHouse type
+definitions (as returned by `RowBinaryWithNamesAndTypes`, or supplied by the
+user) — the skill generates parser code tailored to exactly those types. Rather
+than shipping a generic, runtime-driven decoder, it emits straight-line code
+that reads each column in order, so the parser only contains the logic the
+specific result shape needs.
+
+## Correctness on the gotcha-heavy types
+
+For a plain `UInt64, String, DateTime` result a strong model already writes fast,
+correct code on its own. The skill earns its keep on the **long tail of RowBinary
+traps** — the encodings where a from-scratch decoder is quietly wrong — each one
+captured here with a live, server-verified test:
+
+- **UUID** — two little-endian `UInt64` halves, each byte-reversed vs. the text
+  form (not 16 bytes in order).
+- **`Variant(...)`** — the 1-byte discriminant indexes the alternatives sorted by
+  **type name** (ClickHouse globally sorts them), NOT declaration order; `0xFF`
+  is NULL.
+- **`DateTime64(P)`** — returned as `[Date, nanoseconds]` so the sub-second part
+  isn't lost to a `Date`'s millisecond resolution; `Time`/`Time64` are durations,
+  not instants.
+- **Wide integers** — `Int128`/`Int256` compose from 64-bit words with the **high
+  word read signed**; 64-bit values stay `bigint`, never a lossy `number`.
+- **Decimals** — kept as the exact `[unscaled, scale]` pair, not a lossy float.
+- **`Dynamic` / `JSON`** — self-describing: a per-value binary type encoding, then
+  the value; declared typed `JSON` paths are written without a tag (need the
+  schema). Wrappers are erased (`Nullable`/`Variant` → concrete type).
+- **Transparent wrappers** — `LowCardinality(T)` / `SimpleAggregateFunction(f, T)`
+  decode as the inner `T` (no dictionary layer in RowBinary); `Nested(...)` is
+  `Array(Tuple(...))` with no wire of its own.
+- **`AggregateFunction(...)`** — opaque, unframed state: not decodable or even
+  skippable; finalize server-side instead.
+- **`FixedString`** preserves trailing NUL padding; **`Enum`** decodes to the
+  underlying int (the name map is metadata); **`BFloat16`** is the top 16 bits of
+  a `Float32`.
+
+This is also where a raw model is most likely to go wrong. In a clean-room test
+on a `Variant` / `UUID` / `DateTime64` / `LowCardinality` schema, a no-skill
+Sonnet produced a **silently wrong UUID** (treated the bytes as plain, missing
+the two-reversed-halves layout), and a no-skill Opus got it right only after
+**three web searches**. The skill hands over these answers up front — correct by
+construction, no lookups. See `baseline/README.md` for the full control.
+
+And the failure isn't a one-off — it's a coin-flip. Running the same no-skill
+Sonnet on the `orders` schema (`UInt8, UUID, Decimal64(2), Enum8`) **5 times in
+isolation**, only **3 of 5** runs decoded correctly; both failures were the same
+UUID byte-order scramble. Even the passing runs varied ~1.9x in generated-code
+throughput. With the skill, every run is correct. So a single A/B undersells the
+gap: from scratch the model is right roughly 60% of the time and silently wrong
+the rest, while the skill makes correctness deterministic.
+
+## Examples
+
+Six end-to-end examples live in [EXAMPLES.md](EXAMPLES.md). Each ships both an API-combinator
+reader and an optimized, monomorphized one, with a runnable round-trip test and
+a benchmark — so the speedups below are measured, not claimed (Node 24 / V8;
+`npm run bench` for your own numbers):
+
+| Example           | Columns                                              | Optimized speedup   |
+| ----------------- | ---------------------------------------------------- | ------------------- |
+| **orders**        | `UUID`, `Decimal64`, `Enum8`                         | **~3.4x**           |
+| **carts**         | nested `Array(Tuple(...))`, `Array(Nullable(...))`   | **~2.0x**           |
+| **telemetry**     | `Map`, `Array(Float64)`, `Nullable`, named `Tuple`   | **~1.4x**           |
+| **observability** | `Variant`, `DateTime64(3)`, `LowCardinality`, nested | **~1.4x**           |
+| **profiles**      | `Array(String)`, `Nullable(Int32)`                   | **~1.3x**           |
+| **events**        | `UInt64`, `String`, `DateTime` scalars               | **~1.05x — on par** |
+
+Two axes drive the win. **Composite structure** is one: monomorphization pays in
+proportion to how many per-row combinator closures it removes (`carts` /
+`telemetry` / `observability`). **Per-row formatting** is the other, independent
+of composites: `orders` is all-scalar yet the biggest win (~3.4x), almost
+entirely from swapping the BigInt UUID formatter for the lookup-table
+`formatUUIDTable`. The genuinely flat case — a scalar row with no hot formatter
+(`events`) — is on par, so the simpler API reader is the right call there.
+Measure, don't assume.
+
+## Scope
+
+- **In scope:** `RowBinary`, `RowBinaryWithNames`, and
+  `RowBinaryWithNamesAndTypes` decoding for Node.js — full-buffer and streaming
+  (chunked) via `advance()`/`NeedMoreData`, `readRows()`, and the async
+  `streamRowBatches()` (with a built-in small-chunk warning and the optional
+  `coalesceChunks()` debounce filter).
+- **Planned:** RowBinary **writing / encoding** (the inverse of everything above)
+- **Out of scope (for now):** browsers and Edge runtimes, non-RowBinary formats
+  (JSON / CSV / TSV / Parquet), and big-endian hosts.
+
+## The spirit
+
+A RowBinary parser generator is a narrow thing. But it's built as an instance of
+a broader bet about what libraries become once a capable LLM is part of the
+toolchain. Three shifts, each already visible in this repo:
+
+- **Self-modifiable software.** The library deliberately ships _several_
+  equivalent decoders for the same type — `readUUID` / `readUUIDBigInt` /
+  `readUUIDHiLo`, `formatUUID` / `formatUUIDTable`, `new Array(n)` vs `[]`+push,
+  streaming vs whole-buffer — because the fastest one depends on the workload,
+  not the type. Today the agent picks at generation time from measured
+  benchmarks. The next step is to pair the skill with a tracing layer that runs
+  variant A against variant B _on the live workload_ and keeps whichever wins for
+  this data shape and access pattern — a parser that re-tunes itself as the
+  traffic drifts, instead of freezing one author's guess into a release.
+
+- **Custom software.** The value here isn't a fixed high-level API; it's the
+  benchmarked building blocks plus the judgment to combine them. So the end user
+  doesn't bend their code to the authors' generic surface — they have the agent
+  assemble the high-level API _they_ actually want, shaped to their queries, row
+  shapes, and latency/memory budget. Two teams with different workloads grow two
+  different libraries from the same primitives, and neither inherits a design
+  decision that was only ever right for the original authors' use case.
+
+- **Read-write libraries.** For either of the above to be safe, the source has to
+  be legible to an LLM, not merely runnable. So this repo is written _read-write_:
+  every tradeoff is commented where it's made — the per-column ClickHouse type
+  annotations, the `SAFE TO TOGGLE` markers on the fast variants, each reader's
+  doc comment carrying its exact monomorphized form. An LLM can
+  read _why_ a decision was made and change it in depth with confidence — not
+  just call the public functions, but safely rework the internals.
+
+The through-line: the last mile is glue the LLM writes over stable, benchmarked
+blocks, so the authors' job shrinks to exporting good primitives and documenting
+their tradeoffs honestly — rather than trying to bake the right performance
+constants for every possible workload into the library ahead of time.

package/skills/clickhouse-js-node-rowbinary-parser/SKILL.md

@@ -0,0 +1,190 @@
+---
+name: clickhouse-js-node-rowbinary-parser
+description: >
+  Generate TypeScript/JavaScript code that reads and decodes ClickHouse
+  RowBinary streams from the ClickHouse HTTP server.
+  Use this skill whenever a user wants to parse `RowBinary`,
+  `RowBinaryWithNames`, or `RowBinaryWithNamesAndTypes`.
+  Node.js only, doesn't cover browsers.
+---
+
+# ClickHouse JS RowBinary Parser Generator for Node.js
+
+## First: is RowBinary even the right format?
+
+RowBinary exists for throughput, but it is **not automatically the fastest
+path** — match the format to the shape of the data before committing to a
+bespoke parser.
+
+**Prefer a `JSON*` format (e.g. `JSONEachRow`) when** the result is mostly
+strings / JSON-like values that you consume wholesale — randomly accessing
+essentially every field, running string/regexp methods on them, treating values
+as text. V8's native `JSON.parse` is heavily optimized C++ and builds JS strings
+and objects faster than a JS-level RowBinary decoder can; pair it with HTTP
+response compression (`gzip` / `zstd`, which crushes JSON's repetitive keys) and
+the wire cost shrinks too.
+
+**RowBinary clearly wins when** the result is dominated by:
+
+- **Wide numerics** — `Int128`/`Int256`/`UInt128`/`UInt256`,
+  `Decimal128`/`Decimal256`.
+- **Binary / fixed-width blobs** — `IPv4`, `IPv6`, `UUID`, `FixedString`.
+- **High-volume fixed-width numeric columns** generally, where each value is a
+  single `DataView` read.
+
+**Prefer the `Native` format when** columnar load and client-side analytics are
+the main goal (fold/scan/filter columns, feed typed arrays to a Worker or WASM).
+`Native` is column-major, so it loads straight into one typed array per column
+with no transpose.
+
+For help choosing and consuming a `JSON*` format (or CSV / TSV) instead, use the
+**`clickhouse-js-node-coding`** skill.
+
+## Second: complete buffer, or incremental stream?
+
+Decide this before writing the reader — it changes the shape of the code and is
+a real performance fork.
+
+- **Incremental / streaming (the default here).** You consume the HTTP response
+  chunk by chunk as it arrives — low latency to the first row, bounded memory.
+  It is generally the best choice for large results, but slower per-row.
+
+- **Whole buffer in memory (faster, when it fits).** If you already hold the
+  entire response as one `Buffer`, the bounds check never fires — so you can drop
+  `advance()` entirely and read at a running offset in one monolithic loop.
+  This is 2-3x faster but introduces latency and unbounded memory use.
+
+The exposed API is streaming by default and requires an optimisation pass.
+
+## Third: row objects, or columnar (typed arrays)?
+
+The default output is one object per row (array-of-structs). For a **numeric,
+fixed-width result that the consumer reads column-wise**, decode instead into one
+typed array per column (struct-of-arrays) — it is **~4x faster and several times
+smaller** because it removes the per-row object, `Date`, and number-boxing
+allocations that dominate a numeric decode (the byte reads are already at memory
+bandwidth). Measured in `tests/iot.columnar.bench.ts`; rationale in
+`case-studies/wasm-vs-js.md`.
+
+- **Use columnar when** columns are numeric/fixed-width and the consumer
+  aggregates / filters / scans / plots them, or hands the buffers to a Worker or
+  WASM kernel (typed-array `ArrayBuffer`s are transferable — zero-copy).
+- **The preallocation trick:** if EVERY column is fixed-width the row stride is
+  known, so the exact count is `buf.length / stride` — allocate each column once,
+  write at `[i]`, no growth, no per-row bounds check.
+- **Streaming columnar is just that arithmetic per chunk.** Fixed width means
+  honoring a partial buffer needs no `advance()`/`NeedMoreData`/restart: the
+  complete-row count is `(chunk.length / stride) | 0`, and the leftover bytes
+  carry to the next chunk. Yield one typed-array batch per chunk, each owning a
+  fresh transferable `ArrayBuffer` (see `streamSensorColumns` in
+  `src/columnar.ts`).
+- **Stay row-oriented when** downstream code is row-shaped, the row is
+  string-dominated (columnar's win is numeric — a JS string allocates either
+  way), or the schema is nested/heterogeneous (`Array`/`Map`/`Tuple`).
+- **Hybrid:** store columnar, expose a lazy `rowAt(i)` accessor that builds an
+  object only for rows actually touched (see `iotRowAt` in `src/examples/iot.ts`).
+
+## Core guidance
+
+When generating a parser, follow these:
+
+- **Little-endian only.** RowBinary is little-endian; target x86/ARM. Read every
+  multi-byte number with `DataView` accessors passing a **literal** `true` for
+  the `littleEndian` flag.
+
+- **Correct first, then optimize.** First emit a correct reader built from the
+  plain per-type API. Only after it's correct (and tested) specialize it. Don't
+  bake performance assumptions in before correctness.
+
+- **Monomorphize generic/composite types.** Emit specialized, inlined code per
+  type combination instead of passing functions as arguments where the type
+  is known ahead of time.
+
+- **Streaming: throw + restart, not generators.** To signal "need more bytes",
+  a synchronous reader that throws a sentinel (`NeedMoreData`) and restarts the
+  row beats generators for realistic chunk sizes;
+
+- **Keep an eye on chunk sizes.** Partial trailing rows, small chunks are a silent
+  throughput killer: `streamRowBatches` warns once when
+  rows-per-chunk falls too low, and `coalesceChunks(source, { minSize, timeoutMs })`
+  merges small chunks in front of it when the source size isn't yours to raise.
+
+- **Shared scratch is not reentrant.** Some hot methods reuse a module-level
+  scratch buffer as a write-then-read pair — correct only because reads are fully
+  synchronous. An `async`/`yield` boundary between populating and reading it
+  corrupts the value.
+
+- **Hoist the cursor into locals.** Prefer the working buffer and view declared
+  once at the top of the generated reader, and keep the read offset in a **local variable**,
+  operating on it directly instead of re-reading from an object.
+
+- **Coalesce `advance()` across adjacent fixed-width columns.** A run of
+  neighbouring fixed-width columns has a known combined size, so bounds-check it
+  ONCE.
+
+- **Inline the leaf reads.** The per-type `readX` functions are the correct,
+  composable reference; the generated parser should INLINE their bodies, not call
+  them, so the row reader is straight-line with no per-field indirection (and so
+  the two points above can fold the offset arithmetic together).
+
+- **Annotate the decoded type per column.** Inlining erases the type structure,
+  so put a short comment above each column's decode block naming the ClickHouse
+  type it reads.
+
+- **Pre-allocate small result arrays.** RowBinary gives every array/map its
+  element count up front (the LEB128 prefix), so DEFAULT is to `new Array(n)`.
+  NOTE: for **large** arrays the application will iterate or compute over repeatedly,
+  prefer `[]` + `push` (faster to traverse in V8) — or a typed array (`Float64Array`…)
+  for numeric elements.
+
+- **TypeScript by default.** Generate TypeScript parsers and helpers unless the
+  user explicitly asks for plain JavaScript.
+
+## Type family references
+
+The readers live as real code under `src/`, split by type family.
+
+| Result contains (trigger)                                                                                                                      | Open                                                                                                                                                                  |
+| ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Always** — cursor state, `advance()`, `NeedMoreData`, `Reader<T>`                                                                            | `src/core.ts`                                                                                                                                                         |
+| LEB128 length/count prefixes for `String`/`Array`/`Map` (`readUVarint`)                                                                        | `src/varint.ts`                                                                                                                                                       |
+| `Int8`–`Int256`, `UInt8`–`UInt256`                                                                                                             | `src/integers.ts`                                                                                                                                                     |
+| `Bool`                                                                                                                                         | `src/bool.ts`                                                                                                                                                         |
+| `Enum8`, `Enum16`                                                                                                                              | `src/enums.ts`                                                                                                                                                        |
+| `Float32`, `Float64`, `BFloat16`                                                                                                               | `src/floats.ts`                                                                                                                                                       |
+| `Decimal32/64/128/256`, `Decimal(P, S)`                                                                                                        | `src/decimals.ts`                                                                                                                                                     |
+| `String`, `FixedString(N)`                                                                                                                     | `src/strings.ts`                                                                                                                                                      |
+| `UUID`                                                                                                                                         | `src/uuid.ts`                                                                                                                                                         |
+| `IPv4`, `IPv6`                                                                                                                                 | `src/ip.ts`                                                                                                                                                           |
+| `Date`, `Date32`, `DateTime`, `DateTime(tz)`, `DateTime64(P[, tz])`                                                                            | `src/datetime.ts`                                                                                                                                                     |
+| `Time`, `Time64(P)`                                                                                                                            | `src/time.ts`                                                                                                                                                         |
+| `IntervalNanosecond` … `IntervalYear`                                                                                                          | `src/interval.ts`                                                                                                                                                     |
+| `Array(T)`, `Map(K, V)`, `Tuple(...)`, `Nullable(T)`, `Variant(...)`, `QBit(...)`                                                              | `src/composite.ts`                                                                                                                                                    |
+| `Point`, `Ring`, `LineString`, `MultiLineString`, `Polygon`, `MultiPolygon`, `Geometry`                                                        | `src/geo.ts`                                                                                                                                                          |
+| `Dynamic` (and `Variant`/`Interval`/`Nested`/`Dynamic` nested inside it)                                                                       | `src/dynamic.ts`                                                                                                                                                      |
+| `JSON`                                                                                                                                         | `src/json.ts`                                                                                                                                                         |
+| The whole result — loop rows to EOF (`readRows`)                                                                                               | `src/rows.ts`                                                                                                                                                         |
+| A chunked HTTP response — `streamRowBatches`, `coalesceChunks`                                                                                 | `src/stream.ts`                                                                                                                                                       |
+| **Numeric/fixed-width result read column-wise** (aggregate/scan/plot, hand to a Worker/WASM) → decode into typed arrays, not row objects (~4x) | `src/columnar.ts` (`streamSensorColumns` — streaming, yields transferable typed-array batches); `decodeIotColumnar` in `src/examples/iot.ts` is the whole-buffer form |
+| `LowCardinality(T)` — transparent, decode as `T`                                                                                               | `src/lowCardinality.ts`                                                                                                                                               |
+| `SimpleAggregateFunction(f, T)` — transparent, decode as `T`                                                                                   | `src/simpleAggregateFunction.ts`                                                                                                                                      |
+| `Nested(...)` — no wire of its own; `Array(Tuple(...))`                                                                                        | `src/nested.ts`                                                                                                                                                       |
+| `Nothing` — zero-width, never decoded (only wrapped)                                                                                           | `src/nothing.ts`                                                                                                                                                      |
+| `AggregateFunction(...)` — opaque state; finalize server-side                                                                                  | `src/aggregateFunction.ts`                                                                                                                                            |
+
+## Worked examples
+
+Six end-to-end examples with real speedup are catalogued in [EXAMPLES.md](EXAMPLES.md).
+
+## Out of scope
+
+- **JSON / CSV / TSV / Parquet parsing** → use `clickhouse-js-node-coding`.
+- **Connection errors, hangs, type mismatches** → use
+  `clickhouse-js-node-troubleshooting`.
+- **Browser / Web Worker / Edge** → `@clickhouse/client-web`.
+
+## Still Stuck?
+
+- [ClickHouse RowBinary format](https://clickhouse.com/docs/interfaces/formats#rowbinary)
+- [ClickHouse data types](https://clickhouse.com/docs/sql-reference/data-types)
+- [ClickHouse JS client docs](https://clickhouse.com/docs/integrations/javascript)