vysion 2.1.7__py3-none-any.whl → 2.2.1__py3-none-any.whl

vysion/client/client.py

@@ -38,6 +38,8 @@ from vysion.dto import (
     ImMessageHit,
     ImProfileHit,
     ImServerHit,
+    LeakHit,
+    ImChatMessages,
 )
 from vysion.version import __version__ as vysion_version
 
@@ -509,14 +511,22 @@ class Client(BaseClient):
     
 
     @vysion_error_manager
-    def get_im_chat(
-        self, platform: str, channelId: str, gte: datetime = None, lte: datetime = None
-    ) -> VysionResponse[ImMessageHit]:
+    def get_im_chat_messages(
+        self,
+        platform: str,
+        channelId: str,
+        messageId: str | None,
+        cursor: str | None,
+        limit: str = 30
+    ) -> ImChatMessages:
         url = self._build_api_url__(
-            "im/" + platform + "/chat/" + channelId, gte=gte, lte=lte
+            "im/" + platform + "/chat/" + channelId,
+            messageId=messageId,
+            cursor=cursor,
+            limit=limit
         )
 
-        result = VysionResponse[ImMessageHit].model_validate(self._make_request(url))
+        result = VysionResponse[ImChatMessages].model_validate(self._make_request(url))
         return result.data
 
     @vysion_error_manager
@@ -556,6 +566,246 @@ class Client(BaseClient):
         return result.data
     
 
+    #
+    # Leak search methods
+    #
+
+    @vysion_error_manager
+    def get_leak_by_email(
+        self,
+        email: str,
+        page: int = 1,
+        page_size: int = 50,
+        gte: datetime = None,
+        lte: datetime = None,
+    ) -> VysionResponse[LeakHit]:
+        """
+        Search for leaks containing a specific email address.
+        
+        :param email: Email address to search for
+        :param page: Page number (default: 1)
+        :param page_size: Results per page (default: 50, max: 100)
+        :param gte: Start date filter (optional)
+        :param lte: End date filter (optional)
+        :return: VysionResponse containing LeakHit objects
+        """
+        url = self._build_api_url__(
+            f"leak/email/{email}",
+            page=page,
+            page_size=page_size,
+            gte=gte,
+            lte=lte,
+        )
+        
+        result = VysionResponse[LeakHit].model_validate(self._make_request(url))
+        return result.data
+
+    @vysion_error_manager
+    def get_leak_by_wallet(
+        self,
+        chain: str,
+        address: str,
+        page: int = 1,
+        page_size: int = 50,
+        gte: datetime = None,
+        lte: datetime = None,
+    ) -> VysionResponse[LeakHit]:
+        """
+        Search for leaks containing a cryptocurrency wallet address.
+        
+        :param chain: Blockchain (btc, eth, xmr, xrp, zec, dot, bnb, dash)
+        :param address: Wallet address
+        :param page: Page number (default: 1)
+        :param page_size: Results per page (default: 50, max: 100)
+        :param gte: Start date filter (optional)
+        :param lte: End date filter (optional)
+        :return: VysionResponse containing LeakHit objects
+        """
+        url = self._build_api_url__(
+            f"leak/wallet/{chain}/{address}",
+            page=page,
+            page_size=page_size,
+            gte=gte,
+            lte=lte,
+        )
+        
+        result = VysionResponse[LeakHit].model_validate(self._make_request(url))
+        return result.data
+
+    @vysion_error_manager
+    def get_leak_by_ip(
+        self,
+        ip_address: str,
+        page: int = 1,
+        page_size: int = 50,
+        gte: datetime = None,
+        lte: datetime = None,
+    ) -> VysionResponse[LeakHit]:
+        """
+        Search for leaks containing an IP address (IPv4 or IPv6).
+        
+        :param ip_address: IP address to search for
+        :param page: Page number (default: 1)
+        :param page_size: Results per page (default: 50, max: 100)
+        :param gte: Start date filter (optional)
+        :param lte: End date filter (optional)
+        :return: VysionResponse containing LeakHit objects
+        """
+        url = self._build_api_url__(
+            f"leak/ip/{ip_address}",
+            page=page,
+            page_size=page_size,
+            gte=gte,
+            lte=lte,
+        )
+        
+        result = VysionResponse[LeakHit].model_validate(self._make_request(url))
+        return result.data
+
+    @vysion_error_manager
+    def get_leak_by_phone(
+        self,
+        country_code: str,
+        number: str,
+        page: int = 1,
+        page_size: int = 50,
+        gte: datetime = None,
+        lte: datetime = None,
+    ) -> VysionResponse[LeakHit]:
+        """
+        Search for leaks containing a phone number.
+        
+        :param country_code: Country code (e.g., "1" for US, "34" for Spain)
+        :param number: Phone number without country code
+        :param page: Page number (default: 1)
+        :param page_size: Results per page (default: 50, max: 100)
+        :param gte: Start date filter (optional)
+        :param lte: End date filter (optional)
+        :return: VysionResponse containing LeakHit objects
+        """
+        url = self._build_api_url__(
+            f"leak/phone/{country_code}/{number}",
+            page=page,
+            page_size=page_size,
+            gte=gte,
+            lte=lte,
+        )
+        
+        result = VysionResponse[LeakHit].model_validate(self._make_request(url))
+        return result.data
+
+    @vysion_error_manager
+    def get_leak_by_username(
+        self,
+        username: str,
+        page: int = 1,
+        page_size: int = 50,
+        gte: datetime = None,
+        lte: datetime = None,
+    ) -> VysionResponse[LeakHit]:
+        """
+        Search for leaks containing a specific username.
+        
+        :param username: Username to search for
+        :param page: Page number (default: 1)
+        :param page_size: Results per page (default: 50, max: 100)
+        :param gte: Start date filter (optional)
+        :param lte: End date filter (optional)
+        :return: VysionResponse containing LeakHit objects
+        """
+        url = self._build_api_url__(
+            f"leak/username/{username}",
+            page=page,
+            page_size=page_size,
+            gte=gte,
+            lte=lte,
+        )
+        
+        result = VysionResponse[LeakHit].model_validate(self._make_request(url))
+        return result.data
+
+    @vysion_error_manager
+    def get_leak_by_hash(
+        self,
+        hash_value: str,
+        page: int = 1,
+        page_size: int = 50,
+        gte: datetime = None,
+        lte: datetime = None,
+    ) -> VysionResponse[LeakHit]:
+        """
+        Search for leaks by file hash (SHA256, SHA1, or MD5).
+        Hash type is auto-detected based on length.
+        
+        :param hash_value: File hash (32, 40, or 64 hex characters)
+        :param page: Page number (default: 1)
+        :param page_size: Results per page (default: 50, max: 100)
+        :param gte: Start date filter (optional)
+        :param lte: End date filter (optional)
+        :return: VysionResponse containing LeakHit objects
+        """
+        url = self._build_api_url__(
+            f"leak/hash/{hash_value}",
+            page=page,
+            page_size=page_size,
+            gte=gte,
+            lte=lte,
+        )
+        
+        result = VysionResponse[LeakHit].model_validate(self._make_request(url))
+        return result.data
+
+    @vysion_error_manager
+    def search_leaks(
+        self,
+        q: str,
+        page: int = 1,
+        page_size: int = 50,
+        gte: datetime = None,
+        lte: datetime = None,
+    ) -> VysionResponse[LeakHit]:
+        """
+        Generic search across all leak content and metadata fields.
+        
+        :param q: Search query (minimum 3 characters)
+        :param page: Page number (default: 1)
+        :param page_size: Results per page (default: 50, max: 100)
+        :param gte: Start date filter (optional)
+        :param lte: End date filter (optional)
+        :return: VysionResponse containing LeakHit objects with highlights
+        """
+        url = self._build_api_url__(
+            "leak/search",
+            q=q,
+            page=page,
+            page_size=page_size,
+            gte=gte,
+            lte=lte,
+        )
+        
+        result = VysionResponse[LeakHit].model_validate(self._make_request(url))
+        return result.data
+
+    @vysion_error_manager
+    def get_leak_by_id(
+        self,
+        leak_id: str,
+    ) -> VysionResponse[LeakHit]:
+        """
+        Retrieve a single leak document by its Elasticsearch ID.
+        Includes downloadUrl if available from linked Telegram message.
+        
+        :param leak_id: Elasticsearch document ID
+        :return: VysionResponse containing a single LeakHit object
+        """
+        url = self._build_api_url__(
+            f"leak/{leak_id}",
+        )
+        
+        result = VysionResponse[LeakHit].model_validate(self._make_request(url))
+        return result.data
+    
+
     #
     # FEEDS
     #

vysion/dto/dto.py

@@ -412,6 +412,12 @@ class ImProfileHit(BaseModel):
         return v
 
 
+class ImChatMessages(BaseModel):
+    messages: List[ImMessageHit]
+    prev_cursor: Optional[str] = None
+    next_cursor: Optional[str] = None
+
+
 class ImChannelHit(BaseModel):
     channelId: Union[int, str]
     channelTitles: Optional[List[str]] = Field(default_factory=lambda: None)
@@ -478,6 +484,57 @@ class ImServerHit(BaseModel):
             raise ValueError("creationDate field cannot be empty")
         return v
 
+class LeakHit(BaseModel):
+    """
+    Represents a leak document from telegram-leaks-* indices.
+    Contains file metadata and detected sensitive information.
+    """
+    # Core identification
+    id: str
+    detectionDate: datetime
+    
+    # File metadata
+    filePath: Optional[str] = Field(default_factory=lambda: None)
+    fileHash: Optional[str] = Field(default_factory=lambda: None)  # SHA256, SHA1, or MD5
+    fileSize: Optional[int] = Field(default_factory=lambda: None)
+    fileType: Optional[str] = Field(default_factory=lambda: None)
+    detectedMimeType: Optional[str] = Field(default_factory=lambda: None)
+    decompressedFilename: Optional[str] = Field(default_factory=lambda: None)
+    
+    # Archive metadata (if leak came from archive file)
+    archiveSource: Optional[str] = Field(default_factory=lambda: None)
+    archiveMemberPath: Optional[str] = Field(default_factory=lambda: None)
+    
+    # Telegram source metadata
+    telegram: Optional[dict] = Field(default_factory=lambda: None)  # Contains channel_id, message_id, etc.
+    
+    # Detected sensitive information (enrichment data)
+    detectedInfo: Optional[dict] = Field(default_factory=lambda: None)
+    # detectedInfo contains: emails, usernames, phone_numbers, ipv4_addresses, ipv6_addresses,
+    # btc_wallets, eth_wallets, xmr_wallets, xrp_wallets, zec_wallets, dot_wallets, bnb_wallets, dash_wallets
+    
+    # Language detection
+    language: Optional[str] = Field(default_factory=lambda: None)
+    languages: Optional[List[LanguagePair]] = Field(default_factory=lambda: None)
+    
+    # Parse status
+    parseStatus: Optional[str] = Field(default_factory=lambda: None)
+    
+    # Download URL (only present for /leak/{id} endpoint)
+    downloadUrl: Optional[str] = Field(default_factory=lambda: None)
+    
+    # Search highlights (only present for search endpoints)
+    highlight: Optional[dict] = Field(default_factory=lambda: None)
+    
+    model_config = ConfigDict(exclude_defaults=True)
+    
+    @field_validator("detectionDate")
+    def validate_detectionDate(cls, v: datetime) -> datetime:
+        if not v:
+            raise ValueError("detectionDate field cannot be empty")
+        return v
+
+
 class ImFeedHit(BaseModel):
     id: str
     telegram: List[str]
@@ -499,7 +556,6 @@ class CryptoFeedHit(BaseModel):
     id: str
     url: str
     detectionDate: datetime
-    url: str
     network: str
     title: Optional[str] = Field(default_factory=lambda: None)
     tag: List[Tag] = Field(default_factory=lambda: [])

vysion/version.py

@@ -15,4 +15,4 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-__version__ = "2.1.7"
+__version__ = "2.2.1"

{vysion-2.1.7.dist-info → vysion-2.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vysion
-Version: 2.1.7
+Version: 2.2.1
 Summary: The official Python client library for Vysion
 Home-page: https://vysion.ai
 License: Apache-2.0
@@ -29,7 +29,7 @@ Welcome to the PyPi webpage for Vysion, our implementation as a Python library t
 
 You can request a demo for the web app or an API-key to use in this library at [vysion.ai](https://vysion.ai).
 
-Latest version: [2.1.7](https://pypi.org/project/vysion/)
+Latest version: [2.2.1](https://pypi.org/project/vysion/)
 
 You can visit [the documentation](https://developers.vysion.ai/?python) for more information on the searches and requests performed with the library or directly on the API.
 

{vysion-2.1.7.dist-info → vysion-2.2.1.dist-info}/RECORD

@@ -1,9 +1,9 @@
 vysion/__init__.py,sha256=yxJiM-S29q8GB3PBff9tV70P2nvydd8aKLEprLkXw5o,664
 vysion/client/__init__.py,sha256=aVHmBuetPdybp7TgcNzUx4HkxTjEuXYzSdDYiYfFQd0,630
-vysion/client/client.py,sha256=EW2yh_KzczA4WkdzB87gYLARUTC9cf9IWOaDyKser-g,16352
+vysion/client/client.py,sha256=YmawH7ZVbMYMhjQX1LYaY6nnvzVpCACTnWun9PM7Cn8,24102
 vysion/client/error.py,sha256=JK0dsZkyMjmxPtEgO5IStG_N_q8y_-VGbppwWrUtSgM,1166
 vysion/dto/__init__.py,sha256=ct8JxVMfJ0APiOTgr9ju-JIuBlXOrPkx7n2qISSXUts,605
-vysion/dto/dto.py,sha256=DjHwD2D4NWwdrWDpr_QrUJTLlYFw8BO2KvqjXOzRENM,24464
+vysion/dto/dto.py,sha256=KhsyVty8FHk6qwhnuowBIre2C0at9n63H0AYO-zOCHE,26784
 vysion/dto/tag.py,sha256=whGPsdasgYm8oijrL7MRSMmapzaoCmKNeaJ5ih0aBIk,1503
 vysion/dto/util.py,sha256=AxdMWPdf7xrFtWva5epKxgjI0Bah1GiIw-sEWvIUYb4,4491
 vysion/model/__init__.py,sha256=rJX9eNW9-jQGTgwm97W04jhZa-dV_dSTTTFcbWg73w0,606
@@ -15,8 +15,8 @@ vysion/model/enum/services.py,sha256=fUfZEO0RNNctU4Gzae5TV3c7BU5A_cEwaEb1tzqgcr0
 vysion/taxonomy/__init__.py,sha256=Bc364AYxRCyjIn26-XBPeEDCPe3Hma4r5RAI8R8eblU,635
 vysion/taxonomy/flavours.py,sha256=ubImHBE8v0zhzFy_2YozAQk2SzN1XDQwHAxb2RebtCo,2347
 vysion/taxonomy/taxonomy.py,sha256=mG6vHX5Eyp38AKyJBgfBDqdpEmDMbkv8TA8YUBzko54,12227
-vysion/version.py,sha256=Yp3tdUjsKE1JxBjBEGa8dB-YCri5PQMl0KXXUBmv5qU,610
-vysion-2.1.7.dist-info/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
-vysion-2.1.7.dist-info/METADATA,sha256=2BZZ-bby4JmO7EFCFuP6w_lUiGDuxq3EhoWoMNwTOq4,1958
-vysion-2.1.7.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-vysion-2.1.7.dist-info/RECORD,,
+vysion/version.py,sha256=xLiCsKYJ8-o-U3jLZrcs1fVnnAAzX-xT-HZaBGqdvKo,610
+vysion-2.2.1.dist-info/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
+vysion-2.2.1.dist-info/METADATA,sha256=o6FnxIDlQB0RbqEllP6lZ7rlEohqlx9dXAjhCSDmpD8,1958
+vysion-2.2.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+vysion-2.2.1.dist-info/RECORD,,