@wavehouse/chtypes 0.5.2 → 1.0.2

package/dist/documents.d.ts

@@ -0,0 +1,195 @@
+/**
+ * The result types and their decoders (`docs/reference/bindings-v1.md` §5).
+ *
+ * Every field below is a field of the document the library returned, or the
+ * bytes of an output buffer; nothing is computed here. The rules every
+ * decoder follows:
+ *
+ *   1. Stock JSON only: `JSON.parse`, after a scan that refuses a duplicate
+ *      key (`./abi1/strictjson.ts`). A duplicate key, a document that is not
+ *      JSON, or a value of the wrong JSON type is an `InternalError` naming the
+ *      document and the key.
+ *   2. Absent is the default, and an unknown key is ignored.
+ *   3. Names, and every data-derived string (a rendering, a type, SQL, a
+ *      message, a partition, a setting name), are BYTES. A document carries one
+ *      as `<key>` (a JSON string, when the bytes are valid UTF-8) or as
+ *      `<key>_b64` (standard base64 of the raw bytes, otherwise), and the
+ *      decoder surfaces a `Buffer` either way. Both present is an
+ *      `InternalError`; for a name, neither present is too. A list of names
+ *      (`unknown_fields`, `unsupported_settings`, header names) holds `{name}`
+ *      or `{name_b64}` objects, never a bare string. `value_b64` is a scalar
+ *      String or FixedString value's raw bytes (rule 6), surfaced as `value`.
+ *   4. A vocabulary fact (`Transform.lossy`, `Value.isStored`, a verdict's
+ *      `answered`) is read from the generated vocabulary table, never from a
+ *      list kept here.
+ *   5. Unknown is never false and never empty: `framing.bomSkipped` and
+ *      `framing.header` are `null` when the document says `null`.
+ */
+import { type DefaultKind, type FilterOutcome, type Outcome, type Verdict } from './abi1/index.js';
+/** The byte range of the input body a record occupies: `off` and `len`. */
+export interface Span {
+    readonly off: number;
+    readonly len: number;
+}
+/** One column of a row result: ClickHouse's own rendering of one value, with its provenance. */
+export interface Value {
+    /** The column's name, as raw bytes. */
+    readonly column: Buffer;
+    /** ClickHouse's rendering of the stored value, verbatim, as bytes. */
+    readonly text: Buffer;
+    /** Whether the stored value is NULL: the library decides it, poisoned cells included. */
+    readonly null: boolean;
+    /** Where the value came from: a `Source` value. */
+    readonly source: string;
+    /** Whether a value of this `source` is stored: the description's own fact for it. */
+    readonly isStored: boolean;
+    /** The raw bytes of a scalar String or FixedString value (rule 6), when the document carries them. */
+    readonly value: Buffer | undefined;
+}
+/** One cell of an engine row: ClickHouse's rendering of a stored value after the engine's insert-time merge. */
+export interface EngineCell {
+    readonly column: Buffer;
+    readonly text: Buffer;
+    readonly null: boolean;
+    /** The raw bytes of a scalar String or FixedString value (rule 6), when the document carries them. */
+    readonly value: Buffer | undefined;
+}
+/** A silent change: what the input said, what is stored, and why. */
+export interface Transform {
+    readonly column: Buffer;
+    readonly input: Buffer;
+    readonly stored: Buffer;
+    /** A `Reason` value. */
+    readonly reason: string;
+    /** Whether this reason loses information: the description's own fact for it. */
+    readonly lossy: boolean;
+    /** The row's index in the body; 0 in a single-row result. */
+    readonly row: number;
+}
+/** A column the library computed from a DEFAULT or MATERIALIZED expression. */
+export interface Computed {
+    readonly column: Buffer;
+    readonly kind: string;
+    readonly text: Buffer;
+    /** The raw bytes of a scalar String or FixedString value (rule 6), when the document carries them. */
+    readonly value: Buffer | undefined;
+}
+export interface RowResult {
+    readonly outcome: Outcome;
+    readonly errCode: number;
+    readonly errMsg: Buffer;
+    /** Every entry of `cols`, in document order. */
+    readonly columns: readonly Value[];
+    /** The entries of `columns` whose source is stored, in order. */
+    readonly values: readonly Value[];
+    readonly transformed: readonly Transform[];
+    readonly unknownFields: readonly Buffer[];
+    readonly unsupportedSettings: readonly Buffer[];
+    readonly computed: readonly Computed[];
+    /** Present only with an attached filter. */
+    readonly verdict: Verdict | undefined;
+    readonly verdictCode: number;
+    readonly verdictErr: Buffer;
+    readonly partitionId: Buffer | undefined;
+    /** The bytes the reader consumed for this record. */
+    readonly inputSpan: Span | undefined;
+}
+export interface Header {
+    readonly consumed: boolean;
+    readonly lines: number;
+    readonly names: readonly Buffer[];
+}
+/** What the reader decided about the body's framing. `bomSkipped` and `header` are `null` where the reader does not expose the fact: unknown, never false and never empty. */
+export interface Framing {
+    readonly bomSkipped: boolean | null;
+    /** `array`, `stream`, or `null` for none. */
+    readonly container: string | null;
+    readonly header: Header | null;
+}
+export interface BatchResult {
+    readonly outcome: Outcome;
+    readonly errCode: number;
+    readonly errMsg: Buffer;
+    readonly rows: readonly RowResult[];
+    readonly rowsRead: number;
+    readonly rowsSkipped: number;
+    /** Every transform in the batch, with its `row`, as the library lists them. */
+    readonly transformed: readonly Transform[];
+    /** Each stored row after the engine's insert-time merge, as a list of cells. */
+    readonly engineRows: readonly (readonly EngineCell[])[] | undefined;
+    /** The export buffer, present only when an export was asked for. */
+    readonly payload: Buffer | undefined;
+    /** Each exported row's place in `payload`. */
+    readonly spans: readonly Span[] | undefined;
+    /** Why an asked-for export was declined, as bytes (`export_declined` or `export_declined_b64`); empty when none was. */
+    readonly exportDeclined: Buffer;
+    readonly rowsPassed: number;
+    readonly rowsCut: number;
+    readonly partitionCount: number | undefined;
+    /** The byte ranges the reader's error recovery skipped. */
+    readonly unconsumed: readonly Span[];
+    readonly framing: Framing | undefined;
+}
+export interface FilterRowError {
+    readonly row: number;
+    readonly code: number;
+    readonly msg: Buffer;
+}
+export interface FilterResult {
+    readonly outcome: FilterOutcome;
+    readonly errCode: number;
+    readonly errMsg: Buffer;
+    readonly rowsRead: number;
+    readonly unsupportedSettings: readonly Buffer[];
+    /** One verdict per row, each read through the generated table. `error` and `decline` are never answers. */
+    readonly verdicts: readonly Verdict[];
+    readonly errors: readonly FilterRowError[];
+}
+export interface Column {
+    readonly name: Buffer;
+    /** The canonical type. */
+    readonly type: Buffer;
+    readonly defaultKind: DefaultKind;
+    readonly defaultExpr: Buffer;
+}
+export interface SchemaDescription {
+    readonly columns: readonly Column[];
+}
+export interface DiscoveredColumn {
+    readonly name: Buffer;
+    /** The column declaration as ClickHouse's own formatter writes it. */
+    readonly declaration: Buffer;
+}
+export interface Discovery {
+    readonly columns: readonly DiscoveredColumn[];
+    /** The declarations joined for a `CREATE TABLE`. */
+    readonly columnsSql: Buffer;
+}
+export interface ErrorCodeEntry {
+    readonly code: number;
+    readonly name: string;
+}
+/** This build's own error-code table: lookups are map reads over the library's own entries. An unknown code or name is absent, never synthesized; names match exactly. */
+export declare class ErrorCodeTable implements Iterable<ErrorCodeEntry> {
+    #private;
+    constructor(entries: readonly ErrorCodeEntry[]);
+    name(code: number): string | undefined;
+    code(name: string): number | undefined;
+    all(): readonly ErrorCodeEntry[];
+    [Symbol.iterator](): Iterator<ErrorCodeEntry>;
+}
+/** Decode a `row` document. */
+export declare function decodeRow(bytes: Uint8Array): RowResult;
+/** Decode a `batch` document and the export buffer, when an export was asked for. */
+export declare function decodeBatch(bytes: Uint8Array, payload: Buffer | undefined): BatchResult;
+/** Decode a `filter_result` document. */
+export declare function decodeFilterResult(bytes: Uint8Array): FilterResult;
+/** Decode a `schema_description` document. */
+export declare function decodeSchemaDescription(bytes: Uint8Array): SchemaDescription;
+/** Decode a `discovery` document. */
+export declare function decodeDiscovery(bytes: Uint8Array): Discovery;
+/** Decode an `error_code_table` document: a JSON array of `{code, name}`. */
+export declare function decodeErrorCodes(bytes: Uint8Array): ErrorCodeTable;
+/** Decode a `live_handles` document: handle kind to live count. */
+export declare function decodeLiveHandles(bytes: Uint8Array): Readonly<Record<string, number>>;
+//# sourceMappingURL=documents.d.ts.map

package/dist/documents.d.ts.map

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

package/dist/documents.js

@@ -0,0 +1,389 @@
+/**
+ * The result types and their decoders (`docs/reference/bindings-v1.md` §5).
+ *
+ * Every field below is a field of the document the library returned, or the
+ * bytes of an output buffer; nothing is computed here. The rules every
+ * decoder follows:
+ *
+ *   1. Stock JSON only: `JSON.parse`, after a scan that refuses a duplicate
+ *      key (`./abi1/strictjson.ts`). A duplicate key, a document that is not
+ *      JSON, or a value of the wrong JSON type is an `InternalError` naming the
+ *      document and the key.
+ *   2. Absent is the default, and an unknown key is ignored.
+ *   3. Names, and every data-derived string (a rendering, a type, SQL, a
+ *      message, a partition, a setting name), are BYTES. A document carries one
+ *      as `<key>` (a JSON string, when the bytes are valid UTF-8) or as
+ *      `<key>_b64` (standard base64 of the raw bytes, otherwise), and the
+ *      decoder surfaces a `Buffer` either way. Both present is an
+ *      `InternalError`; for a name, neither present is too. A list of names
+ *      (`unknown_fields`, `unsupported_settings`, header names) holds `{name}`
+ *      or `{name_b64}` objects, never a bare string. `value_b64` is a scalar
+ *      String or FixedString value's raw bytes (rule 6), surfaced as `value`.
+ *   4. A vocabulary fact (`Transform.lossy`, `Value.isStored`, a verdict's
+ *      `answered`) is read from the generated vocabulary table, never from a
+ *      list kept here.
+ *   5. Unknown is never false and never empty: `framing.bomSkipped` and
+ *      `framing.header` are `null` when the document says `null`.
+ */
+import { batchOutcomeOf, defaultKindOf, filterOutcomeOf, outcomeOf, reasonLossy, sourceIsStored, verdictOf, } from './abi1/index.js';
+import { internalError, parseStrictJson } from './abi1/index.js';
+/** This build's own error-code table: lookups are map reads over the library's own entries. An unknown code or name is absent, never synthesized; names match exactly. */
+export class ErrorCodeTable {
+    #entries;
+    #byCode;
+    #byName;
+    constructor(entries) {
+        this.#entries = entries;
+        this.#byCode = new Map();
+        this.#byName = new Map();
+        for (const e of entries) {
+            if (!this.#byCode.has(e.code))
+                this.#byCode.set(e.code, e.name);
+            if (!this.#byName.has(e.name))
+                this.#byName.set(e.name, e.code);
+        }
+    }
+    name(code) {
+        return this.#byCode.get(code);
+    }
+    code(name) {
+        return this.#byName.get(name);
+    }
+    all() {
+        return this.#entries;
+    }
+    [Symbol.iterator]() {
+        return this.#entries[Symbol.iterator]();
+    }
+}
+// ----------------------------------------------------------- field readers
+const EMPTY = Buffer.alloc(0);
+function kindOf(v) {
+    return v === null ? 'null' : Array.isArray(v) ? 'array' : typeof v;
+}
+function bad(doc, key, want, got) {
+    throw internalError(`the ${doc} document: ${key}: want ${want}, got ${kindOf(got)}`);
+}
+/** Parse one document: stock JSON after the duplicate-key scan; any failure is an `InternalError` naming the document. */
+function parseDoc(doc, bytes) {
+    const text = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString('utf8');
+    try {
+        return parseStrictJson(text);
+    }
+    catch (err) {
+        throw internalError(`the ${doc} document does not decode: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function asObject(doc, key, v) {
+    if (typeof v !== 'object' || v === null || Array.isArray(v))
+        bad(doc, key, 'an object', v);
+    return v;
+}
+function asArray(doc, key, v) {
+    if (!Array.isArray(v))
+        bad(doc, key, 'an array', v);
+    return v;
+}
+function listOf(doc, o, key) {
+    const v = o[key];
+    return v === undefined ? [] : asArray(doc, key, v);
+}
+function strOr(doc, o, key, dflt) {
+    const v = o[key];
+    if (v === undefined)
+        return dflt;
+    if (typeof v !== 'string')
+        bad(doc, key, 'a string', v);
+    return v;
+}
+function optStr(doc, o, key) {
+    const v = o[key];
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== 'string')
+        bad(doc, key, 'a string', v);
+    return v;
+}
+function boolOr(doc, o, key, dflt) {
+    const v = o[key];
+    if (v === undefined)
+        return dflt;
+    if (typeof v !== 'boolean')
+        bad(doc, key, 'a boolean', v);
+    return v;
+}
+/** An integer: a JSON number, or a decimal string where the document spells a value beyond 2^53 that way. Beyond what a JS number holds exactly is an `InternalError`, never a rounded value. */
+function intOf(doc, key, v) {
+    if (typeof v === 'number') {
+        if (!Number.isSafeInteger(v))
+            bad(doc, key, 'a safe integer', v);
+        return v;
+    }
+    if (typeof v === 'string' && /^-?[0-9]+$/.test(v)) {
+        const n = Number(v);
+        if (Number.isSafeInteger(n))
+            return n;
+        throw internalError(`the ${doc} document: ${key}: ${v} is beyond 2^53 and this binding's number type cannot hold it exactly`);
+    }
+    return bad(doc, key, 'an integer', v);
+}
+function intOr(doc, o, key, dflt) {
+    const v = o[key];
+    return v === undefined ? dflt : intOf(doc, key, v);
+}
+function optInt(doc, o, key) {
+    const v = o[key];
+    return v === undefined || v === null ? undefined : intOf(doc, key, v);
+}
+function decodeB64(doc, key, text) {
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(text) || text.length % 4 !== 0)
+        bad(doc, key, 'standard base64', text);
+    return Buffer.from(text, 'base64');
+}
+/** A byte-string field: `<key>` as UTF-8 text or `<key>_b64` as base64, never both. Neither reads as `undefined`. */
+function bytesField(doc, o, key) {
+    const plain = o[key];
+    const b64 = o[`${key}_b64`];
+    if (plain !== undefined && b64 !== undefined) {
+        throw internalError(`the ${doc} document: ${key} and ${key}_b64 are both present`);
+    }
+    if (plain !== undefined) {
+        if (typeof plain !== 'string')
+            bad(doc, key, 'a string', plain);
+        return Buffer.from(plain, 'utf8');
+    }
+    if (b64 !== undefined) {
+        if (typeof b64 !== 'string')
+            bad(doc, `${key}_b64`, 'a string', b64);
+        return decodeB64(doc, `${key}_b64`, b64);
+    }
+    return undefined;
+}
+function bytesOr(doc, o, key) {
+    return bytesField(doc, o, key) ?? EMPTY;
+}
+/** A name: exactly one of `<key>` and `<key>_b64`. */
+function nameOf(doc, o, key) {
+    const b = bytesField(doc, o, key);
+    if (b === undefined)
+        throw internalError(`the ${doc} document: neither ${key} nor ${key}_b64 is present`);
+    return b;
+}
+/** A list of names: each element an object carrying exactly one of `name` and `name_b64`. A bare string is an `InternalError`. */
+function bytesListOf(doc, o, key) {
+    return listOf(doc, o, key).map((e) => nameOf(doc, asObject(doc, `${key}[]`, e), 'name'));
+}
+/** One cell of an engine row. */
+function engineCellOf(doc, v) {
+    const o = asObject(doc, 'engine_rows[][]', v);
+    const nullFlag = o.null;
+    if (typeof nullFlag !== 'boolean')
+        bad(doc, 'engine_rows[][].null', 'a boolean', nullFlag);
+    return { column: nameOf(doc, o, 'name'), text: bytesOr(doc, o, 'stored'), null: nullFlag, value: bytesField(doc, o, 'value') };
+}
+function spanOf(doc, key, v) {
+    const o = asObject(doc, key, v);
+    return { off: intOf(doc, `${key}.off`, o.off), len: intOf(doc, `${key}.len`, o.len) };
+}
+// ------------------------------------------------------------- the row
+function decodeValue(doc, v) {
+    const o = asObject(doc, 'cols[]', v);
+    const source = strOr(doc, o, 'src', '');
+    const isStored = sourceIsStored(source);
+    if (isStored === undefined)
+        throw internalError(`the ${doc} document: cols[].src: ${JSON.stringify(source)} is not a value of the source vocabulary`);
+    const nullFlag = o.null;
+    if (typeof nullFlag !== 'boolean')
+        bad(doc, 'cols[].null', 'a boolean', nullFlag);
+    return {
+        column: nameOf(doc, o, 'name'),
+        text: bytesOr(doc, o, 'stored'),
+        null: nullFlag,
+        source,
+        isStored,
+        value: bytesField(doc, o, 'value'),
+    };
+}
+function transformOf(doc, v) {
+    const o = asObject(doc, 'transformed[]', v);
+    const reason = strOr(doc, o, 'reason', '');
+    const lossy = reasonLossy(reason);
+    if (lossy === undefined)
+        throw internalError(`the ${doc} document: transformed[].reason: ${JSON.stringify(reason)} has no lossy fact`);
+    return {
+        column: nameOf(doc, o, 'column'),
+        input: bytesOr(doc, o, 'input'),
+        stored: bytesOr(doc, o, 'stored'),
+        reason,
+        lossy,
+        row: intOr(doc, o, 'row', 0),
+    };
+}
+function computedOf(doc, v) {
+    const o = asObject(doc, 'computed[]', v);
+    return { column: nameOf(doc, o, 'name'), kind: strOr(doc, o, 'kind', ''), text: bytesOr(doc, o, 'stored'), value: bytesField(doc, o, 'value') };
+}
+function rowOf(doc, o) {
+    const rawOutcome = strOr(doc, o, 'outcome', '');
+    const outcome = outcomeOf(rawOutcome);
+    if (outcome === undefined)
+        throw internalError(`the ${doc} document: outcome: ${JSON.stringify(rawOutcome)} is not an outcome`);
+    const columns = listOf(doc, o, 'cols').map((c) => decodeValue(doc, c));
+    const verdictRaw = optStr(doc, o, 'verdict');
+    const verdict = verdictRaw === undefined ? undefined : verdictOf(verdictRaw);
+    const spanRaw = o.input_span;
+    const partitionId = bytesField(doc, o, 'partition_id');
+    return {
+        outcome,
+        errCode: intOr(doc, o, 'code', 0),
+        errMsg: bytesOr(doc, o, 'err'),
+        columns,
+        values: columns.filter((c) => c.isStored),
+        transformed: listOf(doc, o, 'transformed').map((t) => transformOf(doc, t)),
+        unknownFields: bytesListOf(doc, o, 'unknown_fields'),
+        unsupportedSettings: bytesListOf(doc, o, 'unsupported_settings'),
+        computed: listOf(doc, o, 'computed').map((c) => computedOf(doc, c)),
+        verdict,
+        verdictCode: intOr(doc, o, 'verdict_code', 0),
+        verdictErr: bytesOr(doc, o, 'verdict_err'),
+        partitionId,
+        inputSpan: spanRaw === undefined ? undefined : spanOf(doc, 'input_span', spanRaw),
+    };
+}
+/** Decode a `row` document. */
+export function decodeRow(bytes) {
+    return rowOf('row', asObject('row', '$', parseDoc('row', bytes)));
+}
+// ----------------------------------------------------------- the batch
+function headerOf(doc, v) {
+    if (v === null)
+        return null;
+    const o = asObject(doc, 'framing.header', v);
+    return { consumed: boolOr(doc, o, 'consumed', false), lines: intOr(doc, o, 'lines', 0), names: bytesListOf(doc, o, 'names') };
+}
+function framingOf(doc, v) {
+    const o = asObject(doc, 'framing', v);
+    const bom = o.bom_skipped;
+    if (bom !== undefined && bom !== null && typeof bom !== 'boolean')
+        bad(doc, 'framing.bom_skipped', 'a boolean or null', bom);
+    const container = o.container;
+    if (container !== undefined && container !== null && typeof container !== 'string') {
+        bad(doc, 'framing.container', 'a string or null', container);
+    }
+    return {
+        bomSkipped: bom ?? null,
+        container: container ?? null,
+        header: o.header === undefined ? null : headerOf(doc, o.header),
+    };
+}
+/** Decode a `batch` document and the export buffer, when an export was asked for. */
+export function decodeBatch(bytes, payload) {
+    const doc = 'batch';
+    const o = asObject(doc, '$', parseDoc(doc, bytes));
+    const rawOutcome = strOr(doc, o, 'outcome', '');
+    const outcome = batchOutcomeOf(rawOutcome);
+    if (outcome === undefined)
+        throw internalError(`the ${doc} document: outcome: ${JSON.stringify(rawOutcome)} is not an outcome`);
+    const spansRaw = o.row_spans;
+    const engineRaw = o.engine_rows;
+    return {
+        outcome,
+        errCode: intOr(doc, o, 'code', 0),
+        errMsg: bytesOr(doc, o, 'err'),
+        rows: listOf(doc, o, 'rows').map((r) => rowOf(doc, asObject(doc, 'rows[]', r))),
+        rowsRead: intOr(doc, o, 'rows_read', 0),
+        rowsSkipped: intOr(doc, o, 'rows_skipped', 0),
+        transformed: listOf(doc, o, 'transformed').map((t) => transformOf(doc, t)),
+        engineRows: engineRaw === undefined
+            ? undefined
+            : asArray(doc, 'engine_rows', engineRaw).map((row) => asArray(doc, 'engine_rows[]', row).map((c) => engineCellOf(doc, c))),
+        payload,
+        spans: spansRaw === undefined ? undefined : asArray(doc, 'row_spans', spansRaw).map((s) => spanOf(doc, 'row_spans[]', s)),
+        exportDeclined: bytesOr(doc, o, 'export_declined'),
+        rowsPassed: intOr(doc, o, 'rows_passed', 0),
+        rowsCut: intOr(doc, o, 'rows_cut', 0),
+        partitionCount: optInt(doc, o, 'partition_count'),
+        unconsumed: listOf(doc, o, 'unconsumed').map((s) => spanOf(doc, 'unconsumed[]', s)),
+        framing: o.framing === undefined ? undefined : framingOf(doc, o.framing),
+    };
+}
+// ----------------------------------------------------------- the filter
+/** Decode a `filter_result` document. */
+export function decodeFilterResult(bytes) {
+    const doc = 'filter_result';
+    const o = asObject(doc, '$', parseDoc(doc, bytes));
+    const rawOutcome = strOr(doc, o, 'outcome', '');
+    const outcome = filterOutcomeOf(rawOutcome);
+    if (outcome === undefined)
+        throw internalError(`the ${doc} document: outcome: ${JSON.stringify(rawOutcome)} is not an outcome`);
+    const verdicts = [];
+    for (const ch of strOr(doc, o, 'verdicts', '')) {
+        const v = verdictOf(ch);
+        if (v === undefined)
+            throw internalError(`the ${doc} document: verdicts: ${JSON.stringify(ch)} is not a verdict`);
+        verdicts.push(v);
+    }
+    return {
+        outcome,
+        errCode: intOr(doc, o, 'code', 0),
+        errMsg: bytesOr(doc, o, 'err'),
+        rowsRead: intOr(doc, o, 'rows_read', 0),
+        unsupportedSettings: bytesListOf(doc, o, 'unsupported_settings'),
+        verdicts,
+        errors: listOf(doc, o, 'errors').map((e) => {
+            const eo = asObject(doc, 'errors[]', e);
+            return { row: intOr(doc, eo, 'row', 0), code: intOr(doc, eo, 'code', 0), msg: bytesOr(doc, eo, 'err') };
+        }),
+    };
+}
+// --------------------------------------------- schema, discovery, tables
+/** Decode a `schema_description` document. */
+export function decodeSchemaDescription(bytes) {
+    const doc = 'schema_description';
+    const o = asObject(doc, '$', parseDoc(doc, bytes));
+    return {
+        columns: listOf(doc, o, 'columns').map((c) => {
+            const co = asObject(doc, 'columns[]', c);
+            const kindRaw = strOr(doc, co, 'default_kind', '');
+            const defaultKind = defaultKindOf(kindRaw);
+            if (defaultKind === undefined) {
+                throw internalError(`the ${doc} document: columns[].default_kind: ${JSON.stringify(kindRaw)} is not a default kind`);
+            }
+            return { name: nameOf(doc, co, 'name'), type: bytesOr(doc, co, 'type'), defaultKind, defaultExpr: bytesOr(doc, co, 'default_expression') };
+        }),
+    };
+}
+/** Decode a `discovery` document. */
+export function decodeDiscovery(bytes) {
+    const doc = 'discovery';
+    const o = asObject(doc, '$', parseDoc(doc, bytes));
+    return {
+        columns: listOf(doc, o, 'columns').map((c) => {
+            const co = asObject(doc, 'columns[]', c);
+            return { name: nameOf(doc, co, 'name'), declaration: bytesOr(doc, co, 'declaration') };
+        }),
+        columnsSql: bytesOr(doc, o, 'columns_sql'),
+    };
+}
+/** Decode an `error_code_table` document: a JSON array of `{code, name}`. */
+export function decodeErrorCodes(bytes) {
+    const doc = 'error_code_table';
+    const entries = asArray(doc, '$', parseDoc(doc, bytes)).map((e) => {
+        const eo = asObject(doc, '[]', e);
+        const name = eo.name;
+        if (typeof name !== 'string')
+            bad(doc, '[].name', 'a string', name);
+        return { code: intOf(doc, '[].code', eo.code), name };
+    });
+    return new ErrorCodeTable(entries);
+}
+/** Decode a `live_handles` document: handle kind to live count. */
+export function decodeLiveHandles(bytes) {
+    const doc = 'live_handles';
+    const o = asObject(doc, '$', parseDoc(doc, bytes));
+    const out = {};
+    for (const [k, v] of Object.entries(o))
+        out[k] = intOf(doc, k, v);
+    return out;
+}
+//# sourceMappingURL=documents.js.map

package/dist/documents.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The fetch layer's environment (`docs/guides/fetch-v1.md` §2 and §4): the
+ * variables that configure a fetch without code. `CHTYPES_ARTIFACTS_URL` and
+ * `CHTYPES_CACHE` are read by the fetch layer itself; the rest are read here,
+ * once, and an option the caller passed always wins over its variable.
+ *
+ *   CHTYPES_DOWNLOAD_TOKEN   `token`
+ *   CHTYPES_TRUSTED_KEYS     `trustedKeys`: comma-separated raw ed25519 keys, 64 hex characters each; REPLACES the default list
+ *   CHTYPES_ALLOW_UNSIGNED   `allowUnsigned`: `1`, `true`, `yes` or `on`
+ *   CHTYPES_TARGET           `platform`: one of the three platform keys
+ *   CHTYPES_REGISTRY         retired: one warning, otherwise ignored
+ */
+import { type FetchV1Options } from './ocifetch/index.js';
+/** Fills each option the caller left unset from its environment variable. Pure over `process.env`, except the one retired-variable warning. */
+export declare function withEnvironment<T extends FetchV1Options>(options: T): T;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,OAAO,EAAE,KAAK,cAAc,EAAiD,MAAM,qBAAqB,CAAC;AAUzG,+IAA+I;AAC/I,wBAAgB,eAAe,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CA+BvE"}