vysion 2.0.19__tar.gz → 2.1.0__tar.gz

{vysion-2.0.19 → vysion-2.1.0}/PKG-INFO

@@ -1,7 +1,8 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.1
 Name: vysion
-Version: 2.0.19
+Version: 2.1.0
 Summary: The official Python client library for Vysion
+Home-page: https://vysion.ai
 License: Apache-2.0
 Author: Javier Junquera-Sánchez
 Author-email: javier.junquera@byronlabs.io
@@ -14,23 +15,21 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: pydantic (>=2.0.1,<3.0.0)
 Requires-Dist: pymisp (>=2.4.194,<3.0.0)
 Requires-Dist: requests (>=2.28.1,<3.0.0)
 Requires-Dist: softenum (==1.0.1)
 Project-URL: Documentation, https://developers.vysion.ai
-Project-URL: Homepage, https://vysion.ai
 Project-URL: Repository, https://github.com/ByronLabs/vysion-py
 Description-Content-Type: text/markdown
 
 # Vysion-PY
 
-Welcome to the open source repository for vysion-py, our implementation as a Python library to use the Vysion tool. Vysion is a dark web intelligence tool that provides information collected from web pages from Tor, I2P, cybercrime forums on the clearnet, etc. Vysion API also provides a feed of information on ransomware attacks published by the various ransomware groups currently active.
+Welcome to the PyPi webpage for Vysion, our implementation as a Python library to use the Vysion tool. Vysion is a dark web intelligence tool that provides information collected from web pages from Tor, I2P, cybercrime forums on the clearnet, etc. Vysion API also provides a feed of information on ransomware attacks published by the various ransomware groups currently active.
 
 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.0.19](https://pypi.org/project/vysion/)
+Latest version: [2.1.0](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.0.19 → vysion-2.1.0}/README.md

@@ -1,10 +1,10 @@
 # Vysion-PY
 
-Welcome to the open source repository for vysion-py, our implementation as a Python library to use the Vysion tool. Vysion is a dark web intelligence tool that provides information collected from web pages from Tor, I2P, cybercrime forums on the clearnet, etc. Vysion API also provides a feed of information on ransomware attacks published by the various ransomware groups currently active.
+Welcome to the PyPi webpage for Vysion, our implementation as a Python library to use the Vysion tool. Vysion is a dark web intelligence tool that provides information collected from web pages from Tor, I2P, cybercrime forums on the clearnet, etc. Vysion API also provides a feed of information on ransomware attacks published by the various ransomware groups currently active.
 
 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.0.19](https://pypi.org/project/vysion/)
+Latest version: [2.1.0](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.0.19 → vysion-2.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "vysion"
-version = "2.0.19"
+version = "2.1.0"
 description = "The official Python client library for Vysion"
 homepage = "https://vysion.ai"
 repository = "https://github.com/ByronLabs/vysion-py"

{vysion-2.0.19 → vysion-2.1.0}/vysion/client/client.py

@@ -15,8 +15,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-# TODO Referenciar vt-py
-
 import logging
 import os
 from datetime import datetime, timedelta
@@ -323,7 +321,7 @@ class Client(BaseClient):
     @vysion_error_manager
     def search_ransomware_victim(
         self,
-        q: str,
+        q: str = None,
         lte: datetime = None,
         gte: datetime = None,
         page: int = 1,
@@ -419,6 +417,51 @@ class Client(BaseClient):
         result = VysionResponse[ImMessageHit].model_validate(self._make_request(url))
         return result.data
 
+
+    @vysion_error_manager
+    def im_find_email(
+        self,
+        email: str,
+        page: int = 1,
+        page_size: int = 10,
+        lte: datetime = None,
+        gte: datetime = None
+    ) -> VysionResponse[DocumentHit]:
+        url = self._build_api_url__(
+            "im/email",
+            email,
+            page=page,
+            page_size=page_size,
+            lte=lte,
+            gte=gte
+        )
+
+        result = VysionResponse[ImProfileHit].model_validate(self._make_request(url))
+        return result.data
+    
+    @vysion_error_manager
+    def im_find_wallet(
+        self,
+        chain: str,
+        address: str,
+        page: int = 1,
+        page_size: int = 10,
+        lte: datetime = None,
+        gte: datetime = None,
+    ) -> VysionResponse[DocumentHit]:
+        url = self._build_api_url__(
+            "im/wallet/" + chain,
+            address,
+            page=page,
+            page_size=page_size,
+            lte=lte,
+            gte=gte
+        )
+
+        result = VysionResponse[ImProfileHit].model_validate(self._make_request(url))
+        return result.data
+    
+
     @vysion_error_manager
     def get_im_chat(
         self, platform: str, channelId: str, gte: datetime = None, lte: datetime = None
@@ -465,6 +508,7 @@ class Client(BaseClient):
 
         result = VysionResponse[ImServerHit].model_validate(self._make_request(url))
         return result.data
+    
 
     #
     # FEEDS
@@ -472,6 +516,7 @@ class Client(BaseClient):
 
     @vysion_error_manager
     def consume_feed_ransomware(self, batch_day: datetime = datetime.today()):
+        #TODO implement client feed logic
         pass
 
 
@@ -494,7 +539,4 @@ class RansomwareFeed(DaylyFeed):
 
         for page in range(pages):
             url = self._build_api_url__("feed", "ransomware", days=days, page=page + 1)
-            yield self._make_request(url)
-
-
-# TODO /api/v1/feeds
+            yield self._make_request(url)

{vysion-2.0.19 → vysion-2.1.0}/vysion/dto/dto.py

@@ -303,7 +303,25 @@ class ImMessageHit(BaseModel):
     detectionDate: datetime
     serverId: Optional[Union[int, str]] = Field(default_factory=lambda: None) #Discord Exclusive
     serverTitle: Optional[str] = Field(default_factory=lambda: None) #Discord Exclusive
-    platform: Optional[str] = Field(default_factory=lambda: None) #Discord Exclusive
+    platform: Optional[str] = Field(default_factory=lambda: None) 
+
+    @model_validator(mode="after")
+    def validate_platform_specific_fields(cls, values):
+        """
+        Conditionally include platform-specific fields:
+        - Include Discord-specific fields only for Discord platform
+        - Exclude Discord-specific fields for Telegram platform
+        """
+        platform = getattr(values, "platform", None)
+        
+        # For Telegram platform, remove Discord-specific fields
+        if platform is None or (isinstance(platform, str) and platform.lower() == "telegram"):
+            # Delete attributes instead of setting to None
+            for attr in ["serverId", "serverTitle"]:
+                if hasattr(values, attr):
+                    delattr(values, attr)
+        
+        return values
     
 class ImMessageCardHit(BaseModel):
     userId: Optional[Union[int, str]] = Field(default_factory=lambda: None)
@@ -318,6 +336,24 @@ class ImMessageCardHit(BaseModel):
     serverTitle: Optional[str] = Field(default_factory=lambda: None) #Discord Exclusive
     platform: Optional[str] = Field(default_factory=lambda: None)
 
+    @model_validator(mode="after")
+    def validate_platform_specific_fields(cls, values):
+        """
+        Conditionally include platform-specific fields:
+        - Include Discord-specific fields only for Discord platform
+        - Exclude Discord-specific fields for Telegram platform
+        """
+        platform = getattr(values, "platform", None)
+        
+        # For Telegram platform, remove Discord-specific fields
+        if platform is None or (isinstance(platform, str) and platform.lower() == "telegram"):
+            # Delete attributes instead of setting to None
+            for attr in ["serverId", "serverTitle"]:
+                if hasattr(values, attr):
+                    delattr(values, attr)
+        
+        return values
+
 class ImProfileHit(BaseModel):
     userId: Union[int, str]
     usernames: Optional[List[str]] = Field(default_factory=lambda: None)
@@ -328,8 +364,41 @@ class ImProfileHit(BaseModel):
     bot: Optional[bool] = Field(default_factory=lambda: None) #Discord Exclusive
     discordLink: Optional[List[str]] = Field(default_factory=lambda: None) #Discord Exclusive
     discriminator: Optional[List[int]] = Field(default_factory=lambda: None) #Discord Exclusive
+    # TODO platform should be mandatory
     platform: Optional[str] = Field(default_factory=lambda: None)
+    email: List[Email] = Field(default_factory=lambda: [])
+    paste: List[Paste] = Field(default_factory=lambda: [])
+    skype: List[Skype] = Field(default_factory=lambda: [])
+    telegram: List[Telegram] = Field(default_factory=lambda: [])
+    whatsapp: List[WhatsApp] = Field(default_factory=lambda: [])
+    bitcoin_address: List[BitcoinAddress] = Field(default_factory=lambda: [])
+    polkadot_address: List[PolkadotAddress] = Field(default_factory=lambda: [])
+    ethereum_address: List[EthereumAddress] = Field(default_factory=lambda: [])
+    monero_address: List[MoneroAddress] = Field(default_factory=lambda: [])
+    ripple_address: List[RippleAddress] = Field(default_factory=lambda: [])
+    zcash_address: List[ZcashAddress] = Field(default_factory=lambda: [])
+
     
+    model_config = ConfigDict(exclude_defaults=True)
+
+    @model_validator(mode="after")
+    def validate_platform_specific_fields(cls, values):
+        """
+        Conditionally include platform-specific fields:
+        - Include Discord-specific fields only for Discord platform
+        - Exclude Discord-specific fields for Telegram platform
+        """
+        platform = getattr(values, "platform", None)
+        
+        # For Telegram platform, remove Discord-specific fields
+        if platform is None or (isinstance(platform, str) and platform.lower() == "telegram"):
+            # Delete attributes instead of setting to None
+            for attr in ["discordLink", "bot", "discriminator"]:
+                if hasattr(values, attr):
+                    delattr(values, attr)
+        
+        return values
+
     @field_validator("userId")
     def validate_userId(cls, v: int) -> int:
         if not v:
@@ -353,6 +422,29 @@ class ImChannelHit(BaseModel):
     serverTitle: Optional[List[str]] = Field(default_factory=lambda: None) #Discord Exclusive
     platform: Optional[str] = Field(default_factory=lambda: None)
     
+    @model_validator(mode="after")
+    def validate_platform_specific_fields(cls, values):
+        """
+        Conditionally include platform-specific fields:
+        - Include Discord-specific fields only for Discord platform
+        - Exclude Discord-specific fields for Telegram platform
+        """
+        platform = getattr(values, "platform", None)
+        
+        # For Telegram platform, remove Discord-specific fields
+        if platform is None or (isinstance(platform, str) and platform.lower() == "telegram"):
+            # Delete attributes instead of setting to None
+            for attr in ["serverId", "serverTitle"]:
+                if hasattr(values, attr):
+                    delattr(values, attr)
+        else:
+            # For Discord platform, remove Telegram-specific fields
+            for attr in ["channelPhoto"]:
+                if hasattr(values, attr):
+                    delattr(values, attr)
+        
+        return values
+    
     @field_validator("detectionDate")
     def validate_detectionDate(cls, v: datetime) -> datetime:
         if not v:

{vysion-2.0.19 → vysion-2.1.0}/vysion/dto/util.py

@@ -79,7 +79,7 @@ class MISPProcessor:
             self.misp_event.add_attribute("xmr", value=xmr.value)
 
         for xrp in hit.ripple_address:
-            self.misp_event.add_attribute("xrp", value=xmr.value)
+            self.misp_event.add_attribute("xrp", value=xrp.value)
 
         for zec in hit.zcash_address:
             self.misp_event.add_attribute("zec", value=zec.value)

{vysion-2.0.19 → vysion-2.1.0}/vysion/version.py

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