matrx-orm 3.1.65__tar.gz → 3.1.66__tar.gz

{matrx_orm-3.1.65 → matrx_orm-3.1.66}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: matrx-orm
-Version: 3.1.65
+Version: 3.1.66
 Summary: Async-first PostgreSQL ORM with bidirectional migrations, schema introspection, many-to-many relationships, and built-in state caching
 Project-URL: Homepage, https://github.com/AI-Matrix-Engine/aidream-current
 Project-URL: Repository, https://github.com/AI-Matrix-Engine/aidream-current

{matrx_orm-3.1.65 → matrx_orm-3.1.66}/matrx_orm/associations.py

@@ -186,6 +186,7 @@ class Associations:
         target_id_field: str = "target_id",
         org_field: str = "org_id",
         role_field: str = "role",
+        soft_delete_field: str = "deleted_at",
     ) -> None:
         self._assoc = association_model
         self._reg = registry
@@ -196,6 +197,14 @@ class Associations:
         self._org = org_field
         self._role = role_field
         self._role_available = True  # refined by _validate_field_bindings when introspectable
+        # An edge table MAY tombstone edges rather than delete them: the host's
+        # entity soft-delete carries its edges down with it, and the entity's
+        # restore brings exactly those edges back. Where the column exists EVERY
+        # read here is live-only — a tombstoned edge conveys nothing, so handing
+        # one back is an access leak. A minimal host edge table without the
+        # column keeps the old unfiltered behaviour.
+        self._soft_delete = soft_delete_field
+        self._soft_delete_available = False  # refined by _validate_field_bindings
         # Optional edge-document columns (platform.associations carries them;
         # a minimal host edge table may not). Passing the kwarg against a
         # table without the column raises loudly at call time.
@@ -239,9 +248,14 @@ class Associations:
         # role is OPTIONAL on the edge table — engines over role-less edge
         # tables keep working; passing a role against one raises at call time.
         self._role_available = self._role in fields
+        self._soft_delete_available = self._soft_delete in fields
         for col in self._optional_cols:
             self._optional_cols[col] = col in fields
 
+    def _live_filter(self) -> dict[str, Any]:
+        """Restrict a read to non-tombstoned edges (no-op without the column)."""
+        return {self._soft_delete: None} if self._soft_delete_available else {}
+
     # ---- writes ----------------------------------------------------------
 
     def _role_filter(self, role: Any) -> dict[str, Any]:
@@ -332,6 +346,14 @@ class Associations:
                 for col, value in {"metadata": metadata, **extras}.items()
                 if value is not None and getattr(edge, col, None) != value
             }
+            # Re-attaching over a TOMBSTONE revives it. The lookup deliberately
+            # matches tombstoned edges (the DB's unique index does too), so
+            # without this the caller would get back an edge nothing can see.
+            if self._soft_delete_available and getattr(edge, self._soft_delete, None) is not None:
+                updates[self._soft_delete] = None
+                for stamp in ("deleted_via_type", "deleted_via_id"):
+                    if stamp in getattr(getattr(self._assoc, "_meta", None), "fields", ()):
+                        updates[stamp] = None
             if updates:
                 edge = await edge.update(**updates)
         return edge
@@ -352,6 +374,10 @@ class Associations:
                 self._ti: target.id,
                 self._org: org_id,
                 **self._role_filter(role),
+                # Never purge a tombstone: the user is detaching what they can
+                # SEE, and the tombstone must survive to be restored with its
+                # entity. A hard entity DELETE is what purges tombstones.
+                **self._live_filter(),
             }
         )
         for edge in edges:
@@ -374,6 +400,7 @@ class Associations:
         if target_type is not None:
             filters[self._tt] = target_type
         filters.update(self._role_filter(role))
+        filters.update(self._live_filter())
         return await self._assoc.filter_items(**filters)
 
     async def edges_to(
@@ -390,6 +417,7 @@ class Associations:
         if source_type is not None:
             filters[self._st] = source_type
         filters.update(self._role_filter(role))
+        filters.update(self._live_filter())
         return await self._assoc.filter_items(**filters)
 
     async def targets_from(

{matrx_orm-3.1.65 → matrx_orm-3.1.66}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "matrx-orm"
-version = "3.1.65"
+version = "3.1.66"
 description = "Async-first PostgreSQL ORM with bidirectional migrations, schema introspection, many-to-many relationships, and built-in state caching"
 readme = "README.md"
 license = { text = "MIT" }