session-python 1.0.0__py3-none-any.whl

session_python/polling.py

@@ -0,0 +1,222 @@
+import time
+import binascii
+import json
+from typing import List, Dict, Any, Optional
+from .client import Session
+from .crypto import (
+    remove_message_padding,
+    decrypt_with_session_protocol,
+    remove_prefix_if_needed
+)
+from .protobuf.signalservice_pb2 import WebSocketMessage, Envelope, Content
+
+def namespace_priority(namespace: int) -> int:
+    if namespace == 0:
+        return 10
+    return 1
+
+def max_size_map(namespaces: List[int]) -> List[Dict[str, Any]]:
+    priorities = {}
+    for ns in namespaces:
+        p = namespace_priority(ns)
+        if p not in priorities:
+            priorities[p] = []
+        priorities[p].append(ns)
+        
+    sorted_priorities = sorted(priorities.keys(), reverse=True)
+    if not sorted_priorities:
+        return []
+    lowest_priority = sorted_priorities[-1]
+    
+    size_map = []
+    last_split = 1
+    for p in sorted_priorities:
+        padding = 0 if p == lowest_priority else 1
+        splits = padding + len(priorities[p])
+        last_split *= splits
+        for ns in priorities[p]:
+            size_map.append({"namespace": ns, "maxSize": -last_split})
+            
+    return size_map
+
+def get_snode_signature_params(keys, method: str, namespace: int) -> dict:
+    timestamp = int(time.time() * 1000)
+    if namespace == 0:
+        msg = f"{method}{timestamp}"
+    else:
+        msg = f"{method}{namespace}{timestamp}"
+        
+    signature = keys.signing_key.sign(msg.encode('utf-8')).signature
+    signature_b64 = binascii.b2a_base64(signature, newline=False).decode('utf-8')
+    pubkey_ed25519 = binascii.hexlify(keys.ed25519.public_key).decode('utf-8')
+    
+    return {
+        "timestamp": timestamp,
+        "signature": signature_b64,
+        "pubkey_ed25519": pubkey_ed25519
+    }
+
+class Poller:
+    def __init__(self, session: Session, namespaces: Optional[List[int]] = None):
+        self.session = session
+        self.namespaces = namespaces if namespaces is not None else [0, 2, 3, 4, 5]
+        
+    def poll(self) -> List[Dict[str, Any]]:
+        if not self.session.keys or not self.session.session_id:
+            raise ValueError("Session client not initialized.")
+            
+        our_swarm = self.session.get_our_swarm()
+        snode = {
+            "public_ip": our_swarm["ip"],
+            "storage_port": int(our_swarm["port"])
+        }
+        
+        size_mappings = max_size_map(self.namespaces)
+        
+        # Prepare retrieve subrequests
+        subrequests = []
+        for ns in self.namespaces:
+            last_hash = self.session.last_hashes.get(ns, "")
+            
+            # Signature for authenticate retrieve
+            sig = get_snode_signature_params(self.session.keys, "retrieve", ns)
+            
+            # Find maxSize
+            max_size = -1
+            for mapping in size_mappings:
+                if mapping["namespace"] == ns:
+                    max_size = mapping["maxSize"]
+                    break
+                    
+            subrequests.append({
+                "method": "retrieve",
+                "params": {
+                    "pubkey": self.session.session_id,
+                    "lastHash": last_hash,
+                    "namespace": ns,
+                    "maxSize": max_size,
+                    "timestamp": sig["timestamp"],
+                    "signature": sig["signature"],
+                    "pubkey_ed25519": sig["pubkey_ed25519"]
+                }
+            })
+            
+        results = self.session.network.snode_batch_request(
+            snode=snode,
+            requests_list=subrequests
+        )
+        
+        decrypted_messages = []
+        
+        for idx, result in enumerate(results):
+            ns = self.namespaces[idx]
+            if result.get("code") != 200:
+                continue
+                
+            body_val = result.get("body", "{}")
+            if isinstance(body_val, str):
+                try:
+                    body_data = json.loads(body_val)
+                except Exception:
+                    body_data = {}
+            else:
+                body_data = body_val
+                
+            if isinstance(body_data, dict):
+                messages_list = body_data.get("messages", [])
+            else:
+                messages_list = []
+                
+            if not messages_list:
+                continue
+                
+            for m in messages_list:
+                msg_hash = m.get("hash")
+                data_b64 = m.get("data")
+                if not data_b64:
+                    continue
+                    
+                try:
+                    # Extract envelope
+                    data_bytes = binascii.a2b_base64(data_b64)
+                    ws_msg = WebSocketMessage.FromString(data_bytes)
+                    
+                    if ws_msg.type != WebSocketMessage.Type.REQUEST or not ws_msg.request.body:
+                        continue
+                        
+                    envelope_bytes = ws_msg.request.body
+                    envelope = Envelope.FromString(envelope_bytes)
+                    
+                    if not envelope.content:
+                        continue
+                        
+                    # Decrypt Envelope
+                    plaintext_padded, sender_id = decrypt_with_session_protocol(
+                        self.session.keys,
+                        envelope.content
+                    )
+                    
+                    # Unpad plaintext
+                    plaintext = remove_message_padding(plaintext_padded)
+                    
+                    # Parse Content protobuf
+                    content = Content.FromString(plaintext)
+                    
+                    # Map to friendly dict
+                    mapped_msg = {
+                        "hash": msg_hash,
+                        "namespace": ns,
+                        "timestamp": envelope.timestamp,
+                        "from": sender_id,
+                        "type": "unknown",
+                        "body": None,
+                        "attachments": [],
+                        "syncTarget": None
+                    }
+                    
+                    if content.HasField("dataMessage"):
+                        mapped_msg["type"] = "data"
+                        mapped_msg["body"] = content.dataMessage.body
+                        if content.dataMessage.syncTarget:
+                            mapped_msg["syncTarget"] = content.dataMessage.syncTarget
+                            
+                        # Parse attachments
+                        for att in content.dataMessage.attachments:
+                            mapped_msg["attachments"].append({
+                                "id": att.id,
+                                "url": att.url,
+                                "key": att.key,
+                                "digest": att.digest,
+                                "name": att.fileName,
+                                "contentType": att.contentType,
+                                "size": att.size
+                            })
+                            
+                    elif content.HasField("typingMessage"):
+                        mapped_msg["type"] = "typing"
+                        mapped_msg["isTyping"] = (content.typingMessage.action == 0) # STARTED = 0
+                        
+                    elif content.HasField("unsendMessage"):
+                        mapped_msg["type"] = "unsend"
+                        mapped_msg["targetTimestamp"] = content.unsendMessage.timestamp
+                        mapped_msg["author"] = content.unsendMessage.author
+                        
+                    elif content.HasField("receiptMessage"):
+                        mapped_msg["type"] = "receipt"
+                        mapped_msg["targetTimestamps"] = list(content.receiptMessage.timestamp)
+                        
+                    elif content.HasField("messageRequestResponse"):
+                        mapped_msg["type"] = "request_response"
+                        mapped_msg["isApproved"] = content.messageRequestResponse.isApproved
+                        
+                    decrypted_messages.append(mapped_msg)
+                    
+                except Exception as e:
+                    # Decryption or parsing error for a single message shouldn't crash the loop
+                    continue
+            
+            # Update lastHash for this namespace to the hash of the last message
+            if messages_list:
+                self.session.last_hashes[ns] = messages_list[-1]["hash"]
+                
+        return decrypted_messages

session_python/protobuf/__init__.py

@@ -0,0 +1 @@
+# Protobuf package

session_python/protobuf/signalservice_pb2.py

@@ -0,0 +1,112 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: signalservice.proto
+# Protobuf Python Version: 7.35.0
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    7,
+    35,
+    0,
+    '',
+    'signalservice.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x13signalservice.proto\x12\rsignalservice\"\xa1\x01\n\x08\x45nvelope\x12*\n\x04type\x18\x01 \x02(\x0e\x32\x1c.signalservice.Envelope.Type\x12\x0e\n\x06source\x18\x02 \x01(\t\x12\x11\n\ttimestamp\x18\x05 \x02(\x04\x12\x0f\n\x07\x63ontent\x18\x08 \x01(\x0c\"5\n\x04Type\x12\x13\n\x0fSESSION_MESSAGE\x10\x06\x12\x18\n\x14\x43LOSED_GROUP_MESSAGE\x10\x07\"{\n\rTypingMessage\x12\x11\n\ttimestamp\x18\x01 \x02(\x04\x12\x33\n\x06\x61\x63tion\x18\x02 \x02(\x0e\x32#.signalservice.TypingMessage.Action\"\"\n\x06\x41\x63tion\x12\x0b\n\x07STARTED\x10\x00\x12\x0b\n\x07STOPPED\x10\x01\"+\n\x06Unsend\x12\x11\n\ttimestamp\x18\x01 \x02(\x04\x12\x0e\n\x06\x61uthor\x18\x02 \x02(\t\"y\n\x16MessageRequestResponse\x12\x12\n\nisApproved\x18\x01 \x02(\x08\x12\x12\n\nprofileKey\x18\x02 \x01(\x0c\x12\x37\n\x07profile\x18\x03 \x01(\x0b\x32&.signalservice.DataMessage.LokiProfile\"\xbb\x01\n\x13SharedConfigMessage\x12\x35\n\x04kind\x18\x01 \x02(\x0e\x32\'.signalservice.SharedConfigMessage.Kind\x12\r\n\x05seqno\x18\x02 \x02(\x03\x12\x0c\n\x04\x64\x61ta\x18\x03 \x02(\x0c\"P\n\x04Kind\x12\x10\n\x0cUSER_PROFILE\x10\x01\x12\x0c\n\x08\x43ONTACTS\x10\x02\x12\x17\n\x13\x43ONVO_INFO_VOLATILE\x10\x03\x12\x0f\n\x0bUSER_GROUPS\x10\x04\"\xc4\x05\n\x07\x43ontent\x12/\n\x0b\x64\x61taMessage\x18\x01 \x01(\x0b\x32\x1a.signalservice.DataMessage\x12/\n\x0b\x63\x61llMessage\x18\x03 \x01(\x0b\x32\x1a.signalservice.CallMessage\x12\x35\n\x0ereceiptMessage\x18\x05 \x01(\x0b\x32\x1d.signalservice.ReceiptMessage\x12\x33\n\rtypingMessage\x18\x06 \x01(\x0b\x32\x1c.signalservice.TypingMessage\x12\x41\n\x14\x63onfigurationMessage\x18\x07 \x01(\x0b\x32#.signalservice.ConfigurationMessage\x12M\n\x1a\x64\x61taExtractionNotification\x18\x08 \x01(\x0b\x32).signalservice.DataExtractionNotification\x12,\n\runsendMessage\x18\t \x01(\x0b\x32\x15.signalservice.Unsend\x12\x45\n\x16messageRequestResponse\x18\n \x01(\x0b\x32%.signalservice.MessageRequestResponse\x12?\n\x13sharedConfigMessage\x18\x0b \x01(\x0b\x32\".signalservice.SharedConfigMessage\x12=\n\x0e\x65xpirationType\x18\x0c \x01(\x0e\x32%.signalservice.Content.ExpirationType\x12\x17\n\x0f\x65xpirationTimer\x18\r \x01(\r\"K\n\x0e\x45xpirationType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x15\n\x11\x44\x45LETE_AFTER_READ\x10\x01\x12\x15\n\x11\x44\x45LETE_AFTER_SEND\x10\x02\"0\n\x07KeyPair\x12\x11\n\tpublicKey\x18\x01 \x02(\x0c\x12\x12\n\nprivateKey\x18\x02 \x02(\x0c\"\x96\x01\n\x1a\x44\x61taExtractionNotification\x12<\n\x04type\x18\x01 \x02(\x0e\x32..signalservice.DataExtractionNotification.Type\x12\x11\n\ttimestamp\x18\x02 \x01(\x04\"\'\n\x04Type\x12\x0e\n\nSCREENSHOT\x10\x01\x12\x0f\n\x0bMEDIA_SAVED\x10\x02\"\x8f\x0e\n\x0b\x44\x61taMessage\x12\x0c\n\x04\x62ody\x18\x01 \x01(\t\x12\x35\n\x0b\x61ttachments\x18\x02 \x03(\x0b\x32 .signalservice.AttachmentPointer\x12*\n\x05group\x18\x03 \x01(\x0b\x32\x1b.signalservice.GroupContext\x12\r\n\x05\x66lags\x18\x04 \x01(\r\x12\x13\n\x0b\x65xpireTimer\x18\x05 \x01(\r\x12\x12\n\nprofileKey\x18\x06 \x01(\x0c\x12\x11\n\ttimestamp\x18\x07 \x01(\x04\x12/\n\x05quote\x18\x08 \x01(\x0b\x32 .signalservice.DataMessage.Quote\x12\x33\n\x07preview\x18\n \x03(\x0b\x32\".signalservice.DataMessage.Preview\x12\x35\n\x08reaction\x18\x0b \x01(\x0b\x32#.signalservice.DataMessage.Reaction\x12\x37\n\x07profile\x18\x65 \x01(\x0b\x32&.signalservice.DataMessage.LokiProfile\x12K\n\x13openGroupInvitation\x18\x66 \x01(\x0b\x32..signalservice.DataMessage.OpenGroupInvitation\x12W\n\x19\x63losedGroupControlMessage\x18h \x01(\x0b\x32\x34.signalservice.DataMessage.ClosedGroupControlMessage\x12\x12\n\nsyncTarget\x18i \x01(\t\x12&\n\x1e\x62locksCommunityMessageRequests\x18j \x01(\x08\x1a\x92\x01\n\x08Reaction\x12\n\n\x02id\x18\x01 \x02(\x04\x12\x0e\n\x06\x61uthor\x18\x02 \x02(\t\x12\r\n\x05\x65moji\x18\x03 \x01(\t\x12:\n\x06\x61\x63tion\x18\x04 \x02(\x0e\x32*.signalservice.DataMessage.Reaction.Action\"\x1f\n\x06\x41\x63tion\x12\t\n\x05REACT\x10\x00\x12\n\n\x06REMOVE\x10\x01\x1a\xe9\x01\n\x05Quote\x12\n\n\x02id\x18\x01 \x02(\x04\x12\x0e\n\x06\x61uthor\x18\x02 \x02(\t\x12\x0c\n\x04text\x18\x03 \x01(\t\x12\x46\n\x0b\x61ttachments\x18\x04 \x03(\x0b\x32\x31.signalservice.DataMessage.Quote.QuotedAttachment\x1an\n\x10QuotedAttachment\x12\x13\n\x0b\x63ontentType\x18\x01 \x01(\t\x12\x10\n\x08\x66ileName\x18\x02 \x01(\t\x12\x33\n\tthumbnail\x18\x03 \x01(\x0b\x32 .signalservice.AttachmentPointer\x1aV\n\x07Preview\x12\x0b\n\x03url\x18\x01 \x02(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12/\n\x05image\x18\x03 \x01(\x0b\x32 .signalservice.AttachmentPointer\x1a:\n\x0bLokiProfile\x12\x13\n\x0b\x64isplayName\x18\x01 \x01(\t\x12\x16\n\x0eprofilePicture\x18\x02 \x01(\t\x1a\x30\n\x13OpenGroupInvitation\x12\x0b\n\x03url\x18\x01 \x02(\t\x12\x0c\n\x04name\x18\x03 \x02(\t\x1a\x9e\x04\n\x19\x43losedGroupControlMessage\x12G\n\x04type\x18\x01 \x02(\x0e\x32\x39.signalservice.DataMessage.ClosedGroupControlMessage.Type\x12\x11\n\tpublicKey\x18\x02 \x01(\x0c\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x31\n\x11\x65ncryptionKeyPair\x18\x04 \x01(\x0b\x32\x16.signalservice.KeyPair\x12\x0f\n\x07members\x18\x05 \x03(\x0c\x12\x0e\n\x06\x61\x64mins\x18\x06 \x03(\x0c\x12U\n\x08wrappers\x18\x07 \x03(\x0b\x32\x43.signalservice.DataMessage.ClosedGroupControlMessage.KeyPairWrapper\x12\x17\n\x0f\x65xpirationTimer\x18\x08 \x01(\r\x1a=\n\x0eKeyPairWrapper\x12\x11\n\tpublicKey\x18\x01 \x02(\x0c\x12\x18\n\x10\x65ncryptedKeyPair\x18\x02 \x02(\x0c\"\x93\x01\n\x04Type\x12\x07\n\x03NEW\x10\x01\x12\x17\n\x13\x45NCRYPTION_KEY_PAIR\x10\x03\x12\x0f\n\x0bNAME_CHANGE\x10\x04\x12\x11\n\rMEMBERS_ADDED\x10\x05\x12\x13\n\x0fMEMBERS_REMOVED\x10\x06\x12\x0f\n\x0bMEMBER_LEFT\x10\x07\x12\x1f\n\x1b\x45NCRYPTION_KEY_PAIR_REQUEST\x10\x08\"$\n\x05\x46lags\x12\x1b\n\x17\x45XPIRATION_TIMER_UPDATE\x10\x02\"\xea\x01\n\x0b\x43\x61llMessage\x12-\n\x04type\x18\x01 \x02(\x0e\x32\x1f.signalservice.CallMessage.Type\x12\x0c\n\x04sdps\x18\x02 \x03(\t\x12\x17\n\x0fsdpMLineIndexes\x18\x03 \x03(\r\x12\x0f\n\x07sdpMids\x18\x04 \x03(\t\x12\x0c\n\x04uuid\x18\x05 \x02(\t\"f\n\x04Type\x12\r\n\tPRE_OFFER\x10\x06\x12\t\n\x05OFFER\x10\x01\x12\n\n\x06\x41NSWER\x10\x02\x12\x16\n\x12PROVISIONAL_ANSWER\x10\x03\x12\x12\n\x0eICE_CANDIDATES\x10\x04\x12\x0c\n\x08\x45ND_CALL\x10\x05\"\x8c\x04\n\x14\x43onfigurationMessage\x12\x45\n\x0c\x63losedGroups\x18\x01 \x03(\x0b\x32/.signalservice.ConfigurationMessage.ClosedGroup\x12\x12\n\nopenGroups\x18\x02 \x03(\t\x12\x13\n\x0b\x64isplayName\x18\x03 \x01(\t\x12\x16\n\x0eprofilePicture\x18\x04 \x01(\t\x12\x12\n\nprofileKey\x18\x05 \x01(\x0c\x12=\n\x08\x63ontacts\x18\x06 \x03(\x0b\x32+.signalservice.ConfigurationMessage.Contact\x1a\x82\x01\n\x0b\x43losedGroup\x12\x11\n\tpublicKey\x18\x01 \x01(\x0c\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x31\n\x11\x65ncryptionKeyPair\x18\x03 \x01(\x0b\x32\x16.signalservice.KeyPair\x12\x0f\n\x07members\x18\x04 \x03(\x0c\x12\x0e\n\x06\x61\x64mins\x18\x05 \x03(\x0c\x1a\x93\x01\n\x07\x43ontact\x12\x11\n\tpublicKey\x18\x01 \x02(\x0c\x12\x0c\n\x04name\x18\x02 \x02(\t\x12\x16\n\x0eprofilePicture\x18\x03 \x01(\t\x12\x12\n\nprofileKey\x18\x04 \x01(\x0c\x12\x12\n\nisApproved\x18\x05 \x01(\x08\x12\x11\n\tisBlocked\x18\x06 \x01(\x08\x12\x14\n\x0c\x64idApproveMe\x18\x07 \x01(\x08\"g\n\x0eReceiptMessage\x12\x30\n\x04type\x18\x01 \x02(\x0e\x32\".signalservice.ReceiptMessage.Type\x12\x11\n\ttimestamp\x18\x02 \x03(\x04\"\x10\n\x04Type\x12\x08\n\x04READ\x10\x01\"\xd9\x01\n\x11\x41ttachmentPointer\x12\n\n\x02id\x18\x01 \x02(\x06\x12\x13\n\x0b\x63ontentType\x18\x02 \x01(\t\x12\x0b\n\x03key\x18\x03 \x01(\x0c\x12\x0c\n\x04size\x18\x04 \x01(\r\x12\x0e\n\x06\x64igest\x18\x06 \x01(\x0c\x12\x10\n\x08\x66ileName\x18\x07 \x01(\t\x12\r\n\x05\x66lags\x18\x08 \x01(\r\x12\r\n\x05width\x18\t \x01(\r\x12\x0e\n\x06height\x18\n \x01(\r\x12\x0f\n\x07\x63\x61ption\x18\x0b \x01(\t\x12\x0b\n\x03url\x18\x65 \x01(\t\"\x1a\n\x05\x46lags\x12\x11\n\rVOICE_MESSAGE\x10\x01\"\xf5\x01\n\x0cGroupContext\x12\n\n\x02id\x18\x01 \x01(\x0c\x12.\n\x04type\x18\x02 \x01(\x0e\x32 .signalservice.GroupContext.Type\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x0f\n\x07members\x18\x04 \x03(\t\x12\x30\n\x06\x61vatar\x18\x05 \x01(\x0b\x32 .signalservice.AttachmentPointer\x12\x0e\n\x06\x61\x64mins\x18\x06 \x03(\t\"H\n\x04Type\x12\x0b\n\x07UNKNOWN\x10\x00\x12\n\n\x06UPDATE\x10\x01\x12\x0b\n\x07\x44\x45LIVER\x10\x02\x12\x08\n\x04QUIT\x10\x03\x12\x10\n\x0cREQUEST_INFO\x10\x04\"`\n\x17WebSocketRequestMessage\x12\x0c\n\x04verb\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\t\x12\x0c\n\x04\x62ody\x18\x03 \x01(\x0c\x12\x0f\n\x07headers\x18\x05 \x03(\t\x12\n\n\x02id\x18\x04 \x01(\x04\"\xaf\x01\n\x10WebSocketMessage\x12\x32\n\x04type\x18\x01 \x01(\x0e\x32$.signalservice.WebSocketMessage.Type\x12\x37\n\x07request\x18\x02 \x01(\x0b\x32&.signalservice.WebSocketRequestMessage\".\n\x04Type\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x0b\n\x07REQUEST\x10\x01\x12\x0c\n\x08RESPONSE\x10\x02')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'signalservice_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_ENVELOPE']._serialized_start=39
+  _globals['_ENVELOPE']._serialized_end=200
+  _globals['_ENVELOPE_TYPE']._serialized_start=147
+  _globals['_ENVELOPE_TYPE']._serialized_end=200
+  _globals['_TYPINGMESSAGE']._serialized_start=202
+  _globals['_TYPINGMESSAGE']._serialized_end=325
+  _globals['_TYPINGMESSAGE_ACTION']._serialized_start=291
+  _globals['_TYPINGMESSAGE_ACTION']._serialized_end=325
+  _globals['_UNSEND']._serialized_start=327
+  _globals['_UNSEND']._serialized_end=370
+  _globals['_MESSAGEREQUESTRESPONSE']._serialized_start=372
+  _globals['_MESSAGEREQUESTRESPONSE']._serialized_end=493
+  _globals['_SHAREDCONFIGMESSAGE']._serialized_start=496
+  _globals['_SHAREDCONFIGMESSAGE']._serialized_end=683
+  _globals['_SHAREDCONFIGMESSAGE_KIND']._serialized_start=603
+  _globals['_SHAREDCONFIGMESSAGE_KIND']._serialized_end=683
+  _globals['_CONTENT']._serialized_start=686
+  _globals['_CONTENT']._serialized_end=1394
+  _globals['_CONTENT_EXPIRATIONTYPE']._serialized_start=1319
+  _globals['_CONTENT_EXPIRATIONTYPE']._serialized_end=1394
+  _globals['_KEYPAIR']._serialized_start=1396
+  _globals['_KEYPAIR']._serialized_end=1444
+  _globals['_DATAEXTRACTIONNOTIFICATION']._serialized_start=1447
+  _globals['_DATAEXTRACTIONNOTIFICATION']._serialized_end=1597
+  _globals['_DATAEXTRACTIONNOTIFICATION_TYPE']._serialized_start=1558
+  _globals['_DATAEXTRACTIONNOTIFICATION_TYPE']._serialized_end=1597
+  _globals['_DATAMESSAGE']._serialized_start=1600
+  _globals['_DATAMESSAGE']._serialized_end=3407
+  _globals['_DATAMESSAGE_REACTION']._serialized_start=2244
+  _globals['_DATAMESSAGE_REACTION']._serialized_end=2390
+  _globals['_DATAMESSAGE_REACTION_ACTION']._serialized_start=2359
+  _globals['_DATAMESSAGE_REACTION_ACTION']._serialized_end=2390
+  _globals['_DATAMESSAGE_QUOTE']._serialized_start=2393
+  _globals['_DATAMESSAGE_QUOTE']._serialized_end=2626
+  _globals['_DATAMESSAGE_QUOTE_QUOTEDATTACHMENT']._serialized_start=2516
+  _globals['_DATAMESSAGE_QUOTE_QUOTEDATTACHMENT']._serialized_end=2626
+  _globals['_DATAMESSAGE_PREVIEW']._serialized_start=2628
+  _globals['_DATAMESSAGE_PREVIEW']._serialized_end=2714
+  _globals['_DATAMESSAGE_LOKIPROFILE']._serialized_start=2716
+  _globals['_DATAMESSAGE_LOKIPROFILE']._serialized_end=2774
+  _globals['_DATAMESSAGE_OPENGROUPINVITATION']._serialized_start=2776
+  _globals['_DATAMESSAGE_OPENGROUPINVITATION']._serialized_end=2824
+  _globals['_DATAMESSAGE_CLOSEDGROUPCONTROLMESSAGE']._serialized_start=2827
+  _globals['_DATAMESSAGE_CLOSEDGROUPCONTROLMESSAGE']._serialized_end=3369
+  _globals['_DATAMESSAGE_CLOSEDGROUPCONTROLMESSAGE_KEYPAIRWRAPPER']._serialized_start=3158
+  _globals['_DATAMESSAGE_CLOSEDGROUPCONTROLMESSAGE_KEYPAIRWRAPPER']._serialized_end=3219
+  _globals['_DATAMESSAGE_CLOSEDGROUPCONTROLMESSAGE_TYPE']._serialized_start=3222
+  _globals['_DATAMESSAGE_CLOSEDGROUPCONTROLMESSAGE_TYPE']._serialized_end=3369
+  _globals['_DATAMESSAGE_FLAGS']._serialized_start=3371
+  _globals['_DATAMESSAGE_FLAGS']._serialized_end=3407
+  _globals['_CALLMESSAGE']._serialized_start=3410
+  _globals['_CALLMESSAGE']._serialized_end=3644
+  _globals['_CALLMESSAGE_TYPE']._serialized_start=3542
+  _globals['_CALLMESSAGE_TYPE']._serialized_end=3644
+  _globals['_CONFIGURATIONMESSAGE']._serialized_start=3647
+  _globals['_CONFIGURATIONMESSAGE']._serialized_end=4171
+  _globals['_CONFIGURATIONMESSAGE_CLOSEDGROUP']._serialized_start=3891
+  _globals['_CONFIGURATIONMESSAGE_CLOSEDGROUP']._serialized_end=4021
+  _globals['_CONFIGURATIONMESSAGE_CONTACT']._serialized_start=4024
+  _globals['_CONFIGURATIONMESSAGE_CONTACT']._serialized_end=4171
+  _globals['_RECEIPTMESSAGE']._serialized_start=4173
+  _globals['_RECEIPTMESSAGE']._serialized_end=4276
+  _globals['_RECEIPTMESSAGE_TYPE']._serialized_start=4260
+  _globals['_RECEIPTMESSAGE_TYPE']._serialized_end=4276
+  _globals['_ATTACHMENTPOINTER']._serialized_start=4279
+  _globals['_ATTACHMENTPOINTER']._serialized_end=4496
+  _globals['_ATTACHMENTPOINTER_FLAGS']._serialized_start=4470
+  _globals['_ATTACHMENTPOINTER_FLAGS']._serialized_end=4496
+  _globals['_GROUPCONTEXT']._serialized_start=4499
+  _globals['_GROUPCONTEXT']._serialized_end=4744
+  _globals['_GROUPCONTEXT_TYPE']._serialized_start=4672
+  _globals['_GROUPCONTEXT_TYPE']._serialized_end=4744
+  _globals['_WEBSOCKETREQUESTMESSAGE']._serialized_start=4746
+  _globals['_WEBSOCKETREQUESTMESSAGE']._serialized_end=4842
+  _globals['_WEBSOCKETMESSAGE']._serialized_start=4845
+  _globals['_WEBSOCKETMESSAGE']._serialized_end=5020
+  _globals['_WEBSOCKETMESSAGE_TYPE']._serialized_start=4974
+  _globals['_WEBSOCKETMESSAGE_TYPE']._serialized_end=5020
+# @@protoc_insertion_point(module_scope)

session_python-1.0.0.dist-info/METADATA

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: session-python
+Version: 1.0.0
+Summary: A pure Python implementation of the Session Messenger protocol client
+Author-email: Towux <towux@users.noreply.github.com>
+Project-URL: Homepage, https://github.com/towux/session-python
+Project-URL: Bug Tracker, https://github.com/towux/session-python/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pynacl>=1.5.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: protobuf>=4.21.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pysocks>=1.7.1
+Dynamic: license-file
+
+# session-python
+
+[![PyPI version](https://img.shields.io/pypi/v/session-python.svg)](https://pypi.org/project/session-python/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A pure Python implementation of the **Session Messenger** programmatic client protocol.
+
+This library is a 1-to-1 port of the official `@session.js` (Bun) client modules to Python, allowing you to build Session bots, send encrypted messages, upload/download attachments, handle read receipts, typing indicators, message reactions, and unsends natively in Python, **without** wrapping any Node/Bun subprocesses.
+
+---
+
+## 🚀 Features
+
+*   **Zero JS Subprocesses**: Natively implemented in Python using PyNaCl, Cryptography, and Protobuf.
+*   **Oxen Mnemonics**: Ported 13-word Electrum/Monero style mnemonic decoder & encoder (Oxen standard) with CRC32 checksums.
+*   **Session Protocol Encryption**: SealedBox encryption, sender identity signatures, envelope wrapping, and 160-byte block size padding.
+*   **Proxy Support**: SOCKS5 and HTTP proxy support out of the box (uses `socks5h://` to perform remote DNS resolution for high privacy).
+*   **Redundant Node Routing**: Swarm lookup and node rotation (automatically retries other nodes in the swarm if a connection fails).
+*   **In-Memory Swarm Cache**: Caches resolved swarms to reduce network calls and decrease message sending latency by up to 4x.
+*   **Attachments Support**: Encrypts (AES-CBC + HMAC-SHA256) and uploads/downloads attachments to the Session file server.
+*   **Typing Indicators**: Show or hide typing indicators (`show_typing_indicator`, `hide_typing_indicator`).
+*   **Message Reactions**: React to messages with emojis (`add_reaction`, `remove_reaction`).
+*   **Read Receipts**: Mark messages as read (`mark_messages_as_read`).
+*   **Message Deletion (Unsend)**: Delete messages locally and propagate deletion commands (`delete_message`, `delete_messages`).
+*   **SOGS Support**: Sign and send requests to SOGS (Open Groups) (`send_sogs_request`, `sign_sogs_request`).
+*   **Pythonic Interface**: Exposes context managers (`with Session() as s:`) and static generators (`Session.generate_mnemonic()`).
+
+---
+
+## 📦 Installation
+
+To install `session-python` along with its dependencies:
+
+```bash
+pip install pynacl cryptography protobuf requests pysocks
+```
+
+---
+
+## 🛠️ Quick Start
+
+### 1. Basic Send Message
+
+```python
+from session_python import Session
+
+# Initialize with SOCKS5 proxy
+PROXY = "socks5h://user:pass@host:port"
+RECIPIENT_ID = "059ce57868de2b93dc56e3bce3780db7a7aadc91d8e236f4a8f972f92e609ab609"
+
+with Session(proxy=PROXY) as session:
+    # Set your account mnemonic or generate a new one
+    mnemonic = Session.generate_mnemonic()
+    print(f"Generated new mnemonic: {mnemonic}")
+    
+    session.set_mnemonic(mnemonic, display_name="Python Bot")
+    print(f"Your Session ID: {session.get_session_id()}")
+
+    # Send a text message
+    result = session.send_message(to=RECIPIENT_ID, text="Hello from Python!")
+    print(f"Message Hash: {result['messageHash']}")
+```
+
+### 2. Polling for Messages
+
+```python
+from session_python import Session, Poller
+
+with Session(proxy=PROXY) as session:
+    session.set_mnemonic("your 13 word mnemonic here...")
+    
+    poller = Poller(session)
+    print("Listening for messages...")
+    
+    while True:
+        messages = poller.poll()
+        for msg in messages:
+            if msg["type"] == "data":
+                print(f"Received from {msg['from']}: {msg['body']}")
+        time.sleep(5)
+```
+
+### 3. File Attachments
+
+```python
+with Session(proxy=PROXY) as session:
+    session.set_mnemonic(mnemonic)
+
+    # 1. Send file attachment
+    with open("photo.jpg", "rb") as f:
+        file_bytes = f.read()
+
+    attachments = [{
+        "data": file_bytes,
+        "name": "photo.jpg",
+        "content_type": "image/jpeg"
+    }]
+    session.send_message(to=RECIPIENT_ID, text="Here is a file!", attachments=attachments)
+
+    # 2. Download and decrypt attachment from a polled message pointer
+    # file_ptr is extracted from incoming messages: msg["attachments"][0]
+    decrypted_file = session.get_file(file_ptr)
+    with open("downloaded_photo.jpg", "wb") as f:
+        f.write(decrypted_file)
+```
+
+### 4. Advanced Chat Operations
+
+```python
+with Session(proxy=PROXY) as session:
+    session.set_mnemonic(mnemonic)
+    
+    # Typing Indicators
+    session.show_typing_indicator(RECIPIENT_ID)
+    time.sleep(2)
+    session.hide_typing_indicator(RECIPIENT_ID)
+    
+    # Message Reactions
+    session.add_reaction(message_timestamp=1783586415070, message_author=RECIPIENT_ID, emoji="🔥")
+    session.remove_reaction(message_timestamp=1783586415070, message_author=RECIPIENT_ID, emoji="🔥")
+    
+    # Read Receipts
+    session.mark_messages_as_read(conversation=RECIPIENT_ID, timestamps=[1783586415070])
+    
+    # Delete / Unsend Messages
+    session.delete_message(conversation=RECIPIENT_ID, timestamp=1783586415070, hash_val="IXFgLeoj...")
+```
+
+---
+
+## ⚖️ License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

session_python-1.0.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+session_python/__init__.py,sha256=pUE3WQUcc1QEaI58Xa5qBRwSpGcOSwo8CbBbmB34OmM,89
+session_python/client.py,sha256=HLqt_Zk2MZidNnIVhUcmC9yVWSJ_5YbCWvVYlbIk5sk,28729
+session_python/crypto.py,sha256=eouNI6lfXIFd7AqL8GOakLMMTeVvrDdZvIJvEHygc90,10527
+session_python/mnemonic.py,sha256=9j3r2KVawok1sZ3LuY8ThOfvpNTgLz0zTM8unXOhL3M,18952
+session_python/network.py,sha256=50Usnv08R2TgqGq4VURivIzaFhVBOajAt8zaNsXhiL4,6716
+session_python/polling.py,sha256=IaggPaEzMtxSD6gryaiimmW7OFFcDy1Wmqk0GByAPcU,8615
+session_python/protobuf/__init__.py,sha256=4rb44gL-mJV1hlfw6s7bgND1OHr8YlN-jTM-SzgchVY,19
+session_python/protobuf/signalservice_pb2.py,sha256=iBBjC0dBWlBS2gQe7mLkY_YlyjOaWlCaHl0rZyghR0c,14465
+session_python-1.0.0.dist-info/licenses/LICENSE,sha256=1EF7fItXLWrIq-VFUyWGfkNILQebdb_LS5CiT6B-qu4,1062
+session_python-1.0.0.dist-info/METADATA,sha256=JV1kJxZ6eIw_6O9hH3hqeQe0tbtLcEsclWjsuraQjvw,6125
+session_python-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+session_python-1.0.0.dist-info/top_level.txt,sha256=ud9usATeSN6ArJTxpZ_d19Gid7FAGR4kHubtN2-By9g,15
+session_python-1.0.0.dist-info/RECORD,,

session_python-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

session_python-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Towux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

session_python-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+session_python