chtypes 2.0.0.dev2__py3-none-any.whl → 2.0.0.dev3__py3-none-any.whl

chtypes/__init__.py

@@ -53,6 +53,7 @@ from ._abi2._vocab import (
     DocFlags,
     FilterOutcome,
     Format,
+    MergeReason,
     Outcome,
     Reason,
     Source,
@@ -95,6 +96,7 @@ from .errors import (
 from .library import Block, Filter, Library, Schema, Server, open_unverified
 from .registry import FetchOptions, Registry, Resolved, TrustedKey, cache_root, search_dirs
 from .results import (
+    AtMergeEntry,
     BatchResult,
     BuildInfo,
     Capabilities,
@@ -138,6 +140,7 @@ __all__ = [
     "ArtifactPinnedError",
     "ArtifactUnpublishedError",
     "ArtifactUntrustedError",
+    "AtMergeEntry",
     "BatchResult",
     "Block",
     "BuildInfo",
@@ -166,6 +169,7 @@ __all__ = [
     "Header",
     "InternalError",
     "Library",
+    "MergeReason",
     "Outcome",
     "Reason",
     "Registry",

chtypes/_abi2/_decls.py

@@ -1,4 +1,4 @@
-# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:d87e91be2bbe75b985c38224268c2f7dc5d8236dab0a4b4d61357c6dfdc1a232) — DO NOT EDIT  # noqa: E501
+# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:4129dccc3f4e698dedb0e99cae413f5240085f633c5a1244e2c55bf7a7bb6c3a) — DO NOT EDIT  # noqa: E501
 """The Python binding's generated ABI v2 layer: ctypes signatures, the handle
 classes, the two-phase resolve functions and invoke_by_name(), the test-only
 dispatcher the conformance suite drives from tests/fixtures/abi-v2/cases.json.
@@ -19,7 +19,7 @@ from dataclasses import dataclass, field
 from . import _errmap
 
 CHS_ABI_VERSION = 2
-CHS_ABI_FINGERPRINT = "sha256:d87e91be2bbe75b985c38224268c2f7dc5d8236dab0a4b4d61357c6dfdc1a232"
+CHS_ABI_FINGERPRINT = "sha256:4129dccc3f4e698dedb0e99cae413f5240085f633c5a1244e2c55bf7a7bb6c3a"
 
 # The description's stability: "unstable" while this generation is being
 # designed, so CHS_ABI_FINGERPRINT moves with every change, and "locked" after

chtypes/_abi2/_errmap.py

@@ -1,4 +1,4 @@
-# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:d87e91be2bbe75b985c38224268c2f7dc5d8236dab0a4b4d61357c6dfdc1a232) — DO NOT EDIT  # noqa: E501
+# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:4129dccc3f4e698dedb0e99cae413f5240085f633c5a1244e2c55bf7a7bb6c3a) — DO NOT EDIT  # noqa: E501
 """spec/abi-v2/sdk.json's error-mapping tables, as references to the
 public classes (python/src/chtypes/errors.py, re-exported by
 python/src/chtypes/_abi2/_errors.py). Only the MAPPING is generated: the

chtypes/_abi2/_vocab.py

@@ -1,10 +1,10 @@
-# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:d87e91be2bbe75b985c38224268c2f7dc5d8236dab0a4b4d61357c6dfdc1a232) — DO NOT EDIT  # noqa: E501
+# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:4129dccc3f4e698dedb0e99cae413f5240085f633c5a1244e2c55bf7a7bb6c3a) — DO NOT EDIT  # noqa: E501
 """The Python binding's generated vocabularies, from spec/abi-v2/abi.json: the C
 enums (`Format`, `Status`), the document vocabularies (`Outcome`, `FilterOutcome`,
-`Verdict`, `DefaultKind`, `Reason`, `Source`, `DiscoverQueryParam`) with the facts the
-description attaches to each value (`Format.ch_name`, `Reason` lossy, `Source`
-is_stored, `Verdict.answered`), and the `DocFlags` groups. No other file in this
-package keeps a copy of any of it.
+`Verdict`, `DefaultKind`, `MergeReason`, `Reason`, `Source`, `DiscoverQueryParam`) with the
+facts the description attaches to each value (`Format.ch_name`, `Reason` lossy,
+`Source` is_stored, `Verdict.answered`), and the `DocFlags` groups. No other file in
+this package keeps a copy of any of it.
 
 Rule r3 (spec/abi-v2/docs.md): every vocabulary has an unknown(n) member, and a
 value the description does not list reads as it, carrying the raw value, for that
@@ -225,6 +225,30 @@ class DefaultKind(StrEnum):
         return cls(text)
 
 
+class MergeReason(StrEnum):
+    """What a merge would do to one row of the part an INSERT writes, as a batch's
+    `at_merge` reports it."""
+
+    TTL_DELETE = "ttl_delete"
+    TTL_COLUMN_RESET = "ttl_column_reset"
+
+    @classmethod
+    def _missing_(cls, value: object) -> MergeReason | None:
+        return _unknown_str(cls, value)
+
+    @property
+    def known(self) -> bool:
+        """Whether the description lists this value: False for exactly the unknown(n)
+        member an unlisted value reads as (rule r3)."""
+        return type(self)._value2member_map_.get(self._value_) is self
+
+    @classmethod
+    def of(cls, text: str) -> MergeReason:
+        """Map a document's spelling. One the description does not list is kept as
+        this vocabulary's unknown(n) member, carrying it (rule r3)."""
+        return cls(text)
+
+
 class DiscoverQueryParam(StrEnum):
     """A query parameter of the SQL `discover_query` returns, which the caller binds
     when it runs the query."""
@@ -383,6 +407,7 @@ DESCRIBED_VOCABULARIES: Final[dict[str, type]] = {
     "chs_status": Status,
     "chs_format": Format,
     "transform_reason": Reason,
+    "merge_reason": MergeReason,
     "value_src": Source,
     "row_outcome": Outcome,
     "batch_outcome": Outcome,

chtypes/_decode.py

@@ -28,9 +28,10 @@ import json
 from collections.abc import Callable, Mapping
 from typing import Any
 
-from ._abi2._vocab import DefaultKind, FilterOutcome, Outcome, Reason, Source, Verdict
+from ._abi2._vocab import DefaultKind, FilterOutcome, MergeReason, Outcome, Reason, Source, Verdict
 from .errors import ArtifactCorruptError, internal
 from .results import (
+    AtMergeEntry,
     BatchResult,
     BuildInfo,
     Capabilities,
@@ -325,6 +326,29 @@ def _engine_cell(obj: dict[str, Any], where: str) -> EngineCell:
     )
 
 
+def _int_list(obj: Mapping[str, Any], key: str, where: str) -> tuple[int, ...] | None:
+    """A list of non-negative integers: None when absent."""
+    if obj.get(key) is None:
+        return None
+    out = []
+    for item in _list(obj, key, where):
+        if isinstance(item, bool) or not isinstance(item, int) or item < 0:
+            raise _wrong(where, key, "an array of non-negative integers", item)
+        out.append(item)
+    return tuple(out)
+
+
+def _at_merge(obj: dict[str, Any], where: str) -> AtMergeEntry:
+    # An unlisted reason is its unknown(n): kept, never a failure (rule r3).
+    return AtMergeEntry(
+        row=_int(obj, "row", where),
+        reason=MergeReason.of(_text(obj, "reason", where)),
+        column=_bytes_or_none(obj, "column", where),
+        stored=_bytes_or_none(obj, "stored", where),
+        input_rows=_int_list(obj, "input_rows", where),
+    )
+
+
 def _engine_rows(obj: Mapping[str, Any], where: str) -> tuple[tuple[EngineCell, ...], ...]:
     rows = []
     for i, row in enumerate(_list(obj, "engine_rows", where)):
@@ -411,6 +435,8 @@ def decode_batch(raw: bytes, export: bytes | None) -> BatchResult:
         framing=None
         if framing is None
         else _framing(_obj(framing, where, "framing"), f"{where}.framing"),
+        unsupported_settings=_name_list(obj, "unsupported_settings", where),
+        at_merge=_objects(obj, "at_merge", where, _at_merge),
     )
 
 

chtypes/_ocifetch/_channel.py

@@ -18,6 +18,19 @@ five ways:
   used through its subroot `<cache>/v2-dev`, never as a whole layout;
 - a signed predicate must say abi 2.
 
+It also resolves one tag the v1 contract never asks for: a version request
+fetches `<tag>--fp-<its own fingerprint>` first, the newest dev build of the ABI
+this binding speaks, and falls back to `<tag>` only when no base has that alias
+(docs/guides/fetch-v1.md §3, "The dev channel's alias step"), so a dev build of a
+newer fingerprint never strands this one. Its cache lookups (`resolve_installed`,
+and `ensure`'s offline answer and its monotonic rule) see only the records whose
+signed `abi_fingerprint` is its own: a build of another fingerprint in a shared
+cache is never returned and never kept over this one's own, and it is never
+removed or rewritten either. It is automatic, with no override; the trust checks
+are unchanged, and a listing never shows an alias. The fingerprint
+is the generated `CHS_ABI_FINGERPRINT` of the ABI layer (`chtypes._abi2._decls`),
+never a hand-written copy.
+
 The v1 contract itself stays in this package, unchanged, because the fetch-v1
 conformance cases (tests/fixtures/fetch-v1) are its specification and the dev
 channel shares every other rule with it. Only a test run reaches it:
@@ -29,16 +42,19 @@ override a user can reach.
 from __future__ import annotations
 
 import os
+import re
 import sys
 import threading
 from collections.abc import Callable, Sequence
 from dataclasses import dataclass, replace
 from typing import Final, Protocol
 
+from chtypes._abi2._decls import CHS_ABI_FINGERPRINT
 from chtypes._ocifetch import _constants as C
 from chtypes._ocifetch._dsse import TrustedKey
 
 __all__ = [
+    "ALIAS_SEPARATOR",
     "DEV_ABI_GENERATION",
     "DEV_CACHE_DIR",
     "DEV_CHANNEL_BASE",
@@ -50,12 +66,15 @@ __all__ = [
     "PinningRefusedError",
     "abi",
     "active",
+    "alias_tag",
     "allow_overrides_for_tests",
     "channel_name",
     "enforce",
     "ignored_settings_warned",
     "pinning_requested",
     "trusted_keys",
+    "use_own_fingerprint_for_tests",
+    "visible",
     "use_dev_channel_for_tests",
     "use_fetch_v1_for_tests",
 ]
@@ -79,6 +98,10 @@ DEV_RECORD_SCHEMA: Final = 2
 # The abi a dev predicate must carry.
 DEV_ABI_GENERATION: Final = 2
 
+# Joins a tag and a fingerprint into the dev channel's alias tag:
+# <tag>--fp-<64 lowercase hex> (docs/guides/fetch-v1.md §3).
+ALIAS_SEPARATOR: Final = "--fp-"
+
 # What every lock, frozen or update request gets from a 2.0.0-dev SDK, before
 # any network call (rule r6).
 PINNING_REFUSED: Final = (
@@ -102,6 +125,11 @@ class Channel:
     keys: tuple[dict[str, str], ...]  # {"keyid", "ed25519_hex"}: the default trust
     overridable: bool  # the base, trust and unsigned overrides are honored
     pinnable: bool  # lock, frozen and update are honored
+    # The fingerprint, 64 lowercase hex, this contract's SDK speaks: a version
+    # request resolves its alias tag before the tag itself, and the cache
+    # lookups see only records signed with it. "" does neither (the v1 contract
+    # and every production channel).
+    own_fingerprint: str = ""
 
 
 # What a 2.0.0-dev SDK speaks, and what every process speaks unless a test
@@ -117,6 +145,7 @@ DEV_CHANNEL: Final = Channel(
     keys=({"keyid": DEV_KEY_ID, "ed25519_hex": DEV_KEY_HEX},),
     overridable=False,
     pinnable=False,
+    own_fingerprint=CHS_ABI_FINGERPRINT.removeprefix("sha256:"),
 )
 
 # The v1 contract the fetch-v1 conformance cases specify, from the generated
@@ -202,6 +231,49 @@ def allow_overrides_for_tests() -> Callable[[], None]:
     return _use(replace(DEV_CHANNEL, overridable=True))
 
 
+_FINGERPRINT_HEX = re.compile(r"[0-9a-f]{64}")
+
+
+def use_own_fingerprint_for_tests(fingerprint: str) -> Callable[[], None]:
+    """Make this TEST run's active contract speak `fingerprint` (64 lowercase
+    hex) as the dev channel speaks its own: a version request resolves that
+    fingerprint's alias tag first, and the cache lookups see only records
+    signed with it. The fetch-v1 conformance cases that carry
+    `request.own_fingerprint` run under it, against fixtures that name a
+    fixture fingerprint. Everything else stays the active contract's. Returns
+    the restore function; raises outside a test run or on a fingerprint that is
+    not 64 lowercase hex."""
+    _test_only("use_own_fingerprint_for_tests")
+    if not _FINGERPRINT_HEX.fullmatch(fingerprint):
+        raise ValueError(f"use_own_fingerprint_for_tests: {fingerprint!r} is not 64 lowercase hex")
+    return _use(replace(active(), own_fingerprint=fingerprint))
+
+
+def alias_tag(tag: str, channel: Channel | None = None) -> str | None:
+    """The alias a version request for `tag` resolves first under a contract
+    with an own fingerprint, or None when it resolves `tag` alone: under the
+    v1 contract and every production channel, and for a request that is not a
+    version spelling (an arbitrary tag has no alias)."""
+    channel = channel or active()
+    if not channel.own_fingerprint or not re.fullmatch(C.SPELLING_REGEX, tag):
+        return None
+    return f"{tag}{ALIAS_SEPARATOR}{channel.own_fingerprint}"
+
+
+def visible(predicate: object, channel: Channel | None = None) -> bool:
+    """Whether a cache record (or a pre-seeded entry) whose SIGNED predicate is
+    `predicate` may answer a request under the active contract: under one with
+    an own fingerprint (the dev channel), only when the predicate's
+    `abi_fingerprint` is that fingerprint; under every other, always. A record
+    it cannot see is never returned and never kept by the monotonic rule, and
+    nothing removes or rewrites it: another SDK of another fingerprint owns it."""
+    channel = channel or active()
+    if not channel.own_fingerprint:
+        return True
+    fingerprint = predicate.get("abi_fingerprint") if isinstance(predicate, dict) else None
+    return fingerprint == f"sha256:{channel.own_fingerprint}"
+
+
 def use_dev_channel_for_tests() -> Callable[[], None]:
     """Make this TEST run speak the dev channel exactly as a user's process does
     (undoing either function above, for a test of the dev channel itself).

chtypes/_ocifetch/_ensure.py

@@ -355,6 +355,10 @@ def _newer_installed(
     (`26.3.4.1`) keeps only a newer BUILD of that exact version. A request
     that is not a version spelling (an arbitrary tag) names no range, so
     nothing is kept for it.
+
+    Under the dev channel only an install of its own fingerprint counts
+    (`_channel.visible`): a newer build of another fingerprint, installed by
+    another dev SDK, is never kept over this one's own.
     """
     if not re.match(C.SPELLING_REGEX, request_spelling):
         return None
@@ -368,6 +372,8 @@ def _newer_installed(
     for dir_, record in list_verified_records(roots):
         if record.platform != platform_key:
             continue
+        if not _channel.visible(record.predicate):
+            continue  # another fingerprint's build (_channel.visible): never kept over this one's
         if not version_within_request(record.version, request_spelling):
             continue
         version_key = _version_key(record.version)
@@ -693,7 +699,11 @@ def _ensure_floating(
     scratch_root = _scratch_root(cache_root_path)
 
     index_doc, index_bytes, index_digest = fetch_manifest_by_tag(
-        bases, request.spelling, policy=policy, retry=retry
+        bases,
+        request.spelling,
+        policy=policy,
+        retry=retry,
+        alias=_channel.alias_tag(request.spelling),
     )
     platform_desc = resolve_platform_manifest(index_doc, platform_key)
     manifest_hex = parse_digest(platform_desc.digest)
@@ -1050,6 +1060,7 @@ def _verify_and_install_from_local_blobs(
     manifest_digest: str,
     cache_write_root: Path,
     trusted_keys: tuple[TrustedKey, ...],
+    visible_only: bool = False,
 ) -> VerifiedRecord | None:
     """docs/guides/fetch-v1.md §1/§6: "A pre-seeded layout has entries in
     `index.json` with no corresponding `unpacked/` directory yet; the first
@@ -1103,6 +1114,9 @@ def _verify_and_install_from_local_blobs(
         return None
 
     predicate = verified.statement.predicate
+    if visible_only and not _channel.visible(predicate):
+        # A lookup never installs another fingerprint's pre-seeded build.
+        return None
     layer_hex = parse_digest(layer_desc.digest)
     if layer_hex not in verified.statement.subject_sha256:
         return None
@@ -1180,6 +1194,7 @@ def _verify_preseeded_entries(roots: Sequence[Path], trusted_keys: tuple[Trusted
                 manifest_digest=digest,
                 cache_write_root=cache_write_root,
                 trusted_keys=trusted_keys,
+                visible_only=True,
             )
             if record is not None:
                 already_verified.add(digest)
@@ -1224,7 +1239,10 @@ def resolve_installed(request: Request, platform: str, options: Options) -> Reso
     candidates = [
         (dir_path, record)
         for dir_path, record in list_verified_records(roots)
-        if record.platform == platform and version_within_request(record.version, request.spelling)
+        if record.platform == platform
+        and version_within_request(record.version, request.spelling)
+        # Under the dev channel, only its own fingerprint's builds (_channel.visible).
+        and _channel.visible(record.predicate)
     ]
     if not candidates:
         return None

chtypes/_ocifetch/_http.py

@@ -88,6 +88,12 @@ class NotFoundHttpError(TransportError):
     """A 404 (or, for a `file://` base, a missing path)."""
 
 
+class AliasNotFoundError(TransportError):
+    """`mode="alias"`: every configured base answered the alias tag 404 (or,
+    for a `file://` base, has no such path). The one alias outcome the caller
+    answers with the tag itself (docs/guides/fetch-v1.md §3)."""
+
+
 class UnauthorizedHttpError(TransportError):
     """A 401 that is not (or is no longer) resolvable by the anonymous token flow."""
 
@@ -506,6 +512,12 @@ def fetch_from_bases(
       where it is retried within the shared budget before giving up — a
       listed digest that 404s is a host fault, never "unpublished", so the
       final exception for this mode is always `UnreachableHttpError`.
+    - `alias`: the dev channel's alias tag (docs/guides/fetch-v1.md §3). A 404
+      moves to the next base, as for a tag, but only a 404 on EVERY base is
+      "not found" (`AliasNotFoundError`, which the caller answers with the tag
+      itself). Any other failure on any base is raised as that failure, as the
+      tag would get it, so a transient error can never route a request to the
+      tag, which may name a build of another fingerprint.
 
     `decided-here` (the spec does not state it): when bases disagree — some
     404, some unreachable — the outcome follows the LAST base tried, since
@@ -516,6 +528,7 @@ def fetch_from_bases(
         raise UnreachableHttpError("no base URLs configured")
     last_index = len(bases) - 1
     last_error: TransportError | None = None
+    alias_failure: TransportError | None = None  # mode="alias": a base's non-404 failure
     for i, base in enumerate(bases):
         is_last = i == last_index
         scheme = urlsplit(base).scheme
@@ -538,8 +551,13 @@ def fetch_from_bases(
             continue
         except UnreachableHttpError as e:
             last_error = e
+            alias_failure = e
             continue
     assert last_error is not None
+    if mode == "alias":
+        if alias_failure is None:
+            raise AliasNotFoundError(f"{path}: not found on any configured base")
+        last_error = alias_failure
     if mode == "tag" and isinstance(last_error, NotFoundHttpError):
         raise last_error
     if isinstance(last_error, (UnauthorizedHttpError, ForbiddenHttpError)):

chtypes/_ocifetch/_oci.py

@@ -16,7 +16,13 @@ from chtypes._ocifetch._errors import (
     ArtifactUnpublishedError,
     SourceIncompatibleError,
 )
-from chtypes._ocifetch._http import FetchPolicy, RetryPolicy, fetch_from_bases, get_json
+from chtypes._ocifetch._http import (
+    AliasNotFoundError,
+    FetchPolicy,
+    RetryPolicy,
+    fetch_from_bases,
+    get_json,
+)
 
 __all__ = [
     "Descriptor",
@@ -242,9 +248,31 @@ def fetch_manifest_by_tag(
     policy: FetchPolicy,
     retry: RetryPolicy,
     max_bytes: int = C.MANIFEST_MAX_BYTES,
+    alias: str | None = None,
 ) -> tuple[dict, bytes, str]:
-    """GET manifests/<tag>; returns (doc, raw_bytes, resolved_digest)."""
+    """GET manifests/<tag>; returns (doc, raw_bytes, resolved_digest).
+
+    With `alias` (the dev channel's `<tag>--fp-<fingerprint>`, from
+    `_channel.alias_tag`), GET manifests/<alias> first, and the tag only when
+    every base answered the alias 404 (docs/guides/fetch-v1.md §3); any other
+    failure of the alias request is raised as it is. What is returned is then
+    trusted exactly as the tag's own answer would be."""
     accept = (C.MEDIA_TYPE_INDEX, C.MEDIA_TYPE_MANIFEST)
+    if alias is not None:
+        try:
+            doc, resp = get_json(
+                bases,
+                f"/manifests/{alias}",
+                mode="alias",
+                accept=accept,
+                max_bytes=max_bytes,
+                policy=policy,
+                retry=retry,
+            )
+        except AliasNotFoundError:
+            pass
+        else:
+            return doc, resp.body, f"sha256:{hashlib.sha256(resp.body).hexdigest()}"
     doc, resp = get_json(
         bases,
         f"/manifests/{tag}",

chtypes/results.py

@@ -14,9 +14,10 @@ from __future__ import annotations
 from collections.abc import Mapping
 from dataclasses import dataclass
 
-from ._abi2._vocab import DefaultKind, FilterOutcome, Outcome, Verdict
+from ._abi2._vocab import DefaultKind, FilterOutcome, MergeReason, Outcome, Verdict
 
 __all__ = [
+    "AtMergeEntry",
     "BatchResult",
     "BuildInfo",
     "Capabilities",
@@ -108,6 +109,31 @@ class EngineCell:
     value: bytes | None = None
 
 
+@dataclass(frozen=True, slots=True)
+class AtMergeEntry:
+    """One thing an `OPTIMIZE TABLE ... FINAL` of the part the INSERT writes would do
+    to one of its rows, at the call's clock instant: an entry of the batch's
+    `at_merge` list (ABI v2). `engine_rows` stays exactly what the INSERT writer
+    produces, so the two never contradict each other.
+
+    `row` indexes `engine_rows`: the part's row, not the input body's. `reason` is
+    a `MergeReason`; one the description does not list is its unknown(n) member
+    (rule r3). `column` is the column a `ttl_column_reset` resets (from `column`
+    or `column_b64`), None when the entry names none. `stored` is the column's
+    value after the reset (from `stored` or `stored_b64`), None when the document
+    carries none, which it omits when the column's DEFAULT reads the clock or a
+    generator and the value is decided at the merge. `input_rows` is the input
+    rows, each by its index in the body, that formed the part's row, None when
+    the document carries none.
+    """
+
+    row: int
+    reason: MergeReason
+    column: bytes | None = None
+    stored: bytes | None = None
+    input_rows: tuple[int, ...] | None = None
+
+
 @dataclass(frozen=True, slots=True)
 class RowResult:
     """The `row` document. `columns` is every `cols` entry in document order;
@@ -160,6 +186,12 @@ class BatchResult:
     can be fooled too. A caller that needs every record accounted for declines
     a body with any skipped row or any `unconsumed` range
     (docs/guides/batches.md).
+
+    `unsupported_settings` is the call's own settings the library declined, from
+    the batch's top-level list (ABI v2). `at_merge` is what an `OPTIMIZE TABLE ...
+    FINAL` of the part would do to its rows, at least: a later background merge
+    can remove more as more rows expire, and a row both removed and reset lists
+    only `ttl_delete`. Each is empty when the document carries none.
     """
 
     outcome: Outcome
@@ -178,6 +210,8 @@ class BatchResult:
     partition_count: int | None
     unconsumed: tuple[Span, ...]
     framing: Framing | None
+    unsupported_settings: tuple[bytes, ...] = ()
+    at_merge: tuple[AtMergeEntry, ...] = ()
 
 
 @dataclass(frozen=True, slots=True)

{chtypes-2.0.0.dev2.dist-info → chtypes-2.0.0.dev3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: chtypes
-Version: 2.0.0.dev2
+Version: 2.0.0.dev3
 Summary: Python binding for the chtypes artifacts: ClickHouse's own type system, per version, behind the frozen chs_* C ABI
 Project-URL: Homepage, https://github.com/wave-rf/chtypes
 Project-URL: Repository, https://github.com/wave-rf/chtypes
@@ -19,7 +19,7 @@ Description-Content-Type: text/markdown
 
 # chtypes — Python SDK
 
-> **2.0.0-dev: UNSTABLE, staging only, not for production.** This is the ABI v2 development binding (public issue #511). It speaks ABI v2's unstable description, pins its dev fingerprint and refuses a library with any other ("update your dev SDK"). It fetches only from the staging dev channel (`https://registry-staging.wavehouse.dev/chtypes/v2-dev`) and trusts only the staging key; `CHTYPES_ARTIFACTS_URL`, `CHTYPES_TRUSTED_KEYS` and `CHTYPES_ALLOW_UNSIGNED`, and the `bases`, `trusted_keys` and `allow_unsigned` fetch options, are ignored, each with one warning; `--lock`, `--frozen` and `--update`, and the `frozen`, `lock_path`, `lock_write` and `update` options, are refused, because a dev build is replaceable and a superseded one expires after 14 days. Its cache is `${XDG_CACHE_HOME:-~/.cache}/chtypes/v2-dev`, or `<CHTYPES_CACHE>/v2-dev` under an explicit cache, which no 1.x SDK reads. Every vocabulary keeps a value it does not list as its `unknown(n)` member (`Outcome("x")`, whose `known` is `False`) instead of failing the document. The rules are r1 to r6 of [`docs/reference/abi-v2.md`](../docs/reference/abi-v2.md). For production, use the 1.x package: `pip install "chtypes<2"`.
+> **2.0.0-dev: UNSTABLE, staging only, not for production.** This is the ABI v2 development binding (public issue #511). It speaks ABI v2's unstable description, pins its dev fingerprint and refuses a library with any other ("update your dev SDK"). It fetches only from the staging dev channel (`https://registry-staging.wavehouse.dev/chtypes/v2-dev`) and trusts only the staging key; `CHTYPES_ARTIFACTS_URL`, `CHTYPES_TRUSTED_KEYS` and `CHTYPES_ALLOW_UNSIGNED`, and the `bases`, `trusted_keys` and `allow_unsigned` fetch options, are ignored, each with one warning; `--lock`, `--frozen` and `--update`, and the `frozen`, `lock_path`, `lock_write` and `update` options, are refused, because a dev build is replaceable and a superseded one expires after 14 days. Its cache is `${XDG_CACHE_HOME:-~/.cache}/chtypes/v2-dev`, or `<CHTYPES_CACHE>/v2-dev` under an explicit cache, which no 1.x SDK reads. A dev SDK prefers the newest build of its own fingerprint: it resolves `<tag>--fp-<its fingerprint>` first and the tag only when no such build exists, and its cache lookups ignore another dev SDK's builds in a shared cache, so a newer dev fingerprint never strands it (§3 of [`docs/guides/fetch-v1.md`](../docs/guides/fetch-v1.md)). Every vocabulary keeps a value it does not list as its `unknown(n)` member (`Outcome("x")`, whose `known` is `False`) instead of failing the document. The rules are r1 to r6 of [`docs/reference/abi-v2.md`](../docs/reference/abi-v2.md). For production, use the 1.x package: `pip install "chtypes<2"`.
 >
 > An explicit cache directory gets the `v2-dev` subroot whether it comes from `CHTYPES_CACHE` or from `FetchOptions(cache_dir=...)`: the layout is under `<cache_dir>/v2-dev`, never in the directory itself, so code that inspects or pre-populates a cache looks there; `chtypes.cache_root` and `chtypes.search_dirs` return the resolved paths. `CHTYPES_OFFLINE=1` is the environment twin of `FetchOptions(offline=True)` and `--offline`: the cache only, no request.
 

{chtypes-2.0.0.dev2.dist-info → chtypes-2.0.0.dev3.dist-info}/RECORD

@@ -1,6 +1,6 @@
-chtypes/__init__.py,sha256=aIVdrUX79p18amwUcV27FItM4SA1n-LlipJHLopgHgU,5919
+chtypes/__init__.py,sha256=zKL5Y9XuiwZb-Ewfgvhr9IFxdpqpBS7Ub2ca68ZOxJc,5993
 chtypes/__main__.py,sha256=XYGNTpTLXI1AUp7srvuNVv2SZAcfwLaXpoXRVInyhF4,14030
-chtypes/_decode.py,sha256=i_nHXx6QKCbXej0GJMnfq_utRE-Oq7SiqPNETOmhFZ4,21149
+chtypes/_decode.py,sha256=5f-OamDm8Qx17FAWOdHO7ng7r16ZRtYy6QKn1LlnVrc,22207
 chtypes/_ed25519.py,sha256=uwaAKWvgoc936e1ZfgLrtR47W87WWCL541kFaqBXrB0,4141
 chtypes/_guard.py,sha256=zTtwprCS0XvGWY7GDozo-IP6GwjMAWl-o-AjShdCSVI,1985
 chtypes/_input.py,sha256=i4OUmgmHxx618g0DVFYy8LmHhggfBT03NyMxH3ptZBI,6020
@@ -9,29 +9,29 @@ chtypes/errors.py,sha256=9qv94rxbe7hm7lSVFG33Qri82FwDtCY-EnJiwnMfkp8,9501
 chtypes/library.py,sha256=G6DJFiRuv8--JARxfiSNEqeFLkafaMs_n9nG-IwoC74,17878
 chtypes/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 chtypes/registry.py,sha256=HTrzS_3HjOkH4rU90AVMNfFLsLoaut0jgNlt_BJ28QY,13727
-chtypes/results.py,sha256=AI0QALKW-NcgM5qOUxUMesFXd4BcsujzuiaG8ejBelg,9330
+chtypes/results.py,sha256=6uvfkt8dLd-F9aXyxdzWU5_kDVRVirhwB3fcH5NhJDA,11037
 chtypes/_abi2/__init__.py,sha256=d3i7_iUDMFT1jg49vRQz1SMH6oseYZHUR0oPt6aSTiY,1042
-chtypes/_abi2/_decls.py,sha256=c2xuqG0rFgSthOO1FHEGzPhr4ldKQzoOdRxyXaEslq8,38454
-chtypes/_abi2/_errmap.py,sha256=L6WmPSXqqEoNchX1jrfWsbogthm5crwF-8tQBly330E,2886
+chtypes/_abi2/_decls.py,sha256=ZFJUVXYIlyuKVRJyVh8KVxkT4GZjsY-CeCcohK4sWMQ,38454
+chtypes/_abi2/_errmap.py,sha256=uQZ_rMaUU-tk1rSJ5wq_EjOkjesGeF-BKDJOs00KK3I,2886
 chtypes/_abi2/_errors.py,sha256=wRE9M0oYtJz_9izQqpEBh5571M_1QzGWBoJ3pJTykWw,761
 chtypes/_abi2/_loader.py,sha256=VMWrbWMp9Uq3K-7a219lfqAmSmBlD2hcB6WDJgG8XG0,12514
-chtypes/_abi2/_vocab.py,sha256=6UyJwWDnp_R59YMDF7ZWuLchVU7Sq8asmQChH21QEDw,14663
+chtypes/_abi2/_vocab.py,sha256=kH58IzFHpK93ihNBo8UKMtJM6-umxbCaCZlFcqCk7Ro,15543
 chtypes/_ocifetch/__init__.py,sha256=enfPOKkqP4kqAKqckBGWXN1OQsiYo9ngDP-wzG0zn2I,1484
-chtypes/_ocifetch/_channel.py,sha256=p6FbWbrCBTyXmYjdP4UOkkjj02aEkn8Em9EE6xuUZ1Y,12121
+chtypes/_ocifetch/_channel.py,sha256=yqnb35GGxdviipspR3B10t6ZgI8RJMFvW7AnB7zYYfs,15981
 chtypes/_ocifetch/_constants.py,sha256=UdOGIShDXaDP13NGbuftKZRE4u7VK8JfZmoeChw4GMU,5467
 chtypes/_ocifetch/_dsse.py,sha256=0RaFJaG1jhXr1uPfuHxm7yAn6viNzYhfCRUf-sW5SvQ,9333
-chtypes/_ocifetch/_ensure.py,sha256=NG_Fhg-UkafZZC5oHnG4f61W9-sWp9jE8gXOWEWJWrs,60772
+chtypes/_ocifetch/_ensure.py,sha256=gbUSpWvdXP9f6dlFWPk67Cl_bPJ02ehTRLkDrSVNnHI,61565
 chtypes/_ocifetch/_errors.py,sha256=u0eIdrr3g00ugy8ZZoAXYIgUuZgEs6eMue2QkcWXC6w,6595
 chtypes/_ocifetch/_faults.py,sha256=HpoB9tJW7aLRiJdCFnspzkwhpFATZ6f6hGi49Mbfnhs,7609
 chtypes/_ocifetch/_goldens.py,sha256=8MicgeJSRd4WZkaEsdujRnOa7twQvbT-wfSMPZaD-ms,4191
-chtypes/_ocifetch/_http.py,sha256=vz3i0p5I8ch8SONpoEab0Vb5uX9MvPOHjfcaGU03bgo,22807
+chtypes/_ocifetch/_http.py,sha256=DGUW6ym9mrxOgn-9FcdqzuvVGcG9WJGlYyGHnkUvGRA,23817
 chtypes/_ocifetch/_layout.py,sha256=ezEoVrsSMhvDhQ4U04hsGdu1-_ISZQ4V6zg4gGIChTQ,21300
 chtypes/_ocifetch/_lock.py,sha256=14_uex9qXdOht-5FSrSvFvd99-gB7DmI3bDuxXs4YU8,5530
-chtypes/_ocifetch/_oci.py,sha256=lmrlykbyQev55uFDn8UBwXyMLthd3-pQq3xIyfXCUXY,12704
+chtypes/_ocifetch/_oci.py,sha256=YJi8y2iKIRh1_YI8lodWZXRxQfb_KrD5BhM-TQA1SCo,13595
 chtypes/_ocifetch/_referrers.py,sha256=J2b4gN6vryz_IzYHxrd2Tp-tQO9Cz766rZtKgCVcKqA,6008
 chtypes/_ocifetch/_unpack.py,sha256=Cn4-up63KL63L8pnkS5zwJ6VbbHPSigpCnmOdcHJ4RI,5609
-chtypes-2.0.0.dev2.dist-info/METADATA,sha256=ORRyWPTzbIQl_tI3z1ZSAWNYwcOesmInGA0xvW6Eb5o,10632
-chtypes-2.0.0.dev2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-chtypes-2.0.0.dev2.dist-info/entry_points.txt,sha256=TdNcluWBR0VOt5mVFROsp-NiVPAdR3EHo0UsHlMC0r0,50
-chtypes-2.0.0.dev2.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-chtypes-2.0.0.dev2.dist-info/RECORD,,
+chtypes-2.0.0.dev3.dist-info/METADATA,sha256=pCbL5T3EMtLWBTmEaHMGlNSjnUUQOJwYEWF5k7ycUk0,10966
+chtypes-2.0.0.dev3.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+chtypes-2.0.0.dev3.dist-info/entry_points.txt,sha256=TdNcluWBR0VOt5mVFROsp-NiVPAdR3EHo0UsHlMC0r0,50
+chtypes-2.0.0.dev3.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+chtypes-2.0.0.dev3.dist-info/RECORD,,