Merge pull request #88 from CaliLuke/feat/typedb-3.8.0-support

TypeDB 3.8.0 support: iid(), label() built-ins, Unicode identifiers

Author: ds1sqe

.github/workflows/ci.yml

@@ -105,12 +105,12 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        test-group: [crud, queries, schema]
+        test-group: [crud, queries, schema, expressions]
 
     # Start TypeDB as a service container (runs first, before steps)
     services:
       typedb:
-        image: typedb/typedb:3.7.0-rc0
+        image: typedb/typedb:3.8.0-rc0
         ports:
           - 1729:1729
 

.gitignore

@@ -21,3 +21,6 @@ packages/typescript/dist/
 
 # Temporary
 tmp/
+
+# Reference repos
+typeql-ref/

CHANGELOG.md

@@ -2,6 +2,74 @@
 
 All notable changes to TypeBridge will be documented in this file.
 
+## [1.2.4] - 2026-01-30
+
+### New Features
+
+#### TypeDB 3.8.0 Built-in Functions (PR #88)
+- **Added support for TypeDB 3.8.0 built-in functions**
+  - Identity functions: `iid()`, `label()`
+  - Math functions: `abs_()`, `ceil()`, `floor()`, `round_()`
+  - Collection functions: `len_()`, `max_()`, `min_()`
+  - Location: `type_bridge/expressions/builtins.py`
+
+**Usage Example:**
+```python
+from type_bridge.expressions import iid, label, abs_, ceil, floor
+
+# Get entity IID
+query = Person.manager(db).filter(iid() == "0x1a2b3c").execute()
+
+# Use math functions
+query = Person.manager(db).filter(abs_(Age.value) > 18).execute()
+```
+
+#### Unicode XID Identifier Validation (PR #88)
+- **Added Unicode identifier validation for TypeDB 3.8.0 compatibility**
+  - Validates identifiers follow Unicode XID_Start/XID_Continue rules
+  - Ensures TypeQL identifiers are compatible with TypeDB 3.8.0
+  - Clear error messages for invalid identifiers
+  - Location: `type_bridge/validation.py`
+
+### Bug Fixes
+
+#### Value Extraction Fix (PR #88)
+- **Fixed value extraction for `_Value` concepts**
+  - Changed from `.as_value()` to `.get()` for proper value extraction
+  - Fixes issues with function return values and aggregations
+  - Location: `type_bridge/session.py`
+
+#### Driver Initialization Warning Fix (PR #88)
+- **Fixed "Failed to initialize logging" warning**
+  - Suppresses fd 2 (stderr) during TypeDB driver initialization
+  - Eliminates spurious warning messages on startup
+  - Location: `type_bridge/typedb_driver.py`
+
+### Documentation
+
+- **Added AI Assistant Skill Documentation** (`docs/SKILL.md`)
+  - Guidelines for using TypeBridge with AI code assistants
+
+### Testing
+
+- 32 new unit tests for builtin expressions
+- 7 new integration tests for `iid()` and `label()` functions
+- All existing tests pass with TypeDB 3.8.0-rc0
+- Fixed hardcoded port 1729 in tests to use TEST_DB_ADDRESS
+
+### CI/CD
+
+- **Updated CI to TypeDB 3.8.0-rc0**
+  - All tests now run against TypeDB 3.8.0-rc0
+
+### Key Files Modified
+
+- `type_bridge/expressions/builtins.py` - New built-in function expressions
+- `type_bridge/session.py` - Value extraction fix
+- `type_bridge/typedb_driver.py` - Driver initialization fix
+- `type_bridge/validation.py` - Unicode identifier validation
+- `docs/SKILL.md` - New AI assistant documentation
+
 ## [1.2.3] - 2025-12-28
 
 ### New Features

README.md

@@ -234,7 +234,7 @@ generate_models("schema.tql", "./myapp/models/")
 
 This generates a complete Python package:
 
-```
+```text
 myapp/models/
 ├── __init__.py      # Package exports, SCHEMA_VERSION, schema_text()
 ├── attributes.py    # Attribute class definitions
@@ -245,6 +245,7 @@ myapp/models/
 ```
 
 The generator supports:
+
 - Entity/relation/attribute inheritance (`sub` keyword)
 - `@key`, `@unique`, `@card` constraints (including on `plays` and `relates`)
 - `@regex` and `@values` constraints
@@ -265,6 +266,7 @@ See [docs/api/generator.md](docs/api/generator.md) for full documentation.
 - **[docs/TYPEDB.md](docs/TYPEDB.md)** - TypeDB concepts, driver API, and TypeQL syntax
 - **[docs/ABSTRACT_TYPES.md](docs/ABSTRACT_TYPES.md)** - Abstract types and interface hierarchies in TypeDB
 - **[docs/INTERNALS.md](docs/INTERNALS.md)** - Internal type system and architecture
+- **[docs/SKILL.md](docs/SKILL.md)** - AI assistant skill for using type-bridge (for Claude, GPT, etc.)
 
 ### API Reference
 
@@ -372,17 +374,6 @@ uv run pytest -m "" -v                    # Run all tests
 - jinja2>=3.1.0 (for code generation)
 - typer>=0.15.0 (for CLI)
 
-## What's New in v1.2.2 (2025-12-25)
-
-**Critical Bug Fixes:**
-- 🐛 **Fixed RelationManager IID correlation** (Issue #78) - `RelationManager.all()` now correctly assigns unique IIDs to role players instead of duplicating the same IIDs across all relations
-- 🐛 **Fixed stack overflow in `__in` lookups** (Issue #76) - Large `__in` queries (75+ values) now work reliably without causing TypeDB query planner crashes
-
-**Previous Releases:**
-- v1.2.0 - TypeDB 3.0 Structs Support & Batch Query Optimizations
-- v1.1.0 - Polymorphic Entity Instantiation
-- v1.0.0 - Initial stable release
-
 ## Release Notes
 
 See the [CHANGELOG.md](CHANGELOG.md) for detailed release notes and version history.

docker-compose.yml

@@ -1,6 +1,6 @@
 services:
   typedb:
-    image: typedb/typedb:3.7.0
+    image: typedb/typedb:3.8.0-rc0
     container_name: typedb_test
     ports:
       - "${TYPEDB_PORT:-1730}:1729"