qodev-apollo-api 0.1.3__tar.gz → 0.2.0__tar.gz

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-06-02
+
+### Fixed
+- `create_note()` posted `{"note": <plaintext>}`, which Apollo silently ignores — notes were created with empty content. It now serialises `content` to ProseMirror JSON and posts it in the `content` field (the format Apollo stores and `search_notes()` reads back). Closes #6.
+
+### Added
+- `markdown_to_prosemirror()` in `utils` — inverse of `prosemirror_to_markdown()` (title, paragraphs, bullet/ordered lists).
+- `create_note(..., title=...)` — optional note title (rendered as the ProseMirror `noteTitle`).
+- `ApolloClient.delete_note(note_id)` — `DELETE /notes/{id}`.
+
+### Changed
+- `create_note()` association args (`contact_ids`, `account_ids`, `opportunity_ids`) are now keyword-only, so the new positional `title` can't be confused with them.
+
 ## [0.1.3] - 2026-02-23
 
 ### Added

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qodev-apollo-api
-Version: 0.1.3
+Version: 0.2.0
 Summary: Async Python client for Apollo.io CRM API
 Project-URL: Homepage, https://github.com/qodevai/apollo-api
 Project-URL: Repository, https://github.com/qodevai/apollo-api

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qodev-apollo-api"
-version = "0.1.3"
+version = "0.2.0"
 description = "Async Python client for Apollo.io CRM API"
 readme = "README.md"
 authors = [

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/src/qodev_apollo_api/__init__.py

@@ -151,4 +151,4 @@ __all__ = [
     "resolve_task",
 ]
 
-__version__ = "0.1.3"
+__version__ = "0.2.0"

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/src/qodev_apollo_api/client.py

@@ -38,7 +38,7 @@ from .models import (
     TaskType,
     resolve_task,
 )
-from .utils import normalize_linkedin_url, prosemirror_to_markdown
+from .utils import markdown_to_prosemirror, normalize_linkedin_url, prosemirror_to_markdown
 
 
 class ApolloClient:
@@ -597,14 +597,23 @@ class ApolloClient:
     async def create_note(
         self,
         content: str,
+        title: str | None = None,
+        *,
         contact_ids: list[str] | None = None,
         account_ids: list[str] | None = None,
         opportunity_ids: list[str] | None = None,
     ) -> dict:
         """Create a note.
 
+        Apollo stores note bodies in the ``content`` field as ProseMirror JSON,
+        so the plain text / Markdown ``content`` is converted via
+        :func:`~qodev_apollo_api.utils.markdown_to_prosemirror` before posting.
+        (Posting ``{"note": <plaintext>}`` is silently ignored by Apollo and
+        produces an empty note.)
+
         Args:
-            content: Note content (plain text or Markdown)
+            content: Note body as plain text / Markdown.
+            title: Optional note title (rendered as the ProseMirror noteTitle).
             contact_ids: List of contact IDs to associate
             account_ids: List of account IDs to associate
             opportunity_ids: List of opportunity IDs to associate
@@ -612,7 +621,9 @@ class ApolloClient:
         Returns:
             Raw API response with created note data
         """
-        data: dict[str, str | list[str]] = {"note": content}
+        data: dict[str, str | list[str]] = {
+            "content": markdown_to_prosemirror(content, title=title)
+        }
         if contact_ids:
             data["contact_ids"] = contact_ids
         if account_ids:
@@ -622,6 +633,17 @@ class ApolloClient:
 
         return await self._post("/notes", data)
 
+    async def delete_note(self, note_id: str) -> dict:
+        """Delete a note by ID.
+
+        Args:
+            note_id: Apollo note ID.
+
+        Returns:
+            Raw API response.
+        """
+        return await self._request("DELETE", f"/notes/{note_id}")
+
     # ========================================================================
     # ACTIVITIES
     # ========================================================================

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/src/qodev_apollo_api/utils.py

@@ -1,9 +1,12 @@
 """Utility functions for Apollo client.
 
-Includes ProseMirror JSON to Markdown conversion for notes.
+Includes ProseMirror JSON <-> Markdown conversion for notes.
 """
 
 import json
+import re
+
+_ORDERED_ITEM_RE = re.compile(r"^\d+\.\s+(.*)$")
 
 
 def prosemirror_to_markdown(content_json: str) -> tuple[str, str]:
@@ -103,6 +106,66 @@ def _extract_text_from_list_item(item: dict) -> str:
     return " ".join(text_parts)
 
 
+def markdown_to_prosemirror(content: str, title: str | None = None) -> str:
+    """Convert plain text / lightweight Markdown to a ProseMirror JSON string.
+
+    Apollo's ``POST /notes`` stores the note body in the ``content`` field as a
+    ProseMirror JSON string; this is the inverse of :func:`prosemirror_to_markdown`
+    for the node types Apollo notes use.
+
+    Supports:
+      * an optional note title (``noteTitle`` node)
+      * paragraphs (one per line; blank lines become empty paragraphs)
+      * bullet lists (lines starting with ``- `` or ``* ``)
+      * ordered lists (lines starting with ``1. ``)
+
+    Args:
+        content: Note body as plain text / Markdown.
+        title: Optional note title (rendered as the ProseMirror ``noteTitle``).
+
+    Returns:
+        ProseMirror document as a JSON string, ready to post to ``content``.
+    """
+    nodes: list[dict] = []
+    if title:
+        nodes.append({"type": "noteTitle", "content": [{"type": "text", "text": title}]})
+
+    def _paragraph(text: str) -> dict:
+        # Empty text nodes are invalid in ProseMirror — emit a bare paragraph.
+        if not text:
+            return {"type": "paragraph"}
+        return {"type": "paragraph", "content": [{"type": "text", "text": text}]}
+
+    def _list_item(text: str) -> dict:
+        return {"type": "listItem", "content": [_paragraph(text)]}
+
+    lines = (content or "").split("\n")
+    i = 0
+    while i < len(lines):
+        stripped = lines[i].strip()
+
+        if stripped[:2] in ("- ", "* "):
+            items = []
+            while i < len(lines) and lines[i].strip()[:2] in ("- ", "* "):
+                items.append(_list_item(lines[i].strip()[2:].strip()))
+                i += 1
+            nodes.append({"type": "bulletList", "content": items})
+            continue
+
+        if _ORDERED_ITEM_RE.match(stripped):
+            items = []
+            while i < len(lines) and (m := _ORDERED_ITEM_RE.match(lines[i].strip())):
+                items.append(_list_item(m.group(1).strip()))
+                i += 1
+            nodes.append({"type": "orderedList", "content": items})
+            continue
+
+        nodes.append(_paragraph(lines[i]))
+        i += 1
+
+    return json.dumps({"type": "doc", "content": nodes}, ensure_ascii=False)
+
+
 def normalize_linkedin_url(url: str) -> str:
     """Normalize LinkedIn URL for comparison.
 

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/tests/test_client.py

@@ -1,5 +1,6 @@
 """Tests for Apollo client methods."""
 
+import json
 import os
 from datetime import UTC, datetime
 from unittest.mock import AsyncMock, MagicMock, patch
@@ -1109,18 +1110,23 @@ async def test_search_people(client: ApolloClient):
 
 
 async def test_create_note(client: ApolloClient):
-    """Test POST /notes."""
-    client._client.request.return_value = _make_response({"note": {"id": "n1", "content": "Hello"}})
+    """create_note posts ProseMirror JSON in `content` (not plaintext in `note`)."""
+    client._client.request.return_value = _make_response({"note": {"id": "n1"}})
 
-    result = await client.create_note("Hello")
+    result = await client.create_note("Hello", title="Greeting")
 
-    assert result == {"note": {"id": "n1", "content": "Hello"}}
+    assert result == {"note": {"id": "n1"}}
 
     call_args = client._client.request.call_args
     assert call_args[0] == ("POST", "/notes")
     payload = call_args[1]["json"]
-    assert payload["note"] == "Hello"
+    assert "note" not in payload  # old (ignored) field must be gone
     assert "contact_ids" not in payload
+    doc = json.loads(payload["content"])
+    assert doc["type"] == "doc"
+    assert doc["content"][0]["type"] == "noteTitle"
+    assert doc["content"][0]["content"][0]["text"] == "Greeting"
+    assert doc["content"][1]["content"][0]["text"] == "Hello"
 
 
 async def test_create_note_with_associations(client: ApolloClient):
@@ -1135,12 +1141,21 @@ async def test_create_note_with_associations(client: ApolloClient):
     )
 
     payload = client._client.request.call_args[1]["json"]
-    assert payload["note"] == "Meeting notes"
+    assert "Meeting notes" in payload["content"]  # body serialised into ProseMirror
     assert payload["contact_ids"] == ["c1", "c2"]
     assert payload["account_ids"] == ["a1"]
     assert payload["opportunity_ids"] == ["o1"]
 
 
+async def test_delete_note(client: ApolloClient):
+    """delete_note issues DELETE /notes/{id}."""
+    client._client.request.return_value = _make_response({})
+
+    await client.delete_note("n1")
+
+    client._client.request.assert_called_once_with("DELETE", "/notes/n1")
+
+
 async def test_get_api_usage(client: ApolloClient):
     """Test POST /usage_stats/api_usage_stats."""
     usage_data = {

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/tests/test_utils.py

@@ -2,7 +2,11 @@
 
 import json
 
-from qodev_apollo_api.utils import normalize_linkedin_url, prosemirror_to_markdown
+from qodev_apollo_api.utils import (
+    markdown_to_prosemirror,
+    normalize_linkedin_url,
+    prosemirror_to_markdown,
+)
 
 
 def test_prosemirror_to_markdown_simple():
@@ -111,3 +115,60 @@ def test_normalize_linkedin_url_empty():
     """Test normalization of empty URL."""
     assert normalize_linkedin_url("") == ""
     assert normalize_linkedin_url(None) == ""
+
+
+def test_markdown_to_prosemirror_simple():
+    """Title + body become a noteTitle node and a paragraph node."""
+    doc = json.loads(markdown_to_prosemirror("Hello world", title="My Title"))
+    assert doc["type"] == "doc"
+    assert doc["content"][0] == {
+        "type": "noteTitle",
+        "content": [{"type": "text", "text": "My Title"}],
+    }
+    assert doc["content"][1] == {
+        "type": "paragraph",
+        "content": [{"type": "text", "text": "Hello world"}],
+    }
+
+
+def test_markdown_to_prosemirror_blank_line_is_empty_paragraph():
+    """Blank lines become bare paragraphs (empty text nodes are invalid)."""
+    doc = json.loads(markdown_to_prosemirror("a\n\nb"))
+    assert doc["content"] == [
+        {"type": "paragraph", "content": [{"type": "text", "text": "a"}]},
+        {"type": "paragraph"},
+        {"type": "paragraph", "content": [{"type": "text", "text": "b"}]},
+    ]
+
+
+def test_markdown_to_prosemirror_no_title():
+    """Without a title there is no noteTitle node."""
+    doc = json.loads(markdown_to_prosemirror("body only"))
+    assert all(n["type"] != "noteTitle" for n in doc["content"])
+
+
+def test_markdown_to_prosemirror_lists():
+    """Bullet and ordered list lines become bulletList / orderedList nodes."""
+    doc = json.loads(markdown_to_prosemirror("- one\n- two\n1. first\n2. second"))
+    types = [n["type"] for n in doc["content"]]
+    assert types == ["bulletList", "orderedList"]
+    assert len(doc["content"][0]["content"]) == 2  # two bullet items
+    assert doc["content"][0]["content"][0]["content"][0]["content"][0]["text"] == "one"
+    assert doc["content"][1]["content"][1]["content"][0]["content"][0]["text"] == "second"
+
+
+def test_markdown_prosemirror_roundtrip():
+    """markdown_to_prosemirror output is readable back by prosemirror_to_markdown."""
+    pm = markdown_to_prosemirror("First para\n\nSecond para", title="Round Trip")
+    title, markdown = prosemirror_to_markdown(pm)
+    assert title == "Round Trip"
+    assert markdown == "First para\n\nSecond para"
+
+
+def test_markdown_to_prosemirror_empty():
+    """Empty content yields a valid empty doc."""
+    doc = json.loads(markdown_to_prosemirror(""))
+    assert doc["type"] == "doc"
+    # No invalid empty text nodes anywhere.
+    for node in doc["content"]:
+        assert node.get("content") != [{"type": "text", "text": ""}]

{qodev_apollo_api-0.1.3 → qodev_apollo_api-0.2.0}/uv.lock

@@ -407,7 +407,7 @@ wheels = [
 
 [[package]]
 name = "qodev-apollo-api"
-version = "0.1.1"
+version = "0.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },