Merge pull request #94 from ds1sqe/develop

1.2.7 - TypeDB 3.8.0 Support and Batch Operations Optimization

Author: ds1sqe

.github/workflows/release.yml

@@ -0,0 +1,109 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+# Ensure only one release workflow runs at a time
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  # Run tests before releasing
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run linting
+        run: uv run ruff check .
+
+      - name: Run unit tests
+        run: uv run pytest tests/unit/ -v --tb=short
+
+  # Build the package
+  build:
+    name: Build
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  # Publish to PyPI
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write  # Required for trusted publishing
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # Create draft GitHub Release
+  github-release:
+    name: Create GitHub Release
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create draft release
+        uses: softprops/action-gh-release@v2
+        with:
+          draft: true
+          generate_release_notes: true
+          files: dist/*

CHANGELOG.md

@@ -2,6 +2,45 @@
 
 All notable changes to TypeBridge will be documented in this file.
 
+## [1.2.7] - 2026-02-03
+
+### New Features
+
+#### TypeDB 3.8.0 Support (PR #93)
+- Full compatibility with TypeDB 3.8.0
+- Updated driver integration
+
+### Performance Improvements
+
+#### Batch Operations Optimization
+- **Batch delete operations** with disjunctive IID matching
+- **Batch entity inserts/puts** into single query
+- **Optimized IID retrieval** with single-query insert+fetch
+
+### Bug Fixes
+
+- **HydrationError handling** - Raise HydrationError instead of silently swallowing exceptions
+- **Variable collision prevention** - Use double underscore separator to prevent variable collisions
+- **TypeDB 3.x relation syntax** - Use correct relation insert syntax with `links` keyword
+- **Multi-variable let fix** - Remove incorrect parentheses in multi-variable let assignment
+- **Polymorphic attributes** - Restore polymorphic attribute fetching with nested wildcard
+
+### Refactoring
+
+- Consolidate duplicated code and fix Python 3.13 warnings
+- Unify entity identification logic across managers
+- Extract shared attribute-to-AST logic into TypeDBType
+- Remove `.c` accessor for direct field access
+
+### Code Quality
+
+- Remove all `type: ignore` comments for full type safety
+
+### Testing
+
+- Add recursive relation tests
+- Add validation performance benchmarks
+
 ## [1.2.6] - 2026-02-01
 
 ### New Features

CLAUDE.md

@@ -39,7 +39,7 @@ uv run pyright tests/            # Type check tests
 
 ## Project Structure
 
-```
+```text
 type_bridge/
 ├── __init__.py           # Main package exports
 ├── query.py              # TypeQL query builder
@@ -269,4 +269,65 @@ persons = person_manager.all()
 8. **Connection type** - Managers accept `Database`, `Transaction`, or `TransactionContext`
 9. **Dict helpers** - Use `to_dict()` and `from_dict()` for serialization
 
+## Claude Code Instructions
+
+### Always Fix Issues
+
+**CRITICAL**: When encountering bugs, test failures, or issues during development:
+
+- ALWAYS fix issues, regardless of whether they appear to be "pre-existing"
+- Never dismiss bugs as "not related to current changes" - if you found it, fix it
+- Complete the work fully; don't leave partial implementations
+- If a refactor is done, it should be COMPLETE - no dead code, no overridden methods that defeat the purpose
+
+### Code Quality Standards
+
+**CRITICAL: Always run checks on the ENTIRE codebase, not just modified files.**
+
+AI sessions may include multiple separate conversations or context compactions, so changes from earlier in a session could introduce issues. Running checks on only a subset of files will miss these problems and cause CI failures.
+
+Before committing, run ALL of these on the entire codebase:
+
+```bash
+uv run ruff check --fix .        # Lint entire codebase
+uv run ruff format .             # Format entire codebase
+uv run pyright type_bridge/      # Type check library
+uv run pyright tests/            # Type check tests
+uv run pytest tests/unit/ -x     # Run all unit tests
+```
+
+Before PRs, also run:
+
+```bash
+./test-integration.sh            # Integration tests (requires TypeDB)
+```
+
+Additional standards:
+
+- When unifying code (e.g., EntityManager + RelationManager), remove ALL duplicated methods from subclasses
+- Delete dead code completely - no backwards-compatibility hacks, no `_unused` variables, no `# removed` comments
+
+### Pydantic Best Practices
+
+When working with Pydantic model validators:
+
+- **Avoid `object.__setattr__`** - Using `object.__setattr__` to bypass Pydantic's validation is a hack that can mask bugs
+- **Use `mode='before'` validators** to transform input data BEFORE validation, avoiding recursion with `validate_assignment=True`
+- **Use `mode='wrap'` validators** only when you need to capture state before AND after validation (e.g., preserving private attributes)
+- **Access private attributes via `__pydantic_private__`** - This is Pydantic's official API for private attribute storage
+
+Example pattern for value transformation:
+
+```python
+@model_validator(mode="before")
+@classmethod
+def transform_input(cls, values: Any) -> dict[str, Any]:
+    """Transform input BEFORE validation - no recursion possible."""
+    if isinstance(values, dict):
+        data = dict(values)
+        # Transform values here
+        return data
+    return values
+```
+
 For detailed documentation, see the links above.

docs/INTERNALS.md

@@ -176,6 +176,7 @@ class EntityManager(Generic[E]):
 ```
 
 **Benefits:**
+
 - Cleaner syntax
 - Better IDE support
 - Matches modern Python standards
@@ -227,6 +228,7 @@ TypeBridge is fully compatible with:
 - **Pydantic's type system**: Built on Pydantic v2
 
 **Current status:**
+
 - ✅ 0 type errors with Pyright
 - ✅ 0 type warnings (except in type-check-except tests)
 - ✅ Full type inference for managers and queries
@@ -263,9 +265,7 @@ Tests that intentionally check Pydantic validation behavior use raw values and a
 
 ```json
 {
-  "exclude": [
-    "tests/unit/type-check-except/**"
-  ]
+  "exclude": ["tests/unit/type-check-except/**"]
 }
 ```
 
@@ -278,19 +278,22 @@ The project minimizes `Any` usage for type safety:
 **Where `Any` is used:**
 
 1. **`Flag()` function**: Accepts `Any` for parameters to handle type aliases like `Key` and `Unique`
+
    ```python
    def Flag(*args: Any) -> AttributeFlags:
        """Create attribute flags from Key, Unique, Card arguments."""
        ...
    ```
 
 2. **`Flag()` return type**: Returns `AttributeFlags` (used as field default)
+
    ```python
    class Person(Entity):
        name: Name = Flag(Key)  # Flag() returns AttributeFlags
    ```
 
 3. **Pydantic core schema methods**: Use proper TypeVars (`StrValue`, `IntValue`, etc.)
+
    ```python
    @classmethod
    def __get_pydantic_core_schema__(
@@ -381,6 +384,7 @@ class Entity(BaseModel):
 ```
 
 This tells type checkers:
+
 - All fields are keyword-only by default
 - `Flag()` is recognized as a valid field specifier
 - Constructor signature is inferred from class annotations
@@ -433,12 +437,11 @@ crud/
 ### Import Patterns
 
 ```python
-# Public API (backward compatible)
-from type_bridge import EntityManager, RelationManager
+# Public API
+from type_bridge import TypeDBManager
 
-# Direct module imports (new style)
-from type_bridge.crud.entity import EntityManager
-from type_bridge.crud.relation import RelationManager
+# Or from crud module
+from type_bridge.crud import TypeDBManager
 
 # Shared utilities (internal use)
 from type_bridge.crud.utils import format_value, is_multi_value_attribute
@@ -482,6 +485,7 @@ with db.transaction(TransactionType.WRITE) as tx:
 ```
 
 **Behavior:**
+
 - Auto-commit on successful context exit (WRITE/SCHEMA transactions)
 - Auto-rollback on exception
 - READ transactions never commit (no writes)
@@ -510,6 +514,7 @@ class ConnectionExecutor:
 ```
 
 **Design principles:**
+
 1. **Transparency**: CRUD operations work identically regardless of connection type
 2. **Transaction reuse**: Existing transactions are never duplicated
 3. **Auto-management**: Database connections create transactions as needed

examples/advanced/schema_01_manager.py

@@ -18,11 +18,11 @@
     Key,
     Relation,
     Role,
+    SchemaManager,
     String,
     TypeFlags,
     Unique,
 )
-from type_bridge.schema import SchemaManager
 from type_bridge.session import Database
 
 

examples/advanced/schema_02_comparison.py

@@ -14,10 +14,10 @@
     Key,
     Relation,
     Role,
+    SchemaManager,
     String,
     TypeFlags,
 )
-from type_bridge.schema import SchemaManager
 
 
 # Version 1: Initial schema

examples/advanced/schema_03_conflict.py

@@ -8,10 +8,11 @@
     Entity,
     Flag,
     Key,
+    SchemaConflictError,
+    SchemaManager,
     String,
     TypeFlags,
 )
-from type_bridge.schema import SchemaConflictError, SchemaManager
 from type_bridge.session import Database