@wavehouse/chtypes 0.5.2 → 1.0.0

package/dist/error-codes.js

@@ -1,139 +0,0 @@
-/**
- * The error-code table (revision 6): one loaded build's own code -> name map.
- *
- * There is no table in this package, and there must never be one. The table is
- * a property of the BUILD: codes join and leave between ClickHouse lines, and
- * one number can name two different errors on two lines (903 is
- * LICENSE_EXPIRED on 25.3 and 25.8, absent on 25.10, and
- * DISTRIBUTED_CACHE_REGISTRY_SHUTDOWN on 26.2 through 26.9). Every answer
- * therefore comes from `Library#errorCodes()`, i.e. from
- * `chs_error_codes` of the library being asked, and
- * `scripts/check-no-error-code-table.py` fails the build if a literal code ->
- * name table appears in any binding.
- */
-import { ChtypesError } from './errors.js';
-/**
- * One loaded library's own error-code table, from `chs_error_codes` — obtained
- * from `Library#errorCodes()` and valid for that library's ClickHouse line
- * only. Immutable once built.
- *
- * Lookups answer only what the build's own table holds: an unknown code, a
- * negative code (the ABI's -1 and -2 sentinels included — they are not
- * ClickHouse codes) or an unknown name is `undefined`, never a synthesized
- * spelling. Names match exactly and case-sensitively, as the server prints
- * them.
- */
-export class ErrorCodeTable {
-    entries;
-    byCode;
-    byName;
-    /** @internal — obtained from `Library#errorCodes()`. */
-    constructor(entries) {
-        const byCode = new Map();
-        const byName = new Map();
-        const kept = [];
-        for (const e of entries) {
-            // Not a name, not a ClickHouse code, or a repeat: the first entry for a
-            // code or a name wins, and nothing else is invented.
-            if (e.name === '' || e.code < 0 || byCode.has(e.code) || byName.has(e.name))
-                continue;
-            byCode.set(e.code, e.name);
-            byName.set(e.name, e.code);
-            kept.push(Object.freeze({ code: e.code, name: e.name }));
-        }
-        kept.sort((a, b) => a.code - b.code);
-        this.entries = Object.freeze(kept);
-        this.byCode = byCode;
-        this.byName = byName;
-    }
-    /**
-     * The name this build gives `code`.
-     *
-     * @returns the name, or `undefined` for an unknown or negative code.
-     */
-    name(code) {
-        if (code < 0)
-            return undefined;
-        return this.byCode.get(code);
-    }
-    /**
-     * The code this build gives `name` — an exact, case-sensitive match.
-     *
-     * @returns the code, or `undefined` for an unknown name.
-     */
-    code(name) {
-        return this.byName.get(name);
-    }
-    /** Every entry, in ascending code order. */
-    all() {
-        return this.entries;
-    }
-    /** Iterates the entries in ascending code order, as `all()` returns them. */
-    [Symbol.iterator]() {
-        return this.entries[Symbol.iterator]();
-    }
-}
-function bad(why) {
-    return new ChtypesError(`chtypes: bad chs_error_codes document: ${why}`);
-}
-/**
- * Build a table from a `chs_error_codes` document,
- * `{"error_codes":[{"code":N,"name":"…"}, …]}`. Unknown keys are ignored and
- * an absent (or null) key is its default, like every document this ABI hands
- * back; a value of the wrong type is a bad document, never a guess.
- *
- * Not re-exported from the package: it is the parser `Library#errorCodes()`
- * runs, exported for this binding's own tests.
- */
-export function parseErrorCodes(doc) {
-    let parsed;
-    try {
-        parsed = JSON.parse(typeof doc === 'string' ? doc : doc.toString('utf8'));
-    }
-    catch (err) {
-        throw bad(err.message);
-    }
-    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
-        throw bad('not a JSON object');
-    const rows = parsed['error_codes'] ?? [];
-    if (!Array.isArray(rows))
-        throw bad('error_codes is not an array');
-    const entries = [];
-    for (const row of rows) {
-        if (row === null || typeof row !== 'object' || Array.isArray(row))
-            throw bad('an entry is not an object');
-        const code = row['code'] ?? 0;
-        const name = row['name'] ?? '';
-        if (typeof code !== 'number' || !Number.isInteger(code) || typeof name !== 'string') {
-            throw bad(`entry ${JSON.stringify(row)}`);
-        }
-        entries.push({ code, name });
-    }
-    return new ErrorCodeTable(entries);
-}
-/**
- * One library's table once it has been built, and only then. A `null` answer
- * from `chs_error_codes` is a guarded exception inside the library — transient
- * by definition — so it throws `ChtypesError` and is NOT remembered: the next
- * call asks again. A missing symbol throws the decline type and is not
- * remembered either.
- *
- * Not re-exported from the package: `Library` holds one, and this binding's
- * own tests drive it directly.
- */
-export class ErrorCodeCache {
-    table;
-    get(fetch) {
-        if (this.table !== undefined)
-            return this.table;
-        const doc = fetch();
-        if (doc === null) {
-            throw new ChtypesError('chtypes: chs_error_codes returned no document (a guarded exception inside the library); ' +
-                'nothing was cached, so the next call asks again');
-        }
-        const table = parseErrorCodes(doc);
-        this.table = table;
-        return table;
-    }
-}
-//# sourceMappingURL=error-codes.js.map

package/dist/error-codes.js.map

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

package/dist/errors.d.ts

@@ -1,284 +0,0 @@
-/**
- * The error model, which is three outcomes that must never be conflated
- * (the C ABI contract §Error model):
- *
- *   - ClickHouse rejects        -> a real ClickHouse error code
- *   - this build refuses        -> CODE_UNSUPPORTED (-2), never a ClickHouse code
- *   - ClickHouse accepts but the value cannot be read back -> usually code 691; it
- *     is an ACCEPTED insert, surfaced through the row outcome rather than here.
- *
- * Mapping `unsupported` onto a rejection manufactures an over-reject the product
- * never made; mapping it onto an acceptance manufactures an over-accept, which
- * is the cardinal sin. So it gets its own sentinel on the wire and, since
- * 2026-08-26, its own ERROR CLASS here — `UnsupportedError`, a peer of
- * `SchemaError` rather than a subclass, so that a `catch` which handles only
- * `SchemaError` cannot silently swallow a decline as a rejection.
- */
-/** "This build refuses to answer." Never a real ClickHouse error code. */
-export declare const CODE_UNSUPPORTED = -2;
-/**
- * The chs_* ABI revision this binding was written against — `CHS_ABI_REVISION`
- * in `include/chtypes.h`.
- *
- * This package dlopens artifacts rather than compiling against the header, so
- * this is a hand-kept mirror and MUST be bumped in the same cycle the header
- * is. A `Registry` refuses an artifact reporting a different nonzero revision;
- * 0 means the artifact predates the probe, which is ignorance rather than
- * incompatibility (docs/reference/artifact.md §Loading).
- *
- * Revision 3 (2026-08-31): `chs_rows` gained `export_format` / `doc_flags` /
- * `out_bytes`, and the `chs_filter_compile` / `chs_filter_free` /
- * `chs_filter_rows` trio joined the surface.
- *
- * Revision 4 (2026-08-31, the filter phase-2 cycle): `chs_filter_compile`
- * gained `params_json` (`{name:Type}` query parameters), and the block twin
- * joined — `chs_block_parse` / `chs_block_free` / `chs_filter_eval`.
- *
- * Revision 5 (2026-09-15, the explicit INSERT column list): `chs_row`,
- * `chs_rows` and `chs_block_parse` each gained a trailing `columns_json` —
- * `RowsOptions#columns`. This binding therefore speaks 5 and refuses
- * revision-4 artifacts — calling the 6-argument `chs_row` (or the
- * 9-argument `chs_rows`, or the 8-argument `chs_block_parse`) through a
- * revision-4 artifact's shorter declaration is undefined behavior, which is
- * exactly what the gate exists to prevent.
- *
- * Revision 6 (the error-code table and the partition key): `chs_error_codes`
- * and `chs_schema_partition_by` joined the surface. Purely additive, and still
- * a new number: this binding speaks 6 and refuses revision-5 artifacts.
- */
-export declare const ABI_REVISION = 6;
-/** Base class for everything this package throws. */
-export declare class ChtypesError extends Error {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/** A registry could not be loaded, or a version could not be resolved. */
-export declare class RegistryError extends ChtypesError {
-}
-/**
- * This artifact IMAGE is already initialized under a different timezone.
- *
- * `dlopen` maps one image per file, and `chs_init` runs at most once per
- * image, so a second load asking for another zone can be neither honored nor
- * silently ignored: re-running `chs_init` would move the zone under the first
- * load's live libraries. A hardlink or symlink to a loaded artifact is that
- * same image and is refused the same way.
- *
- * A `RegistryError`, because it is a reason the loader cannot serve this
- * request — so a `catch` written against `for()`'s documented `RegistryError`
- * keeps working — and matched with `instanceof InitConflictError`, like every
- * other class here. Not an `ArtifactError`: the artifact is fine, and none of
- * the shared fetch codes describes it.
- */
-export declare class InitConflictError extends RegistryError {
-    /** The artifact path this load asked for, as given. */
-    readonly path: string;
-    /** The timezone the image is live under. */
-    readonly have: string;
-    /** The timezone this load asked for, refused. */
-    readonly want: string;
-    constructor(path: string, have: string, want: string);
-}
-/**
- * A REFUSAL: ClickHouse itself refused a type, a column list, an engine or a
- * TTL.
- *
- * `code` is ALWAYS a real ClickHouse error code. "This build declines to
- * answer" is a DIFFERENT CLASS — `UnsupportedError` — never this one carrying
- * a sentinel, so no `SchemaError` ever holds `CODE_UNSUPPORTED`
- * (docs/reference/bindings.md rule 12).
- */
-export declare class SchemaError extends ChtypesError {
-    readonly code: number;
-    readonly detail: string;
-    readonly column: string | undefined;
-    constructor(code: number, detail: string, column?: string);
-}
-/**
- * A DECLINE: "a real server might well have accepted this; I will not guess."
- * Never ClickHouse rejecting anything, so it carries no `code` property at all
- * — there is no code to carry.
- *
- * It is a PEER of `SchemaError`, deliberately NOT a subclass and deliberately
- * NOT matched by `err instanceof SchemaError`. A decline that still satisfied
- * "is a SchemaError" would be the sentinel problem wearing a class hierarchy:
- * every `catch` that forgot the predicate would keep silently turning declines
- * into rejections, which is a manufactured over-reject — data loss the product
- * never made, budgeted at zero. As a peer, forgetting throws on past the
- * handler, which is loud.
- *
- * ```ts
- * try {
- *   schema.setEngine(engine, orderBy);
- * } catch (err) {
- *   // validate cautiously; do NOT blame the tenant
- *   if (err instanceof UnsupportedError) return degradeToCarefulPath(err);
- *   // ClickHouse refused: err.code is its own code
- *   if (err instanceof SchemaError) return rejectWith(err.code, err.detail);
- *   throw err;
- * }
- * ```
- *
- * The MESSAGE still renders the ABI's `CODE_UNSUPPORTED` sentinel in the shape
- * `SchemaError` renders its code. The sentinel is not a property of this class
- * — it is the wire value the C ABI returned — but the rendering is frozen: the
- * conformance driver puts this exact string on the protocol wire as an
- * `unsupported` scope, and Python's `UnsupportedError` already spells it this
- * way. Changing the text would move rig records without changing a verdict.
- */
-export declare class UnsupportedError extends ChtypesError {
-    readonly detail: string;
-    readonly column: string | undefined;
-    constructor(detail: string, column?: string);
-}
-/**
- * The ONE place an ABI error code becomes an error object, so the
- * refusal/decline split cannot be decided differently in two files.
- *
- * The SIGN decides (docs/reference/bindings.md rule 12, the C ABI contract §Error model): a
- * positive code is the server's own refusal and rides through verbatim; any
- * negative code is this library declining (`-2` "I will not guess", `-1` a
- * guarded exception, and a binding's own missing-symbol sentinel) and becomes
- * an `UnsupportedError`. Keying on the sign rather than on `=== CODE_UNSUPPORTED`
- * means a negative sentinel a later era adds can never become "a SchemaError
- * with a negative code", which the class's own contract forbids.
- *
- * Internal: not re-exported from the package index.
- */
-export declare function schemaErrorFor(code: number, detail: string, column?: string): SchemaError | UnsupportedError;
-/**
- * The codes docs/guides/fetch.md §6 shares across every SDK, as named constants.
- *
- * Each error below carries its own `code`, and a caller matches on it. Naming
- * them here is what lets that caller write `err.code === CODE_ARTIFACT_PINNED`
- * instead of retyping the string — which is exactly why the Go, Python and Rust
- * bindings all export them, and why this one already exported
- * `CODE_UNSUPPORTED`. A typo in a hand-written literal is a comparison that is
- * silently always false.
- */
-export declare const CODE_ARTIFACT_MISSING = "CHTYPES_ARTIFACT_MISSING";
-/** docs/guides/fetch.md §6: the signature did not verify against the trust list. */
-export declare const CODE_ARTIFACT_UNTRUSTED = "CHTYPES_ARTIFACT_UNTRUSTED";
-/** docs/guides/fetch.md §6: a hash mismatch, or a release that disagrees with itself. */
-export declare const CODE_ARTIFACT_CORRUPT = "CHTYPES_ARTIFACT_CORRUPT";
-/** docs/guides/fetch.md §6: `--frozen` refused an asset the lock file does not pin. */
-export declare const CODE_ARTIFACT_PINNED = "CHTYPES_ARTIFACT_PINNED";
-/** docs/guides/fetch.md §6: the release offers nothing for this platform or line. */
-export declare const CODE_ARTIFACT_UNPUBLISHED = "CHTYPES_ARTIFACT_UNPUBLISHED";
-/** docs/guides/fetch.md §6: the source could not be reached or does not serve the release. */
-export declare const CODE_SOURCE_UNREACHABLE = "CHTYPES_SOURCE_UNREACHABLE";
-/** The codes docs/guides/fetch.md §7 shares across every SDK. */
-export type ArtifactErrorCode = typeof CODE_ARTIFACT_MISSING | typeof CODE_ARTIFACT_UNTRUSTED | typeof CODE_ARTIFACT_CORRUPT | typeof CODE_ARTIFACT_PINNED | typeof CODE_ARTIFACT_UNPUBLISHED | typeof CODE_SOURCE_UNREACHABLE;
-/**
- * The single catchable type for every artifact-loading condition: a missing
- * artifact (`ArtifactMissingError`) or one of the five fetch/verify verdicts
- * (`FetchError`'s subclasses) — the six conditions docs/guides/fetch.md §3, §5
- * and §7 name. A caller that wants "the loader could not produce a usable
- * artifact" now catches exactly this one class, matching Python's
- * `ArtifactError`, Go's `*ArtifactError` (`.Code`), and Rust's
- * `Error::artifact_code()` (chtypes-sdk#13 A3, aligned 2026-09-15) — before
- * this, `ArtifactMissingError` was a `RegistryError` while the other five
- * were unrelated `FetchError`s, and a caller had to catch both types to
- * cover all six conditions.
- *
- * A `RegistryError`, because every one of these is a reason the loader could
- * not serve a version — `catch`es written against the pre-existing
- * `RegistryError` contract keep working unchanged.
- */
-export declare abstract class ArtifactError extends RegistryError {
-    abstract readonly code: ArtifactErrorCode;
-}
-/** The command this SDK's §7 message tells a user to run. */
-export declare const FETCH_COMMAND = "npx @wavehouse/chtypes fetch";
-/**
- * The §7 message, verbatim apart from the bracketed parts:
- *
- *     chtypes: no artifact for ClickHouse <line> (<os>-<arch>). Looked in: <dir1>, <dir2>, ….
- *     Install it:  npx @wavehouse/chtypes fetch <line>
- *     or set CHTYPES_AUTOFETCH=1 to fetch on first use.
- */
-export declare function artifactMissingMessage(line: string, platform: string, lookedIn: readonly string[]): string;
-/**
- * The one identifiable error for a missing artifact (docs/guides/fetch.md §7):
- * a `Registry` was asked for a line that no directory on its search path
- * holds. `code` is `'CHTYPES_ARTIFACT_MISSING'`; the message is the
- * contract's, and names every directory that was looked in and the command
- * that installs the line.
- *
- * A subclass of `ArtifactError` (itself a `RegistryError`), so a `catch`
- * written against `for()`'s documented `RegistryError`, or against the
- * single catchable `ArtifactError`, both keep working; the `code` is what a
- * caller matches on.
- */
-export declare class ArtifactMissingError extends ArtifactError {
-    readonly code: 'CHTYPES_ARTIFACT_MISSING';
-    /** The minor line that was asked for, e.g. `25.8`. */
-    readonly line: string;
-    /** The platform key the registry serves, e.g. `darwin-arm64`. */
-    readonly platform: string;
-    /** Every directory of the search path, in order. */
-    readonly lookedIn: readonly string[];
-    constructor(line: string, platform: string, lookedIn: readonly string[]);
-}
-/**
- * Base of the fetch-time verdicts (docs/guides/fetch.md §3–§7). `code` is one of the
- * shared codes; the subclasses exist so `instanceof` reads as well as `code`.
- *
- * An `ArtifactError`, alongside `ArtifactMissingError` — so `catch (err) { if
- * (err instanceof ArtifactError) … }` handles all six artifact conditions in
- * one arm, while `instanceof FetchError` still isolates these five verdicts
- * from a missing artifact when that distinction matters.
- */
-export declare class FetchError extends ArtifactError {
-    readonly code: Exclude<ArtifactErrorCode, 'CHTYPES_ARTIFACT_MISSING'>;
-    constructor(code: Exclude<ArtifactErrorCode, 'CHTYPES_ARTIFACT_MISSING'>, message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * `CHTYPES_ARTIFACT_UNTRUSTED`: the release's `SHA256SUMS.sig` is absent,
- * malformed, or does not verify with any trusted key. Nothing is downloaded
- * around it (§3 step 0).
- */
-export declare class ArtifactUntrustedError extends FetchError {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * `CHTYPES_ARTIFACT_CORRUPT`: any hash mismatch along the chain, a release
- * that disagrees with itself (`index.json` vs `SHA256SUMS`, manifest vs
- * index), or an archive that cannot be read safely.
- */
-export declare class ArtifactCorruptError extends FetchError {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * `CHTYPES_ARTIFACT_PINNED`: a `--frozen` lock file names a different asset
- * or sha256 for this line — or none at all — and the fetch refused it (§5).
- */
-export declare class ArtifactPinnedError extends FetchError {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/** `CHTYPES_ARTIFACT_UNPUBLISHED`: the release has nothing for this platform, line or exact patch. */
-export declare class ArtifactUnpublishedError extends FetchError {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * `CHTYPES_SOURCE_UNREACHABLE`: the source could not be reached or does not
- * serve the release files — or `offline` forbade reaching it and the line is
- * not installed and verified.
- */
-export declare class SourceUnreachableError extends FetchError {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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