@wavehouse/chtypes 0.5.2 → 1.0.2

package/CHANGELOG.md

@@ -6,6 +6,40 @@ The four bindings in this repository are released together and give one answer,
 
 ## [Unreleased]
 
+## [1.0.2] — 2026-10-06
+
+There is no 1.0.1 of this binding: 1.0.1 was a Go-only fix to that module's metadata. From 1.0.2 the four bindings release together again.
+
+### Fixed
+
+- `setup` now latches only once an image completes load step 7 (#458). A zone the library refuses, such as `setup({ timezone: 'Not/AZone' })`, used to fix the process setup at the first open: every later open failed with ClickHouse's code 36, and a corrected `setup` was a `UsageError` until the process restarted. Now, if step 7 (`chs_initialize`, then `chs_set_defaults` when there are defaults) fails before any image has completed it, the setup record is cleared. That open still raises the library's own error, a corrected `setup` is accepted, and the next open runs step 7 again with it, on the same image too: a failed step 7 is never remembered (`openUnverified` and `registry.for` alike). Once an image has completed step 7, a different setup is still a `UsageError`. No name or signature changes. All four bindings run the same case, `tests/fixtures/abi-v1/setup-cases.json`, and the rule is `docs/reference/bindings-v1.md` section 6.
+
+## [1.0.0] — 2026-10-04
+
+The TypeScript binding's first v1 release, and a deliberate break from 0.x. The default branch switches to v1 shortly after release. The sections below are the entries written as each part landed; this is what they add up to.
+
+- **A new ABI.** The binding speaks the generated ABI v1 layer, identified by an ABI fingerprint in `include/chtypes.h` rather than a revision number, so every FFI declaration is generated from `spec/abi-v1/abi.json`, not written by hand. The ABI stays provisional until the maintainer confirms it.
+- **Fetch over OCI, with signed statements.** Libraries are fetched from an OCI registry and verified against a signed statement before they are loaded; the default trust is the release key only (`docs/guides/fetch-v1.md`).
+- **The public API is `docs/reference/bindings-v1.md`**, the same four-binding contract with each language's own spelling.
+- **The CLI** is the `chtypes` bin (`dist/cli.js`): `fetch`, `verify`, `list` and `where`.
+- **The v0 surface is removed**; the list, and the reason for each removal, is `docs/reference/bindings-v1.md` section 7.
+- **Known gaps** are listed in [`docs/limitations.md`](../docs/limitations.md#known-gaps-in-10), and support for a line this release does not mention is "support unknown", never "unsupported".
+
+### Changed (v1: breaking)
+
+- **The public API is rebuilt over the ABI v1 generated layer** (`docs/reference/bindings-v1.md`). `setup()` replaces the registry timezone option; `Registry.open()`, `for()` and `installed()` are async and resolve through the fetch layer; `compileTable` takes exactly one `CREATE TABLE` statement; every name, SQL text, message and rendered value is a `Buffer`; the four call errors (`SchemaError`, `UnsupportedError`, `UsageError`, `InternalError`) carry the library's five error fields, under the abstract `CallError`; the loader's refusals are `ArtifactIncompatibleError` and `ArtifactCorruptError`, one family with the fetch layer's errors.
+- **The vocabularies are generated from the description** (`Format`, `Status`, `Outcome`, `FilterOutcome`, `Verdict`, `Reason`, `Source`, `DefaultKind`, `DocFlags`), each fact (`Transform.lossy`, `Value.isStored`, `verdictAnswered`) read from it.
+
+### Removed
+
+- The hand FFI table and the presence and per-format probes, the transform classifier and its numeric helpers, the hand JSON reader's denormal repair, discovery reconstruction (`discoverQuery` and `discoverColumns` replace it), the error-code table parsers, the v0 loader halves (search path, manifests, revision gate, checksum re-hash, `Resolve`), `Registry#close`, `Library#shutdown`, `setDefaultSettings`, `InitConflictError`, `ABI_REVISION` and `CODE_UNSUPPORTED` from the public API, and numeric settings values.
+
+### Fixed
+
+- **The tar reader now refuses a symlink, hardlink, device or FIFO entry instead of silently skipping it.** `extractTarGz` treated anything that was not a regular file or directory as "skip, never follow", so an artifact tarball carrying one of those installed everything else around it with no error. It now throws `ArtifactCorruptError`, naming the entry and its type, matching the other three bindings' install refusal for the same shapes.
+- **The crash-guard refuse-list is now sourced identically to the other three bindings, and an artifact with neither source refuses rather than loading unguarded.** This binding already fell back to the manifest's `unsafe_families` field when `unsafe_families.txt` was absent, but a manifest predating the field (or one that simply omitted it) parsed to the same `undefined` as one carrying it empty, so `chs_init` silently ran with no refuse-list either way. A directory with neither the file nor the field is now refused, naming both, instead of loading unguarded (`docs/reference/artifact.md` step 9).
+- **`ensure`/`fetch` now retry a transient HTTP 5xx, 408 or 429 from the artifacts host, and a connection-level failure (refused, reset, timed out, DNS), within the existing retry budget and schedule** (`docs/guides/fetch.md` §3a: 5 attempts, delays doubling from 4s) — previously `HttpSource`'s `request` ran its own separate, shorter retry (3 attempts, 500ms steps) before giving up, independent of the publish-window budget, and a tarball download had no outer retry at all. A `Retry-After` on a 503 or 429 is honored, in both the delta-seconds and HTTP-date forms, capped so it never makes the total wait exceed the existing budget — one that does not fit fails at once, naming the requested delay. A 404 or 410, and a tarball hash or size mismatch, are still decided on the first attempt, never retried; a 410 is now also recognized as "not found" (it used to fall through as an ungrouped refusal, never retried either way, but misclassified). `SourceUnreachableError` gains `.retryable`/`.retryAfterMs` properties (closes #365).
+
 ## [0.5.2] — 2026-10-01
 
 ### Added

package/README.md

@@ -6,75 +6,71 @@ Node ≥ 22, ESM only. `ffi-rs` ships prebuilt for darwin arm64/x64 and linux ar
 
 ## Install
 
-Two things: this package, and at least one **artifact** — the per-version native library it `dlopen`s at runtime.
+Two things: this package, and at least one **artifact**, the per-version native library it `dlopen`s at runtime. The fetch layer (`src/ocifetch`) resolves a version request to a signed artifact in its cache, verifies the signature and the library's digest, and hands the result to the loader; a `Registry` turns on fetching with `autofetch` (or `CHTYPES_AUTOFETCH=1`).
 
 ```sh
 pnpm add @wavehouse/chtypes
-npx @wavehouse/chtypes fetch 26.8
 ```
 
-The fetch lands in `~/.cache/chtypes/artifacts/abi<R>/<os>-<arch>/26.8/` — the per-user cache every chtypes binding reads by default, `<R>` the ABI revision this SDK speaks (fetch installs only artifacts built at it) — after checking an ed25519 signature over the release and the sha256 of every byte. `$CHTYPES_REGISTRY` overrides it.
-
 ## Quickstart
 
 ```ts
-import { Format, Registry } from '@wavehouse/chtypes';
+import { Format, Registry, setup } from '@wavehouse/chtypes';
 
-const registry = new Registry();     // walks the search path
-const lib = registry.for('26.8');    // a line or an exact patch; never a nearest match
-const schema = lib.compileDdl('x UInt8, ts DateTime DEFAULT now()');
+setup({ timezone: 'UTC' });                  // optional; once, before the first open
+const registry = await Registry.open({ autofetch: true });
+const lib = await registry.for('26.8');      // two, three or four parts; never a nearest match
+const schema = lib.compileTable('CREATE TABLE t (x UInt8, ts DateTime DEFAULT now()) ENGINE = Memory');
 
-const batch = schema.rows(Format.JSONEachRow, Buffer.from('{"x":256}'));
+const batch = schema.rows(Format.JSONEachRow, Buffer.from('{"x":256}\n'));
 const row = batch.rows[0];
-console.log(batch.outcome);              // accepted
-console.log(row.values[0].text);         // 0             — what would actually be stored
-console.log(row.transformed[0]?.reason); // overflow_wrap — which is the product
-console.log(row.substituted[0]?.column); // ts — send it explicitly in the real INSERT
+console.log(batch.outcome);                    // accepted
+console.log(row?.values[0]?.text.toString());  // 0             what would actually be stored
+console.log(row?.transformed[0]?.reason);      // overflow_wrap which is the product
 
 schema.close();
 ```
 
-The row is **accepted** and `256` is silently stored as `0`. That report — `transformed` — is the one derived answer in the system and the reason it exists.
+The row is **accepted** and `256` is silently stored as `0`. That report, `transformed`, comes from the library, which is the only place a ClickHouse rule lives.
+
+## What a result is
+
+Every field of a result is a field of the document the library returned, decoded one to one with the stock `JSON.parse`; nothing is computed in this package. Every name, SQL text, message and rendered value is **bytes** (`Buffer`), never assumed to be UTF-8: ClickHouse round-trips column names containing NUL and invalid UTF-8. `Value.isStored`, `Transform.lossy` and `verdictAnswered` are the description's own facts for the value a document carries.
 
-`ts` was substituted rather than stored: send every substituted column as an explicit value in the real INSERT, or the server re-evaluates `now()` at its own instant and your preview is not what landed.
+## Errors
 
-## Three outcomes, and conflating any two is a bug
+A bad **row** is a verdict, not an exception: `outcome` becomes `'rejected'` with ClickHouse's own code and message. The calls that can fail throw one of four peers, under the abstract `CallError`:
 
-A bad **row** is a verdict, not an exception: `outcome` becomes `'rejected'` with ClickHouse's own code and message. Exceptions are for schema-level answers — `compileDdl`, `setEngine`, `setTtl`, `validateType` — and there the class _is_ the verdict.
+- `SchemaError`: the server would refuse; `chCode` and `chName` are ClickHouse's own.
+- `UnsupportedError`: this build declines to answer, and a real server might well have accepted. **Fall back to the server.**
+- `UsageError`: caller misuse, whichever side caught it (a closed object, a zone given twice, a refused version spelling).
+- `InternalError`: a library bug, or a document that does not decode.
 
-- `SchemaError` — the server refused, and `code` is a real ClickHouse code.
-- `UnsupportedError` — chtypes declines to guess, and a real server might well have accepted. **Fall back to the server.**
-- The two are **peers**: a decline never satisfies `instanceof SchemaError`.
+The four are **peers**: a decline never satisfies `instanceof SchemaError`. Loader and fetch errors are `ArtifactError`s: `ArtifactIncompatibleError`, `ArtifactCorruptError` (the fetch layer's and the loader's step 5 are one class), `ArtifactMissingError` and the rest of the fetch family.
 
 ## Documentation
 
-|                                                                                                                                                                             |                                                                              |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
-| [Quickstart](https://github.com/wave-rf/chtypes/blob/main/docs/quickstart.md)                                                                                               | the same program in all four languages                                       |
-| [TypeScript API reference](https://github.com/wave-rf/chtypes/blob/main/docs/reference/ts.md)                                                                               | every symbol, the C entry point under it, what it returns and what it throws |
-| [Artifacts](https://github.com/wave-rf/chtypes/blob/main/docs/guides/artifacts.md)                                                                                          | getting one, where it lands, verifying and pinning it                        |
-| [Batches](https://github.com/wave-rf/chtypes/blob/main/docs/guides/batches.md)                                                                                              | always `rows`, and the two bad-row policies                                  |
-| [Transformations](https://github.com/wave-rf/chtypes/blob/main/docs/guides/transformations.md)                                                                              | the silent-change report, and the DEFAULTs you must echo back                |
-| [Settings](https://github.com/wave-rf/chtypes/blob/main/docs/guides/settings.md) · [Discovery](https://github.com/wave-rf/chtypes/blob/main/docs/guides/discovery.md)       | the four channels; asking a real server what profile to validate under       |
-| [Filters](https://github.com/wave-rf/chtypes/blob/main/docs/guides/filters.md) · [Multi-version](https://github.com/wave-rf/chtypes/blob/main/docs/guides/multi-version.md) | boolean expressions over rows; several ClickHouse versions in one process    |
-| [Support matrix](https://github.com/wave-rf/chtypes/blob/main/docs/support.md) · [Limitations](https://github.com/wave-rf/chtypes/blob/main/docs/limitations.md)            | what works where; what chtypes declines to answer                            |
+|                                                        |                                                                                |
+| ------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| [The v1 binding API](../docs/reference/bindings-v1.md) | every operation, type, error class and document decoder, in all four languages |
+| [Fetching artifacts](../docs/guides/fetch-v1.md)       | resolving, verifying and caching an artifact                                   |
 
-## Four things specific to this binding
+## Things specific to this binding
 
-**`using` is a syntax error on Node 22**, this package's own floor. Explicit resource management needs TypeScript to downlevel it for you, or plain JavaScript on Node ≥ 24. `close()` works everywhere and every disposable here has both, so portable examples use `close()`.
+**`using` is a syntax error on Node 22**, this package's own floor. Explicit resource management needs TypeScript to downlevel it for you, or plain JavaScript on Node >= 24. `close()` works everywhere and every disposable here has both, so portable examples use `close()`.
 
-**A settings value may be a `string` or a `bigint`, never a `number`.** The runtime rejects a `number`, because TypeScript is not present at a JS consumer's call site and a 19-digit `chtypes_now_epoch_nanos` does not survive an IEEE double — sent as a JSON number the setting would be silently ignored.
+**Settings values are strings, and only strings.** The map becomes a JSON object of string values and is passed verbatim; a `number` or a `boolean` is a `TypeError`. The per-call zone is the `session_timezone` key of the call's settings: pass `sessionTimezone`, or the key, never both.
 
-**`for()` never fetches; `open()` can.** `Registry#for(v)` is synchronous and resolves from the search path alone. `await registry.open(v)` is its async twin, and with `{ autofetch: true }` (or `CHTYPES_AUTOFETCH=1`) it fetches a missing line first. Off by default: a production process must not begin a 250 MB download inside a request.
+**`Registry.open`, `for` and `installed` are async**, because the fetch layer is. Construction opens nothing; `for` resolves from the cache first and fetches only when `autofetch` is on.
 
-**`worker_threads` is the boundary.** Two JS threads share one dlopen'd image and one set of C globals, which no per-isolate counter can see. Seed default settings before starting workers, and do not share a `Schema` across them.
+**`worker_threads` is the boundary.** Every call runs synchronously on one thread, so there is nothing to share inside an isolate. A handle cannot cross to another worker: each worker opens its own objects over the shared image, and every worker must call `setup` identically.
 
 ## Tests
 
-`pnpm test`. Tests that need an artifact **skip loudly by name** without a registry on the search path, and a suite that ran nothing fails. The fetch suite runs offline against the miniature releases in `tests/fixtures/fetch/`.
+`pnpm test`. The stub-backed suites under `test/abi1` need `$CHTYPES_ABI1_STUBS` and skip loudly by name without it; the decoder, settings and setup suites need nothing.
 
-Working against a checkout: build `dist/` first (`pnpm install && pnpm build`) — that is what `package.json#exports` serves. If a linked copy goes stale, note that `pnpm install --force` does **not** relink; remove `node_modules` and reinstall.
+Working against a checkout: build `dist/` first (`pnpm install && pnpm build`), which is what `package.json#exports` serves.
 
 ## License
 
-Apache 2.0. The artifacts this package loads are **Elastic License 2.0** — a separate license, shipped inside each artifact release, and `fetch` says so once.
+Apache 2.0. The artifacts this package loads are **Elastic License 2.0**, a separate license shipped inside each artifact release.

package/dist/abi1/buildinfo.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `BuildInfo`: the decoded form of the library's static build-info JSON
+ * (`docs/reference/bindings-v1.md` §5, `BuildInfo`). Decoded once, at loader
+ * step 4, where a malformed document is a `LoaderCorruptError`
+ * (`build_info_malformed`): ASCII only, no duplicate key at any depth,
+ * `schema` equal to 1, every required field of its type.
+ */
+/** What the build itself says it supports, from its own format factory and document groups. */
+export interface Capabilities {
+    /** ClickHouse's own format names the build can read. */
+    readonly inputFormats: readonly string[];
+    /** ClickHouse's own format names the build can write. */
+    readonly exportFormats: readonly string[];
+    readonly docFlags: readonly string[];
+    /** Open: an entry is a build-level feature, the first being `default_generators`. */
+    readonly features: readonly string[];
+}
+export interface BuildInfo {
+    readonly schema: number;
+    readonly abi: number;
+    readonly abiFingerprint: string;
+    /** Four parts, no channel. */
+    readonly clickhouseVersion: string;
+    readonly channel: string;
+    readonly clickhouseMinor: string;
+    readonly clickhouseCommit: string;
+    readonly coreCommit: string;
+    readonly build: string;
+    readonly inputsSha256: string;
+    readonly os: string;
+    readonly arch: string;
+    /** The parsed object, uninterpreted. */
+    readonly toolchain: Readonly<Record<string, unknown>>;
+    readonly capabilities: Capabilities;
+    /** The exact bytes the library returned. */
+    readonly raw: Buffer;
+}
+/** Decode the build-info text the library returned; every failure is `build_info_malformed`. */
+export declare function decodeBuildInfo(path: string, text: string): BuildInfo;
+//# sourceMappingURL=buildinfo.d.ts.map

package/dist/abi1/buildinfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildinfo.d.ts","sourceRoot":"","sources":["../../src/abi1/buildinfo.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,yDAAyD;IACzD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AA4BD,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAyCrE"}

package/dist/abi1/buildinfo.js

@@ -0,0 +1,83 @@
+/**
+ * `BuildInfo`: the decoded form of the library's static build-info JSON
+ * (`docs/reference/bindings-v1.md` §5, `BuildInfo`). Decoded once, at loader
+ * step 4, where a malformed document is a `LoaderCorruptError`
+ * (`build_info_malformed`): ASCII only, no duplicate key at any depth,
+ * `schema` equal to 1, every required field of its type.
+ */
+import { LoaderCorruptError } from './errors.js';
+import { DuplicateKeyError, isAsciiOnly, parseStrictJson } from './strictjson.js';
+function malformed(path, want, got) {
+    throw new LoaderCorruptError({ reason: 'build_info_malformed', path, want, got });
+}
+function kindOf(v) {
+    return v === null ? 'null' : Array.isArray(v) ? 'array' : typeof v;
+}
+function str(path, obj, key) {
+    const v = obj[key];
+    if (typeof v !== 'string')
+        malformed(path, `${key} as a string`, kindOf(v));
+    return v;
+}
+function int(path, obj, key) {
+    const v = obj[key];
+    if (typeof v !== 'number' || !Number.isInteger(v))
+        malformed(path, `${key} as an integer`, kindOf(v));
+    return v;
+}
+function strList(path, obj, key) {
+    const v = obj[key];
+    if (!Array.isArray(v) || !v.every((e) => typeof e === 'string'))
+        malformed(path, `${key} as a list of strings`, kindOf(v));
+    return v;
+}
+/** Decode the build-info text the library returned; every failure is `build_info_malformed`. */
+export function decodeBuildInfo(path, text) {
+    if (!isAsciiOnly(text))
+        malformed(path, 'ASCII only', 'a non-ASCII byte');
+    let parsed;
+    try {
+        parsed = parseStrictJson(text);
+    }
+    catch (err) {
+        if (err instanceof DuplicateKeyError)
+            malformed(path, 'no duplicate keys', err.message);
+        malformed(path, 'valid JSON', 'a parse error');
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        malformed(path, 'a JSON object', kindOf(parsed));
+    const obj = parsed;
+    if (obj.schema !== 1)
+        malformed(path, 'schema === 1', JSON.stringify(obj.schema));
+    const toolchain = obj.toolchain;
+    if (typeof toolchain !== 'object' || toolchain === null || Array.isArray(toolchain)) {
+        malformed(path, 'toolchain as an object', kindOf(toolchain));
+    }
+    const caps = obj.capabilities;
+    if (typeof caps !== 'object' || caps === null || Array.isArray(caps))
+        malformed(path, 'capabilities as an object', kindOf(caps));
+    const capsObj = caps;
+    return {
+        schema: 1,
+        abi: int(path, obj, 'abi'),
+        abiFingerprint: str(path, obj, 'abi_fingerprint'),
+        clickhouseVersion: str(path, obj, 'clickhouse_version'),
+        channel: str(path, obj, 'channel'),
+        clickhouseMinor: str(path, obj, 'clickhouse_minor'),
+        clickhouseCommit: str(path, obj, 'clickhouse_commit'),
+        coreCommit: str(path, obj, 'core_commit'),
+        build: str(path, obj, 'build'),
+        inputsSha256: str(path, obj, 'inputs_sha256'),
+        os: str(path, obj, 'os'),
+        arch: str(path, obj, 'arch'),
+        toolchain: toolchain,
+        capabilities: {
+            inputFormats: strList(path, capsObj, 'input_formats'),
+            exportFormats: strList(path, capsObj, 'export_formats'),
+            docFlags: strList(path, capsObj, 'doc_flags'),
+            features: strList(path, capsObj, 'features'),
+        },
+        raw: Buffer.from(text, 'latin1'),
+    };
+}
+//# sourceMappingURL=buildinfo.js.map

package/dist/abi1/buildinfo.js.map

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

package/dist/abi1/calls.gen.d.ts

@@ -0,0 +1,55 @@
+import { type Abi1Handle } from './handles.js';
+import { type RawApi } from './raw.js';
+export type SchemaHandle = Abi1Handle & {
+    readonly kind: "chs_schema";
+};
+export type FilterHandle = Abi1Handle & {
+    readonly kind: "chs_filter";
+};
+export type BlockHandle = Abi1Handle & {
+    readonly kind: "chs_block";
+};
+export declare class Calls {
+    readonly raw: RawApi;
+    constructor(raw: RawApi);
+    /** The generated call wrapper for chs_live_handles. */
+    liveHandles(): Buffer;
+    /** The generated call wrapper for chs_error_codes. */
+    errorCodes(): Buffer;
+    /** The generated call wrapper for chs_initialize. */
+    initialize(timezone: Uint8Array): void;
+    /** The generated call wrapper for chs_set_defaults. */
+    setDefaults(settings: Uint8Array): void;
+    /** The generated call wrapper for chs_type_validate. */
+    typeValidate(typeExpr: Uint8Array): Buffer;
+    /** The generated call wrapper for chs_back_quote. */
+    backQuote(name: Uint8Array): Buffer;
+    /** The generated call wrapper for chs_back_quote_if_needed. */
+    backQuoteIfNeeded(name: Uint8Array): Buffer;
+    /** The generated call wrapper for chs_quote_string. */
+    quoteString(text: Uint8Array): Buffer;
+    /** The generated call wrapper for chs_schema_create. */
+    schemaCreate(createTable: Uint8Array, settings: Uint8Array): SchemaHandle;
+    /** The generated call wrapper for chs_schema_describe. */
+    schemaDescribe(schema: SchemaHandle): Buffer;
+    /** The generated call wrapper for chs_preview_row. */
+    previewRow(schema: SchemaHandle, format: number, body: Uint8Array, settings: Uint8Array, columns: Uint8Array): Buffer;
+    /** The generated call wrapper for chs_preview_batch. */
+    previewBatch(schema: SchemaHandle, format: number, body: Uint8Array, settings: Uint8Array, columns: Uint8Array, filter: FilterHandle | null, exportFormat: number, docFlags: number): {
+        readonly out: Buffer;
+        readonly outExport: Buffer;
+    };
+    /** The generated call wrapper for chs_filter_create. */
+    filterCreate(schema: SchemaHandle, expr: Uint8Array, queryParams: Uint8Array, settings: Uint8Array): FilterHandle;
+    /** The generated call wrapper for chs_filter_eval_body. */
+    filterEvalBody(filter: FilterHandle, format: number, body: Uint8Array, settings: Uint8Array): Buffer;
+    /** The generated call wrapper for chs_block_create. */
+    blockCreate(schema: SchemaHandle, format: number, body: Uint8Array, settings: Uint8Array, columns: Uint8Array): BlockHandle;
+    /** The generated call wrapper for chs_filter_eval_block. */
+    filterEvalBlock(filter: FilterHandle, block: BlockHandle): Buffer;
+    /** The generated call wrapper for chs_discover_query. */
+    discoverQuery(): Buffer;
+    /** The generated call wrapper for chs_discover_columns. */
+    discoverColumns(rows: Uint8Array): Buffer;
+}
+//# sourceMappingURL=calls.gen.d.ts.map

package/dist/abi1/calls.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.gen.d.ts","sourceRoot":"","sources":["../../src/abi1/calls.gen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAwD,KAAK,MAAM,EAAW,MAAM,UAAU,CAAC;AAEtG,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAEtE,qBAAa,KAAK;IAChB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,YAAY,GAAG,EAAE,MAAM,EAEtB;IAED,uDAAuD;IACvD,WAAW,IAAI,MAAM,CAGpB;IAED,sDAAsD;IACtD,UAAU,IAAI,MAAM,CAGnB;IAED,qDAAqD;IACrD,UAAU,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAErC;IAED,uDAAuD;IACvD,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAEtC;IAED,wDAAwD;IACxD,YAAY,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAGzC;IAED,qDAAqD;IACrD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGlC;IAED,+DAA+D;IAC/D,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAG1C;IAED,uDAAuD;IACvD,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGpC;IAED,wDAAwD;IACxD,YAAY,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,YAAY,CAGxE;IAED,0DAA0D;IAC1D,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAG3C;IAED,sDAAsD;IACtD,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAGpH;IAED,wDAAwD;IACxD,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAMzO;IAED,wDAAwD;IACxD,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,YAAY,CAGhH;IAED,2DAA2D;IAC3D,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAGnG;IAED,uDAAuD;IACvD,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,WAAW,CAG1H;IAED,4DAA4D;IAC5D,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAGhE;IAED,yDAAyD;IACzD,aAAa,IAAI,MAAM,CAGtB;IAED,2DAA2D;IAC3D,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGxC;CAEF"}

package/dist/abi1/calls.gen.js

@@ -0,0 +1,110 @@
+/* GENERATED by scripts/abi-v1/gen.py from spec/abi-v1/abi.json (CHS_ABI_FINGERPRINT sha256:856e5cb7543db291b4db716662bf6e487b2258973b959bbf5d58b4bd46d73285) — DO NOT EDIT */
+/*
+ * One typed, copy-then-free method per described call, named without the `chs_` prefix.
+ * Each marshals through the generic `rawCall`, throws the error class sdk.json's status
+ * table gives for a non-OK status, returns every owned buffer as a Buffer (already copied
+ * and freed) and every new handle wrapped. No raw buffer or error handle ever escapes.
+ * The accessors and frees of those two kinds, and the handshake, tombstone and tooling
+ * exports, get no method: the generic engine and the loader own them.
+ */
+import { SYMBOL } from './decls.gen.js';
+import { wrapHandle } from './handles.js';
+import { asBuffer, checkStatus, NULL_EXTERNAL, rawCall } from './raw.js';
+export class Calls {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    /** The generated call wrapper for chs_live_handles. */
+    liveHandles() {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.LIVE_HANDLES, []));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_error_codes. */
+    errorCodes() {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.ERROR_CODES, []));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_initialize. */
+    initialize(timezone) {
+        checkStatus(rawCall(this.raw, SYMBOL.INITIALIZE, [asBuffer(timezone)]));
+    }
+    /** The generated call wrapper for chs_set_defaults. */
+    setDefaults(settings) {
+        checkStatus(rawCall(this.raw, SYMBOL.SET_DEFAULTS, [asBuffer(settings)]));
+    }
+    /** The generated call wrapper for chs_type_validate. */
+    typeValidate(typeExpr) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.TYPE_VALIDATE, [asBuffer(typeExpr)]));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_back_quote. */
+    backQuote(name) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.BACK_QUOTE, [asBuffer(name)]));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_back_quote_if_needed. */
+    backQuoteIfNeeded(name) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.BACK_QUOTE_IF_NEEDED, [asBuffer(name)]));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_quote_string. */
+    quoteString(text) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.QUOTE_STRING, [asBuffer(text)]));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_schema_create. */
+    schemaCreate(createTable, settings) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.SCHEMA_CREATE, [asBuffer(createTable), asBuffer(settings)]));
+        return wrapHandle(this.raw, outs["out"]);
+    }
+    /** The generated call wrapper for chs_schema_describe. */
+    schemaDescribe(schema) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.SCHEMA_DESCRIBE, [schema.ptr]));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_preview_row. */
+    previewRow(schema, format, body, settings, columns) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.PREVIEW_ROW, [schema.ptr, format, asBuffer(body), asBuffer(settings), asBuffer(columns)]));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_preview_batch. */
+    previewBatch(schema, format, body, settings, columns, filter, exportFormat, docFlags) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.PREVIEW_BATCH, [schema.ptr, format, asBuffer(body), asBuffer(settings), asBuffer(columns), filter === null ? NULL_EXTERNAL : filter.ptr, exportFormat, docFlags]));
+        return {
+            out: outs["out"],
+            outExport: outs["out_export"],
+        };
+    }
+    /** The generated call wrapper for chs_filter_create. */
+    filterCreate(schema, expr, queryParams, settings) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.FILTER_CREATE, [schema.ptr, asBuffer(expr), asBuffer(queryParams), asBuffer(settings)]));
+        return wrapHandle(this.raw, outs["out"]);
+    }
+    /** The generated call wrapper for chs_filter_eval_body. */
+    filterEvalBody(filter, format, body, settings) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.FILTER_EVAL_BODY, [filter.ptr, format, asBuffer(body), asBuffer(settings)]));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_block_create. */
+    blockCreate(schema, format, body, settings, columns) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.BLOCK_CREATE, [schema.ptr, format, asBuffer(body), asBuffer(settings), asBuffer(columns)]));
+        return wrapHandle(this.raw, outs["out"]);
+    }
+    /** The generated call wrapper for chs_filter_eval_block. */
+    filterEvalBlock(filter, block) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.FILTER_EVAL_BLOCK, [filter.ptr, block.ptr]));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_discover_query. */
+    discoverQuery() {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.DISCOVER_QUERY, []));
+        return outs["out"];
+    }
+    /** The generated call wrapper for chs_discover_columns. */
+    discoverColumns(rows) {
+        const outs = checkStatus(rawCall(this.raw, SYMBOL.DISCOVER_COLUMNS, [asBuffer(rows)]));
+        return outs["out"];
+    }
+}
+//# sourceMappingURL=calls.gen.js.map

package/dist/abi1/calls.gen.js.map

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

package/dist/abi1/decls.gen.d.ts

@@ -0,0 +1,115 @@
+export type ParamKind = 'scalar' | 'enum' | 'bytes_in' | 'handle' | 'out_handle' | 'out_error' | 'out_scalar';
+export type ReturnKind = 'status' | 'void' | 'scalar' | 'enum' | 'handle';
+export interface ParamSpec {
+    readonly name: string;
+    readonly kind: ParamKind;
+    readonly type: string | null;
+    readonly nullable: boolean;
+    readonly content: string | null;
+}
+export interface ReturnSpec {
+    readonly kind: ReturnKind;
+    readonly type: string | null;
+    readonly owned: boolean;
+    readonly nullable: boolean;
+    readonly content: string | null;
+    readonly borrows: string | null;
+    readonly constant: string | null;
+}
+export interface FunctionSpec {
+    readonly cls: 'handshake' | 'tombstone' | 'api' | 'tooling';
+    readonly thread: string;
+    readonly params: readonly ParamSpec[];
+    readonly returns: ReturnSpec;
+    readonly mayReturn: readonly string[];
+}
+/** Every described function's shape, keyed by its chs_* name. */
+export declare const FUNCTION_SPECS: Readonly<Record<string, FunctionSpec>>;
+/** chs_* name -> the key ts/src/abi1/raw.ts's ffi-rs define() table uses for it. */
+export declare const CAMEL_NAMES: Readonly<Record<string, string>>;
+/**
+ * Every described chs_* name, reachable WITHOUT spelling it: hand code writes
+ * `SYMBOL.BUF_FREE`, never the string `"chs_buf_free"`. Generated so the one place that
+ * spells a chs_* name is this file, machine-checked against spec/abi-v1/abi.json.
+ *
+ * Deliberately NOT typed `Record<string, string>`: each key's value is its own string
+ * LITERAL type, so a known key (`SYMBOL.BUF_FREE`) is never widened to `string | undefined`
+ * by `noUncheckedIndexedAccess` the way an index signature would be. Nothing here is ever
+ * looked up with a variable key — `CAMEL_NAMES` and `FUNCTION_SPECS` are, and keep their
+ * `Record` types for that reason.
+ */
+export declare const SYMBOL: {
+    readonly ABI_REVISION: "chs_abi_revision";
+    readonly ABI_VERSION: "chs_abi_version";
+    readonly BACK_QUOTE: "chs_back_quote";
+    readonly BACK_QUOTE_IF_NEEDED: "chs_back_quote_if_needed";
+    readonly BLOCK_CREATE: "chs_block_create";
+    readonly BLOCK_FREE: "chs_block_free";
+    readonly BUF_DATA: "chs_buf_data";
+    readonly BUF_FREE: "chs_buf_free";
+    readonly BUF_LEN: "chs_buf_len";
+    readonly BUILD_INFO: "chs_build_info";
+    readonly CLICKHOUSE_VERSION: "chs_clickhouse_version";
+    readonly DISCOVER_COLUMNS: "chs_discover_columns";
+    readonly DISCOVER_QUERY: "chs_discover_query";
+    readonly ERROR_CH_CODE: "chs_error_ch_code";
+    readonly ERROR_CH_NAME: "chs_error_ch_name";
+    readonly ERROR_CODES: "chs_error_codes";
+    readonly ERROR_COLUMN: "chs_error_column";
+    readonly ERROR_FREE: "chs_error_free";
+    readonly ERROR_MESSAGE: "chs_error_message";
+    readonly ERROR_STATUS: "chs_error_status";
+    readonly FILTER_CREATE: "chs_filter_create";
+    readonly FILTER_EVAL_BLOCK: "chs_filter_eval_block";
+    readonly FILTER_EVAL_BODY: "chs_filter_eval_body";
+    readonly FILTER_FREE: "chs_filter_free";
+    readonly FUNCTION_FLAGS: "chs_function_flags";
+    readonly INITIALIZE: "chs_initialize";
+    readonly LIVE_HANDLES: "chs_live_handles";
+    readonly PREVIEW_BATCH: "chs_preview_batch";
+    readonly PREVIEW_ROW: "chs_preview_row";
+    readonly QUOTE_STRING: "chs_quote_string";
+    readonly REFERENCE_TYPE: "chs_reference_type";
+    readonly REGISTERED_FAMILIES: "chs_registered_families";
+    readonly SCHEMA_CREATE: "chs_schema_create";
+    readonly SCHEMA_DESCRIBE: "chs_schema_describe";
+    readonly SCHEMA_FREE: "chs_schema_free";
+    readonly SET_DEFAULTS: "chs_set_defaults";
+    readonly SHUTDOWN: "chs_shutdown";
+    readonly TYPE_VALIDATE: "chs_type_validate";
+};
+export interface HandleInfo {
+    readonly free: string;
+    readonly holds: readonly string[];
+    readonly className: string;
+}
+/** Every described handle kind: its free function (a SYMBOL.* value) and what it holds. */
+export declare const HANDLE_INFO: Readonly<Record<string, HandleInfo>>;
+/** chs_status, both directions (the wire int32 and its C name). */
+export declare const STATUS_NAMES: Readonly<Record<number, string>>;
+export declare const STATUS_VALUES: Readonly<Record<string, number>>;
+/** Every exported symbol, sorted — the loader's step 6 resolve-all sweep. */
+export declare const DESCRIBED_SYMBOLS: readonly string[];
+/**
+ * The buf handle's own chs_* name (D2/D3's universal owned-output type), named so hand
+ * code can compare `ParamSpec.type`/`ReturnSpec.type` against it without ever spelling
+ * the literal itself (a literal would read as a hand-written chs_ reference to
+ * scripts/abi-v1/check-no-hand-decls.py once this file's own `define(`-adjacent code also
+ * names it — see ts/src/abi1/raw.ts's module comment).
+ */
+export declare const BUF_HANDLE: 'chs_buf';
+/**
+ * This binding's own compiled-in ABI identity (D1.1/§1.7's "one computation, copied
+ * everywhere else" — never recomputed, byte-compared against a loaded library's
+ * chs_build_info().abi_fingerprint at loader step 4).
+ */
+export declare const ABI_VERSION = 1;
+export declare const ABI_FINGERPRINT = "sha256:856e5cb7543db291b4db716662bf6e487b2258973b959bbf5d58b4bd46d73285";
+export interface CrossCheckField {
+    readonly buildInfo: string;
+    readonly predicate: string;
+    readonly compare: 'bytes' | 'int';
+}
+/** spec/abi-v1/sdk.json's cross_check table: loader step 5's nine fields. */
+export declare const CROSS_CHECK: readonly CrossCheckField[];
+//# sourceMappingURL=decls.gen.d.ts.map

package/dist/abi1/decls.gen.d.ts.map

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