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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: type-bridge
-Version: 2.1.0
+Version: 2.2.0
 Summary: Typed Python, TypeScript, and Rust application tooling for TypeDB
 Project-URL: Homepage, https://github.com/ds1sqe/type-bridge
 Project-URL: Repository, https://github.com/ds1sqe/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.0
 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">

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "type-bridge"
-version = "2.1.0"
+version = "2.2.0"
 description = "Typed Python, TypeScript, and Rust application tooling for TypeDB"
 readme = "README.md"
 requires-python = ">=3.12,<3.15"
@@ -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.0",
     "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.0}/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.0"
 
 
 _LAZY_EXPORTS: dict[str, tuple[str, str]] = {

{type_bridge-2.1.0 → type_bridge-2.2.0}/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.0}/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.0}/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.0}/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.0}/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