boarddata 6.7.1__tar.gz → 6.7.2__tar.gz

{boarddata-6.7.1 → boarddata-6.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boarddata
-Version: 6.7.1
+Version: 6.7.2
 Summary: Python SDK for the BoardData V2 REST API
 License: MIT
 Classifier: Development Status :: 4 - Beta

{boarddata-6.7.1 → boarddata-6.7.2}/__init__.py

@@ -6,7 +6,7 @@ from .cache import FileTokenCache, ScalewaySecretTokenCache
 from .client import BoardDataClient
 from .errors import BoardDataError, ExportTooLargeError
 
-__version__ = "6.7.1"
+__version__ = "6.7.2"
 __all__ = [
     "Base",
     "BoardDataClient",

{boarddata-6.7.1 → boarddata-6.7.2}/_assemblies.py

@@ -6,6 +6,7 @@ from typing import Any
 
 from .types.assemblies import (
     AssemblyDetail,
+    AssemblyDocumentLink,
     AssemblyExportItem,
     CreatePresentationPayload,
     CreateQuestionPayload,
@@ -456,6 +457,24 @@ class AssemblyMixin:
         """Delete a question."""
         self._delete(f"assemblies/{assembly_uid}/questions/{pk}/")  # type: ignore[attr-defined]
 
+    # --- Assembly document links ---
+    def link_assembly_document(
+        self, assembly_uid: str, document_id: str, category: str, doc_type: str
+    ) -> AssemblyDocumentLink:
+        """Link a document to an assembly (idempotent; returns the link row).
+
+        The backend refuses cross-company links: ``document`` must belong to the
+        assembly's company.
+        """
+        return self._post(  # type: ignore[attr-defined]
+            f"assemblies/{assembly_uid}/documents/",
+            {"document_id": document_id, "category": category, "doc_type": doc_type},
+        )
+
+    def unlink_assembly_document(self, assembly_uid: str, link_id: str) -> None:
+        """Delete an assembly-document link (the Document itself is untouched)."""
+        self._delete(f"assemblies/{assembly_uid}/documents/{link_id}/")  # type: ignore[attr-defined]
+
     # -- Resolutions --
 
     def list_resolutions(self, **params: Any) -> PaginatedResponse:

{boarddata-6.7.1 → boarddata-6.7.2}/boarddata.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boarddata
-Version: 6.7.1
+Version: 6.7.2
 Summary: Python SDK for the BoardData V2 REST API
 License: MIT
 Classifier: Development Status :: 4 - Beta

{boarddata-6.7.1 → boarddata-6.7.2}/dq/apply.py

@@ -7,10 +7,10 @@ the pghistory audit trail. There is no direct DB write anywhere here.
 
 Reversibility, by action:
   * ``repoint`` — full. Restore the document's previous ISIN.
-  * ``delete``  — partial. The document row is recreated from a full pre-delete
-    snapshot, but its assembly↔document link(s) cannot be restored through the
-    current API (the link is read-only / has no create endpoint). The links are
-    recorded in the manifest so the gap is explicit, never silent.
+  * ``delete``  — full. The document row is recreated from a full pre-delete
+    snapshot, and its assembly↔document link(s) are re-created via
+    ``link_assembly_document``. A link that fails to restore (e.g. a
+    cross-company refusal) is recorded rather than aborting the revert.
   * ``merge``   — refused. Destructive and not yet revertible; ``apply`` raises
     rather than perform an irreversible operation.
 """
@@ -54,6 +54,9 @@ class FixClient(Protocol):
     def update_document(self, uid: str, **kwargs: Any) -> dict[str, Any]: ...
     def delete_document(self, uid: str, *, cascade_field_sources: bool = False) -> None: ...
     def merge_document(self, uid: str, *, into: str) -> dict[str, Any]: ...
+    def link_assembly_document(
+        self, assembly_uid: str, document_id: str, category: str, doc_type: str
+    ) -> dict[str, Any]: ...
 
 
 def _snapshot(client: FixClient, uid: str) -> dict[str, Any]:
@@ -78,9 +81,9 @@ def apply_action(action: FixAction, client: FixClient) -> dict[str, Any] | None:
             "action": "delete",
             "document_id": doc_id,
             "before": before,
-            # links are gone (backend cascade) and not API-restorable — record them
+            # links are gone (backend cascade); recorded so revert can re-create them
             "assembly_links": list(action.before_state.get("assembly_links", [])),
-            "reversible": "partial",
+            "reversible": "full",
         }
 
     if action.action == "repoint":
@@ -155,12 +158,24 @@ def revert_entry(entry: dict[str, Any], client: FixClient) -> dict[str, Any]:
             url=before.get("url"),
             original_url=before.get("original_url"),
         )
+        new_id = new.get("id")
+        restored: list[dict[str, Any]] = []
+        unrestored: list[dict[str, Any]] = []
+        for link in entry.get("assembly_links", []):
+            try:
+                client.link_assembly_document(
+                    link["assembly_id"], new_id, link.get("category", ""), link.get("doc_type", "")
+                )
+                restored.append(link)
+            except Exception as exc:  # noqa: BLE001 — best-effort restore; record, never abort the revert
+                unrestored.append({**link, "error": str(exc)})
         return {
             "document_id": doc_id,
             "reverted": "delete",
-            "status": "partial",  # doc recreated (new id); assembly links not restored
-            "new_document_id": new.get("id"),
-            "unrestored_assembly_links": list(entry.get("assembly_links", [])),
+            "status": "ok" if not unrestored else "partial",
+            "new_document_id": new_id,
+            "restored_assembly_links": restored,
+            "unrestored_assembly_links": unrestored,
         }
 
     raise ApplyError(f"cannot revert action {act!r} for document {doc_id}")

{boarddata-6.7.1 → boarddata-6.7.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "boarddata"
-version = "6.7.1"
+version = "6.7.2"
 description = "Python SDK for the BoardData V2 REST API"
 readme = "README.md"
 license = {text = "MIT"}

{boarddata-6.7.1 → boarddata-6.7.2}/tests/test_assemblies.py

@@ -161,3 +161,29 @@ class TestListPublishedAssemblies:
         c.list_published_assemblies(page=2, page_size=500)
         _, kwargs = c._request.call_args
         assert kwargs["params"] == {"page": 2, "page_size": 500}
+
+
+class TestLinkAssemblyDocument:
+    def test_posts_link_payload(self):
+        c = make_client()
+        c._request.return_value = {
+            "id": "link1",
+            "document_id": "doc1",
+            "url": "k.pdf",
+            "title": "Notice",
+            "document_type": "notice_of_gm",
+            "category": "ODJ",
+            "doc_type": "NOTICE",
+        }
+        out = c.link_assembly_document("asm1", "doc1", "ODJ", "NOTICE")
+        args, kwargs = c._request.call_args
+        assert args == ("POST", "assemblies/asm1/documents/")
+        assert kwargs["json"] == {"document_id": "doc1", "category": "ODJ", "doc_type": "NOTICE"}
+        assert out["id"] == "link1"
+
+    def test_unlink_issues_delete(self):
+        c = make_client()
+        c._request.return_value = None
+        c.unlink_assembly_document("asm1", "link1")
+        args, _ = c._request.call_args
+        assert args == ("DELETE", "assemblies/asm1/documents/link1/")

{boarddata-6.7.1 → boarddata-6.7.2}/types/assemblies.py

@@ -248,6 +248,18 @@ class _AssemblyDocumentInline(TypedDict):
     doc_type: str
 
 
+class AssemblyDocumentLink(TypedDict):
+    """A document↔assembly link row (the join shown on an AGM page)."""
+
+    id: str
+    document_id: str
+    url: str
+    title: str
+    document_type: str
+    category: str
+    doc_type: str
+
+
 # -- Assemblies --