trodo-python 2.6.0__py3-none-any.whl → 2.7.0__py3-none-any.whl

trodo/__init__.py

@@ -40,7 +40,7 @@ Downstream microservice (join the caller's run instead of making a new one):
 
 from __future__ import annotations
 
-__version__ = "2.4.0"
+__version__ = "2.7.0"
 
 from typing import Any, Callable, Dict, List, Optional, Union
 

trodo/session/server_session.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import time
-import uuid
 from datetime import datetime, timezone
 from typing import Any, Dict, Optional
 
@@ -14,13 +13,24 @@ def now_iso() -> str:
     return datetime.now(timezone.utc).isoformat()
 
 
+def server_session_id(distinct_id: str) -> str:
+    """Deterministic, "backend consistent" session id for a backend user.
+
+    Backend SDKs are stateless: the same distinct_id must resolve to the SAME
+    session across processes and restarts. Using ``server:{distinct_id}`` instead
+    of a per-process ``uuid4()`` produces exactly one session row per backend
+    user (no per-process bloat) and is idempotent server-side.
+    """
+    return f"server:{distinct_id}"
+
+
 def create_server_session(
     site_id: str,
     distinct_id: str,
     session_id: Optional[str] = None,
 ) -> ServerSession:
     return ServerSession(
-        session_id=session_id or str(uuid.uuid4()),
+        session_id=session_id or server_session_id(distinct_id),
         site_id=site_id,
         distinct_id=distinct_id,
         start_time=now_iso(),
@@ -30,6 +40,15 @@ def create_server_session(
 
 
 def build_session_payload(session: ServerSession) -> Dict[str, Any]:
+    """Minimal server-session payload.
+
+    Backend SDKs cannot know browser-only signals (geo, device, browser, UTM,
+    referrer, wallet), so those fields are OMITTED rather than sent as ~30
+    explicit nulls — ingestion defaults missing fields to null. This saves
+    ingestion bandwidth and is more accurate. Only the markers ingestion keys
+    on are retained: ``is_server_session`` (drives identity-level browser-field
+    guards) and ``device_type='server'`` (server-origin fallback detector).
+    """
     return {
         "session_id": session.session_id,
         "site_id": session.site_id,
@@ -37,39 +56,9 @@ def build_session_payload(session: ServerSession) -> Dict[str, Any]:
         "distinct_id": session.distinct_id,
         "team_id": None,
         "start_time": session.start_time,
-        "end_time": None,
         "last_activity": int(session.last_activity * 1000),
-        "duration": 0,
-        "pages_viewed": 0,
         "is_bounce": False,
-        "previous_session_id": None,
-        "time_since_last_session": None,
-        "entry_page": None,
-        "exit_page": None,
         "referrer": "server",
-        "ip_address": None,
-        "city": None,
-        "region": None,
-        "country": None,
-        "browser_name": None,
-        "browser_version": None,
         "device_type": "server",
-        "os": None,
-        "resolution": None,
-        "user_agent": None,
-        "language": None,
-        "wallet_address": None,
-        "wallet_type": None,
-        "chain_name": None,
-        "is_web3_user": False,
-        "wallet_connected": False,
-        "utm_source": None,
-        "utm_medium": None,
-        "utm_campaign": None,
-        "utm_term": None,
-        "utm_content": None,
-        "utm_id": None,
-        "visited_pages": [],
-        "active_time_ms": 0,
         "is_server_session": True,
     }

{trodo_python-2.6.0.dist-info → trodo_python-2.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trodo-python
-Version: 2.6.0
+Version: 2.7.0
 Summary: Trodo Analytics SDK for Python — server-side event tracking
 License: ISC
 Keywords: analytics,tracking,trodo,server-side

{trodo_python-2.6.0.dist-info → trodo_python-2.7.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-trodo/__init__.py,sha256=bO9bAzJhM6-QGDSIIxyiy0UxjYUcQsrhxhb6r6Rvu-8,16678
+trodo/__init__.py,sha256=NapUF153zVbbqH45gud9g9M_UyQgxuqw_yAYERTGJlw,16678
 trodo/client.py,sha256=8DsKoLh_eaNxj93qkHynfeee-QsdomB_kXfUQjGnWDk,18607
 trodo/types.py,sha256=eySgUvCXROG2TxtxgiU0MNr5iH0DEcduK8bmYtTKG44,3138
 trodo/user_context.py,sha256=9la6azzwEanVmdP4ps_xMoufbeWVeIGU-M8ychmgajg,7859
@@ -23,9 +23,9 @@ trodo/queue/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 trodo/queue/batch_flusher.py,sha256=4Lg6T3Urwi9U0Q4FpFGPmjDYKg4ZliCTR-ND8BJvWaY,1298
 trodo/queue/event_queue.py,sha256=EVFZrhlq_kwC3jJ2GK0wMhHISf9UzLCZNDnT_aZ2I2A,872
 trodo/session/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-trodo/session/server_session.py,sha256=4bQZc_Zxktmu8RVoyh0qI7tvr8AKsHI5xkGf3jEpWVE,2005
+trodo/session/server_session.py,sha256=McsudEiq33XDq3nqxgzBcUvIjQxCMscwEuAPnYXrTjs,2136
 trodo/session/session_manager.py,sha256=JrgH1VeicmtlxPR4dXEuJbxhi23OelkgwW3-9Slv80o,2525
-trodo_python-2.6.0.dist-info/METADATA,sha256=JMJrzgxO8YnCH5FGXslwUr72IPrdFo-FO9wgxfPS76E,17882
-trodo_python-2.6.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-trodo_python-2.6.0.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
-trodo_python-2.6.0.dist-info/RECORD,,
+trodo_python-2.7.0.dist-info/METADATA,sha256=K19DXcIe8jCHbOCEWXkyy0mxGhjCz_fH_VIdm0vuM9E,17882
+trodo_python-2.7.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+trodo_python-2.7.0.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
+trodo_python-2.7.0.dist-info/RECORD,,