chtypes 2.0.0.dev9__py3-none-any.whl → 2.0.0.dev11__py3-none-any.whl

chtypes/__init__.py

@@ -47,28 +47,41 @@ from importlib.metadata import PackageNotFoundError as _PackageNotFound
 from importlib.metadata import version as _package_version
 
 from ._abi2._vocab import (
+    CODE_DECLINED,
     EXPORT_NONE,
     DeclinedLayer,
     DeclinedTier,
     DefaultKind,
+    DefaultSupport,
     DiscoverQueryParam,
     DocFlags,
     FilterOutcome,
     Format,
     MergeReason,
     Outcome,
+    Posture,
     Reason,
+    RefusalSite,
     Source,
     Status,
     Verdict,
 )
-from ._input import BytesIn, ServerProfile, Settings
+from ._input import (
+    BytesIn,
+    ColumnDefault,
+    DeferDefaults,
+    ParamEncoding,
+    ServerProfile,
+    Settings,
+    VerdictBasis,
+)
 from ._setup import setup
 from .errors import (
     CODE_ARTIFACT_CORRUPT,
     CODE_ARTIFACT_INCOMPATIBLE,
     CODE_ARTIFACT_MISSING,
     CODE_ARTIFACT_PINNED,
+    CODE_ARTIFACT_REVOKED,
     CODE_ARTIFACT_UNPUBLISHED,
     CODE_ARTIFACT_UNTRUSTED,
     CODE_CACHE_UNUSABLE,
@@ -77,17 +90,20 @@ from .errors import (
     CODE_SOURCE_RETIRED,
     CODE_SOURCE_UNAUTHORIZED,
     CODE_SOURCE_UNREACHABLE,
+    Advisory,
     ArtifactCorruptError,
     ArtifactError,
     ArtifactIncompatibleError,
     ArtifactMissingError,
     ArtifactPinnedError,
+    ArtifactRevokedError,
     ArtifactUnpublishedError,
     ArtifactUntrustedError,
     CacheUnusableError,
     CallError,
     ChtypesError,
     InternalError,
+    Revocation,
     SchemaError,
     SourceForbiddenError,
     SourceIncompatibleError,
@@ -130,6 +146,7 @@ __all__ = [
     "CODE_ARTIFACT_INCOMPATIBLE",
     "CODE_ARTIFACT_MISSING",
     "CODE_ARTIFACT_PINNED",
+    "CODE_ARTIFACT_REVOKED",
     "CODE_ARTIFACT_UNPUBLISHED",
     "CODE_ARTIFACT_UNTRUSTED",
     "CODE_CACHE_UNUSABLE",
@@ -138,12 +155,15 @@ __all__ = [
     "CODE_SOURCE_RETIRED",
     "CODE_SOURCE_UNAUTHORIZED",
     "CODE_SOURCE_UNREACHABLE",
+    "CODE_DECLINED",
     "EXPORT_NONE",
+    "Advisory",
     "ArtifactCorruptError",
     "ArtifactError",
     "ArtifactIncompatibleError",
     "ArtifactMissingError",
     "ArtifactPinnedError",
+    "ArtifactRevokedError",
     "ArtifactUnpublishedError",
     "ArtifactUntrustedError",
     "AtMergeEntry",
@@ -156,11 +176,14 @@ __all__ = [
     "Capabilities",
     "ChtypesError",
     "Column",
+    "ColumnDefault",
     "Computed",
     "DeclinedLayer",
     "DeclinedSetting",
     "DeclinedTier",
+    "DeferDefaults",
     "DefaultKind",
+    "DefaultSupport",
     "DiscoverQueryParam",
     "DiscoveredColumn",
     "Discovery",
@@ -180,9 +203,13 @@ __all__ = [
     "Library",
     "MergeReason",
     "Outcome",
+    "ParamEncoding",
+    "Posture",
     "Reason",
     "Registry",
+    "RefusalSite",
     "Resolved",
+    "Revocation",
     "RowResult",
     "Schema",
     "SchemaDescription",
@@ -205,6 +232,7 @@ __all__ = [
     "UsageError",
     "Value",
     "Verdict",
+    "VerdictBasis",
     "cache_root",
     "open_unverified",
     "search_dirs",

chtypes/__main__.py

@@ -3,6 +3,7 @@
 
     chtypes fetch <spelling>... | --all  [--platform <os-arch>] [--cache <dir>] [--lock <file>]
                                          [--frozen] [--offline] [--update] [--strict]
+                                         [--allow-revoked] [--require-revocation-check]
     chtypes verify [--cache <dir>] [--strict]   re-verify every installed build
     chtypes list   [--cache <dir>] [--offline] [--strict]
     chtypes where  [--cache <dir>] [--strict] [--all]   the cache root; --all: every search dir
@@ -37,7 +38,7 @@ from collections.abc import Sequence
 
 from . import __version__ as chtypes_version
 from . import _ocifetch as fetch_layer
-from ._codes import CODE_ARTIFACT_CORRUPT
+from ._codes import CODE_ARTIFACT_CORRUPT, CODE_ARTIFACT_REVOKED
 from ._ocifetch import _channel
 from ._ocifetch import _constants as C
 from ._ocifetch._ensure import _translate_transport_error, detect_host_platform, missing_notes
@@ -148,6 +149,19 @@ def build_parser() -> argparse.ArgumentParser:
             "(or set CHTYPES_OFFLINE=1)"
         ),
     )
+    fetch.add_argument(
+        "--allow-revoked",
+        action="store_true",
+        help=(
+            "use a build a verified revocation refuses, with one warning "
+            "(this call only; never --lock or --update)"
+        ),
+    )
+    fetch.add_argument(
+        "--require-revocation-check",
+        action="store_true",
+        help="a revocation status that cannot be read is the transport's error, not a warning",
+    )
 
     verify = sub.add_parser(
         "verify",
@@ -249,6 +263,8 @@ def _options(args: argparse.Namespace, *, platform: str | None = None):
         lock_path=lock_path,
         lock_write=lock_write,
         update=getattr(args, "update", False),
+        allow_revoked=getattr(args, "allow_revoked", False),
+        require_revocation_check=getattr(args, "require_revocation_check", False),
     )
     return fetch._to_options(platform)
 
@@ -348,10 +364,23 @@ def _cmd_verify(args: argparse.Namespace) -> int:
         return EXIT_OK
     _say_notes(options)
     failed = 0
+    revoked = 0
     for r in results:
-        if not r.ok:
+        if r.revocation is not None:
+            # A build a stored revocation refuses (docs/guides/fetch-v1.md,
+            # "Build-level revocation"); it is reported whatever its bytes say.
+            revoked += 1
+            _say(f"REVOKED {r.version} {r.platform} {r.dir}: {r.detail}")
+        elif not r.ok:
             failed += 1
             _say(f"chtypes: FAILED {r.version} {r.platform} {r.dir}: {r.detail}")
+    if revoked:
+        # Exit 11 wins over a mismatch's 1: a revocation is the more specific finding.
+        _say(
+            f"chtypes: {revoked} of {len(results)} installed build(s) are revoked "
+            f"[{CODE_ARTIFACT_REVOKED}]"
+        )
+        return C.ERROR_EXIT_CODES[CODE_ARTIFACT_REVOKED]
     if failed:
         _say(f"chtypes: {failed} of {len(results)} installed build(s) FAILED verification")
         return C.ERROR_EXIT_CODES[CODE_ARTIFACT_CORRUPT]

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:d60a681ea0e249ab9e2c83b50640ad9cef040261ddf61805106c93e2c68774e4) — DO NOT EDIT  # noqa: E501
+# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:d53239933966e15a3c363e631a94fbba1231d84c4300337115d3ae5377bb41c2) — 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:d60a681ea0e249ab9e2c83b50640ad9cef040261ddf61805106c93e2c68774e4"
+CHS_ABI_FINGERPRINT = "sha256:d53239933966e15a3c363e631a94fbba1231d84c4300337115d3ae5377bb41c2"
 
 # The description's stability: "unstable" while this generation is being
 # designed, so CHS_ABI_FINGERPRINT moves with every change, and "locked" after
@@ -87,6 +87,7 @@ ALL_SYMBOLS: tuple[str, ...] = (
     "chs_error_column",
     "chs_error_free",
     "chs_error_message",
+    "chs_error_reason",
     "chs_error_status",
     "chs_filter_create",
     "chs_filter_eval_block",
@@ -248,6 +249,7 @@ _add("chs_error_ch_code", "scalar", "int32", _P("error", "handle", "chs_error"))
 _add("chs_error_ch_name", "handle", "chs_buf", _P("error", "handle", "chs_error"))
 _add("chs_error_message", "handle", "chs_buf", _P("error", "handle", "chs_error"))
 _add("chs_error_column", "handle", "chs_buf", _P("error", "handle", "chs_error"))
+_add("chs_error_reason", "handle", "chs_buf", _P("error", "handle", "chs_error"))
 _add("chs_error_free", "void", None, _P("error", "handle", "chs_error", nullable=True))
 _add(
     "chs_live_handles",
@@ -371,6 +373,7 @@ _add(
     _P("body", "bytes_in", None),
     _P("settings", "bytes_in", None),
     _P("columns", "bytes_in", None),
+    _P("options", "bytes_in", None),
     _P("out", "out_handle", "chs_buf"),
     _P("err", "out_error", "chs_error", nullable=True),
 )
@@ -386,6 +389,7 @@ _add(
     _P("filter", "handle", "chs_filter", nullable=True),
     _P("export_format", "scalar", "int32"),
     _P("doc_flags", "scalar", "uint32"),
+    _P("options", "bytes_in", None),
     _P("out", "out_handle", "chs_buf"),
     _P("out_export", "out_handle", "chs_buf", nullable=True),
     _P("err", "out_error", "chs_error", nullable=True),
@@ -398,6 +402,7 @@ _add(
     _P("expr", "bytes_in", None),
     _P("query_params", "bytes_in", None),
     _P("settings", "bytes_in", None),
+    _P("options", "bytes_in", None),
     _P("out", "out_handle", "chs_filter"),
     _P("err", "out_error", "chs_error", nullable=True),
 )
@@ -410,6 +415,8 @@ _add(
     _P("format", "enum", "chs_format"),
     _P("body", "bytes_in", None),
     _P("settings", "bytes_in", None),
+    _P("columns", "bytes_in", None),
+    _P("options", "bytes_in", None),
     _P("out", "out_handle", "chs_buf"),
     _P("err", "out_error", "chs_error", nullable=True),
 )
@@ -422,6 +429,7 @@ _add(
     _P("body", "bytes_in", None),
     _P("settings", "bytes_in", None),
     _P("columns", "bytes_in", None),
+    _P("options", "bytes_in", None),
     _P("out", "out_handle", "chs_block"),
     _P("err", "out_error", "chs_error", nullable=True),
 )
@@ -563,6 +571,7 @@ class Api:
             info.ch_name.decode("ascii", "replace") if info else "",
             message,
             info.column if info else b"",
+            reason=info.reason.decode("ascii", "replace") if info else "",
         )
 
     def live_handles(self) -> bytes:
@@ -801,6 +810,7 @@ class Api:
         body: bytes | None,
         settings: bytes | None,
         columns: bytes | None,
+        options: bytes | None,
     ) -> bytes:
         """The generated call wrapper for chs_preview_row (thread class shared).
 
@@ -813,6 +823,7 @@ class Api:
             *_bytes_in(body),
             *_bytes_in(settings),
             *_bytes_in(columns),
+            *_bytes_in(options),
             ctypes.byref(out),
             ctypes.byref(err),
         )
@@ -829,6 +840,7 @@ class Api:
         filter: FilterHandle | None,
         export_format: int,
         doc_flags: int,
+        options: bytes | None,
     ) -> tuple[bytes, bytes | None]:
         """The generated call wrapper for chs_preview_batch (thread class shared).
 
@@ -845,6 +857,7 @@ class Api:
             None if filter is None else filter.value,
             int(export_format),
             int(doc_flags),
+            *_bytes_in(options),
             ctypes.byref(out),
             ctypes.byref(out_export),
             ctypes.byref(err),
@@ -861,6 +874,7 @@ class Api:
         expr: bytes | None,
         query_params: bytes | None,
         settings: bytes | None,
+        options: bytes | None,
     ) -> FilterHandle:
         """The generated call wrapper for chs_filter_create (thread class shared).
 
@@ -872,6 +886,7 @@ class Api:
             *_bytes_in(expr),
             *_bytes_in(query_params),
             *_bytes_in(settings),
+            *_bytes_in(options),
             ctypes.byref(out),
             ctypes.byref(err),
         )
@@ -884,6 +899,8 @@ class Api:
         format: int,
         body: bytes | None,
         settings: bytes | None,
+        columns: bytes | None,
+        options: bytes | None,
     ) -> bytes:
         """The generated call wrapper for chs_filter_eval_body (thread class shared).
 
@@ -895,6 +912,8 @@ class Api:
             int(format),
             *_bytes_in(body),
             *_bytes_in(settings),
+            *_bytes_in(columns),
+            *_bytes_in(options),
             ctypes.byref(out),
             ctypes.byref(err),
         )
@@ -908,6 +927,7 @@ class Api:
         body: bytes | None,
         settings: bytes | None,
         columns: bytes | None,
+        options: bytes | None,
     ) -> BlockHandle:
         """The generated call wrapper for chs_block_create (thread class shared).
 
@@ -920,6 +940,7 @@ class Api:
             *_bytes_in(body),
             *_bytes_in(settings),
             *_bytes_in(columns),
+            *_bytes_in(options),
             ctypes.byref(out),
             ctypes.byref(err),
         )
@@ -1007,6 +1028,7 @@ class ErrorInfo:
     ch_name: bytes
     message: bytes
     column: bytes
+    reason: bytes = b""
 
 
 @dataclass
@@ -1068,6 +1090,7 @@ def _decode_error(api: Api, err_ptr: int) -> ErrorInfo:
     ch_name = _read_buf(api, api._raw["chs_error_ch_name"](err_ptr))
     message = _read_buf(api, api._raw["chs_error_message"](err_ptr))
     column = _read_buf(api, api._raw["chs_error_column"](err_ptr))
+    reason = _read_buf(api, api._raw["chs_error_reason"](err_ptr))
     api._raw["chs_error_free"](err_ptr)
     return ErrorInfo(
         status=STATUS_BY_VALUE.get(status_val, f"UNKNOWN:{status_val}"),
@@ -1075,6 +1098,7 @@ def _decode_error(api: Api, err_ptr: int) -> ErrorInfo:
         ch_name=ch_name,
         message=message,
         column=column,
+        reason=reason,
     )
 
 

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:d60a681ea0e249ab9e2c83b50640ad9cef040261ddf61805106c93e2c68774e4) — DO NOT EDIT  # noqa: E501
+# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:d53239933966e15a3c363e631a94fbba1231d84c4300337115d3ae5377bb41c2) — 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,4 +1,4 @@
-# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:d60a681ea0e249ab9e2c83b50640ad9cef040261ddf61805106c93e2c68774e4) — DO NOT EDIT  # noqa: E501
+# GENERATED by scripts/abi-v1/gen.py --major 2 from spec/abi-v2/abi.json (CHS_ABI_FINGERPRINT sha256:d53239933966e15a3c363e631a94fbba1231d84c4300337115d3ae5377bb41c2) — 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`, `MergeReason`, `DeclinedTier`, `DeclinedLayer`, `Reason`,
@@ -256,6 +256,7 @@ class DeclinedTier(StrEnum):
     PREDICATE = "predicate"
     PREDICATE_UNFLIPPED = "predicate-unflipped"
     RESULT_CONTENT = "result-content"
+    SERVER_REFUSES = "server-refuses"
 
     @classmethod
     def _missing_(cls, value: object) -> DeclinedTier | None:
@@ -299,6 +300,83 @@ class DeclinedLayer(StrEnum):
         return cls(text)
 
 
+class Posture(StrEnum):
+    """How a schema's statement was compiled: `create`, as a server's CREATE TABLE,
+    or `load`, as a server loads the stored definition of a table it holds."""
+
+    CREATE = "create"
+    LOAD = "load"
+
+    @classmethod
+    def _missing_(cls, value: object) -> Posture | 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) -> Posture:
+        """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 RefusalSite(StrEnum):
+    """Where a batch or filter document's refusal sits: `call` (the call, its settings or its
+    column list), `body_read` (the body outside any row: a header, the framing), `row` (one
+    row, `refused_row`) or `body_step` (a whole-body step)."""
+
+    CALL = "call"
+    BODY_READ = "body_read"
+    ROW = "row"
+    BODY_STEP = "body_step"
+
+    @classmethod
+    def _missing_(cls, value: object) -> RefusalSite | 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) -> RefusalSite:
+        """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 DefaultSupport(StrEnum):
+    """What this build does with a column's DEFAULT, as `schema_description` reports it per
+    column: `computed`, `generated`, `deferred` or `declined` (with a reason)."""
+
+    COMPUTED = "computed"
+    GENERATED = "generated"
+    DEFERRED = "deferred"
+    DECLINED = "declined"
+
+    @classmethod
+    def _missing_(cls, value: object) -> DefaultSupport | 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) -> DefaultSupport:
+        """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."""
@@ -409,6 +487,8 @@ class Source:
     DEFAULT_EXPR_UNSUPPORTED: Final = "default_expr_unsupported"
     DEFAULT_VOLATILE_UNRESOLVED: Final = "default_volatile_unresolved"
     DEFAULT_PENDING: Final = "default_pending"
+    DEFAULT_DEFERRED: Final = "default_deferred"
+    DEFAULT_OVERRIDE: Final = "default_override"
 
     @staticmethod
     def known(source: str) -> bool:
@@ -417,9 +497,8 @@ class Source:
 
     @staticmethod
     def is_stored(source: str) -> bool:
-        """The description's `is_stored` fact for `source`. The description does not yet
-        say what an unknown(n) source reports (rule r3, "Facts without a fallback");
-        until it does, an unlisted source is not stored."""
+        """The description's `is_stored` fact for `source`; an unknown(n) source
+        reports its fallback's (`skipped`), as rule r3 says."""
         return _SOURCE_IS_STORED.get(source, False)
 
 
@@ -435,6 +514,8 @@ _SOURCE_IS_STORED: Final[dict[str, bool]] = {
     "default_expr_unsupported": False,
     "default_volatile_unresolved": False,
     "default_pending": False,
+    "default_deferred": False,
+    "default_override": True,
 }
 
 
@@ -450,6 +531,10 @@ class DocFlags(IntFlag):
 # `chs_preview_batch`'s `export_format` for no export (`CHS_EXPORT_NONE`).
 EXPORT_NONE: Final = -1
 
+# The code a declined row, outcome or verdict carries (`CHS_CODE_DECLINED`), outside
+# ClickHouse's code table.
+CODE_DECLINED: Final = -2
+
 # Every enum the description defines, by its own name, and the Python type that
 # spells it: rule r3's tests reach every one from here, so a new enum is covered
 # without a hand-kept list.
@@ -463,10 +548,13 @@ DESCRIBED_VOCABULARIES: Final[dict[str, type]] = {
     "batch_outcome": Outcome,
     "filter_outcome": FilterOutcome,
     "filter_verdict": Verdict,
+    "refusal_site": RefusalSite,
     "discover_query_param": DiscoverQueryParam,
     "default_kind": DefaultKind,
+    "default_support": DefaultSupport,
     "declined_tier": DeclinedTier,
     "declined_layer": DeclinedLayer,
+    "posture": Posture,
 }
 
 

chtypes/_advisory.py

@@ -0,0 +1,38 @@
+"""What a `CHTYPES_ARTIFACT_REVOKED` error carries for programs
+(docs/guides/fetch-v1.md, "Build-level revocation"; public issue #625).
+
+A leaf module, so the fetch layer's errors and the public ones share the two
+types without importing each other."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+__all__ = ["Advisory", "Revocation"]
+
+
+@dataclass(frozen=True)
+class Advisory:
+    """One advisory a revocation names, every string made safe to print. A
+    signed revocation's carries its `revoked_at`; a 410's carries the `build` it
+    names, newest first. A field the source did not send is "". `class_` is the
+    advisory's `class` (a keyword in Python)."""
+
+    id: str = ""
+    url: str = ""
+    class_: str = ""
+    summary: str = ""
+    build: str = ""
+    superseded_by: str = ""
+    revoked_at: str = ""
+
+
+@dataclass(frozen=True)
+class Revocation:
+    """`signed` is true for a verified, signed revocation of `manifest`, whose
+    one advisory it is, and false for a 410's body, which is unsigned, names no
+    manifest (`manifest` is "") and lists one advisory per revoked build."""
+
+    signed: bool = False
+    manifest: str = ""
+    advisories: tuple[Advisory, ...] = ()

chtypes/_codes.py

@@ -1,6 +1,6 @@
 # Code generated by scripts/fetch-v1/gen-constants.py from
 # spec/fetch-v1/constants.json. DO NOT EDIT.
-# Source sha256: 82afa8d6cba96c10b5945c6f7c1c8360a504cc8ac6231e74017cc6c20b908df6
+# Source sha256: 5aa3d14a5d8b60399040a8242f003135fa5f6c2c402de7d4e2db4c768a3366ae
 """The shared error codes (docs/guides/fetch-v1.md §8), one per entry of the
 fetch constants' `errors`, in their order. `chtypes.errors` re-exports them
 (docs/reference/bindings-v1.md §4, the codes)."""
@@ -21,3 +21,4 @@ CODE_SOURCE_INCOMPATIBLE: Final[str] = "CHTYPES_SOURCE_INCOMPATIBLE"
 CODE_ARTIFACT_INCOMPATIBLE: Final[str] = "CHTYPES_ARTIFACT_INCOMPATIBLE"
 CODE_CACHE_UNUSABLE: Final[str] = "CHTYPES_CACHE_UNUSABLE"
 CODE_SOURCE_RETIRED: Final[str] = "CHTYPES_SOURCE_RETIRED"
+CODE_ARTIFACT_REVOKED: Final[str] = "CHTYPES_ARTIFACT_REVOKED"