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

package/dist/registry.d.ts

@@ -15,6 +15,20 @@
  *     5. loader steps 1-6, once per image; step 7 under the process setup
  *     6. the image's Library, whose `resolved` is the record that first opened it
  *
+ *   registry.fetch(request)   (public issue #492)
+ *     ensure(request, fetch options) for this host, and nothing opened: no
+ *     image loaded, no setup touched, nothing memoized or in `libraries()`.
+ *
+ * One fetch per request at a time: an open that misses the cache and may fetch
+ * and a `fetch` of the same request share the fetch in progress, and each gets
+ * its answer; a failed fetch is never remembered.
+ *
+ * Every build the registry opens or fetches is held by this process until it
+ * exits (`hold`, the shared flock on the entry's `verified.json`), so
+ * `chtypes prune` never removes it meanwhile (public issue #494). A build a
+ * concurrent prune removed between the lookup and the hold is looked up (or
+ * fetched) again, once.
+ *
  * This is the 2.0.0-dev registry: its fetch layer speaks the ABI v2 dev channel
  * (`./ocifetch/channel.ts`; `spec/abi-v2/docs.md`, rules r5 and r6). A pinning
  * option (`frozen`, `lockPath`, `lockWrite`, `update`) is refused at
@@ -27,9 +41,55 @@
  * installed build a floating request means is the fetch layer's.
  */
 import { type Library } from './library.js';
-import { type FetchV1Options, type Resolved } from './ocifetch/index.js';
-/** The fetch layer's options (bases, cache directory, system directories, trusted keys, token, allow-unsigned, offline, frozen, lock path, ...) without its test-only hooks. */
-export type FetchOptions = Omit<FetchV1Options, 'beforeIndexRename' | 'httpLog' | 'clock'>;
+import { type Resolved } from './ocifetch/index.js';
+/**
+ * What the fetch layer is configured with (`docs/guides/fetch-v1.md`; `docs/reference/bindings-v1.md` §6), under
+ * the same names as Go's, Python's and Rust's fields, each falling back to its environment variable and then to
+ * the fetch layer's own default. The fetch layer's test hooks are not here, and a registry opens libraries for
+ * this host only (`chtypes fetch --platform` names another).
+ */
+export interface FetchOptions {
+    /** Base URLs, most preferred first; overrides `CHTYPES_ARTIFACTS_URL` and the built-in list. */
+    readonly bases?: readonly string[] | undefined;
+    /** The cache (`CHTYPES_CACHE`). */
+    readonly cacheDir?: string | undefined;
+    /** Read-only system directories searched after the cache; undefined is the built-in list, `[]` none. */
+    readonly systemDirs?: readonly string[] | undefined;
+    /** Raw 32-byte ed25519 public keys, each as 64 hex characters (`CHTYPES_TRUSTED_KEYS`'s spelling); the key id is derived. A non-empty list REPLACES the default trust. */
+    readonly trustedKeys?: readonly string[] | undefined;
+    /** Proceed, with a warning, when no signed statement verifies (`CHTYPES_ALLOW_UNSIGNED`). */
+    readonly allowUnsigned?: boolean | undefined;
+    /** Sent as `Authorization: Bearer <token>` to configured base hosts only (`CHTYPES_DOWNLOAD_TOKEN`). */
+    readonly token?: string | undefined;
+    /** The cache only, no request; on when this is true or `CHTYPES_OFFLINE` is `1` (public issue #528). */
+    readonly offline?: boolean | undefined;
+    /** Fetch exactly the lock's pinned digests. */
+    readonly frozen?: boolean | undefined;
+    /** The lock file. */
+    readonly lockPath?: string | undefined;
+    /** Write (or update) the lock after a successful fetch. */
+    readonly lockWrite?: boolean | undefined;
+    /** Re-resolve every locked request and rewrite the lock. */
+    readonly update?: boolean | undefined;
+    /** Strict mode (public issue #486): every fault of the cache and of an existing system dir is a `CacheUnusableError`. Unset reads `CHTYPES_CACHE_STRICT`. */
+    readonly strictCache?: boolean | undefined;
+    /** Use a build a verified revocation refuses, with one warning naming the advisory (fetch-v1.md, "Build-level revocation"). Per call, never an environment variable, and never with a lock or an update. */
+    readonly allowRevoked?: boolean | undefined;
+    /** A revocation status that cannot be read is the transport's error rather than one warning. */
+    readonly requireRevocationCheck?: boolean | undefined;
+}
+/**
+ * The cache root a fetch, list or `chtypes where` with `options` would use: `options.cacheDir`, else
+ * `CHTYPES_CACHE` (each used through its `v2-dev` subroot, rule r5 of `spec/abi-v2/docs.md`), else `${XDG_CACHE_HOME:-~/.cache}/chtypes/v2-dev`. It is the
+ * fetch layer's own resolution and the first entry of {@link searchDirs}; it creates nothing and reads no cache.
+ */
+export declare function cacheRoot(options?: FetchOptions): string;
+/**
+ * Every directory a lookup reads for installed builds, in the order it reads them: the cache root first, then
+ * each read-only system directory (`options.systemDirs`; undefined is the built-in list, `[]` none). The order is
+ * the fetch layer's own, and on a tie the earlier directory wins. It creates nothing and touches no file.
+ */
+export declare function searchDirs(options?: FetchOptions): readonly string[];
 export interface RegistryOptions {
     readonly fetch?: FetchOptions | undefined;
     /** Fetch on a miss. Defaults to the `CHTYPES_AUTOFETCH` environment variable, and is off when that is unset. */
@@ -37,6 +97,13 @@ export interface RegistryOptions {
     /** Requests opened at construction, in list order. They never fetch, even with autofetch on. */
     readonly preload?: readonly string[] | undefined;
 }
+/**
+ * Test only: `hook` is called with the request each time an open or a `fetch`
+ * of `registry` starts waiting on a fetch, its own or another's, so a test can
+ * hold a fetch until every caller it starts is waiting on it, on events rather
+ * than a clock. `undefined` removes it. Not part of the public API.
+ */
+export declare function onFetchWaitForTests(registry: Registry, hook: ((request: string) => void) | undefined): void;
 export declare class Registry {
     #private;
     private constructor();
@@ -46,6 +113,16 @@ export declare class Registry {
     for(request: string): Promise<Library>;
     /** What is installed: the fetch layer's own listing. */
     installed(): Promise<readonly Resolved[]>;
+    /**
+     * Resolve, fetch, verify and install the build `request` names into the cache, as `chtypes fetch` does, and open
+     * nothing: no library is loaded and the process setup is untouched, so it needs no `setup` (public issue #492). It
+     * honors the registry's fetch options (offline, the cache, and under a production channel the bases, the trust and
+     * the lock), and it shares one fetch with a concurrent open or `fetch` of the same request. The `Resolved` names the
+     * installed version, build, digests and library path. The build is held by this process until it exits, so no
+     * `chtypes prune` removes it meanwhile (public issue #494). A refused spelling is a `UsageError`, as for `for`;
+     * every other failure is the fetch layer's own error, an `ArtifactError` with its code.
+     */
+    fetch(request: string): Promise<Resolved>;
     /** The libraries this registry has opened, in order of first open. */
     libraries(): readonly Library[];
 }

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,cAAc,CAAC;AACvD,OAAO,EAGL,KAAK,cAAc,EAQnB,KAAK,QAAQ,EAId,MAAM,qBAAqB,CAAC;AAK7B,gLAAgL;AAChL,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1C,gHAAgH;IAChH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAClD;AAiBD,qBAAa,QAAQ;;IAMnB,OAAO,eAGN;IAED,iKAAiK;IACjK,OAAa,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAalE;IAED,uHAAuH;IACjH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3C;IAED,wDAAwD;IAClD,SAAS,IAAI,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAE9C;IAED,sEAAsE;IACtE,SAAS,IAAI,SAAS,OAAO,EAAE,CAE9B;CAkEF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAKH,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,cAAc,CAAC;AACvD,OAAO,EAgBL,KAAK,QAAQ,EAKd,MAAM,qBAAqB,CAAC;AAK7B;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/C,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,wGAAwG;IACxG,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACpD,0KAA0K;IAC1K,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACrD,6FAA6F;IAC7F,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,wGAAwG;IACxG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,wGAAwG;IACxG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,6JAA6J;IAC7J,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,4MAA4M;IAC5M,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,gGAAgG;IAChG,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvD;AA0BD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,YAAiB,GAAG,SAAS,MAAM,EAAE,CAExE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1C,gHAAgH;IAChH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAClD;AAoBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAG3G;AAED,qBAAa,QAAQ;;IAQnB,OAAO,eAMN;IAED,iKAAiK;IACjK,OAAa,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAalE;IAED,uHAAuH;IACjH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3C;IAED,wDAAwD;IAClD,SAAS,IAAI,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAE9C;IAED;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAU9C;IAED,sEAAsE;IACtE,SAAS,IAAI,SAAS,OAAO,EAAE,CAE9B;CAmHF"}

package/dist/registry.js

@@ -15,6 +15,20 @@
  *     5. loader steps 1-6, once per image; step 7 under the process setup
  *     6. the image's Library, whose `resolved` is the record that first opened it
  *
+ *   registry.fetch(request)   (public issue #492)
+ *     ensure(request, fetch options) for this host, and nothing opened: no
+ *     image loaded, no setup touched, nothing memoized or in `libraries()`.
+ *
+ * One fetch per request at a time: an open that misses the cache and may fetch
+ * and a `fetch` of the same request share the fetch in progress, and each gets
+ * its answer; a failed fetch is never remembered.
+ *
+ * Every build the registry opens or fetches is held by this process until it
+ * exits (`hold`, the shared flock on the entry's `verified.json`), so
+ * `chtypes prune` never removes it meanwhile (public issue #494). A build a
+ * concurrent prune removed between the lookup and the hold is looked up (or
+ * fetched) again, once.
+ *
  * This is the 2.0.0-dev registry: its fetch layer speaks the ABI v2 dev channel
  * (`./ocifetch/channel.ts`; `spec/abi-v2/docs.md`, rules r5 and r6). A pinning
  * option (`frozen`, `lockPath`, `lockWrite`, `update`) is refused at
@@ -27,13 +41,65 @@
  * installed build a floating request means is the fetch layer's.
  */
 import os from 'node:os';
-import { LoaderCorruptError, openAbi2 } from './abi2/index.js';
+import { corruptRefusal, openAbi2 } from './abi2/index.js';
 import { usageError } from './abi2/index.js';
 import { libraryOf } from './library.js';
-import { ArtifactMissingError, ensure, hostPlatformKey, isFilesystemError, listInstalled, missingNotes, PinningRefusedError, refusePinning, resolveInstalled, satisfiesRequest, withNotes, } from './ocifetch/index.js';
+import { activeChannel, ArtifactMissingError, cacheRoot as fetchCacheRoot, ensure, checkInstalled, hold, hostPlatformKey, isFilesystemError, listInstalled, missingNotes, PinningRefusedError, refusePinning, removedWhileHeld, resolveInstalled, satisfiesRequest, searchDirs as fetchSearchDirs, withNotes, } from './ocifetch/index.js';
 import { ENV_AUTOFETCH_NAME, SPELLING_REGEX } from './ocifetch/constants.gen.js';
-import { withEnvironment } from './env.js';
+import { trustedKeysOfHex, withEnvironment } from './env.js';
 import { commitSetup, latchSetup, settleFailedOpen, setupGeneration } from './setup.js';
+/** The public options as the fetch layer's own: each set field copied, and the trusted keys read from hex. */
+function fetchLayerOptions(options = {}) {
+    const out = {};
+    if (options.bases !== undefined)
+        out.bases = options.bases;
+    if (options.cacheDir !== undefined)
+        out.cacheDir = options.cacheDir;
+    if (options.systemDirs !== undefined)
+        out.systemDirs = options.systemDirs;
+    if (options.trustedKeys !== undefined) {
+        // A channel that honors no trust override ignores the option, with its one
+        // warning, whatever it holds (rule r6), as every binding does.
+        out.trustedKeys = activeChannel().overridable ? trustedKeysOfHex(options.trustedKeys, 'the trustedKeys option') : [];
+    }
+    if (options.allowUnsigned !== undefined)
+        out.allowUnsigned = options.allowUnsigned;
+    if (options.token !== undefined)
+        out.token = options.token;
+    if (options.offline !== undefined)
+        out.offline = options.offline;
+    if (options.frozen !== undefined)
+        out.frozen = options.frozen;
+    if (options.lockPath !== undefined)
+        out.lockPath = options.lockPath;
+    if (options.lockWrite !== undefined)
+        out.lockWrite = options.lockWrite;
+    if (options.update !== undefined)
+        out.update = options.update;
+    if (options.strictCache !== undefined)
+        out.strictCache = options.strictCache;
+    if (options.allowRevoked !== undefined)
+        out.allowRevoked = options.allowRevoked;
+    if (options.requireRevocationCheck !== undefined)
+        out.requireRevocationCheck = options.requireRevocationCheck;
+    return out;
+}
+/**
+ * The cache root a fetch, list or `chtypes where` with `options` would use: `options.cacheDir`, else
+ * `CHTYPES_CACHE` (each used through its `v2-dev` subroot, rule r5 of `spec/abi-v2/docs.md`), else `${XDG_CACHE_HOME:-~/.cache}/chtypes/v2-dev`. It is the
+ * fetch layer's own resolution and the first entry of {@link searchDirs}; it creates nothing and reads no cache.
+ */
+export function cacheRoot(options = {}) {
+    return fetchCacheRoot(options.cacheDir);
+}
+/**
+ * Every directory a lookup reads for installed builds, in the order it reads them: the cache root first, then
+ * each read-only system directory (`options.systemDirs`; undefined is the built-in list, `[]` none). The order is
+ * the fetch layer's own, and on a tie the earlier directory wins. It creates nothing and touches no file.
+ */
+export function searchDirs(options = {}) {
+    return fetchSearchDirs(fetchLayerOptions(options));
+}
 function envFlag(name) {
     const v = process.env[name];
     return v !== undefined && ['1', 'true', 'yes', 'on'].includes(v.trim().toLowerCase());
@@ -44,19 +110,38 @@ function checkSpelling(request) {
         throw usageError(`${JSON.stringify(request)} is not a version spelling: give two, three or four dotted parts (26.8, 26.8.15, 26.8.15.10), with no "v" prefix and no channel suffix`);
     }
 }
+/** The test hook a registry calls each time an open or a `fetch` starts waiting on a fetch, its own or another's; see `onFetchWaitForTests`. */
+const fetchWaitHooks = new WeakMap();
+/**
+ * Test only: `hook` is called with the request each time an open or a `fetch`
+ * of `registry` starts waiting on a fetch, its own or another's, so a test can
+ * hold a fetch until every caller it starts is waiting on it, on events rather
+ * than a clock. `undefined` removes it. Not part of the public API.
+ */
+export function onFetchWaitForTests(registry, hook) {
+    if (hook === undefined)
+        fetchWaitHooks.delete(registry);
+    else
+        fetchWaitHooks.set(registry, hook);
+}
 export class Registry {
     #fetch;
     #autofetch;
     #memo = new Map();
     #opened = [];
+    /** The fetches in progress, by request: every open that misses the cache and every `fetch` of the request waits on the one there. */
+    #fetches = new Map();
     constructor(options) {
-        this.#fetch = withEnvironment(options.fetch ?? {});
+        // The environment fills what the caller left unset. CHTYPES_TARGET names
+        // `chtypes fetch`'s platform, never a registry's: it opens for this host.
+        const { platform: _cliOnly, ...fetch } = withEnvironment(fetchLayerOptions(options.fetch));
+        this.#fetch = fetch;
         this.#autofetch = options.autofetch ?? envFlag(ENV_AUTOFETCH_NAME);
     }
     /** Construct a registry. It opens nothing, except each `preload` request, in list order. A pinning fetch option is refused here, as a `UsageError` (rule r6). */
     static async open(options = {}) {
         try {
-            refusePinning(options.fetch ?? {});
+            refusePinning(fetchLayerOptions(options.fetch));
         }
         catch (err) {
             if (err instanceof PinningRefusedError)
@@ -79,6 +164,27 @@ export class Registry {
     async installed() {
         return listInstalled(this.#fetch);
     }
+    /**
+     * Resolve, fetch, verify and install the build `request` names into the cache, as `chtypes fetch` does, and open
+     * nothing: no library is loaded and the process setup is untouched, so it needs no `setup` (public issue #492). It
+     * honors the registry's fetch options (offline, the cache, and under a production channel the bases, the trust and
+     * the lock), and it shares one fetch with a concurrent open or `fetch` of the same request. The `Resolved` names the
+     * installed version, build, digests and library path. The build is held by this process until it exits, so no
+     * `chtypes prune` removes it meanwhile (public issue #494). A refused spelling is a `UsageError`, as for `for`;
+     * every other failure is the fetch layer's own error, an `ArtifactError` with its code.
+     */
+    async fetch(request) {
+        checkSpelling(request); // misuse, refused before anything is attempted
+        if (hostPlatformKey(os.platform(), os.arch()) === undefined) {
+            throw new ArtifactMissingError(`chtypes: no artifact is published for this host (${os.platform()}-${os.arch()})`);
+        }
+        try {
+            return await this.#ensureHeld(request);
+        }
+        catch (err) {
+            throw typedFilesystemError(err);
+        }
+    }
     /** The libraries this registry has opened, in order of first open. */
     libraries() {
         return [...this.#opened];
@@ -102,15 +208,15 @@ export class Registry {
         return opening;
     }
     async #openRequest(request, mayFetch) {
-        const platform = this.#fetch.platform ?? hostPlatformKey(os.platform(), os.arch());
+        const platform = hostPlatformKey(os.platform(), os.arch());
         if (platform === undefined) {
             throw new ArtifactMissingError(`chtypes: no artifact is published for this host (${os.platform()}-${os.arch()})`);
         }
         let resolved;
         try {
-            resolved = await resolveInstalled(request, platform, this.#fetch);
+            resolved = await this.#lookupHeld(request, platform);
             if (resolved === undefined && mayFetch)
-                resolved = await ensure(request, this.#fetch);
+                resolved = await this.#ensureHeld(request);
         }
         catch (err) {
             throw typedFilesystemError(err);
@@ -133,7 +239,7 @@ export class Registry {
         // own build_info must report a version within the request, whatever the
         // cache answered. The image stays loaded for the requests it does answer.
         if (!satisfiesRequest(request, library.version)) {
-            throw new LoaderCorruptError({
+            throw corruptRefusal({
                 reason: 'build_info_mismatch:clickhouse_version',
                 path: resolved.libraryPath,
                 want: request,
@@ -142,6 +248,59 @@ export class Registry {
         }
         return library;
     }
+    /**
+     * The installed lookup, then this process's hold on the build it found (`hold`), taken before anything reads the
+     * library. A build a concurrent prune removed between the two is looked up again, once; removed twice, it is a
+     * miss.
+     */
+    async #lookupHeld(request, platform) {
+        for (let attempt = 0; attempt < 2; attempt++) {
+            const resolved = await resolveInstalled(request, platform, this.#fetch);
+            if (resolved === undefined)
+                return undefined;
+            // The installed-build revocation check (check_installed; fetch-v1.md,
+            // "Build-level revocation"), before anything reads the library: at most one
+            // per build per process, its warnings printed once on stderr.
+            const checked = await checkInstalled(resolved, this.#fetch);
+            for (const w of checked.warnings)
+                process.stderr.write(`${w}\n`);
+            if (checked.error !== undefined)
+                throw checked.error;
+            if (hold(resolved.dir) !== 'vanished')
+                return resolved;
+        }
+        return undefined;
+    }
+    /**
+     * The request's one fetch (`#ensure`), then this process's hold on the build it installed. A build a concurrent
+     * prune removed between the two is fetched again, once; removed twice, it is `ArtifactMissingError`.
+     */
+    async #ensureHeld(request) {
+        for (let attempt = 0;; attempt++) {
+            const resolved = await this.#ensure(request);
+            if (hold(resolved.dir) !== 'vanished')
+                return resolved;
+            if (attempt === 1)
+                throw removedWhileHeld(request, resolved.dir);
+        }
+    }
+    /**
+     * Joins the fetch in progress for `request`, or starts it: every caller waiting on it gets its answer, and it
+     * leaves the table as it settles, so a failed fetch is never remembered and the next caller starts a new one.
+     */
+    #ensure(request) {
+        let flight = this.#fetches.get(request);
+        if (flight === undefined) {
+            const started = ensure(request, this.#fetch).finally(() => {
+                if (this.#fetches.get(request) === started)
+                    this.#fetches.delete(request);
+            });
+            this.#fetches.set(request, started);
+            flight = started;
+        }
+        fetchWaitHooks.get(this)?.(request);
+        return flight;
+    }
 }
 /**
  * A filesystem failure in the fetch layer (an unwritable or full cache) as

package/dist/registry.js.map

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

package/dist/schema.d.ts

@@ -16,23 +16,47 @@
  * 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 BytesIn, type Settings } from './settings.js';
+import type { Server } from './server.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
+     * Replicated engine's ZooKeeper path and replica name expand the server's
+     * macros. A closed server is a `UsageError`, raised before any call; a server
+     * from another library is that library's own refusal, also a `UsageError`.
+     * 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 {
@@ -49,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/server.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `Server`: one ClickHouse server as a profile describes it (`chs_server`,
+ * `input:server_profile`, `chs_server_create`, `chs_server_free`), made by
+ * `Library.newServer` and passed to `Library.compileTable` as `server`. The
+ * binding serializes the profile and validates nothing in it (`./settings.ts`).
+ *
+ * A server is immutable once made. `close` releases the caller's reference; a
+ * schema compiled on the server holds its own counted reference inside the
+ * library, so a server and its schemas close in any order. A closed server
+ * raises a `UsageError` before any call (its freed handle would otherwise cross
+ * as NULL, which the library takes for no server). A `FinalizationRegistry`
+ * frees what the caller abandons.
+ */
+import type { ServerHandle } from './abi2/index.js';
+export type { ServerProfile } from './settings.js';
+/** The generated layer's handle behind a `Server`. */
+export declare function serverHandleOf(server: Server): ServerHandle;
+/** One ClickHouse server, made by `Library.newServer`. */
+export declare class Server {
+    #private;
+    /** Not for callers: use `Library.newServer`. */
+    constructor(handle: ServerHandle);
+    /** Release this server; idempotent. Schemas compiled on it keep working. */
+    close(): void;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED,0DAA0D;AAC1D,qBAAa,MAAM;;IAGjB,gDAAgD;IAChD,YAAY,MAAM,EAAE,YAAY,EAG/B;IAED,4EAA4E;IAC5E,KAAK,IAAI,IAAI,CAEZ;IAED,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAEvB;CACF"}