@wavehouse/chtypes 0.5.2 → 1.0.0

package/dist/results.js

@@ -1,406 +0,0 @@
-/**
- * The result types and the document parsers. Field for field the same concepts
- * as the reference implementation's `RowResult` / `BatchResult`
- * (docs/reference/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';
-/**
- * The verdict on a row or a batch — the error taxonomy in one string, and
- * conflating any two arms is a scoring error (the C ABI contract §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` is the readback's code, usually
- *   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 const Outcome = {
-    Accepted: 'accepted',
-    Rejected: 'rejected',
-    AcceptedPoisoned: 'accepted_poisoned',
-    Unsupported: 'unsupported',
-    Skipped: 'skipped',
-};
-const EMPTY = Buffer.alloc(0);
-/**
- * The two revision-5 `source` provenances `columns_json` introduces (issue
- * #53), plus the pre-existing `Skipped` provenance named alongside them
- * (issue #90). A plain const object, not a closed union: `source` is a
- * growing vocabulary arriving from the C layer, and an unrecognized spelling
- * from a newer artifact must pass through unchanged, not be rejected.
- */
-export const Source = {
-    /**
-     * MATERIALIZED / ALIAS / EPHEMERAL, never read from an input row.
-     * Predates revision 5 — unlike the two provenances below — but
-     * `rowResultOf` has excluded it from `values` from the start, the same
-     * exclusion `EphemeralInput` was modeled on. Named here, in the same
-     * idiom, so the exclusion can be keyed on a symbol rather than a bare
-     * string literal.
-     */
-    Skipped: 'skipped',
-    /**
-     * A listed EPHEMERAL column's read value. The server reads it — it is in
-     * scope for the DEFAULT expressions that reference it — and it is never
-     * stored and never exported. `rowResultOf` excludes it from `values`
-     * exactly as it already excludes `Source.Skipped`: a value that is never
-     * stored must not sit where a caller reads the stored row (a hash, a
-     * signature).
-     */
-    EphemeralInput: 'ephemeral_input',
-    /**
-     * A listed MATERIALIZED column's supplied value under
-     * `insert_allow_materialized_columns=1`. The supplied value REPLACES the
-     * column's expression and IS stored — unlike `EphemeralInput`, it stays
-     * IN `values`.
-     */
-    MaterializedInput: 'materialized_input',
-    /**
-     * A VOLATILE DEFAULT (`now()`/`now64(n)`/`today()`/`yesterday()`, or an
-     * expression over one) this library resolved locally rather than
-     * ClickHouse — the caller MUST send it as an explicit column on any later
-     * INSERT, or the value silently drifts each attempt. `rowResultOf` has
-     * always populated `substituted` for exactly this src value; like
-     * `Skipped` before issue #90, it had no named constant of its own (issue
-     * #122).
-     */
-    DefaultSubstituted: 'default_substituted',
-};
-/**
- * Map a document's outcome string. An outcome this binding does not recognize
- * degrades to `unsupported`, never to `rejected` (docs/reference/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';
-    }
-}
-// Exported (but not re-exported from index.ts, so the public surface is
-// unchanged) so tests can parse a single `cols[]` entry the way `rowResultOf`
-// does and call `classify()` on it directly — see transform-ephemeral.test.ts, #97.
-export 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);
-        // Source.Skipped (MATERIALIZED/ALIAS/EPHEMERAL, never read) and
-        // Source.EphemeralInput (a LISTED EPHEMERAL column: read, but never
-        // stored — see the `source` doc on `Value`) are both excluded from
-        // `values`, which is the stored row. Source.MaterializedInput stays IN:
-        // under insert_allow_materialized_columns=1 the supplied value genuinely
-        // IS stored, replacing the column's expression (issue #53).
-        if (c.src === Source.Skipped || c.src === Source.EphemeralInput)
-            continue;
-        values.push({
-            column: c.name,
-            text: c.stored,
-            bytes: c.storedBytes,
-            isNull: c.storedIsNull && !c.poison,
-            source: c.src,
-        });
-        if (c.src === Source.DefaultSubstituted) {
-            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')),
-    }));
-    // `verdict` (RowsExportWith's TypeScript spelling: `rows(..., { rowFilter })`)
-    // is present exactly when a filter was attached to the call that produced
-    // this document — absent from every Row/Rows document and from `rows()`
-    // with no `rowFilter`. `verdictOf` degrades an unrecognized character to
-    // `'d'`, never to an invented answer.
-    const verdictNode = field(doc, 'verdict');
-    const verdict = verdictNode === undefined ? undefined : verdictOf(asString(verdictNode));
-    const verdictCode = asInt(field(doc, 'verdict_code'));
-    const verdictErr = asString(field(doc, 'verdict_err'));
-    // `partition_id` (revision 6) is present exactly when the schema declared a
-    // partition key and this row would be stored; absent stays absent.
-    const partitionNode = field(doc, 'partition_id');
-    return {
-        values,
-        transformed,
-        outcome,
-        errCode: asInt(field(doc, 'code')),
-        errMsg: asString(field(doc, 'err')),
-        unknownFields,
-        unsupportedSettings,
-        substituted,
-        computed,
-        verdict,
-        verdictCode,
-        verdictErr,
-        ...(partitionNode !== undefined && partitionNode.kind === 'string' ? { partitionId: asString(partitionNode) } : {}),
-    };
-}
-/**
- * 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
-    // (the C ABI contract §Rows). Both absent = no export requested.
-    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);
-    const partitionCountNode = field(doc, 'partition_count');
-    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,
-        rowsPassed: asInt(field(doc, 'rows_passed')),
-        rowsCut: asInt(field(doc, 'rows_cut')),
-        // Revision 6: present exactly when the schema declared a partition key;
-        // absent stays absent, never a guessed 0.
-        ...(partitionCountNode !== undefined && partitionCountNode.kind === 'number'
-            ? { partitionCount: asInt(partitionCountNode) }
-            : {}),
-    };
-}
-// ------------------------------------------------------------------ filters
-/**
- * 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 `'e'` AND
- * `'d'` — collapsing either into `'f'`-the-answer inverts
- * fail-closed into fail-open under NOT, the measured leak class
- * (docs/reference/bindings.md §Revision 3).
- *
- * Rendered as the wire character the C result document carries — the same
- * spelling Go and Python use — rather than a word (docs/reference/bindings.md
- * §Revision 3; aligned 2026-09-15, chtypes-sdk#13 A1).
- *
- * - `'t'` the predicate is non-NULL and non-zero for this row.
- * - `'f'` false OR NULL — SQL's three-valued logic collapsed at the
- *         WHERE boundary, computed by the vendored functions.
- * - `'e'` 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.
- * - `'d'` 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 const Verdict = {
-    True: 't',
-    False: 'f',
-    Error: 'e',
-    Decline: 'd',
-};
-/** Whether a verdict is an ANSWER (`'t'`/`'f'`) rather than an error
- * or a decline. A security-enforcing caller hides the row when this is false. */
-export function isAnswer(v) {
-    return v === 't' || v === 'f';
-}
-/**
- * Map ONE wire verdict character to a `Verdict` — the single place that
- * decision is made, shared by `filterResultOf` (`chs_filter_rows`'s /
- * `chs_block_parse`'s `verdicts` string, one char per row) and `rowResultOf`
- * (`chs_rows`'s per-row `verdict` field, the revision-5 attached filter). A
- * second, drifted copy of this switch is exactly how `'e'` or `'d'` could
- * get silently collapsed into `'f'` in one call path and not the other —
- * the fail-open bug this vocabulary exists to prevent.
- */
-function verdictOf(ch) {
-    switch (ch) {
-        case 't':
-            return 't';
-        case 'f':
-            return 'f';
-        case 'e':
-            return 'e';
-        default:
-            // 'd', and any character this binding does not know: decline — fail
-            // closed, mirroring the unknown-outcome rule.
-            return 'd';
-    }
-}
-/**
- * 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 recognize degrades to `'unsupported'`, never to
- * `'rejected'` (the unknown-outcome rule, docs/reference/bindings.md §RowResult).
- */
-export const FilterOutcome = {
-    Ok: 'ok',
-    Rejected: 'rejected',
-    Unsupported: 'unsupported',
-};
-/**
- * `chs_schema_column_default_kind`'s five answers, as `ColumnInfo#defaultKind`
- * carries them. Named here because the Go, Python and Rust bindings all name
- * them and a TypeScript caller was otherwise typing the strings by hand — and
- * one of them is load-bearing: `EPHEMERAL` is the column a gateway must DECLINE
- * to preview rather than mispreview (docs/reference/bindings.md §EPHEMERAL columns).
- */
-export const DefaultKind = {
-    None: '',
-    Default: 'DEFAULT',
-    Materialized: 'MATERIALIZED',
-    Alias: 'ALIAS',
-    Ephemeral: 'EPHEMERAL',
-};
-/** 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'))) {
-        verdicts.push(verdictOf(ch));
-    }
-    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

@@ -1 +0,0 @@
-{"version":3,"file":"results.js","sourceRoot":"","sources":["../src/results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,MAAM,EACN,OAAO,EACP,KAAK,EACL,QAAQ,EACR,aAAa,EACb,KAAK,EACL,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,OAAO,GAER,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,mBAAmB;IACrC,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;CACV,CAAC;AAGX,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AA8B9B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;;;;;;OAOG;IACH,OAAO,EAAE,SAAS;IAClB;;;;;;;OAOG;IACH,cAAc,EAAE,iBAAiB;IACjC;;;;;OAKG;IACH,iBAAiB,EAAE,oBAAoB;IACvC;;;;;;;;OAQG;IACH,kBAAkB,EAAE,qBAAqB;CACjC,CAAC;AAoRX;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,CAAS;IAC1B,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,mBAAmB;YACtB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,8EAA8E;AAC9E,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,GAAS;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC;IAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,uEAAuE;IACvE,gDAAgD;IAChD,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;IACpE,4EAA4E;IAC5E,+EAA+E;IAC/E,MAAM,aAAa,GAAG,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC;IAC1D,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC1B,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACzC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE;QAChD,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;QACvC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC;QAC9B,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK;QACzD,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK;QAChD,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACxC,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC3C,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC7C,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACvD,YAAY;KACb,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,GAAS;IACnC,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAClE,MAAM,mBAAmB,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAC9E,IAAI,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACzD,wDAAwD;IACxD,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,GAAG,aAAa,CAAC;IAEtF,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAgB,EAAE,CAAC;IACpC,MAAM,WAAW,GAAmB,EAAE,CAAC;IAEvC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9B,gEAAgE;QAChE,oEAAoE;QACpE,mEAAmE;QACnE,wEAAwE;QACxE,yEAAyE;QACzE,4DAA4D;QAC5D,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,cAAc;YAAE,SAAS;QAC1E,MAAM,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,CAAC,CAAC,IAAI;YACd,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,KAAK,EAAE,CAAC,CAAC,WAAW;YACpB,MAAM,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM;YACnC,MAAM,EAAE,CAAC,CAAC,GAAG;SACd,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,QAAQ,GAAe,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;KACtC,CAAC,CAAC,CAAC;IAEJ,+EAA+E;IAC/E,0EAA0E;IAC1E,wEAAwE;IACxE,yEAAyE;IACzE,sCAAsC;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAwB,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9G,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;IACvD,4EAA4E;IAC5E,mEAAmE;IACnE,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAEjD,OAAO;QACL,MAAM;QACN,WAAW;QACX,OAAO;QACP,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,aAAa;QACb,mBAAmB;QACnB,WAAW;QACX,QAAQ;QACR,OAAO;QACP,WAAW;QACX,UAAU;QACV,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAS,EAAE,OAAO,GAAkB,IAAI;IACpE,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAgB,EAAE,CAAC;IAEpC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,WAAW;YAAE,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;QAC/C,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,8EAA8E;IAC9E,8EAA8E;IAC9E,mCAAmC;IACnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,WAAW,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACxC,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACnD,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC;YAC7B,MAAM;YACN,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC/B,qEAAqE;YACrE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC;IAC9E,MAAM,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExF,+DAA+D;IAC/D,oEAAoE;IACpE,iEAAiE;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,KAAK,GACT,SAAS,KAAK,SAAS;QACrB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClG,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvF,MAAM,kBAAkB,GAAG,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAEzD,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;QACnD,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACxC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC9C,WAAW;QACX,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5F,eAAe;QACf,OAAO,EAAE,OAAO,IAAI,SAAS;QAC7B,KAAK;QACL,cAAc;QACd,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC5C,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACtC,wEAAwE;QACxE,0CAA0C;QAC1C,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI,kBAAkB,CAAC,IAAI,KAAK,QAAQ;YAC1E,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,kBAAkB,CAAC,EAAE;YAC/C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,6EAA6E;AAE7E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,GAAG;CACJ,CAAC;AAGX;iFACiF;AACjF,MAAM,UAAU,QAAQ,CAAC,CAAU;IACjC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,SAAS,CAAC,EAAU;IAC3B,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,GAAG;YACN,OAAO,GAAG,CAAC;QACb,KAAK,GAAG;YACN,OAAO,GAAG,CAAC;QACb,KAAK,GAAG;YACN,OAAO,GAAG,CAAC;QACb;YACE,oEAAoE;YACpE,8CAA8C;YAC9C,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;CAClB,CAAC;AAGX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,cAAc;IAC5B,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;CACd,CAAC;AAmCX,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,GAAS;IACtC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IACnD,4EAA4E;IAC5E,6CAA6C;IAC7C,MAAM,OAAO,GACX,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC;IACtF,MAAM,IAAI,GAAG;QACX,OAAO;QACP,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACxC,mBAAmB,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;KACvE,CAAC;IACF,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAEnE,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,MAAM,GAAqB,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7B,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;KAC/B,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC"}

package/dist/transform.d.ts

@@ -1,73 +0,0 @@
-/**
- * Silent-transformation detection — a port of `go/chtypes/transform.go`.
- *
- * ClickHouse has no notion of "I changed your value": `readIntText` wraps mod
- * 2^N, `SerializationDateTime` truncates, `parseUUID` maps every non-hex byte to
- * 0xff, and all of it returns success. So the fact of a change has to be
- * established from outside, and this is the one part of chtypes that is derived
- * rather than executed by ClickHouse — which makes it the one part a binding can
- * get wrong without the C library noticing. Omitting it scores 0 % recall on the
- * arbiter's transformation axis regardless of everything else.
- *
- * Two independent detectors run and their union is reported:
- *
- *  1. **Supplied vs stored** — the raw input text against ClickHouse's rendering
- *     of what it kept. Models nothing; catches changes a widened type makes
- *     identically (2024-02-30 -> 2024-03-01) and types with no wider type to
- *     compare against (Float64, Int256, String).
- *  2. **Reference type** — the C layer already parsed each field a second time
- *     through a structurally identical type with widened leaves and reported it
- *     as `ref` / `ref_type`. This names the reason precisely (an overflow wrap
- *     versus a decimal truncation) and still fires where the supplied text is
- *     not comparable (a CSV field, a base64 blob).
- *
- * Neither reimplements a coercion rule: the first compares two values already in
- * hand, the second compares two ClickHouse answers.
- *
- * Both compare **bytes**. A supplied field and a stored `String` can each be any
- * byte sequence, and two different byte sequences that both decode to U+FFFD are
- * not the same value — deciding on decoded text would silently merge them, and
- * `equivalent`'s fast path would then call a real change identical.
- */
-import type { ColumnDoc, Transform } from './results.js';
-/** The stable reason vocabulary. The harness groups on these strings. */
-export declare const Reason: {
-    readonly OverflowWrap: 'overflow_wrap';
-    readonly NullToDefault: 'null_to_default';
-    readonly NullLoss: 'null_loss';
-    readonly DecimalTruncate: 'decimal_truncate';
-    readonly DateClamp: 'date_clamp';
-    readonly DateTimeWrap: 'datetime_wrap';
-    readonly DateShift: 'date_shift';
-    readonly UuidMangle: 'uuid_mangle';
-    readonly IpMangle: 'ip_mangle';
-    readonly FloatPrecision: 'float_precision';
-    readonly LossyNumeric: 'lossy_numeric';
-    readonly FixedStringPad: 'fixedstring_pad';
-    readonly Emptied: 'emptied';
-    readonly ElementChanged: 'element_changed';
-    readonly EnumCoerce: 'enum_coerce';
-    readonly ValueChanged: 'value_changed';
-    readonly Poisoned: 'poisoned';
-    readonly DuplicateKeyDropped: 'duplicate_key_dropped';
-    readonly Reformat: 'reformat';
-    readonly DefaultFilled: 'default_filled';
-    readonly ZeroFilled: 'zero_filled';
-    readonly DefaultMaterialized: 'default_materialized';
-    readonly TtlExpired: 'ttl_expired';
-    readonly TtlColumnExpired: 'ttl_column_expired';
-};
-/** One of the stable reason strings — see the `Reason` constant object. */
-export type Reason = (typeof Reason)[keyof typeof Reason];
-/**
- * Whether a transform reason means information was LOST (a warning to raise to
- * the tenant) rather than merely re-spelled or filled in. False for exactly
- * four reasons — `reformat`, `default_filled`, `zero_filled`,
- * `default_materialized` — true for everything else, unknown strings included:
- * a reason nobody has audited must degrade to a warning, never to silence.
- * Mirrors `Transform#lossy`. Never throws.
- */
-export declare function isLossyReason(reason: string): boolean;
-/** Classify one column of a row document. */
-export declare function classify(c: ColumnDoc): Transform[];
-//# sourceMappingURL=transform.d.ts.map

package/dist/transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,yEAAyE;AACzE,eAAO,MAAM,MAAM;aACjB,YAAY,EAAE,eAAe;aAC7B,aAAa,EAAE,iBAAiB;aAChC,QAAQ,EAAE,WAAW;aACrB,eAAe,EAAE,kBAAkB;aACnC,SAAS,EAAE,YAAY;aACvB,YAAY,EAAE,eAAe;aAC7B,SAAS,EAAE,YAAY;aACvB,UAAU,EAAE,aAAa;aACzB,QAAQ,EAAE,WAAW;aACrB,cAAc,EAAE,iBAAiB;aACjC,YAAY,EAAE,eAAe;aAC7B,cAAc,EAAE,iBAAiB;aACjC,OAAO,EAAE,SAAS;aAClB,cAAc,EAAE,iBAAiB;aACjC,UAAU,EAAE,aAAa;aACzB,YAAY,EAAE,eAAe;aAC7B,QAAQ,EAAE,UAAU;aACpB,mBAAmB,EAAE,uBAAuB;aAC5C,QAAQ,EAAE,UAAU;aACpB,aAAa,EAAE,gBAAgB;aAC/B,UAAU,EAAE,aAAa;aACzB,mBAAmB,EAAE,sBAAsB;aAC3C,UAAU,EAAE,aAAa;aACzB,gBAAgB,EAAE,oBAAoB;CAC9B,CAAC;AAEX,2EAA2E;AAC3E,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAe1D;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAsBD,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAwFlD"}