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

package/dist/schema.d.ts

@@ -16,16 +16,16 @@
  * thread, so the close guard of the other bindings reduces to this check: no
  * call is ever in flight while `close` runs.
  */
-import type { BlockHandle, Calls, FilterHandle, SchemaHandle } from './abi2/index.js';
+import type { BlockHandle, Calls, FilterHandle, Posture, SchemaHandle } from './abi2/index.js';
 import { type Format } from './abi2/index.js';
 import { type BatchResult, type FilterResult, type RowResult, type SchemaDescription } from './documents.js';
 import type { Server } from './server.js';
-import { type BytesIn, type Settings } from './settings.js';
+import { type BytesIn, type ColumnDefault, type DeferDefaults, type ParamEncoding, type SettingValue, type Settings, type VerdictBasis } from './settings.js';
 /** Options of `Library.compileTable`: the profile settings a schema compiles under, and the zone that profile defaults to. */
 export interface CompileOptions {
     readonly settings?: Settings | undefined;
-    /** In a compile profile it is a default for later calls on the schema; a compiled type always takes the image zone, never the profile's. */
-    readonly sessionTimezone?: string | undefined;
+    /** In a compile profile it is a default for later calls on the schema; a compiled type always takes the image zone, never the profile's. Bytes that are not valid UTF-8 are sent in the `{"b64": ...}` object form. */
+    readonly sessionTimezone?: SettingValue | undefined;
     /**
      * Compile on this server (`Library.newServer`): the schema's home zone is the
      * server's timezone, the server's settings layer under the schema's own, and a
@@ -35,14 +35,28 @@ export interface CompileOptions {
      * Absent (or `undefined`) is no server: the schema is on the image's own server.
      */
     readonly server?: Server | undefined;
+    /** `schema_options.posture` (ABI v2): 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`: 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 schemaOptionsExtra?: Readonly<Record<string, string>> | undefined;
 }
-/** Options of `Schema.row` and `Schema.parseBlock`. */
+/** Options of `Schema.row` and `Schema.parseBlock`: the settings, the zone, the INSERT column list and the `insert_options` members (ABI v2). */
 export interface RowOptions {
     readonly settings?: Settings | undefined;
     /** The per-call zone: written into the settings as `session_timezone`, verbatim. */
-    readonly sessionTimezone?: string | undefined;
+    readonly sessionTimezone?: SettingValue | undefined;
     /** The INSERT column list. */
     readonly columns?: readonly BytesIn[] | undefined;
+    /** `insert_options.insertable_columns` (ABI v2): the columns an INSERT may supply. Absent leaves the member out (every column); `[]` is sent as `[]` (no column). */
+    readonly insertableColumns?: readonly BytesIn[] | undefined;
+    /** `insert_options.column_defaults`: per-call DEFAULT overrides. Absent leaves the member out; `[]` is sent as `[]`. */
+    readonly columnDefaults?: readonly ColumnDefault[] | undefined;
+    /** `insert_options.verdict_basis`. */
+    readonly verdictBasis?: VerdictBasis | undefined;
+    /** `insert_options.defer_defaults`. */
+    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;
 }
 /** Options of `Schema.rows`. */
 export interface RowsOptions extends RowOptions {
@@ -59,12 +73,31 @@ export interface FilterOptions {
     readonly params?: Settings | undefined;
     /** The filter's own zone and profile: fixed when it is compiled, and every evaluation of it runs its WHERE under them. */
     readonly settings?: Settings | undefined;
-    readonly sessionTimezone?: string | undefined;
+    readonly sessionTimezone?: SettingValue | undefined;
+    /** `filter_options.param_encoding` (ABI v2): how a query parameter's value is read. */
+    readonly paramEncoding?: ParamEncoding | undefined;
+    /** Any other member of `filter_options`, as `insertOptionsExtra` is for `insert_options`. */
+    readonly filterOptionsExtra?: Readonly<Record<string, string>> | undefined;
 }
-/** Options of `Filter.rows`. The settings are PARSE settings only: they decide how the body is parsed, never the filter's WHERE. */
+/**
+ * Options of `Filter.rows`. The settings are PARSE settings only: they decide how the body is parsed, never the filter's WHERE.
+ * `columns` and the `insert_options` members model the same INSERT as on `Schema.rows` (ABI v2).
+ */
 export interface EvalOptions {
     readonly settings?: Settings | undefined;
-    readonly sessionTimezone?: string | undefined;
+    readonly sessionTimezone?: SettingValue | undefined;
+    /** The INSERT column list. */
+    readonly columns?: readonly BytesIn[] | undefined;
+    /** `insert_options.insertable_columns` (ABI v2): the columns an INSERT may supply. Absent leaves the member out (every column); `[]` is sent as `[]` (no column). */
+    readonly insertableColumns?: readonly BytesIn[] | undefined;
+    /** `insert_options.column_defaults`: per-call DEFAULT overrides. Absent leaves the member out; `[]` is sent as `[]`. */
+    readonly columnDefaults?: readonly ColumnDefault[] | undefined;
+    /** `insert_options.verdict_basis`. */
+    readonly verdictBasis?: VerdictBasis | undefined;
+    /** `insert_options.defer_defaults`. */
+    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;
 }
 /** A compiled `WHERE`-style expression bound to a schema. It holds its own zone, fixed at compile. */
 export declare class Filter {

package/dist/schema.d.ts.map

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

package/dist/schema.js

@@ -18,7 +18,7 @@
  */
 import { DocFlags, EXPORT_NONE } from './abi2/index.js';
 import { decodeBatch, decodeFilterResult, decodeRow, decodeSchemaDescription, } from './documents.js';
-import { bytesIn, encodeColumns, encodeParams, encodeSettings } from './settings.js';
+import { bytesIn, encodeColumns, encodeFilterOptions, encodeInsertOptions, encodeParams, encodeSettings, } from './settings.js';
 function bodyIn(body) {
     if (typeof body === 'string')
         throw new TypeError('chtypes: a body is bytes (a Uint8Array); it never accepts the text type');
@@ -37,7 +37,7 @@ export class Filter {
     }
     /** Evaluate over a body. */
     rows(format, body, options = {}) {
-        return decodeFilterResult(this.#calls.filterEvalBody(this.#h, format, bodyIn(body), encodeSettings(options.settings, options.sessionTimezone)));
+        return decodeFilterResult(this.#calls.filterEvalBody(this.#h, format, bodyIn(body), encodeSettings(options.settings, options.sessionTimezone), encodeColumns(options.columns), encodeInsertOptions(options)));
     }
     /** Evaluate over a parsed block. The filter brings its zone and the block brought its parse zone, so there are no settings here. */
     eval(block) {
@@ -83,22 +83,22 @@ export class Schema {
     }
     /** One row. */
     row(format, body, options = {}) {
-        return decodeRow(this.#calls.previewRow(this.#h, format, bodyIn(body), encodeSettings(options.settings, options.sessionTimezone), encodeColumns(options.columns)));
+        return decodeRow(this.#calls.previewRow(this.#h, format, bodyIn(body), encodeSettings(options.settings, options.sessionTimezone), encodeColumns(options.columns), encodeInsertOptions(options)));
     }
     /** A whole body. */
     rows(format, body, options = {}) {
         const filter = options.rowFilter === undefined ? null : filterHandles.get(options.rowFilter);
         const exporting = options.exportFormat !== undefined;
-        const out = this.#calls.previewBatch(this.#h, format, bodyIn(body), encodeSettings(options.settings, options.sessionTimezone), encodeColumns(options.columns), filter, exporting ? options.exportFormat : EXPORT_NONE, options.docFlags ?? DocFlags.All);
+        const out = this.#calls.previewBatch(this.#h, format, bodyIn(body), encodeSettings(options.settings, options.sessionTimezone), encodeColumns(options.columns), filter, exporting ? options.exportFormat : EXPORT_NONE, options.docFlags ?? DocFlags.All, encodeInsertOptions(options));
         return decodeBatch(out.out, exporting ? out.outExport : undefined);
     }
     /** Compile a filter. Its zone is fixed here. */
     compileFilter(expr, options = {}) {
-        return new Filter(this.#calls, this.#calls.filterCreate(this.#h, bytesIn(expr), encodeParams(options.params), encodeSettings(options.settings, options.sessionTimezone)));
+        return new Filter(this.#calls, this.#calls.filterCreate(this.#h, bytesIn(expr), encodeParams(options.params), encodeSettings(options.settings, options.sessionTimezone), encodeFilterOptions(options)));
     }
     /** Parse a body once. */
     parseBlock(format, body, options = {}) {
-        return new Block(this.#calls.blockCreate(this.#h, format, bodyIn(body), encodeSettings(options.settings, options.sessionTimezone), encodeColumns(options.columns)));
+        return new Block(this.#calls.blockCreate(this.#h, format, bodyIn(body), encodeSettings(options.settings, options.sessionTimezone), encodeColumns(options.columns), encodeInsertOptions(options)));
     }
     /** Release this schema; idempotent. Filters and blocks made from it keep working. */
     close() {

package/dist/schema.js.map

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

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