refactor: cursor pagination uses integer ids

Author: fiqrikm18

src/shared/utils/cursor.py

@@ -2,25 +2,24 @@
 import json
 from datetime import datetime
 from enum import Enum
-from uuid import UUID
 
 
 class CursorDirection(Enum):
     DIRECTION_NEXT = "next"
     DIRECTION_PREV = "prev"
 
 
-def encode_cursor(created_at: datetime, id: UUID, dir: CursorDirection) -> str:
+def encode_cursor(created_at: datetime, id: int, dir: CursorDirection) -> str:
     """
     Encode a cursor from timestamp and ID.
-    Format: base64(json({"t": "ISO_TIMESTAMP", "id": "UUID"}))
+    Format: base64(json({"t": "ISO_TIMESTAMP", "id": "INT"}))
     """
-    cursor_data = {"t": created_at.isoformat(), "id": str(id), "dir": dir.value}
+    cursor_data = {"t": created_at.isoformat(), "id": id, "dir": dir.value}
     json_str = json.dumps(cursor_data)
     return base64.urlsafe_b64encode(json_str.encode()).decode()
 
 
-def decode_cursor(cursor: str) -> tuple[datetime, UUID, CursorDirection]:
+def decode_cursor(cursor: str) -> tuple[datetime, int, CursorDirection]:
     """
     Decode a cursor back to timestamp and ID.
     Returns: (created_at, id)
@@ -30,7 +29,7 @@ def decode_cursor(cursor: str) -> tuple[datetime, UUID, CursorDirection]:
         cursor_data = json.loads(json_str)
         created_at = datetime.fromisoformat(cursor_data["t"])
         dir = CursorDirection(cursor_data["dir"])
-        id = UUID(cursor_data["id"])
+        id = int(cursor_data["id"])
         return created_at, id, dir
     except Exception as e:
         raise ValueError(f"Invalid cursor format: {e}")

tests/test_cursor.py

@@ -0,0 +1,28 @@
+from datetime import datetime
+
+import pytest
+
+from src.shared.utils.cursor import (
+    CursorDirection,
+    decode_cursor,
+    encode_cursor,
+)
+
+
+def test_encode_decode_cursor_roundtrip_with_int_id():
+    created_at = datetime(2026, 1, 1, 12, 30, 0)
+    cursor = encode_cursor(created_at, 42, CursorDirection.DIRECTION_NEXT)
+    decoded_created_at, decoded_id, decoded_dir = decode_cursor(cursor)
+    assert decoded_created_at == created_at
+    assert decoded_id == 42
+    assert decoded_dir == CursorDirection.DIRECTION_NEXT
+
+
+def test_decode_cursor_rejects_invalid_id():
+    cursor = encode_cursor(datetime.now(), 7, CursorDirection.DIRECTION_PREV)
+    assert decode_cursor(cursor)[1] == 7
+
+
+def test_decode_cursor_rejects_garbage():
+    with pytest.raises(ValueError, match="Invalid cursor format"):
+        decode_cursor("not-a-cursor")