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

{type_bridge-2.0.2 → type_bridge-2.1.0}/.gitignore

@@ -52,3 +52,4 @@ type-bridge-core/**/target/
 
 # Plan 12 generator cross-language parity build output (ephemeral)
 type-bridge-core/crates/node/tests/parity/generated/
+examples/generated/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: type-bridge
-Version: 2.0.2
+Version: 2.1.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.0.2
+Requires-Dist: type-bridge-core==2.1.0
 Requires-Dist: typer>=0.15.0
 Requires-Dist: typing-extensions>=4.12
 Provides-Extra: dev
@@ -45,7 +45,7 @@ Requires-Dist: mkdocs-section-index>=0.3; extra == 'docs'
 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.8; (python_version < '3.14') and 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'
 Description-Content-Type: text/markdown
 
@@ -63,73 +63,79 @@ Description-Content-Type: text/markdown
 </p>
 
 TypeBridge is a typed application toolkit for [TypeDB](https://typedb.com/).
-It defines and evolves schemas, generates application models, and provides
-native Python, TypeScript/Node, and Rust data APIs. One Rust semantic engine
-owns schema, query, migration, validation, and ORM behavior across every SDK
-and the standalone query server.
+A versioned Split-YAML workspace is the schema authority. TypeBridge validates
+that workspace and generates Python, TypeScript/Node, and Rust bindings that
+share one Rust-owned schema, query, migration, validation, and ORM engine.
 
-## One system, several ways in
+## One system, three generated SDKs
 
-2.0.2 is a compatibility-notice and dependency-security maintenance release. Read the
-[exact expanded 2.1 inventory and safe pins](https://github.com/ds1sqe/type-bridge/releases/tag/v2.0.2)
-before upgrading beyond 2.0.x. No API is removed or new warning added here.
-
-| Surface | Use it for | Distribution |
+| Surface | Generated application API | Distribution |
 | --- | --- | --- |
-| Python | Declarative Pydantic models, CRUD, queries, schema management | [`type-bridge`](https://pypi.org/project/type-bridge/) |
-| TypeScript / Node | Branded models, typed managers, queries, native runtime | [`@type-bridge/node`](https://www.npmjs.com/package/@type-bridge/node) |
-| Rust | Generated schema crates, async CRUD and immutable queries | [`type-bridge`](https://crates.io/crates/type-bridge) |
-| CLI and generators | Split-YAML schemas, migrations, Python/Node/Rust projections | Included with the Python package |
-| Server | Remote V2 query execution over the same contracts | `ghcr.io/ds1sqe/type-bridge-server` |
-
-TypeBridge is designed around TypeDB rather than flattened into a relational
-ORM shape:
+| 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 |
+| Server | Remote V2 query execution over the same generated contract | `ghcr.io/ds1sqe/type-bridge-server` |
 
-- attributes remain independent types owned by entities and relations;
-- roles, inheritance, cardinality, ordering, `@key`, and `@unique` stay typed;
-- schema generation and migration use the same rules as runtime queries;
-- direct and remote immutable queries preserve typed, owner-aware results;
-- Python and Node are thin facades over the shared Rust runtime.
+TypeBridge preserves TypeDB concepts directly: independent attributes,
+entities, relations, roles, inheritance, cardinality, ordering, keys, and
+uniqueness remain typed from schema through hydrated results.
 
-## Start with Python
+## Start from Split-YAML
 
-Requires Python 3.12–3.14 and a supported TypeDB 3.x server.
+Install the CLI and Python runtime:
 
 ```bash
 pip install type-bridge
 ```
 
-```python
-from type_bridge import Database, Entity, Flag, Integer, Key, SchemaManager, String
+Create `typebridge.yaml`, a schema-set manifest, and one or more schema
+fragments. Configure the generated package output in the workspace, then run:
 
-class PersonId(String):
-    pass
+```bash
+type-bridge --manifest typebridge.yaml schema check
+type-bridge --manifest typebridge.yaml schema generate
+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
+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
+generic server can additionally configure `artifacts.schema-authority.output`;
+the server mounts that generated, source-free artifact instead of compiling
+YAML or accepting a user-maintained JSON schema.
 
-class Age(Integer):
-    pass
+The generated Python package owns the concise single-type manager:
 
-class Person(Entity):
-    person_id: PersonId = Flag(Key)
-    age: Age | None = None
+```python
+from app_models import Age, Person, PersonId
+from type_bridge import Database
 
 db = Database(address="localhost:1729", database="example")
 db.connect()
-db.create_database()
-
-schema = SchemaManager(db)
-schema.register(Person)
-schema.sync_schema()
 
 ada = Person(person_id=PersonId("ada"), age=Age(36))
 Person.manager(db).put(ada)
 people = Person.manager(db).filter(age__gte=18).all()
 ```
 
+Use its package-local query session when a query spans types:
+
+```python
+session = Person.query(db)
+person = session.exact(Person)
+adults = (
+    session.query(person)
+    .where(person.field(Person.age).gte(Age(18)))
+    .rows(limit=100)
+)
+```
+
 Continue with the [Python quick start](https://ds1sqe.github.io/type-bridge/getting-started/quickstart/),
-then choose the [model](https://ds1sqe.github.io/type-bridge/guide/models/),
-[data](https://ds1sqe.github.io/type-bridge/guide/data/), or
-[schema](https://ds1sqe.github.io/type-bridge/guide/schema-workflows/)
-workflow.
+[Split-YAML reference](https://ds1sqe.github.io/type-bridge/guide/split-yaml-v1/),
+and [data guide](https://ds1sqe.github.io/type-bridge/guide/data/).
 
 ## TypeScript / Node
 
@@ -137,55 +143,50 @@ workflow.
 npm install @type-bridge/node
 ```
 
-```ts
-import { Entity, Key, attr, field } from "@type-bridge/node";
-
-class PersonId extends attr.String("person-id") {}
-class Person extends Entity("person", {
-  personId: field(PersonId, Key),
-}) {}
+Import application values from the generated package and connection primitives
+from `@type-bridge/node`:
 
-const ada = new Person({ personId: new PersonId("ada") });
+```ts
+import { RustDatabase } from "@type-bridge/node";
+import { Age, Person, PersonId } from "./generated/models/index.js";
+
+const db = RustDatabase.connect("localhost:1729", "example", {
+  username: "admin",
+  password: "password",
+});
+const ada = Person.create({
+  personId: PersonId.create("ada"),
+  age: Age.create(36n),
+});
+Person.manager(db).put(ada);
+const people = Person.manager(db).filter({ age__gte: Age.create(18n) }).all();
 ```
 
 See the [TypeScript/Node guide](https://ds1sqe.github.io/type-bridge/guide/typescript/)
-for native targets, database lifecycle, managers, queries, and generation.
+for generated managers, transactions, and direct/remote queries.
 
-## Schema-first and Rust workflows
+## Rust
 
-The V2 workspace makes a versioned Split-YAML schema the authority and projects
-it into each configured SDK:
+The same workspace emits a schema-bound Rust crate. The generated SDK uses
+Rust 1.88+ and the crates.io `type-bridge` runtime:
 
-```bash
-type-bridge --manifest typebridge.yaml schema check
-type-bridge --manifest typebridge.yaml schema generate
-type-bridge --manifest typebridge.yaml migration make --name initial
-type-bridge --manifest typebridge.yaml migration apply --environment development
+```toml
+[dependencies]
+type-bridge = "2"
 ```
 
-The generated Rust SDK requires Rust 1.88+ and, starting with 2.0.1, resolves
-from crates.io with `type-bridge = "2"`. TypeBridge 2.0.0 remains available
-from its exact Git revision. Follow the
-[Rust client guide](https://ds1sqe.github.io/type-bridge/guide/rust/) and
-[Split-YAML reference](https://ds1sqe.github.io/type-bridge/guide/split-yaml-v1/)
-for the reproducible setup.
+Follow the [Rust client guide](https://ds1sqe.github.io/type-bridge/guide/rust/)
+for generation, direct execution, transactions, and remote queries.
 
 ## Documentation
 
 - [Install a surface](https://ds1sqe.github.io/type-bridge/getting-started/installation/)
-- [Choose an SDK](https://ds1sqe.github.io/type-bridge/guide/sdks/)
-- [Model TypeDB data](https://ds1sqe.github.io/type-bridge/guide/models/)
-- [Read and write data](https://ds1sqe.github.io/type-bridge/guide/data/)
+- [Model data in Split-YAML](https://ds1sqe.github.io/type-bridge/guide/models/)
+- [Read and write generated models](https://ds1sqe.github.io/type-bridge/guide/data/)
 - [Manage schemas and migrations](https://ds1sqe.github.io/type-bridge/guide/schema-workflows/)
-- [Run the server](https://ds1sqe.github.io/type-bridge/guide/server-container/)
-- [Upgrade to 2.0](https://ds1sqe.github.io/type-bridge/guide/upgrade-v2/)
-- [Python API reference](https://ds1sqe.github.io/type-bridge/reference/)
-
-TypeBridge 2.0.x supports TypeDB 3.8–3.12. Support for 3.8 and 3.10 is
-deprecated and scheduled for removal in 2.1; consult the
-[compatibility matrix](https://ds1sqe.github.io/type-bridge/development/typedb/#server-and-driver-compatibility)
-and [deprecation inventory](https://ds1sqe.github.io/type-bridge/guide/v2-deprecations/)
-before upgrading production deployments.
+- [Run the query server](https://ds1sqe.github.io/type-bridge/guide/server-container/)
+- [Browse the Cargo package index](https://ds1sqe.github.io/type-bridge/guide/cargo-packages/)
+- [Compatibility and removals](https://ds1sqe.github.io/type-bridge/guide/v2-deprecations/)
 
 ## Development
 
@@ -197,12 +198,10 @@ uv run pytest
 uv run --extra docs mkdocs build --strict
 ```
 
-See [DEVELOPMENT.md](DEVELOPMENT.md) for repository layout, test tiers, docs
-architecture, and contribution checks.
+See [DEVELOPMENT.md](DEVELOPMENT.md) for repository boundaries and verification.
 
 ## License
 
 TypeBridge-authored code is MIT licensed. Native artifacts also include
 third-party TypeDB components under Apache-2.0 and MPL-2.0; exact notices ship
-with each artifact and are documented in
-[`type-bridge-core/vendor/README.md`](type-bridge-core/vendor/README.md).
+with each artifact.

type_bridge-2.1.0/README.md

@@ -0,0 +1,156 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ds1sqe/type-bridge/master/docs/assets/typebridge-hero.svg" alt="TypeBridge connects typed Python, TypeScript, and Rust applications to TypeDB through one semantic engine." width="100%">
+</p>
+
+<p align="center">
+  <a href="https://github.com/ds1sqe/type-bridge/actions/workflows/ci.yml"><img src="https://github.com/ds1sqe/type-bridge/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/type-bridge/"><img src="https://img.shields.io/pypi/v/type-bridge.svg" alt="PyPI"></a>
+  <a href="https://www.npmjs.com/package/@type-bridge/node"><img src="https://img.shields.io/npm/v/%40type-bridge%2Fnode.svg" alt="npm"></a>
+  <a href="https://crates.io/crates/type-bridge"><img src="https://img.shields.io/crates/v/type-bridge.svg" alt="crates.io"></a>
+  <a href="https://ds1sqe.github.io/type-bridge/"><img src="https://img.shields.io/badge/docs-TypeBridge-67e8f9" alt="Documentation"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-8b5cf6.svg" alt="MIT license"></a>
+</p>
+
+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
+share one Rust-owned schema, query, migration, validation, and ORM engine.
+
+## One system, three 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 |
+| Server | Remote V2 query execution over the same generated contract | `ghcr.io/ds1sqe/type-bridge-server` |
+
+TypeBridge preserves TypeDB concepts directly: independent attributes,
+entities, relations, roles, inheritance, cardinality, ordering, keys, and
+uniqueness remain typed from schema through hydrated results.
+
+## Start from Split-YAML
+
+Install the CLI and Python runtime:
+
+```bash
+pip install type-bridge
+```
+
+Create `typebridge.yaml`, a schema-set manifest, and one or more schema
+fragments. Configure the generated package output in the workspace, then run:
+
+```bash
+type-bridge --manifest typebridge.yaml schema check
+type-bridge --manifest typebridge.yaml schema generate
+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
+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
+generic server can additionally configure `artifacts.schema-authority.output`;
+the server mounts that generated, source-free artifact instead of compiling
+YAML or accepting a user-maintained JSON schema.
+
+The generated Python package owns the concise single-type manager:
+
+```python
+from app_models import Age, Person, PersonId
+from type_bridge import Database
+
+db = Database(address="localhost:1729", database="example")
+db.connect()
+
+ada = Person(person_id=PersonId("ada"), age=Age(36))
+Person.manager(db).put(ada)
+people = Person.manager(db).filter(age__gte=18).all()
+```
+
+Use its package-local query session when a query spans types:
+
+```python
+session = Person.query(db)
+person = session.exact(Person)
+adults = (
+    session.query(person)
+    .where(person.field(Person.age).gte(Age(18)))
+    .rows(limit=100)
+)
+```
+
+Continue with the [Python quick start](https://ds1sqe.github.io/type-bridge/getting-started/quickstart/),
+[Split-YAML reference](https://ds1sqe.github.io/type-bridge/guide/split-yaml-v1/),
+and [data guide](https://ds1sqe.github.io/type-bridge/guide/data/).
+
+## TypeScript / Node
+
+```bash
+npm install @type-bridge/node
+```
+
+Import application values from the generated package and connection primitives
+from `@type-bridge/node`:
+
+```ts
+import { RustDatabase } from "@type-bridge/node";
+import { Age, Person, PersonId } from "./generated/models/index.js";
+
+const db = RustDatabase.connect("localhost:1729", "example", {
+  username: "admin",
+  password: "password",
+});
+const ada = Person.create({
+  personId: PersonId.create("ada"),
+  age: Age.create(36n),
+});
+Person.manager(db).put(ada);
+const people = Person.manager(db).filter({ age__gte: Age.create(18n) }).all();
+```
+
+See the [TypeScript/Node guide](https://ds1sqe.github.io/type-bridge/guide/typescript/)
+for generated managers, transactions, and direct/remote queries.
+
+## Rust
+
+The same workspace emits a schema-bound Rust crate. The generated SDK uses
+Rust 1.88+ and the crates.io `type-bridge` runtime:
+
+```toml
+[dependencies]
+type-bridge = "2"
+```
+
+Follow the [Rust client guide](https://ds1sqe.github.io/type-bridge/guide/rust/)
+for generation, direct execution, transactions, and remote queries.
+
+## Documentation
+
+- [Install a surface](https://ds1sqe.github.io/type-bridge/getting-started/installation/)
+- [Model data in Split-YAML](https://ds1sqe.github.io/type-bridge/guide/models/)
+- [Read and write generated models](https://ds1sqe.github.io/type-bridge/guide/data/)
+- [Manage schemas and migrations](https://ds1sqe.github.io/type-bridge/guide/schema-workflows/)
+- [Run the query server](https://ds1sqe.github.io/type-bridge/guide/server-container/)
+- [Browse the Cargo package index](https://ds1sqe.github.io/type-bridge/guide/cargo-packages/)
+- [Compatibility and removals](https://ds1sqe.github.io/type-bridge/guide/v2-deprecations/)
+
+## Development
+
+```bash
+PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1 uv sync --extra dev
+uv run pytest
+./test.sh
+./scripts/check.sh all
+uv run --extra docs mkdocs build --strict
+```
+
+See [DEVELOPMENT.md](DEVELOPMENT.md) for repository boundaries and verification.
+
+## License
+
+TypeBridge-authored code is MIT licensed. Native artifacts also include
+third-party TypeDB components under Apache-2.0 and MPL-2.0; exact notices ship
+with each artifact.

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "type-bridge"
-version = "2.0.2"
+version = "2.1.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.0.2",
+    "type-bridge-core==2.1.0",
     "typing-extensions>=4.12",
 ]
 
@@ -55,8 +55,8 @@ dev = [
     # server. The first native driver line supporting CPython 3.14 is band 9,
     # so that interpreter has a dedicated native-constructor smoke; direct
     # connections from that lane require a 3.12 server. The ORM itself uses
-    # the embedded Rust runtime and continues to serve TypeDB 3.8 through 3.12
-    # on every supported interpreter.
+    # 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'",
     "pytest>=9.0.1",
@@ -80,7 +80,7 @@ docs = [
     "mkdocs-section-index>=0.3",
 ]
 typedb-driver = [
-    "typedb-driver>=3.8,<3.13; python_version < '3.14'",
+    "typedb-driver>=3.11,<3.13; python_version < '3.14'",
     "typedb-driver==3.12.1; python_version >= '3.14'",
 ]
 
@@ -115,6 +115,9 @@ mypy_path = ["typings"]
 line-length = 100
 target-version = "py312"
 
+[tool.ruff.format]
+exclude = ["type-bridge-core/crates/schema-codegen/src/python/query.pyi"]
+
 [tool.ruff.lint]
 select = ["E", "F", "I", "N", "W", "UP"]
 ignore = [
@@ -144,7 +147,6 @@ branch = true
 omit = [
     "type_bridge/__main__.py",
     "type_bridge/migration/__main__.py",
-    "type_bridge/generator/__main__.py",
 ]
 
 [tool.coverage.report]

type_bridge-2.1.0/type_bridge/__init__.py

@@ -0,0 +1,90 @@
+"""Python SDK for generated TypeBridge applications and retained query APIs."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from type_bridge.proxy import ProxyDatabase, ProxyError
+from type_bridge.query import Query, QueryBuilder
+from type_bridge.session import (
+    Connection,
+    Database,
+    TransactionContext,
+)
+from type_bridge.typedb_driver import Credentials, TransactionType, TypeDB, create_driver_options
+
+if TYPE_CHECKING:
+    from type_bridge.crud.exceptions import (
+        EntityNotFoundError,
+        KeyAttributeError,
+        NotUniqueError,
+        RelationNotFoundError,
+    )
+    from type_bridge.crud.hooks import CrudEvent, CrudHook, HookCancelled
+    from type_bridge.migration.exceptions import SchemaConflictError, SchemaValidationError
+    from type_bridge.migration.introspection import SchemaIntrospector
+
+__version__ = "2.1.0"
+
+
+_LAZY_EXPORTS: dict[str, tuple[str, str]] = {
+    "CrudEvent": ("type_bridge.crud.hooks", "CrudEvent"),
+    "CrudHook": ("type_bridge.crud.hooks", "CrudHook"),
+    "HookCancelled": ("type_bridge.crud.hooks", "HookCancelled"),
+    "EntityNotFoundError": ("type_bridge.crud.exceptions", "EntityNotFoundError"),
+    "RelationNotFoundError": ("type_bridge.crud.exceptions", "RelationNotFoundError"),
+    "NotUniqueError": ("type_bridge.crud.exceptions", "NotUniqueError"),
+    "KeyAttributeError": ("type_bridge.crud.exceptions", "KeyAttributeError"),
+    "SchemaIntrospector": ("type_bridge.migration.introspection", "SchemaIntrospector"),
+    "SchemaConflictError": ("type_bridge.migration.exceptions", "SchemaConflictError"),
+    "SchemaValidationError": ("type_bridge.migration.exceptions", "SchemaValidationError"),
+}
+
+
+def __getattr__(name: str) -> Any:
+    """Load retained compatibility identities without importing authoring eagerly."""
+    target = _LAZY_EXPORTS.get(name)
+    if target is None:
+        from type_bridge.migration._archive_imports import archive_attribute
+
+        return archive_attribute(__name__, name)
+
+    from importlib import import_module
+
+    module_name, attribute_name = target
+    value = getattr(import_module(module_name), attribute_name)
+    globals()[name] = value
+    return value
+
+
+__all__ = [
+    # Database and session
+    "Connection",
+    "Database",
+    "TransactionContext",
+    # TypeDB driver (re-exported for convenience)
+    "Credentials",
+    "TransactionType",
+    "TypeDB",
+    "create_driver_options",
+    # Query
+    "Query",
+    "QueryBuilder",
+    # Hooks
+    "CrudEvent",
+    "CrudHook",
+    "HookCancelled",
+    # Proxy
+    "ProxyDatabase",
+    "ProxyError",
+    # CRUD Exceptions
+    "EntityNotFoundError",
+    "RelationNotFoundError",
+    "NotUniqueError",
+    "KeyAttributeError",
+    # Schema
+    "SchemaIntrospector",
+    # Schema exceptions
+    "SchemaConflictError",
+    "SchemaValidationError",
+]

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

@@ -33,6 +33,6 @@ def manager_class(default_manager: type[Any]) -> type[Any]:
     if default_manager.__name__ == "RustTypeDBManager":
         return default_manager
 
-    from type_bridge.crud.rust_manager import RustTypeDBManager
+    from type_bridge.crud.rust_manager import _QueryRustTypeDBManager
 
-    return RustTypeDBManager
+    return _QueryRustTypeDBManager

type_bridge-2.1.0/type_bridge/_runtime_projection.py

@@ -0,0 +1,92 @@
+"""Thin forwarding facade for generated V2 runtime projections."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from type_bridge_core import PyProjectedModelManager, PyRuntimeProjection
+
+from type_bridge._rust_runtime import rust_core, rust_database_for, rust_transaction_for
+
+
+class GeneratedEntityProjection:
+    """Nominal marker implemented only by generated entity model bases."""
+
+    __slots__ = ()
+
+
+class GeneratedRelationProjection:
+    """Nominal marker implemented only by generated relation model bases."""
+
+    __slots__ = ()
+
+
+_installed_projection_by_model: dict[type[object], PyRuntimeProjection] = {}
+
+
+def install_runtime_projection(
+    projection_json: str,
+    semantic_fingerprint_json: str,
+    projection_fingerprint_json: str,
+    models: Sequence[tuple[type[object], type[object] | None]],
+) -> PyRuntimeProjection:
+    """Verify and install one generated package's native projection."""
+    installed = rust_core().PyRuntimeProjection(
+        projection_json,
+        semantic_fingerprint_json,
+        projection_fingerprint_json,
+        list(models),
+    )
+    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]
+    except KeyError:
+        raise TypeError("query builder requires an exact installed generated model class") from None
+
+
+def projected_query_builder_match_entity_for(
+    model: type[GeneratedEntityProjection],
+    variable: str,
+    filters: dict[str, object],
+) -> str:
+    """Compile a raw-query entity match from verified generated projection facts."""
+    projection = _installed_projection_for(model)
+    return projection.query_builder_match_entity(model, variable, filters)
+
+
+def projected_query_builder_insert_entity_for(
+    instance: GeneratedEntityProjection,
+    variable: str,
+) -> str:
+    """Compile a raw-query entity insert from one exact generated value."""
+    projection = _installed_projection_for(type(instance))
+    return projection.query_builder_insert_entity(instance, variable)
+
+
+def projected_query_builder_match_relation_for(
+    model: type[GeneratedRelationProjection],
+    variable: str,
+    role_players: dict[str, str] | None,
+) -> str:
+    """Compile a raw-query relation match from verified generated role tokens."""
+    projection = _installed_projection_for(model)
+    return projection.query_builder_match_relation(model, variable, role_players)
+
+
+def projected_manager_for(
+    projection: PyRuntimeProjection,
+    model: type[object],
+    connection: object,
+) -> PyProjectedModelManager:
+    """Bind a package projection to an existing native connection handle."""
+    transaction = rust_transaction_for(connection)
+    if transaction is not None:
+        return projection.manager_for_transaction(model, transaction)
+    return projection.manager_for_database(model, rust_database_for(connection))