mbuzz 0.7.0__py3-none-any.whl → 0.7.3__py3-none-any.whl

mbuzz/__init__.py

@@ -9,7 +9,7 @@ from .client.track import track, TrackResult
 from .client.identify import identify
 from .client.conversion import conversion, ConversionResult
 
-__version__ = "0.7.0"
+__version__ = "0.7.3"
 
 
 def init(

mbuzz/api.py

@@ -10,7 +10,7 @@ from .config import config
 
 logger = logging.getLogger("mbuzz")
 
-VERSION = "0.1.0"
+VERSION = "0.7.3"
 
 
 def post(path: str, payload: Dict[str, Any]) -> bool:

mbuzz/middleware/flask.py

@@ -1,14 +1,46 @@
 """Flask middleware for mbuzz tracking."""
 # NOTE: Session cookie removed in 0.7.0 - server handles session resolution
 
+import threading
+import uuid
+from datetime import datetime, timezone
+from typing import Optional
+
 from flask import Flask, request, g, Response
 
+from ..api import post
 from ..config import config
 from ..context import RequestContext, set_context, clear_context
 from ..cookies import VISITOR_COOKIE, VISITOR_MAX_AGE
+from ..utils.fingerprint import device_fingerprint
 from ..utils.identifier import generate_id
 
 
+def should_create_session() -> bool:
+    """Determine whether this request is a real page navigation.
+
+    Primary signal: Sec-Fetch-* headers (modern browsers, unforgeable).
+    Fallback: blacklist known sub-request framework headers (old browsers/bots).
+    """
+    mode = request.headers.get("Sec-Fetch-Mode")
+    dest = request.headers.get("Sec-Fetch-Dest")
+
+    if mode:
+        return (
+            mode == "navigate"
+            and dest == "document"
+            and not request.headers.get("Sec-Purpose")
+        )
+
+    # Fallback for old browsers / bots: blacklist known sub-requests
+    return (
+        not request.headers.get("Turbo-Frame")
+        and not request.headers.get("HX-Request")
+        and not request.headers.get("X-Up-Version")
+        and request.headers.get("X-Requested-With") != "XMLHttpRequest"
+    )
+
+
 def init_app(app: Flask) -> None:
     """Initialize mbuzz tracking for Flask app."""
 
@@ -24,6 +56,11 @@ def init_app(app: Flask) -> None:
         _set_request_context(visitor_id, ip, user_agent)
         _store_in_g(visitor_id)
 
+        if should_create_session():
+            _create_session_async(
+                visitor_id, request.url, request.referrer, ip, user_agent
+            )
+
     @app.after_request
     def after_request(response: Response) -> Response:
         if not hasattr(g, "mbuzz_visitor_id"):
@@ -83,6 +120,34 @@ def _store_in_g(visitor_id: str) -> None:
     g.mbuzz_is_new_visitor = VISITOR_COOKIE not in request.cookies
 
 
+def _create_session_async(
+    visitor_id: str,
+    url: str,
+    referrer: Optional[str],
+    ip: str,
+    user_agent: str,
+) -> None:
+    """Fire-and-forget session creation via background thread.
+
+    All data is captured before the thread starts — no request-object
+    access inside the thread (it would be invalid after the response).
+    """
+    payload = {
+        "session": {
+            "visitor_id": visitor_id,
+            "session_id": str(uuid.uuid4()),
+            "url": url,
+            "referrer": referrer,
+            "device_fingerprint": device_fingerprint(ip, user_agent),
+            "started_at": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        }
+    }
+
+    threading.Thread(
+        target=post, args=("/sessions", payload), daemon=True
+    ).start()
+
+
 def _set_cookies(response: Response) -> None:
     """Set visitor cookie on response."""
     secure = request.is_secure

mbuzz/utils/__init__.py

@@ -1,5 +1,6 @@
 """Utility functions for mbuzz SDK."""
 
 from .identifier import generate_id
+from .fingerprint import device_fingerprint
 
-__all__ = ["generate_id"]
+__all__ = ["generate_id", "device_fingerprint"]

mbuzz/utils/fingerprint.py

@@ -0,0 +1,12 @@
+"""Device fingerprint generation — matches server-side SHA256(ip|user_agent)[0:32]."""
+
+import hashlib
+
+
+def device_fingerprint(ip: str, user_agent: str) -> str:
+    """Compute a device fingerprint from IP and User-Agent.
+
+    Produces a 32-char hex string identical to the server-side computation
+    and the Ruby/Node SDKs.
+    """
+    return hashlib.sha256(f"{ip}|{user_agent}".encode()).hexdigest()[:32]

{mbuzz-0.7.0.dist-info → mbuzz-0.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mbuzz
-Version: 0.7.0
+Version: 0.7.3
 Summary: Multi-touch attribution SDK for Python
 Project-URL: Homepage, https://mbuzz.co
 Project-URL: Documentation, https://mbuzz.co/docs/getting-started

{mbuzz-0.7.0.dist-info → mbuzz-0.7.3.dist-info}/RECORD

@@ -1,5 +1,5 @@
-mbuzz/__init__.py,sha256=tIBoql6_TTtWXErayliL98YGa-EIFMq9rE-X2vgfVHk,2150
-mbuzz/api.py,sha256=BITkW6TQEGmPA0OmYFFC611X6JWiY6C1dY-_wsKDT2U,2107
+mbuzz/__init__.py,sha256=OQDjNSQTB6Yfc66NRpZPN8cWjWcVJopDysoB8tb3cbU,2150
+mbuzz/api.py,sha256=bOLjQRgv9PbfGvNxYMtdyiBQvlLFHsHcVgZ8_lEWEHU,2107
 mbuzz/config.py,sha256=u6v1WnMTgiqyDXHszlXw5hyNENgYRy7-z-IWKuYp0-o,2399
 mbuzz/context.py,sha256=tcvtKaAbHzH8dHGkKviNgXF31IKgintqo0lhb6uU4dU,1308
 mbuzz/cookies.py,sha256=pDcvSq0ulzKrFLf5UK408s9Lv2pVzLANVaF_-P7iG3c,194
@@ -8,9 +8,10 @@ mbuzz/client/conversion.py,sha256=mUkxU8FgbmvvXnliTskawnDzbwn1SxutZ5E4rFkNt5o,31
 mbuzz/client/identify.py,sha256=duyd-OWdBo4w7-7Nv5X-GeG2IpMI-1G_kYwnDXup0FE,859
 mbuzz/client/track.py,sha256=NReHqXWx24cPhIlc7UBQjj9QVdnXfrJsFzS5UmOUMtA,4354
 mbuzz/middleware/__init__.py,sha256=gIjwTArToaQNB2NC0iPE_RcmzuHjH7-7jjd7_Dyq4Pw,37
-mbuzz/middleware/flask.py,sha256=ccotvyzS4PB5-cfaplpwGJJOQzR90hy5iz6sTrhwXXc,2687
-mbuzz/utils/__init__.py,sha256=-ejtRN6CTkV3D8uujDtAPDoMT0DAG-ULpWOF-Ae55dY,103
+mbuzz/middleware/flask.py,sha256=gkvwtgfLasTKq64lUvK_9I2PeOR9oBRbrWpQZbqnaAk,4656
+mbuzz/utils/__init__.py,sha256=tq5wgr4Cy-PFl2tvpN5VYHzPd3M-e5qcxnv-McoTopI,169
+mbuzz/utils/fingerprint.py,sha256=T2plrP9n70LkoCvGbBCh7nxZRfdQpCd_CdZBseBfzCg,410
 mbuzz/utils/identifier.py,sha256=iAYmd4he2RTtTNlmszb6KQmD9McZbSMgZZdkMuoGOCE,174
-mbuzz-0.7.0.dist-info/METADATA,sha256=phnoKfsZaw8nA4u3UTE9uF6n9TkXxzGSAOBGKi35J_U,1849
-mbuzz-0.7.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-mbuzz-0.7.0.dist-info/RECORD,,
+mbuzz-0.7.3.dist-info/METADATA,sha256=Q0dHPns1Lk73_ziPwsknxzQMIkJFAYnqRo5drKkCD_0,1849
+mbuzz-0.7.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mbuzz-0.7.3.dist-info/RECORD,,