type-bridge 2.1.0__tar.gz → 2.2.1__tar.gz

{type_bridge-2.1.0 → type_bridge-2.2.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: type-bridge
-Version: 2.1.0
-Summary: Typed Python, TypeScript, and Rust application tooling for TypeDB
+Version: 2.2.1
+Summary: Typed Python, TypeScript, Rust, and C application tooling for TypeDB
 Project-URL: Homepage, https://github.com/ds1sqe/type-bridge
 Project-URL: Repository, https://github.com/ds1sqe/type-bridge
 Project-URL: Documentation, https://ds1sqe.github.io/type-bridge/
@@ -23,7 +23,7 @@ Requires-Python: <3.15,>=3.12
 Requires-Dist: isodate==0.7.2
 Requires-Dist: jinja2>=3.1.0
 Requires-Dist: pydantic>=2.12.4
-Requires-Dist: type-bridge-core==2.1.0
+Requires-Dist: type-bridge-core==2.2.1
 Requires-Dist: typer>=0.15.0
 Requires-Dist: typing-extensions>=4.12
 Provides-Extra: dev
@@ -35,7 +35,7 @@ Requires-Dist: pytest-order>=1.2.0; extra == 'dev'
 Requires-Dist: pytest>=9.0.1; extra == 'dev'
 Requires-Dist: pyyaml>=6.0.3; extra == 'dev'
 Requires-Dist: ruff==0.15.21; extra == 'dev'
-Requires-Dist: typedb-driver==3.12.1; (python_version >= '3.14') and extra == 'dev'
+Requires-Dist: typedb-driver==3.12.3; (python_version >= '3.14') and extra == 'dev'
 Requires-Dist: typedb-driver~=3.11.5; (python_version < '3.14') and extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: mkdocs-gen-files>=0.5; extra == 'docs'
@@ -46,7 +46,7 @@ Requires-Dist: mkdocs>=1.6; extra == 'docs'
 Requires-Dist: mkdocstrings[python]>=0.27; extra == 'docs'
 Provides-Extra: typedb-driver
 Requires-Dist: typedb-driver<3.13,>=3.11; (python_version < '3.14') and extra == 'typedb-driver'
-Requires-Dist: typedb-driver==3.12.1; (python_version >= '3.14') and extra == 'typedb-driver'
+Requires-Dist: typedb-driver==3.12.3; (python_version >= '3.14') and extra == 'typedb-driver'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -64,17 +64,18 @@ Description-Content-Type: text/markdown
 
 TypeBridge is a typed application toolkit for [TypeDB](https://typedb.com/).
 A versioned Split-YAML workspace is the schema authority. TypeBridge validates
-that workspace and generates Python, TypeScript/Node, and Rust bindings that
+that workspace and generates Python, TypeScript/Node, Rust, and C bindings that
 share one Rust-owned schema, query, migration, validation, and ORM engine.
 
-## One system, three generated SDKs
+## One system, four generated SDKs
 
 | Surface | Generated application API | Distribution |
 | --- | --- | --- |
 | Python | Value classes, model managers, transactions, direct/remote queries | [`type-bridge`](https://pypi.org/project/type-bridge/) |
 | TypeScript / Node | Branded values, model managers, native and remote queries | [`@type-bridge/node`](https://www.npmjs.com/package/@type-bridge/node) |
 | Rust | Schema-bound create/model types, async CRUD and immutable queries | [`type-bridge`](https://crates.io/crates/type-bridge) |
-| CLI | Split-YAML checks, migrations, and all three projections | Included with the Python package |
+| C | Generated nominal models, transactions, direct/remote queries | [Ubuntu 24.04 x86_64 shared runtime](https://ds1sqe.github.io/type-bridge/guide/c/) |
+| CLI | Split-YAML checks, migrations, and all four projections | Python package or standalone Linux archive |
 | Server | Remote V2 query execution over the same generated contract | `ghcr.io/ds1sqe/type-bridge-server` |
 
 TypeBridge preserves TypeDB concepts directly: independent attributes,
@@ -99,7 +100,7 @@ type-bridge --manifest typebridge.yaml migration make --name initial
 type-bridge --manifest typebridge.yaml migration apply --environment development
 ```
 
-One generation snapshot writes every configured Python, TypeScript, and Rust
+One generation snapshot writes every configured Python, TypeScript, Rust, and C
 package. Generated packages privately embed the verified authority used by
 their managers and direct or remote queries, so ordinary applications never
 configure or read an external authority JSON. A workspace deploying the optional
@@ -178,6 +179,15 @@ type-bridge = "2"
 Follow the [Rust client guide](https://ds1sqe.github.io/type-bridge/guide/rust/)
 for generation, direct execution, transactions, and remote queries.
 
+## C
+
+TypeBridge 2.2.0 ships a C ABI 1.6.0 shared runtime and standalone CLI for
+Ubuntu 24.04 on x86_64 GNU/Linux. Generate an application schema package from
+Split-YAML, then link C17 or C++17 consumers with CMake or pkg-config.
+
+See the [C SDK guide](https://ds1sqe.github.io/type-bridge/guide/c/) for signed
+archives, installation, generation, and the exact supported matrix.
+
 ## Documentation
 
 - [Install a surface](https://ds1sqe.github.io/type-bridge/getting-started/installation/)
@@ -191,7 +201,7 @@ for generation, direct execution, transactions, and remote queries.
 ## Development
 
 ```bash
-PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1 uv sync --extra dev
+uv sync --extra dev
 uv run pytest
 ./test.sh
 ./scripts/check.sh all

{type_bridge-2.1.0 → type_bridge-2.2.1}/README.md

@@ -13,17 +13,18 @@
 
 TypeBridge is a typed application toolkit for [TypeDB](https://typedb.com/).
 A versioned Split-YAML workspace is the schema authority. TypeBridge validates
-that workspace and generates Python, TypeScript/Node, and Rust bindings that
+that workspace and generates Python, TypeScript/Node, Rust, and C bindings that
 share one Rust-owned schema, query, migration, validation, and ORM engine.
 
-## One system, three generated SDKs
+## One system, four generated SDKs
 
 | Surface | Generated application API | Distribution |
 | --- | --- | --- |
 | Python | Value classes, model managers, transactions, direct/remote queries | [`type-bridge`](https://pypi.org/project/type-bridge/) |
 | TypeScript / Node | Branded values, model managers, native and remote queries | [`@type-bridge/node`](https://www.npmjs.com/package/@type-bridge/node) |
 | Rust | Schema-bound create/model types, async CRUD and immutable queries | [`type-bridge`](https://crates.io/crates/type-bridge) |
-| CLI | Split-YAML checks, migrations, and all three projections | Included with the Python package |
+| C | Generated nominal models, transactions, direct/remote queries | [Ubuntu 24.04 x86_64 shared runtime](https://ds1sqe.github.io/type-bridge/guide/c/) |
+| CLI | Split-YAML checks, migrations, and all four projections | Python package or standalone Linux archive |
 | Server | Remote V2 query execution over the same generated contract | `ghcr.io/ds1sqe/type-bridge-server` |
 
 TypeBridge preserves TypeDB concepts directly: independent attributes,
@@ -48,7 +49,7 @@ type-bridge --manifest typebridge.yaml migration make --name initial
 type-bridge --manifest typebridge.yaml migration apply --environment development
 ```
 
-One generation snapshot writes every configured Python, TypeScript, and Rust
+One generation snapshot writes every configured Python, TypeScript, Rust, and C
 package. Generated packages privately embed the verified authority used by
 their managers and direct or remote queries, so ordinary applications never
 configure or read an external authority JSON. A workspace deploying the optional
@@ -127,6 +128,15 @@ type-bridge = "2"
 Follow the [Rust client guide](https://ds1sqe.github.io/type-bridge/guide/rust/)
 for generation, direct execution, transactions, and remote queries.
 
+## C
+
+TypeBridge 2.2.0 ships a C ABI 1.6.0 shared runtime and standalone CLI for
+Ubuntu 24.04 on x86_64 GNU/Linux. Generate an application schema package from
+Split-YAML, then link C17 or C++17 consumers with CMake or pkg-config.
+
+See the [C SDK guide](https://ds1sqe.github.io/type-bridge/guide/c/) for signed
+archives, installation, generation, and the exact supported matrix.
+
 ## Documentation
 
 - [Install a surface](https://ds1sqe.github.io/type-bridge/getting-started/installation/)
@@ -140,7 +150,7 @@ for generation, direct execution, transactions, and remote queries.
 ## Development
 
 ```bash
-PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1 uv sync --extra dev
+uv sync --extra dev
 uv run pytest
 ./test.sh
 ./scripts/check.sh all

{type_bridge-2.1.0 → type_bridge-2.2.1}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "type-bridge"
-version = "2.1.0"
-description = "Typed Python, TypeScript, and Rust application tooling for TypeDB"
+version = "2.2.1"
+description = "Typed Python, TypeScript, Rust, and C application tooling for TypeDB"
 readme = "README.md"
 requires-python = ">=3.12,<3.15"
 license = {text = "MIT"}
@@ -30,7 +30,7 @@ dependencies = [
     "jinja2>=3.1.0",
     "typer>=0.15.0",
     # The facade and native semantic engine are one release unit.
-    "type-bridge-core==2.1.0",
+    "type-bridge-core==2.2.1",
     "typing-extensions>=4.12",
 ]
 
@@ -58,7 +58,7 @@ dev = [
     # the embedded Rust runtime and serves TypeDB 3.11 and 3.12 on every
     # supported interpreter.
     "typedb-driver~=3.11.5; python_version < '3.14'",
-    "typedb-driver==3.12.1; python_version >= '3.14'",
+    "typedb-driver==3.12.3; python_version >= '3.14'",
     "pytest>=9.0.1",
     "pytest-asyncio>=1.3.0",
     "pytest-order>=1.2.0",
@@ -81,7 +81,7 @@ docs = [
 ]
 typedb-driver = [
     "typedb-driver>=3.11,<3.13; python_version < '3.14'",
-    "typedb-driver==3.12.1; python_version >= '3.14'",
+    "typedb-driver==3.12.3; python_version >= '3.14'",
 ]
 
 [tool.ty.environment]
@@ -165,6 +165,10 @@ precision = 2
 [tool.coverage.html]
 directory = "htmlcov"
 
+[tool.uv]
+# Keep mypy's wheel-only helper on a complete, verified release.
+constraint-dependencies = ["ast-serialize==0.10.0"]
+
 [tool.uv.workspace]
 members = [
     "type-bridge-core",

{type_bridge-2.1.0 → type_bridge-2.2.1}/type_bridge/__init__.py

@@ -24,7 +24,7 @@ if TYPE_CHECKING:
     from type_bridge.migration.exceptions import SchemaConflictError, SchemaValidationError
     from type_bridge.migration.introspection import SchemaIntrospector
 
-__version__ = "2.1.0"
+__version__ = "2.2.1"
 
 
 _LAZY_EXPORTS: dict[str, tuple[str, str]] = {

{type_bridge-2.1.0 → type_bridge-2.2.1}/type_bridge/_backend.py

@@ -13,7 +13,7 @@ RUST_BACKEND = "rust"
 def selected_backend() -> str:
     """Return the configured manager backend.
 
-    The Python ORM backend was retired in #125 Phase 4. The environment
+    The Python ORM backend was retired in #125. The environment
     variable is retained only to reject stale transition settings clearly.
     """
     value = os.environ.get(BACKEND_ENV_VAR, RUST_BACKEND).strip().lower()

{type_bridge-2.1.0 → type_bridge-2.2.1}/type_bridge/_runtime_projection.py

@@ -44,6 +44,29 @@ def install_runtime_projection(
     return installed
 
 
+def install_runtime_projection_with_authority(
+    projection_json: str,
+    semantic_fingerprint_json: str,
+    projection_fingerprint_json: str,
+    models: Sequence[tuple[type[object], type[object] | None]],
+    schema_authority: bytes,
+    *,
+    structs: Sequence[type[object]] = (),
+) -> PyRuntimeProjection:
+    """Verify and install one ordered generated package with compiled authority."""
+    installed = rust_core().PyRuntimeProjection(
+        projection_json,
+        semantic_fingerprint_json,
+        projection_fingerprint_json,
+        list(models),
+        schema_authority,
+        list(structs),
+    )
+    for model, _reference in models:
+        _installed_projection_by_model[model] = installed
+    return installed
+
+
 def _installed_projection_for(model: type[object]) -> PyRuntimeProjection:
     try:
         return _installed_projection_by_model[model]

{type_bridge-2.1.0 → type_bridge-2.2.1}/type_bridge/_rust_runtime.py

@@ -531,6 +531,20 @@ def rust_database_for(connection: Any) -> PyRustDatabase:
         return rust_db
 
 
+def database_from_rust(
+    endpoint: str,
+    database_name: str,
+    rust_database: PyRustDatabase,
+) -> Any:
+    """Wrap one package-owned native database without reconnecting."""
+    from type_bridge.session import Database
+
+    database = Database(address=endpoint, database=database_name)
+    setattr(database, "_rust_backend_database", rust_database)
+    database._transport_committed = True
+    return database
+
+
 def state_reader_for(connection: Any) -> Any:
     """Return the native read-only frozen-ledger reader."""
     return rust_core().PyMigrationStateReader(rust_database_for(connection))

{type_bridge-2.1.0 → type_bridge-2.2.1}/type_bridge/session.py

@@ -8,7 +8,7 @@ import threading
 import warnings
 from dataclasses import dataclass
 from enum import Enum
-from typing import TYPE_CHECKING, Any, cast, overload
+from typing import TYPE_CHECKING, Any, Literal, cast, overload
 
 import type_bridge.typedb_driver as typedb_driver
 import type_bridge.version as version
@@ -637,45 +637,61 @@ class Database:
 
     def create_database(self) -> None:
         """Create the database if it doesn't exist."""
+        self.create_database_outcome()
+
+    def create_database_outcome(self) -> Literal["created", "already_exists"]:
+        """Create the bound database and return a race-normalized outcome."""
         if self._driver is not None:
-            if not self.driver.databases.contains(self.database_name):
-                logger.debug(f"Creating database: {self.database_name}")
-                self.driver.databases.create(self.database_name)
-                logger.info(f"Database created: {self.database_name}")
-            else:
+            if self.driver.databases.contains(self.database_name):
                 logger.debug(f"Database already exists: {self.database_name}")
-            return
+                return "already_exists"
+            logger.debug(f"Creating database: {self.database_name}")
+            try:
+                self.driver.databases.create(self.database_name)
+            except Exception:
+                if self.driver.databases.contains(self.database_name):
+                    return "already_exists"
+                raise
+            logger.info(f"Database created: {self.database_name}")
+            return "created"
 
         from type_bridge._rust_runtime import rust_database_for
 
-        rust_db = rust_database_for(self)
-        if not rust_db.database_exists():
-            logger.debug(f"Creating database: {self.database_name}")
-            rust_db.create_database()
-            logger.info(f"Database created: {self.database_name}")
-        else:
-            logger.debug(f"Database already exists: {self.database_name}")
+        outcome = cast(
+            Literal["created", "already_exists"],
+            rust_database_for(self).create_database_outcome(),
+        )
+        logger.debug(f"Database create outcome for '{self.database_name}': {outcome}")
+        return outcome
 
     def delete_database(self) -> None:
         """Delete the database."""
+        self.delete_database_outcome()
+
+    def delete_database_outcome(self) -> Literal["deleted", "already_absent"]:
+        """Delete the bound database and return a race-normalized outcome."""
         if self._driver is not None:
-            if self.driver.databases.contains(self.database_name):
-                logger.debug(f"Deleting database: {self.database_name}")
-                self.driver.databases.get(self.database_name).delete()
-                logger.info(f"Database deleted: {self.database_name}")
-            else:
+            if not self.driver.databases.contains(self.database_name):
                 logger.debug(f"Database does not exist, skipping delete: {self.database_name}")
-            return
+                return "already_absent"
+            logger.debug(f"Deleting database: {self.database_name}")
+            try:
+                self.driver.databases.get(self.database_name).delete()
+            except Exception:
+                if not self.driver.databases.contains(self.database_name):
+                    return "deleted"
+                raise
+            logger.info(f"Database deleted: {self.database_name}")
+            return "deleted"
 
         from type_bridge._rust_runtime import rust_database_for
 
-        rust_db = rust_database_for(self)
-        if rust_db.database_exists():
-            logger.debug(f"Deleting database: {self.database_name}")
-            rust_db.delete_database()
-            logger.info(f"Database deleted: {self.database_name}")
-        else:
-            logger.debug(f"Database does not exist, skipping delete: {self.database_name}")
+        outcome = cast(
+            Literal["deleted", "already_absent"],
+            rust_database_for(self).delete_database_outcome(),
+        )
+        logger.debug(f"Database delete outcome for '{self.database_name}': {outcome}")
+        return outcome
 
     def database_exists(self) -> bool:
         """Check if database exists."""
@@ -688,6 +704,54 @@ class Database:
         logger.debug(f"Database exists check for '{self.database_name}': {exists}")
         return exists
 
+    def inspect_database_pair(
+        self,
+    ) -> Literal["absent", "standalone_managed", "owned_pair", "owned_journal_orphan"]:
+        """Inspect the managed database and its package-owned journal as one pair."""
+        from type_bridge._rust_runtime import rust_database_for
+
+        return cast(
+            Literal["absent", "standalone_managed", "owned_pair", "owned_journal_orphan"],
+            rust_database_for(self).inspect_database_pair(),
+        )
+
+    def inspect_database_pair_controlled(
+        self,
+        *,
+        timeout_milliseconds: int | None = None,
+        cancellation: Any | None = None,
+    ) -> Literal["absent", "standalone_managed", "owned_pair", "owned_journal_orphan"]:
+        """Inspect the managed database pair under explicit execution controls."""
+        from type_bridge._rust_runtime import rust_database_for
+
+        return cast(
+            Literal["absent", "standalone_managed", "owned_pair", "owned_journal_orphan"],
+            rust_database_for(self).inspect_database_pair_controlled(
+                timeout_milliseconds=timeout_milliseconds,
+                cancellation=cancellation,
+            ),
+        )
+
+    def plan_database_delete(self) -> Any:
+        """Create a single-use, pair-aware managed database deletion plan."""
+        from type_bridge._rust_runtime import rust_database_for
+
+        return rust_database_for(self).plan_database_delete()
+
+    def plan_database_delete_controlled(
+        self,
+        *,
+        timeout_milliseconds: int | None = None,
+        cancellation: Any | None = None,
+    ) -> Any:
+        """Create a managed deletion plan under explicit execution controls."""
+        from type_bridge._rust_runtime import rust_database_for
+
+        return rust_database_for(self).plan_database_delete_controlled(
+            timeout_milliseconds=timeout_milliseconds,
+            cancellation=cancellation,
+        )
+
     @overload
     def transaction(self, transaction_type: Enum) -> TransactionContext: ...
 
@@ -747,7 +811,7 @@ class Database:
     def detected_server_version(self) -> str | None:
         """The server version detected by the connect-time version gate.
 
-        Returns the version string (e.g. ``"3.12.1"``) when known. ``None``
+        Returns the version string (e.g. ``"3.12.3"``) when known. ``None``
         means the negotiated connection path produced no authoritative server
         identity; supply ``server_version=`` at construction when strict
         identity validation is required.

{type_bridge-2.1.0 → type_bridge-2.2.1}/type_bridge/typedb_driver.py

@@ -102,7 +102,7 @@ def _ensure_driver_interpreter_supported(installed: str) -> int | None:
         raise _version.UnsupportedVersionError(
             f"Installed typedb-driver {installed!r} has no compatible native wheel "
             "for CPython 3.14. Install `type-bridge[typedb-driver]` "
-            "(driver 3.12.1) and target TypeDB 3.12."
+            "(driver 3.12.3) and target TypeDB 3.12."
         )
     return driver_band
 
@@ -166,7 +166,7 @@ def create_driver_options(
     max_l = _version.max_supported_line()
     if sys.version_info >= (3, 14):
         remediation = (
-            "Install `type-bridge[typedb-driver]` (driver 3.12.1 on "
+            "Install `type-bridge[typedb-driver]` (driver 3.12.3 on "
             "CPython 3.14) and target TypeDB 3.12."
         )
     else:
@@ -209,7 +209,7 @@ def embedded_driver_versions() -> dict[int, str]:
     """Return all driver versions compiled into the Rust runtime, keyed by band.
 
     Delegates to ``type_bridge_core.embedded_driver_versions``.  The default
-    build returns ``{8: "3.11.5", 9: "3.12.1"}``; a
+    build returns ``{8: "3.11.5", 9: "3.12.3"}``; a
     single-band build returns only the one entry for its compiled band.
     """
     return _core.embedded_driver_versions()
@@ -236,7 +236,7 @@ def server_version(
             probe. The root path does not enable TLS implicitly.
 
     Returns:
-        Version string reported by the server (e.g. ``"3.12.1"``).
+        Version string reported by the server (e.g. ``"3.12.3"``).
 
     Raises:
         type_bridge_core.VersionError: When the endpoint is unreachable or the