@wavehouse/chtypes 2.0.0-dev.10 → 2.0.0-dev.12

package/dist/settings.d.ts

@@ -2,10 +2,14 @@
  * Settings, the per-call zone and the other call inputs, serialized for the
  * library exactly as `docs/reference/bindings-v1.md` §2 and §3 say.
  *
- * Settings values are strings, and only strings. The map becomes a JSON object
- * of string values through the stock encoder and is passed verbatim: no
- * boolean or integer spelling, no float. A value that is not a string is the
- * language's own type error (`TypeError`).
+ * Settings values are strings or bytes, and nothing else. The map becomes a JSON
+ * object through the stock encoder and each value is passed verbatim: no boolean
+ * or integer spelling, no float. A value that is neither a string nor a
+ * `Uint8Array` is the language's own type error (`TypeError`). A value whose
+ * bytes are valid UTF-8 is a JSON string; any other bytes (a `Uint8Array`) are
+ * the object form `{"b64": "<standard base64>"}` (ABI v2, `json_object_byte_values`),
+ * so the library sees the exact bytes. A key that is not valid UTF-8 cannot be
+ * carried at all and is a `UsageError`.
  *
  * The per-call zone is a settings key and nothing more: `sessionTimezone` is
  * written into the object as `session_timezone`, verbatim, with no default,
@@ -13,8 +17,15 @@
  * database). Passing it alongside a `session_timezone` key in `settings` is a
  * `UsageError`, raised before any call and whether or not the two agree.
  */
-/** Settings and query parameters: names to string values. */
-export type Settings = Readonly<Record<string, string>>;
+import { type Posture } from './abi2/index.js';
+/** A settings or query-parameter value: text, or the bytes of a value that need not be text (a non-UTF-8 value is sent in the `{"b64": ...}` object form). */
+export type SettingValue = string | Uint8Array;
+/** Settings and query parameters: names to values. */
+export type Settings = Readonly<Record<string, SettingValue>>;
+/** A value as the document carries it: a JSON string, or the object form of bytes that are not UTF-8. */
+export type WireValue = string | {
+    readonly b64: string;
+};
 /** Bytes in: a statement, expression, type, name or literal. A string is encoded as UTF-8; pass a `Uint8Array` for bytes that are not text. */
 export type BytesIn = Uint8Array | string;
 /** The bytes of a `BytesIn`: UTF-8 for a string, the same bytes for a `Uint8Array`. */
@@ -24,13 +35,13 @@ export declare function bytesIn(value: BytesIn): Buffer;
  * map nor a zone, else a JSON object of string values with the zone, when
  * given, written in as `session_timezone`.
  */
-export declare function encodeSettings(settings: Settings | undefined, sessionTimezone: string | undefined): Buffer;
+export declare function encodeSettings(settings: Settings | undefined, sessionTimezone: SettingValue | undefined): Buffer;
 /** Query parameters: a JSON object of string values, or nothing when absent. */
 export declare function encodeParams(params: Settings | undefined): Buffer;
 /** The INSERT column list: a JSON array of names, each an object carrying `name` when its bytes are valid UTF-8 and `name_b64` otherwise, or nothing (length 0) when absent. */
 export declare function encodeColumns(columns: readonly BytesIn[] | undefined): Buffer;
-/** The process default settings, as `chs_set_defaults` takes them. */
-export declare function validateDefaults(defaults: Settings): void;
+/** The process default settings, as `chs_set_defaults` takes them: the wire form of each value (a value that is not valid UTF-8 is `{"b64": ...}`). */
+export declare function validateDefaults(defaults: Settings): Readonly<Record<string, WireValue>>;
 /**
  * One ClickHouse server, as `chs_server_create` takes it (`input:server_profile`).
  * Every member is optional, and every value is passed through as given: the
@@ -40,16 +51,76 @@ export declare function validateDefaults(defaults: Settings): void;
 export interface ServerProfile {
     /** The server's zone, the one its `timezone()` returns. Absent or `''` omits it: the server does not describe it, and the image zone applies. */
     readonly timezone?: string | undefined;
-    /** What the server's profile applies to every query. Absent omits it (no server settings layer); `{}` is sent as `{}`. */
+    /** What the server's profile applies to every query. Absent omits it (no server settings layer); `{}` is sent as `{}`. A value that is not valid UTF-8 is a `Uint8Array`, sent in the `{"b64": ...}` form. */
     readonly settings?: Settings | undefined;
     /**
      * The server's `<macros>`, which a Replicated engine's ZooKeeper path and
      * replica name expand. ABSENT is not `{}`: absent means the server's macros
      * are UNKNOWN, and a schema whose engine reads one is declined; present, even
-     * `{}`, is the server's COMPLETE set.
+     * `{}`, is the server's COMPLETE set. A macro's name and value are text: they
+     * have no byte form.
      */
-    readonly macros?: Settings | undefined;
+    readonly macros?: Readonly<Record<string, string>> | undefined;
 }
 /** The profile document: an empty or absent zone, absent settings and absent macros are omitted; a present map is sent as given, `{}` when empty. */
 export declare function encodeServerProfile(profile: ServerProfile): Buffer;
+/** `insert_options.verdict_basis`: what row a filter verdict answers for. */
+export declare const VerdictBasis: {
+    /** The default: the verdict answers for the input row. */
+    readonly Input: 'input';
+    /** The row the export would store. A build that does not implement it declines it. */
+    readonly Export: 'export';
+};
+export type VerdictBasis = (typeof VerdictBasis)[keyof typeof VerdictBasis];
+/** `insert_options.defer_defaults`. */
+export declare const DeferDefaults: {
+    /** The default: no DEFAULT is deferred. */
+    readonly None: 'none';
+    /** Defer to the server each DEFAULT the build would otherwise decline. A build that does not implement it declines it. */
+    readonly Server: 'server';
+};
+export type DeferDefaults = (typeof DeferDefaults)[keyof typeof DeferDefaults];
+/** `filter_options.param_encoding`: how a query parameter's value is read. */
+export declare const ParamEncoding: {
+    /** The default: ClickHouse's escaped-text reader. */
+    readonly Escaped: 'escaped';
+    /** The bytes as the value. A build that does not implement it declines it. */
+    readonly Raw: 'raw';
+};
+export type ParamEncoding = (typeof ParamEncoding)[keyof typeof ParamEncoding];
+/** One entry of `insert_options.column_defaults`: the value the call uses in a cell the server would fill from the column's DEFAULT. Both are byte strings: bytes that are not valid UTF-8 are sent in the `name_b64` and `value_b64` forms. */
+export interface ColumnDefault {
+    readonly name: BytesIn;
+    readonly value: BytesIn;
+}
+/** The `insert_options` members of the four calls that model an INSERT of a body (`row`, `rows`, `parseBlock`, and a filter's `rows`): what `encodeInsertOptions` reads from those calls' options objects. */
+export interface InsertOptions {
+    /** The columns an INSERT may supply (the server's column-level INSERT grant). Absent leaves the member out (every column); `[]` is sent as `[]` (no column). */
+    readonly insertableColumns?: readonly BytesIn[] | undefined;
+    /** Per-call DEFAULT overrides. Absent leaves the member out; `[]` is sent as `[]`. */
+    readonly columnDefaults?: readonly ColumnDefault[] | undefined;
+    readonly verdictBasis?: VerdictBasis | undefined;
+    readonly deferDefaults?: DeferDefaults | undefined;
+    /** Any other member of `insert_options`: key to its value as JSON text, passed through as given (rule r1). A key also named above keeps this value. Text that is not valid JSON is a `UsageError` before any call. */
+    readonly insertOptionsExtra?: Readonly<Record<string, string>> | undefined;
+}
+/** The `filter_options` members of `Schema.compileFilter`. */
+export interface FilterOptionMembers {
+    readonly paramEncoding?: ParamEncoding | undefined;
+    /** Any other member of `filter_options`, as `insertOptionsExtra` is for `insert_options`. */
+    readonly filterOptionsExtra?: Readonly<Record<string, string>> | undefined;
+}
+/** The `schema_options` members of `Library.compileTable`. */
+export interface SchemaOptionMembers {
+    /** How the statement is compiled: `Posture.Create` (the default), as a server's CREATE TABLE, or `Posture.Load`, as a server loads the stored definition of a table it holds. */
+    readonly posture?: Posture | undefined;
+    /** Any other member of `schema_options`, as `insertOptionsExtra` is for `insert_options`. */
+    readonly schemaOptionsExtra?: Readonly<Record<string, string>> | undefined;
+}
+/** The `insert_options` document of a call that models an INSERT. */
+export declare function encodeInsertOptions(o: InsertOptions): Buffer;
+/** The `filter_options` document of `chs_filter_create`. */
+export declare function encodeFilterOptions(o: FilterOptionMembers): Buffer;
+/** The `schema_options` document of `chs_schema_create`. */
+export declare function encodeSchemaOptions(o: SchemaOptionMembers): Buffer;
 //# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,6DAA6D;AAC7D,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAExD,+IAA+I;AAC/I,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAI1C,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE9C;AAuBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAgB1G;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAIjE;AAaD,gLAAgL;AAChL,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GAAG,MAAM,CAO7E;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAEzD;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,iJAAiJ;IACjJ,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,0HAA0H;IAC1H,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACxC;AAED,qJAAqJ;AACrJ,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAgBlE"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/dist/settings.js

@@ -2,10 +2,14 @@
  * Settings, the per-call zone and the other call inputs, serialized for the
  * library exactly as `docs/reference/bindings-v1.md` §2 and §3 say.
  *
- * Settings values are strings, and only strings. The map becomes a JSON object
- * of string values through the stock encoder and is passed verbatim: no
- * boolean or integer spelling, no float. A value that is not a string is the
- * language's own type error (`TypeError`).
+ * Settings values are strings or bytes, and nothing else. The map becomes a JSON
+ * object through the stock encoder and each value is passed verbatim: no boolean
+ * or integer spelling, no float. A value that is neither a string nor a
+ * `Uint8Array` is the language's own type error (`TypeError`). A value whose
+ * bytes are valid UTF-8 is a JSON string; any other bytes (a `Uint8Array`) are
+ * the object form `{"b64": "<standard base64>"}` (ABI v2, `json_object_byte_values`),
+ * so the library sees the exact bytes. A key that is not valid UTF-8 cannot be
+ * carried at all and is a `UsageError`.
  *
  * The per-call zone is a settings key and nothing more: `sessionTimezone` is
  * written into the object as `session_timezone`, verbatim, with no default,
@@ -19,26 +23,58 @@ const ZONE_KEY = 'session_timezone';
 export function bytesIn(value) {
     return typeof value === 'string' ? Buffer.from(value, 'utf8') : asBuffer(value);
 }
-const NON_UTF8_HINT = 'this ABI generation cannot carry a non-UTF-8 value in a JSON input; write the bytes as unhex(\'<hex>\') in the expression instead';
+const NON_UTF8_HINT = 'a JSON input cannot carry these bytes here (only a settings or query-parameter value has the {"b64": ...} object form, and a string holding a lone surrogate has no bytes; pass a Uint8Array)';
 /** True for a string with a lone surrogate, which no UTF-8 encoding carries: `JSON.stringify` writes it as a `\udXXX` escape and `TextEncoder` as U+FFFD. */
 function hasLoneSurrogate(text) {
     return /\p{Surrogate}/u.test(text);
 }
-function checkStrings(what, map) {
+// ignoreBOM: a leading U+FEFF is data, and the decoder must not drop it.
+const utf8 = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true });
+/** The text of `bytes` when they are valid UTF-8, else `undefined`. */
+function utf8Text(bytes) {
+    try {
+        return utf8.decode(bytes);
+    }
+    catch {
+        return undefined;
+    }
+}
+function isValidUtf8(bytes) {
+    return utf8Text(bytes) !== undefined;
+}
+/**
+ * One value of `json_object_byte_values`: a string stays a JSON string, and
+ * bytes are a JSON string when they are valid UTF-8 and `{"b64": ...}` (standard
+ * base64, padded) otherwise. `where` names the value for a refusal.
+ */
+function wireValue(what, where, v) {
+    if (typeof v === 'string') {
+        if (hasLoneSurrogate(v))
+            throw usageError(`${what}: ${where} is not valid UTF-8, and ${NON_UTF8_HINT}`);
+        return v;
+    }
+    if (v instanceof Uint8Array) {
+        return utf8Text(v) ?? { b64: asBuffer(v).toString('base64') };
+    }
+    throw new TypeError(`chtypes: ${what} ${where} must be a string or a Uint8Array, got ${typeof v}`);
+}
+function keyName(k) {
+    return `the key ${JSON.stringify(k)}`;
+}
+/** The wire form of a map of byte values; refuses a key that is not valid UTF-8 (the key is shown through JSON.stringify, which escapes a lone surrogate: never raw). */
+function wireMap(what, map) {
     const shown = what === 'params' ? 'query parameters' : what;
+    const out = {};
     for (const [k, v] of Object.entries(map)) {
-        if (typeof v !== 'string')
-            throw new TypeError(`chtypes: ${what}[${JSON.stringify(k)}] must be a string, got ${typeof v}`);
-        // The key is shown through JSON.stringify, which escapes a lone surrogate: never raw.
         if (hasLoneSurrogate(k))
-            throw usageError(`${shown}: the key ${JSON.stringify(k)} is not valid UTF-8, and ${NON_UTF8_HINT}`);
-        if (hasLoneSurrogate(v))
-            throw usageError(`${shown}: the value for key ${JSON.stringify(k)} is not valid UTF-8, and ${NON_UTF8_HINT}`);
+            throw usageError(`${shown}: ${keyName(k)} is not valid UTF-8, and ${NON_UTF8_HINT}`);
+        if (typeof v !== 'string' && !(v instanceof Uint8Array)) {
+            throw new TypeError(`chtypes: ${what}[${JSON.stringify(k)}] must be a string or a Uint8Array, got ${typeof v}`);
+        }
+        // defineProperty, so a key such as "__proto__" is an own member and never the prototype.
+        Object.defineProperty(out, k, { value: wireValue(shown, `the value for key ${JSON.stringify(k)}`, v), enumerable: true, writable: true, configurable: true });
     }
-}
-function checkZone(what, zone) {
-    if (hasLoneSurrogate(zone))
-        throw usageError(`${what}: the value is not valid UTF-8, and ${NON_UTF8_HINT}`);
+    return out;
 }
 /**
  * The `settings` input of a call: nothing (length 0) when there is neither a
@@ -48,19 +84,18 @@ function checkZone(what, zone) {
 export function encodeSettings(settings, sessionTimezone) {
     if (settings === undefined && sessionTimezone === undefined)
         return Buffer.alloc(0);
-    const out = {};
+    let out = {};
     if (settings !== undefined) {
-        checkStrings('settings', settings);
         if (sessionTimezone !== undefined && Object.hasOwn(settings, ZONE_KEY)) {
             throw usageError(`the zone was given twice: sessionTimezone and a ${ZONE_KEY} key in settings; pass only one`);
         }
-        Object.assign(out, settings);
+        out = wireMap('settings', settings);
     }
     if (sessionTimezone !== undefined) {
-        if (typeof sessionTimezone !== 'string')
-            throw new TypeError(`chtypes: sessionTimezone must be a string, got ${typeof sessionTimezone}`);
-        checkZone('the zone', sessionTimezone);
-        out[ZONE_KEY] = sessionTimezone;
+        if (typeof sessionTimezone !== 'string' && !(sessionTimezone instanceof Uint8Array)) {
+            throw new TypeError(`chtypes: sessionTimezone must be a string or a Uint8Array, got ${typeof sessionTimezone}`);
+        }
+        out[ZONE_KEY] = wireValue('the zone', 'the value', sessionTimezone);
     }
     return Buffer.from(JSON.stringify(out), 'utf8');
 }
@@ -68,18 +103,7 @@ export function encodeSettings(settings, sessionTimezone) {
 export function encodeParams(params) {
     if (params === undefined)
         return Buffer.alloc(0);
-    checkStrings('params', params);
-    return Buffer.from(JSON.stringify({ ...params }), 'utf8');
-}
-const utf8 = new TextDecoder('utf-8', { fatal: true });
-function isValidUtf8(bytes) {
-    try {
-        utf8.decode(bytes);
-        return true;
-    }
-    catch {
-        return false;
-    }
+    return Buffer.from(JSON.stringify(wireMap('params', params)), 'utf8');
 }
 /** The INSERT column list: a JSON array of names, each an object carrying `name` when its bytes are valid UTF-8 and `name_b64` otherwise, or nothing (length 0) when absent. */
 export function encodeColumns(columns) {
@@ -92,9 +116,9 @@ export function encodeColumns(columns) {
     });
     return Buffer.from(JSON.stringify(names), 'utf8');
 }
-/** The process default settings, as `chs_set_defaults` takes them. */
+/** The process default settings, as `chs_set_defaults` takes them: the wire form of each value (a value that is not valid UTF-8 is `{"b64": ...}`). */
 export function validateDefaults(defaults) {
-    checkStrings('defaults', defaults);
+    return wireMap('defaults', defaults);
 }
 /** The profile document: an empty or absent zone, absent settings and absent macros are omitted; a present map is sent as given, `{}` when empty. */
 export function encodeServerProfile(profile) {
@@ -102,17 +126,132 @@ export function encodeServerProfile(profile) {
     if (profile.timezone !== undefined && profile.timezone !== '') {
         if (typeof profile.timezone !== 'string')
             throw new TypeError(`chtypes: timezone must be a string, got ${typeof profile.timezone}`);
-        checkZone('server profile: the timezone', profile.timezone);
+        if (hasLoneSurrogate(profile.timezone))
+            throw usageError(`server profile: the timezone is not valid UTF-8, and ${NON_UTF8_HINT}`);
         out.timezone = profile.timezone;
     }
     if (profile.settings !== undefined) {
-        checkStrings('settings', profile.settings);
-        out.settings = { ...profile.settings };
+        out.settings = wireMap('settings', profile.settings);
     }
     if (profile.macros !== undefined) {
-        checkStrings('macros', profile.macros);
+        for (const [k, v] of Object.entries(profile.macros)) {
+            if (typeof v !== 'string')
+                throw new TypeError(`chtypes: macros[${JSON.stringify(k)}] must be a string, got ${typeof v}`);
+            if (hasLoneSurrogate(k))
+                throw usageError(`macros: ${keyName(k)} is not valid UTF-8, and ${NON_UTF8_HINT}`);
+            if (hasLoneSurrogate(v))
+                throw usageError(`macros: the value for key ${JSON.stringify(k)} is not valid UTF-8, and ${NON_UTF8_HINT}`);
+        }
         out.macros = { ...profile.macros };
     }
     return Buffer.from(JSON.stringify(out), 'utf8');
 }
+// ---- the options documents (rule r1). Each named member is its own option, and a
+// key the binding has no name for goes through an `...Extra` record as JSON text.
+// The binding builds the document from the members the caller set, sends nothing
+// when none was set, and validates no member: the library refuses a key it does not
+// know, or a value that is not one of the member's, with CHS_INVALID_ARGUMENT,
+// naming it.
+/** `insert_options.verdict_basis`: what row a filter verdict answers for. */
+export const VerdictBasis = {
+    /** The default: the verdict answers for the input row. */
+    Input: 'input',
+    /** The row the export would store. A build that does not implement it declines it. */
+    Export: 'export',
+};
+/** `insert_options.defer_defaults`. */
+export const DeferDefaults = {
+    /** The default: no DEFAULT is deferred. */
+    None: 'none',
+    /** Defer to the server each DEFAULT the build would otherwise decline. A build that does not implement it declines it. */
+    Server: 'server',
+};
+/** `filter_options.param_encoding`: how a query parameter's value is read. */
+export const ParamEncoding = {
+    /** The default: ClickHouse's escaped-text reader. */
+    Escaped: 'escaped',
+    /** The bytes as the value. A build that does not implement it declines it. */
+    Raw: 'raw',
+};
+/** A name or value as a byte-string member: `<key>` when it is text, `<key>_b64` otherwise. */
+function byteMember(what, key, v) {
+    if (typeof v === 'string') {
+        if (hasLoneSurrogate(v))
+            throw usageError(`${what}: the ${key} is not valid UTF-8, and ${NON_UTF8_HINT}`);
+        return { [key]: v };
+    }
+    if (!(v instanceof Uint8Array))
+        throw new TypeError(`chtypes: ${what}: the ${key} must be a string or a Uint8Array, got ${typeof v}`);
+    return isValidUtf8(v) ? { [key]: Buffer.from(v.buffer, v.byteOffset, v.byteLength).toString('utf8') } : { [`${key}_b64`]: asBuffer(v).toString('base64') };
+}
+function nameObject(what, name) {
+    return byteMember(what, 'name', name);
+}
+/** The members of an options document under construction, each as its JSON text, by key; a key set twice keeps the last. */
+class OptionDoc {
+    #members = new Map();
+    what;
+    constructor(what) {
+        this.what = what;
+    }
+    set(key, value) {
+        this.#members.set(key, JSON.stringify(value));
+    }
+    /** Members given as JSON text, passed through verbatim after a validity check. */
+    setRaw(extra) {
+        if (extra === undefined)
+            return;
+        for (const [key, text] of Object.entries(extra)) {
+            if (hasLoneSurrogate(key))
+                throw usageError(`${this.what}: ${keyName(key)} is not valid UTF-8, and ${NON_UTF8_HINT}`);
+            if (typeof text !== 'string')
+                throw new TypeError(`chtypes: ${this.what}[${JSON.stringify(key)}] must be JSON text (a string), got ${typeof text}`);
+            try {
+                JSON.parse(text);
+            }
+            catch {
+                throw usageError(`${this.what}: the value for key ${JSON.stringify(key)} is not valid JSON`);
+            }
+            this.#members.set(key, text);
+        }
+    }
+    /** The document, or nothing (length 0, which the library reads as `{}`) when no member was set. */
+    encode() {
+        if (this.#members.size === 0)
+            return Buffer.alloc(0);
+        const members = [...this.#members].map(([k, text]) => `${JSON.stringify(k)}:${text}`);
+        return Buffer.from(`{${members.join(',')}}`, 'utf8');
+    }
+}
+/** The `insert_options` document of a call that models an INSERT. */
+export function encodeInsertOptions(o) {
+    const doc = new OptionDoc('insert options');
+    if (o.insertableColumns !== undefined)
+        doc.set('insertable_columns', o.insertableColumns.map((n) => nameObject('insert options', n)));
+    if (o.columnDefaults !== undefined) {
+        doc.set('column_defaults', o.columnDefaults.map((d) => ({ ...nameObject('insert options', d.name), ...byteMember('insert options', 'value', d.value) })));
+    }
+    if (o.verdictBasis !== undefined)
+        doc.set('verdict_basis', o.verdictBasis);
+    if (o.deferDefaults !== undefined)
+        doc.set('defer_defaults', o.deferDefaults);
+    doc.setRaw(o.insertOptionsExtra);
+    return doc.encode();
+}
+/** The `filter_options` document of `chs_filter_create`. */
+export function encodeFilterOptions(o) {
+    const doc = new OptionDoc('filter options');
+    if (o.paramEncoding !== undefined)
+        doc.set('param_encoding', o.paramEncoding);
+    doc.setRaw(o.filterOptionsExtra);
+    return doc.encode();
+}
+/** The `schema_options` document of `chs_schema_create`. */
+export function encodeSchemaOptions(o) {
+    const doc = new OptionDoc('schema options');
+    if (o.posture !== undefined)
+        doc.set('posture', o.posture);
+    doc.setRaw(o.schemaOptionsExtra);
+    return doc.encode();
+}
 //# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/setup.d.ts

@@ -25,7 +25,7 @@
  * This is state of the isolate: every worker thread calls it identically, and
  * a worker whose zone differs is refused by the library at its first open.
  */
-import { type Settings } from './settings.js';
+import { type Settings, type WireValue } from './settings.js';
 /** What `setup` takes: the image zone (an IANA name) and the default settings every call starts from. */
 export interface SetupOptions {
     readonly timezone?: string;
@@ -34,7 +34,8 @@ export interface SetupOptions {
 /** The setup in effect, as step 7 applies it. */
 export interface ProcessSetup {
     readonly timezone: string;
-    readonly defaults: Readonly<Record<string, string>>;
+    /** Each default as the library takes it: a JSON string, or `{"b64": ...}` for a value that is not valid UTF-8. */
+    readonly defaults: Readonly<Record<string, WireValue>>;
 }
 /** Record the process setup, once. Call it before the first open; see this module's header for the rule. */
 export declare function setup(options?: SetupOptions): void;

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,KAAK,QAAQ,EAAoB,MAAM,eAAe,CAAC;AAEhE,yGAAyG;AACzG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAuBD,4GAA4G;AAC5G,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,IAAI,CActD;AAED,4KAA4K;AAC5K,wBAAgB,WAAW,IAAI,YAAY,CAI1C;AAED,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wMAAwM;AACxM,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,KAAK,QAAQ,EAAoB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhF,yGAAyG;AACzG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kHAAkH;IAClH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACxD;AAuBD,4GAA4G;AAC5G,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,IAAI,CAatD;AAED,4KAA4K;AAC5K,wBAAgB,WAAW,IAAI,YAAY,CAI1C;AAED,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wMAAwM;AACxM,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}

package/dist/setup.js

@@ -44,15 +44,14 @@ function same(a, b) {
         return false;
     const ak = Object.keys(a.defaults);
     const bk = Object.keys(b.defaults);
-    return ak.length === bk.length && ak.every((k) => Object.hasOwn(b.defaults, k) && a.defaults[k] === b.defaults[k]);
+    return ak.length === bk.length && ak.every((k) => Object.hasOwn(b.defaults, k) && JSON.stringify(a.defaults[k]) === JSON.stringify(b.defaults[k]));
 }
 /** Record the process setup, once. Call it before the first open; see this module's header for the rule. */
 export function setup(options = {}) {
     const timezone = options.timezone ?? '';
     if (typeof timezone !== 'string')
         throw new TypeError(`chtypes: setup timezone must be a string, got ${typeof timezone}`);
-    const defaults = options.defaults ?? {};
-    validateDefaults(defaults);
+    const defaults = validateDefaults(options.defaults ?? {});
     const next = { timezone, defaults: { ...defaults } };
     if (recorded !== undefined && same(recorded, next))
         return;

package/dist/setup.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavehouse/chtypes",
-  "version": "2.0.0-dev.10",
+  "version": "2.0.0-dev.12",
   "description": "ClickHouse's own type system, per version, over the frozen chs_* C ABI",
   "license": "Apache-2.0",
   "type": "module",
@@ -30,8 +30,8 @@
   "devDependencies": {
     "@types/node": "^26.5.0",
     "typescript": "^7.0.2",
-    "vite": "^8.2.2",
-    "vitest": "^5.0.0"
+    "vite": "^8.3.4",
+    "vitest": "^5.0.5"
   },
   "repository": {
     "type": "git",