athena-python-docx 0.1.0__tar.gz → 0.1.1__tar.gz

{athena_python_docx-0.1.0 → athena_python_docx-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: athena-python-docx
-Version: 0.1.0
+Version: 0.1.1
 Summary: Drop-in replacement for python-docx that connects to Athena's Superdoc/Keryx collaborative document stack
 Project-URL: Homepage, https://athenaintelligence.ai
 Author-email: Athena Intelligence <engineering@athenaintelligence.ai>

{athena_python_docx-0.1.0 → athena_python_docx-0.1.1}/docx/__init__.py

@@ -6,7 +6,7 @@ See CLAUDE.md for the API parity contract.
 
 from __future__ import annotations
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 from docx.api import Document
 

{athena_python_docx-0.1.0 → athena_python_docx-0.1.1}/docx/document.py

@@ -306,12 +306,50 @@ class Document:
 # ---- Module-level helpers ----
 
 def _extract_inserted_node_id(result: dict, *, expected_type: str) -> str:
-    """Parse Superdoc's insert() response to find the new nodeId.
-
-    Superdoc rotates response shape across versions. Defensively probe.
+    """Parse Superdoc's insert() response to find the relevant blockId.
+
+    Superdoc rotates response shapes across versions; we probe in order
+    of "most current" first. Real observed shape (superdoc-sdk 1.6.0.dev29):
+
+        {
+          "receipt": {
+            "resolution": {
+              "target": {"kind": "text", "blockId": "<uuid>", "range": {...}}
+            }
+          },
+          ...
+        }
+
+    Older/alternate shapes we also accept:
+      - top-level ``blockId``
+      - nested ``result.insertedNodes[].nodeId`` (when typed = expected_type)
+      - last element of ``result.nodes``
     """
     if not isinstance(result, dict):
         return ""
+
+    # Shape 1 (current): receipt.resolution.target.blockId
+    receipt: object = result.get("receipt")
+    if isinstance(receipt, dict):
+        resolution: object = receipt.get("resolution")
+        if isinstance(resolution, dict):
+            target: object = resolution.get("target")
+            if isinstance(target, dict):
+                block_id: str = str(target.get("blockId", ""))
+                if block_id:
+                    return block_id
+
+    # Shape 2: top-level blockId or target.blockId
+    top_block: object = result.get("blockId")
+    if isinstance(top_block, str) and top_block:
+        return top_block
+    top_target: object = result.get("target")
+    if isinstance(top_target, dict):
+        tb: str = str(top_target.get("blockId", ""))
+        if tb:
+            return tb
+
+    # Shape 3 (legacy): nested result.result.insertedNodes[] / nodes[]
     data_obj: object = result.get("result", {})
     data: dict = data_obj if isinstance(data_obj, dict) else {}
     nodes_obj: object = data.get("insertedNodes", data.get("nodes", []))
@@ -323,6 +361,7 @@ def _extract_inserted_node_id(result: dict, *, expected_type: str) -> str:
             return str(node.get("nodeId", ""))
     if nodes and isinstance(nodes[-1], dict):
         return str(nodes[-1].get("nodeId", ""))
+
     return ""
 
 

{athena_python_docx-0.1.0 → athena_python_docx-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "athena-python-docx"
-version = "0.1.0"
+version = "0.1.1"
 description = "Drop-in replacement for python-docx that connects to Athena's Superdoc/Keryx collaborative document stack"
 readme = "README.md"
 license = "MIT"