@wavehouse/chtypes 0.1.0

package/dist/results.d.ts

@@ -0,0 +1,326 @@
+/**
+ * The result types and the document parsers. Field for field the same concepts
+ * as the reference implementation's `RowResult` / `BatchResult`
+ * (spec/bindings.md §Result types), in TypeScript spelling.
+ *
+ * ---------------------------------------------------------------- text vs bytes
+ * Every rendered value here comes in both spellings, and which one is
+ * authoritative is not a matter of taste:
+ *
+ *   `bytes`  the exact slice ClickHouse emitted — the answer. Equivalent to the
+ *            reference's `json.RawMessage`, and the only form a `String`,
+ *            `FixedString` or `AggregateFunction` value survives (it holds
+ *            arbitrary bytes; base64 or `Buffer` it, never a JS string).
+ *   `text`   those bytes decoded as UTF-8, for logs, comparisons and previews.
+ *            **Lossy exactly when the bytes are not valid UTF-8**, where a JS
+ *            string can only hold U+FFFD. `isValidUtf8(bytes)` says so.
+ *
+ * A caller that echoes a value back into an INSERT, hashes it, or compares it
+ * against a real server MUST use `bytes`: reporting U+FFFD where the table holds
+ * `0xff` is an invented transformation, which is the one thing this product may
+ * never do.
+ */
+import { type Json } from './json.js';
+/**
+ * The verdict on a row or a batch — the error taxonomy in one string, and
+ * conflating any two arms is a scoring error (spec/c-abi.md §Error model):
+ *
+ * - `'accepted'` — the server would take this, possibly with silent coercions
+ *   (read `transformed`), defaults filled and volatile DEFAULTs substituted
+ *   (read `substituted` — the caller MUST send those columns explicitly).
+ * - `'rejected'` — the server itself would refuse; `errCode` is ClickHouse's
+ *   own code (27, 117, 455, …) and `errMsg` its own message. Tell the tenant.
+ * - `'accepted_poisoned'` — the insert is ACCEPTED (rc = 0) but the stored
+ *   value can never be read back (`errCode` 691). Never report it as a
+ *   rejection.
+ * - `'unsupported'` — chtypes declines to answer ("a real server might well
+ *   have accepted this; I will not guess"). NOT a rejection: fall back to the
+ *   server. Mapping it onto either other arm manufactures an over-reject or an
+ *   over-accept, both budgeted at zero.
+ * - `'skipped'` (2026-08-27) — the row was dropped under
+ *   `input_format_allow_errors_*` and the batch continued: the server's own
+ *   skip, itemized. `errCode`/`errMsg` carry the error the vendored reader
+ *   caught before resyncing, verbatim; `values` is empty — the row is NOT
+ *   stored. Only ever seen on rows inside a `BatchResult`, never as a batch
+ *   verdict and never from `Schema#row`.
+ */
+export type Outcome = 'accepted' | 'rejected' | 'accepted_poisoned' | 'unsupported' | 'skipped';
+/**
+ * One coerced column value, as ClickHouse itself renders it.
+ *
+ * `bytes` is that rendering verbatim (`0`, `"2023-11-14 22:13:20"`, `[1,0,3]`,
+ * a blob with no valid UTF-8 in it) — the same bytes the server would emit for
+ * the row, which is what makes it directly comparable against a real ClickHouse.
+ * `text` is `bytes` as UTF-8, and it is kept as text on purpose: parsing it into
+ * a JS number would turn 18446744073709551615 into 18446744073709552000.
+ */
+export interface Value {
+    readonly column: string;
+    /** ClickHouse's rendering as UTF-8 text; lossy iff `bytes` is not valid UTF-8. */
+    readonly text: string;
+    /** ClickHouse's rendering, verbatim. **Authoritative.** */
+    readonly bytes: Buffer;
+    /** True only for a genuine stored null. A poisoned column has no value at all. */
+    readonly isNull: boolean;
+    /**
+     * Where the value came from: `input` | `default` | `default_substituted` |
+     * `absent` | `skipped` | `default_volatile_unresolved` | `default_pending` |
+     * `default_expr_unsupported` (spec/c-abi.md §`src` values).
+     */
+    readonly source: string;
+}
+/** A silent change: input 256 into UInt8 stored as 0. */
+export interface Transform {
+    readonly column: string;
+    readonly input: string;
+    readonly stored: string;
+    /** The supplied field, verbatim. **Authoritative** where `input` is lossy. */
+    readonly inputBytes: Buffer;
+    /** The stored rendering, verbatim. **Authoritative** where `stored` is lossy. */
+    readonly storedBytes: Buffer;
+    /** One of the stable reason strings — see `Reason`. */
+    readonly reason: string;
+    /** 0-based index of the row inside the request body. */
+    row: number;
+    /** False for reformat / default_filled / zero_filled / default_materialised. */
+    readonly lossy: boolean;
+}
+/** A volatile DEFAULT this library resolved instead of the server. */
+export interface Substitution {
+    readonly column: string;
+    /** The DEFAULT as ClickHouse canonicalised it, e.g. `now()`. */
+    readonly expr: string;
+    /** The value rendered by ClickHouse's own serializer. Send it back verbatim. */
+    readonly text: string;
+    /** The same value as bytes — this is the form to put in the INSERT. */
+    readonly bytes: Buffer;
+}
+/** One MATERIALIZED column's value: stored at insert, frozen thereafter. */
+export interface Computed {
+    readonly column: string;
+    readonly kind: string;
+    readonly text: string;
+    /** The stored rendering, verbatim. */
+    readonly bytes: Buffer;
+}
+/**
+ * The verdict on one row: what would be stored, what was silently changed, and
+ * which of the five outcomes it is. Returned by `Schema#row` (which never
+ * answers `'skipped'` — a single row has no batch to continue), and one per
+ * row inside `BatchResult#rows`.
+ */
+export interface RowResult {
+    /** The coerced stored row, positional, excluding `skipped` columns. */
+    readonly values: Value[];
+    /** Every silent change. Not optional — it is the product. */
+    readonly transformed: Transform[];
+    /** The row verdict — see `Outcome` for the four arms and their obligations. */
+    readonly outcome: Outcome;
+    /**
+     * ClickHouse's own code when `rejected`; 691 when `accepted_poisoned`; 0 when
+     * `accepted`. NOT a reliable sentinel for `unsupported`: a row-level decline
+     * carries the document's code verbatim, which is 0 for e.g. a
+     * `DEFAULT hostName()` decline and -2 only on the clock-skew decline — key on
+     * `outcome`, never on this number alone (spec/bindings.md §RowResult).
+     */
+    readonly errCode: number;
+    /** ClickHouse's own message, `''` when none. */
+    readonly errMsg: string;
+    /** Input fields with no matching column. */
+    readonly unknownFields: string[];
+    /** Non-empty means the answer must not be scored as agreement. */
+    readonly unsupportedSettings: string[];
+    /**
+     * Columns whose volatile DEFAULT this library resolved from its own clock.
+     * THE CALLER MUST SEND EVERY ONE OF THESE AS AN EXPLICIT COLUMN in the INSERT:
+     * if the server evaluates the expression instead, preview and stored differ
+     * always at now64 resolution and sometimes at now() resolution.
+     */
+    readonly substituted: Substitution[];
+    /** MATERIALIZED values — durable, but not part of `SELECT *`. */
+    readonly computed: Computed[];
+}
+/**
+ * The verdict on a whole request body, which may hold many rows. Returned by
+ * `Schema#rows`. The batch is where "not stored" lives: a TTL-expired row is
+ * `accepted` in its own `RowResult` and reported not-stored here, through
+ * `transformed` and `engineRows`.
+ */
+export interface BatchResult {
+    /**
+     * One `RowResult` per row the reader consumed, in input order — including
+     * (2026-08-27) rows dropped under `input_format_allow_errors_*`, which
+     * appear as `outcome: 'skipped'` with the server's own caught error and no
+     * values. Filter on the row outcome when rendering survivors; a skipped
+     * row is never stored.
+     */
+    readonly rows: RowResult[];
+    /** The batch verdict — same vocabulary and obligations as a row's. */
+    readonly outcome: Outcome;
+    /** ClickHouse's own code when the BATCH was rejected; 0 when accepted. */
+    readonly errCode: number;
+    /** ClickHouse's own message, `''` when none. */
+    readonly errMsg: string;
+    /** Rows the reader consumed, failed ones included. */
+    readonly rowsRead: number;
+    /** Rows dropped under `input_format_allow_errors_num` / `_ratio`. */
+    readonly rowsSkipped: number;
+    /**
+     * Every transform in the batch, each tagged with its row index — including the
+     * batch-level `storage_transforms` (a TTL-expired row is `accepted` per row and
+     * NOT STORED per batch; dropping these tells a tenant a row was stored that the
+     * table deletes at merge time).
+     */
+    readonly transformed: Transform[];
+    /**
+     * The stored preview AFTER the engine's insert-time merge, one exact JSON text
+     * per row, or null when no engine semantics applied. When present this — not
+     * `rows` — is the stored truth: it can be shorter (a SummingMergeTree dropping
+     * an all-zero row) or reordered (the block is sorted by the sorting key first).
+     */
+    readonly engineRows: string[] | null;
+    /** The same preview as bytes, positionally aligned with `engineRows`. */
+    readonly engineRowsBytes: Buffer[] | null;
+    /**
+     * The export channel (revision 3; only when `rows()` was asked for an
+     * `exportFormat`): the batch's accepted rows, serialized once by the
+     * vendored writer, copied out of the C buffer and freed before the call
+     * returned — no ownership crosses the FFI boundary. Three states, and the
+     * distinction is the ABI's own (spec/c-abi.md §Rows):
+     *
+     *   `undefined`         no export was requested, the export was DECLINED
+     *                       (`exportDeclined` then names the reason), or a
+     *                       call-level verdict preempted the export machinery
+     *                       entirely (the batch `outcome` is then the reason and
+     *                       `exportDeclined` stays absent).
+     *   zero-length Buffer  EMITTED-EMPTY: an accepted batch with zero accepted
+     *                       rows — distinguishable from a decline.
+     *   bytes               the exported lines; slice per `spans`.
+     */
+    readonly payload: Buffer | undefined;
+    /**
+     * Index-aligned with `rows`: `spans[i]` addresses row i's complete output
+     * line (terminating `\n` included) inside `payload` — each slice is itself
+     * a valid one-row body in the export format, a non-accepted row carries
+     * `{off: 0, len: 0}`, and the concatenation of all non-zero spans
+     * reproduces `payload` exactly (batches merge by byte concatenation).
+     * `undefined` when no bytes were emitted.
+     */
+    readonly spans: readonly Span[] | undefined;
+    /**
+     * The library's reason for withholding requested export bytes (a
+     * non-accepted batch, the full-arity guard, a serialization failure,
+     * `output_format_json_validate_utf8`) — `undefined` when bytes were emitted
+     * or no export was requested. A decline here is -2-class honesty, never a
+     * server verdict.
+     */
+    readonly exportDeclined: string | undefined;
+}
+/** One row's byte range inside an export `payload` — see `BatchResult#spans`. */
+export interface Span {
+    readonly off: number;
+    readonly len: number;
+}
+/** One entry of the result document's `cols` array, decoded. */
+export interface ColumnDoc {
+    readonly name: string;
+    readonly type: string;
+    readonly base: string;
+    readonly src: string;
+    readonly input: string;
+    readonly refType: string;
+    /** Exact JSON text of the stored value; "" when absent or poisoned. */
+    readonly stored: string;
+    /** Exact JSON text of the reference parse; "" when it does not apply. */
+    readonly ref: string;
+    /** The raw input field, verbatim — a supplied value can be any byte sequence. */
+    readonly inputBytes: Buffer;
+    /** The stored rendering, verbatim. **This, not `stored`, is the answer.** */
+    readonly storedBytes: Buffer;
+    /** The reference parse's rendering, verbatim. */
+    readonly refBytes: Buffer;
+    readonly nullable: boolean;
+    readonly poison: boolean;
+    readonly nullInput: boolean;
+    readonly dupDropped: boolean;
+    /**
+     * The C layer found this leaf numeric/temporal but had no reference-ladder
+     * entry (audit F4): the classifier treats a visible change as lossy, never
+     * `reformat`. Absent from every artifact whose build gate ran.
+     */
+    readonly refUnclassified: boolean;
+    /** True when `stored` is a genuine JSON null. */
+    readonly storedIsNull: boolean;
+}
+/** Turn one row document into a `RowResult`. */
+export declare function rowResultOf(doc: Json): RowResult;
+/**
+ * Turn one batch document into a `BatchResult`. `payload` is the export
+ * channel's copy from the FFI layer (`null` = the ABI's `{NULL, 0}` — mapped
+ * to `undefined`; a zero-length Buffer is emitted-empty and kept), which the
+ * document itself never carries.
+ */
+export declare function batchResultOf(doc: Json, payload?: Buffer | null): BatchResult;
+/**
+ * One row's answer from `Filter#rows`. Two of the four states are ANSWERS and
+ * two are NOT, and the split is load-bearing: a caller enforcing visibility
+ * MUST fail closed (hide the row / fail the request) on `'error'` AND
+ * `'decline'` — collapsing either into `'false'`-the-answer inverts
+ * fail-closed into fail-open under NOT, the measured leak class
+ * (spec/bindings.md §Revision 3).
+ *
+ * - `'true'`    the predicate is non-NULL and non-zero for this row.
+ * - `'false'`   false OR NULL — SQL's three-valued logic collapsed at the
+ *               WHERE boundary, computed by the vendored functions.
+ * - `'error'`   the predicate THREW on this row's values (e.g. NO_COMMON_TYPE
+ *               386 from `s = 257` over String). On a real server a WHERE
+ *               that throws fails the WHOLE query. NOT an answer.
+ * - `'decline'` this library declines to answer for this row — unparseable
+ *               under the schema, poisoned, or the admission envelope
+ *               tripped. NOT an answer, and the state an unknown verdict
+ *               character degrades to.
+ */
+export type Verdict = 'true' | 'false' | 'error' | 'decline';
+/** Whether a verdict is an ANSWER (`'true'`/`'false'`) rather than an error
+ * or a decline. A security-enforcing caller hides the row when this is false. */
+export declare function isAnswer(v: Verdict): boolean;
+/**
+ * The CALL-level verdict of `Filter#rows` — whether evaluation completed at
+ * all; per-row failures live in the verdicts, not here. An outcome spelling
+ * this binding does not recognise degrades to `'unsupported'`, never to
+ * `'rejected'` (the unknown-outcome rule, spec/bindings.md §RowResult).
+ */
+export type FilterOutcome = 'ok' | 'rejected' | 'unsupported';
+/** One `'error'` or `'decline'` row, itemized: its 0-based index and the code
+ * and message verbatim — ClickHouse's own for an error row, this library's
+ * decline otherwise. */
+export interface FilterRowError {
+    readonly row: number;
+    readonly code: number;
+    readonly err: string;
+}
+/** One `Filter#rows` answer. */
+export interface FilterResult {
+    /** The call-level verdict. On anything but `'ok'`, `verdicts` and `errors`
+     * are empty — a malformed body yields no partial answers. */
+    readonly outcome: FilterOutcome;
+    /** The call-level code: the server's own on `'rejected'` (an unknown
+     * setting's 115, a framing error, a binary decode fault); -2 on a decline. */
+    readonly errCode: number;
+    readonly errMsg: string;
+    /** Rows the splitter/decoder yielded. */
+    readonly rowsRead: number;
+    /** Non-empty means the answer must not be scored as agreement. */
+    readonly unsupportedSettings: string[];
+    /**
+     * One verdict per row, in input order, index-aligned with the rows the
+     * reader consumed — the itemized addressing contract holds even across
+     * resync tails after a bad text row.
+     */
+    readonly verdicts: Verdict[];
+    /** Every `'error'` and `'decline'` row, itemized. */
+    readonly errors: FilterRowError[];
+}
+/** Turn one filter document into a `FilterResult`. */
+export declare function filterResultOf(doc: Json): FilterResult;
+//# sourceMappingURL=results.d.ts.map

package/dist/results.d.ts.map

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

package/dist/results.js

@@ -0,0 +1,235 @@
+/**
+ * The result types and the document parsers. Field for field the same concepts
+ * as the reference implementation's `RowResult` / `BatchResult`
+ * (spec/bindings.md §Result types), in TypeScript spelling.
+ *
+ * ---------------------------------------------------------------- text vs bytes
+ * Every rendered value here comes in both spellings, and which one is
+ * authoritative is not a matter of taste:
+ *
+ *   `bytes`  the exact slice ClickHouse emitted — the answer. Equivalent to the
+ *            reference's `json.RawMessage`, and the only form a `String`,
+ *            `FixedString` or `AggregateFunction` value survives (it holds
+ *            arbitrary bytes; base64 or `Buffer` it, never a JS string).
+ *   `text`   those bytes decoded as UTF-8, for logs, comparisons and previews.
+ *            **Lossy exactly when the bytes are not valid UTF-8**, where a JS
+ *            string can only hold U+FFFD. `isValidUtf8(bytes)` says so.
+ *
+ * A caller that echoes a value back into an INSERT, hashes it, or compares it
+ * against a real server MUST use `bytes`: reporting U+FFFD where the table holds
+ * `0xff` is an invented transformation, which is the one thing this product may
+ * never do.
+ */
+import { asBool, asBytes, asInt, asString, asStringArray, field, hasField, items, rawBytes, rawText, } from './json.js';
+import { classify, isLossyReason } from './transform.js';
+const EMPTY = Buffer.alloc(0);
+/**
+ * Map a document's outcome string. An outcome this binding does not recognise
+ * degrades to `unsupported`, never to `rejected` (spec/bindings.md
+ * §RowResult, rule added 2026-08-26): a future artifact's new verdict is an
+ * answer this binding cannot interpret, and `unsupported` is the arm that is
+ * never scored as agreement, while a default of `rejected` would manufacture
+ * an over-reject — the zero-budget failure — out of pure vocabulary drift.
+ */
+function outcomeOf(s) {
+    switch (s) {
+        case 'accepted':
+            return 'accepted';
+        case 'rejected':
+            return 'rejected';
+        case 'accepted_poisoned':
+            return 'accepted_poisoned';
+        case 'unsupported':
+            return 'unsupported';
+        case 'skipped':
+            return 'skipped';
+        default:
+            return 'unsupported';
+    }
+}
+function columnDocOf(raw) {
+    const poison = asBool(field(raw, 'poison'));
+    const inputNode = field(raw, 'input');
+    const storedNode = field(raw, 'stored');
+    const storedIsNull = storedNode !== undefined && storedNode.kind === 'null';
+    const refNode = field(raw, 'ref');
+    // Absent, or a literal null: no reference parse applies (the reference
+    // implementation's `Ref()` folds both onto "").
+    const refPresent = refNode !== undefined && refNode.kind !== 'null';
+    // A JSON null in `stored` is a real stored value (a Nullable column holding
+    // null), not the absence of one. Only the poison case has no renderable value.
+    const storedPresent = storedNode !== undefined && !poison;
+    return {
+        name: asString(field(raw, 'name')),
+        type: asString(field(raw, 'type')),
+        base: asString(field(raw, 'base')),
+        src: asString(field(raw, 'src')),
+        input: asString(inputNode),
+        refType: asString(field(raw, 'ref_type')),
+        stored: storedPresent ? rawText(storedNode) : '',
+        ref: refPresent ? rawText(refNode) : '',
+        inputBytes: asBytes(inputNode),
+        storedBytes: storedPresent ? rawBytes(storedNode) : EMPTY,
+        refBytes: refPresent ? rawBytes(refNode) : EMPTY,
+        nullable: asBool(field(raw, 'nullable')),
+        poison,
+        nullInput: asBool(field(raw, 'null_input')),
+        dupDropped: asBool(field(raw, 'dup_dropped')),
+        refUnclassified: asBool(field(raw, 'ref_unclassified')),
+        storedIsNull,
+    };
+}
+/** Turn one row document into a `RowResult`. */
+export function rowResultOf(doc) {
+    const unknownFields = asStringArray(field(doc, 'unknown_fields'));
+    const unsupportedSettings = asStringArray(field(doc, 'unsupported_settings'));
+    let outcome = outcomeOf(asString(field(doc, 'outcome')));
+    // A declined setting must never be scored as agreement.
+    if (unsupportedSettings.length > 0 && outcome !== 'rejected')
+        outcome = 'unsupported';
+    const values = [];
+    const transformed = [];
+    const substituted = [];
+    for (const rawCol of items(field(doc, 'cols'))) {
+        const c = columnDocOf(rawCol);
+        if (c.src === 'skipped')
+            continue;
+        values.push({
+            column: c.name,
+            text: c.stored,
+            bytes: c.storedBytes,
+            isNull: c.storedIsNull && !c.poison,
+            source: c.src,
+        });
+        if (c.src === 'default_substituted') {
+            substituted.push({ column: c.name, expr: c.input, text: c.stored, bytes: c.storedBytes });
+        }
+        transformed.push(...classify(c));
+    }
+    const computed = items(field(doc, 'computed')).map((raw) => ({
+        column: asString(field(raw, 'name')),
+        kind: asString(field(raw, 'kind')),
+        text: rawText(field(raw, 'stored')),
+        bytes: rawBytes(field(raw, 'stored')),
+    }));
+    return {
+        values,
+        transformed,
+        outcome,
+        errCode: asInt(field(doc, 'code')),
+        errMsg: asString(field(doc, 'err')),
+        unknownFields,
+        unsupportedSettings,
+        substituted,
+        computed,
+    };
+}
+/**
+ * Turn one batch document into a `BatchResult`. `payload` is the export
+ * channel's copy from the FFI layer (`null` = the ABI's `{NULL, 0}` — mapped
+ * to `undefined`; a zero-length Buffer is emitted-empty and kept), which the
+ * document itself never carries.
+ */
+export function batchResultOf(doc, payload = null) {
+    const rows = [];
+    const transformed = [];
+    items(field(doc, 'rows')).forEach((rawRow, index) => {
+        const row = rowResultOf(rawRow);
+        for (const t of row.transformed)
+            t.row = index;
+        transformed.push(...row.transformed);
+        rows.push(row);
+    });
+    // storage_transforms is what the STORAGE layer did to rows the type layer
+    // accepted: ttl_expired (the row is not stored at all) and ttl_column_expired
+    // (the value was reset to the column DEFAULT). Both are lossy by construction
+    // and both must be folded in here.
+    for (const rawSt of items(field(doc, 'storage_transforms'))) {
+        const reason = asString(field(rawSt, 'reason'));
+        const stored = hasField(rawSt, 'stored') ? field(rawSt, 'stored') : undefined;
+        transformed.push({
+            column: asString(field(rawSt, 'column')),
+            input: '',
+            stored: stored === undefined ? '' : rawText(stored),
+            inputBytes: EMPTY,
+            storedBytes: rawBytes(stored),
+            reason,
+            row: asInt(field(rawSt, 'row')),
+            // ttl_expired and ttl_column_expired are both lossy by construction.
+            lossy: isLossyReason(reason),
+        });
+    }
+    const engineNode = field(doc, 'engine_rows');
+    const enginePresent = engineNode !== undefined && engineNode.kind === 'array';
+    const engineRowsBytes = enginePresent ? engineNode.items.map((r) => rawBytes(r)) : null;
+    // row_spans is present exactly when export bytes were emitted;
+    // export_declined exactly when an export was requested and withheld
+    // (spec/c-abi.md §Rows). Both absent = no export requested, or a call-level
+    // verdict preempted the machinery.
+    const spansNode = field(doc, 'row_spans');
+    const spans = spansNode === undefined
+        ? undefined
+        : items(spansNode).map((s) => ({ off: asInt(field(s, 'off')), len: asInt(field(s, 'len')) }));
+    const declinedNode = field(doc, 'export_declined');
+    const exportDeclined = declinedNode === undefined ? undefined : asString(declinedNode);
+    return {
+        rows,
+        outcome: outcomeOf(asString(field(doc, 'outcome'))),
+        errCode: asInt(field(doc, 'code')),
+        errMsg: asString(field(doc, 'err')),
+        rowsRead: asInt(field(doc, 'rows_read')),
+        rowsSkipped: asInt(field(doc, 'rows_skipped')),
+        transformed,
+        engineRows: engineRowsBytes === null ? null : engineRowsBytes.map((b) => b.toString('utf8')),
+        engineRowsBytes,
+        payload: payload ?? undefined,
+        spans,
+        exportDeclined,
+    };
+}
+/** Whether a verdict is an ANSWER (`'true'`/`'false'`) rather than an error
+ * or a decline. A security-enforcing caller hides the row when this is false. */
+export function isAnswer(v) {
+    return v === 'true' || v === 'false';
+}
+/** Turn one filter document into a `FilterResult`. */
+export function filterResultOf(doc) {
+    const rawOutcome = asString(field(doc, 'outcome'));
+    // 'unsupported', and every spelling this binding does not know, degrades to
+    // the decline arm — never the rejection arm.
+    const outcome = rawOutcome === 'ok' ? 'ok' : rawOutcome === 'rejected' ? 'rejected' : 'unsupported';
+    const base = {
+        outcome,
+        errCode: asInt(field(doc, 'code')),
+        errMsg: asString(field(doc, 'err')),
+        rowsRead: asInt(field(doc, 'rows_read')),
+        unsupportedSettings: asStringArray(field(doc, 'unsupported_settings')),
+    };
+    if (outcome !== 'ok')
+        return { ...base, verdicts: [], errors: [] };
+    const verdicts = [];
+    for (const ch of asString(field(doc, 'verdicts'))) {
+        switch (ch) {
+            case 't':
+                verdicts.push('true');
+                break;
+            case 'f':
+                verdicts.push('false');
+                break;
+            case 'e':
+                verdicts.push('error');
+                break;
+            default:
+                // 'd', and any character this binding does not know: decline — fail
+                // closed, mirroring the unknown-outcome rule.
+                verdicts.push('decline');
+        }
+    }
+    const errors = items(field(doc, 'errors')).map((e) => ({
+        row: asInt(field(e, 'row')),
+        code: asInt(field(e, 'code')),
+        err: asString(field(e, 'err')),
+    }));
+    return { ...base, verdicts, errors };
+}
+//# sourceMappingURL=results.js.map

package/dist/results.js.map

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