Skip to content

A modern platform for visual, flexible, and extensible graph-based investigations. For cybersecurity analysts and investigators.

feat(types): support SocialAccount and Username

dextmorgna18ac52efc6f
diff --git a/flowsint-types/src/flowsint_types/__init__.py b/flowsint-types/src/flowsint_types/__init__.py
index 5db08907..1eca15dc 100644
--- a/flowsint-types/src/flowsint_types/__init__.py
+++ b/flowsint-types/src/flowsint_types/__init__.py
@@ -30,7 +30,7 @@ from .reputation_score import ReputationScore
from .risk_profile import RiskProfile
from .script import Script
from .session import Session
-from .social import SocialProfile
+from .social_account import SocialAccount
from .ssl_certificate import SSLCertificate
from .username import Username
from .wallet import CryptoWallet, CryptoWalletTransaction, CryptoNFT
@@ -40,7 +40,7 @@ from .website import Website
from .whois import Whois
__version__ = "0.1.0"
-__author__ = "dextmorgn <[email protected]>"
+__author__ = "dextmorgn <[email protected]>"
__all__ = [
"Location",
@@ -71,7 +71,7 @@ __all__ = [
"RiskProfile",
"Script",
"Session",
- "SocialProfile",
+ "SocialAccount",
"SSLCertificate",
"Node",
"Edge",
diff --git a/flowsint-types/src/flowsint_types/social.py b/flowsint-types/src/flowsint_types/social.py
deleted file mode 100644
index fe9a23b5..00000000
--- a/flowsint-types/src/flowsint_types/social.py
+++ /dev/null
@@ -1,31 +0,0 @@
-from pydantic import BaseModel, Field
-from typing import Optional
-
-
-class SocialProfile(BaseModel):
- """Represents a social media profile with engagement metrics."""
-
- username: str = Field(
- ..., description="Username on the social platform", title="Username"
- )
- profile_url: Optional[str] = Field(
- None, description="URL to the user's profile page", title="Profile URL"
- )
- platform: Optional[str] = Field(
- None, description="Name of the social media platform", title="Platform"
- )
- profile_picture_url: Optional[str] = Field(
- None, description="URL to the user's profile picture", title="Profile Picture"
- )
- bio: Optional[str] = Field(
- None, description="User's biography or description", title="Bio"
- )
- followers_count: Optional[int] = Field(
- None, description="Number of followers", title="Followers Count"
- )
- following_count: Optional[int] = Field(
- None, description="Number of users being followed", title="Following Count"
- )
- posts_count: Optional[int] = Field(
- None, description="Number of posts made by the user", title="Posts Count"
- )
diff --git a/flowsint-types/src/flowsint_types/social_account.py b/flowsint-types/src/flowsint_types/social_account.py
new file mode 100644
index 00000000..efa4b37f
--- /dev/null
+++ b/flowsint-types/src/flowsint_types/social_account.py
@@ -0,0 +1,24 @@
+from pydantic import BaseModel, Field
+from typing import Optional, List
+from .username import Username
+
+
+class SocialAccount(BaseModel):
+ """Represents a social media account (the 'home' of a username)."""
+
+ username: Username = Field(..., description="Username associated with this account", title="Username")
+ display_name: Optional[str] = Field(None, description="Display name or full name on the profile", title="Display name")
+ profile_url: Optional[str] = Field(None, description="URL to the account profile page", title="Profile URL")
+ profile_picture_url: Optional[str] = Field(None, description="URL to the profile avatar/picture", title="Image URL")
+ bio: Optional[str] = Field(None, description="Biography or description text", title="Bio")
+ location: Optional[str] = Field(None, description="Location specified in the profile", title="Location")
+ platform: Optional[str] = Field(None, description="Platform/Website URL from the profile", title="Platform")
+ created_at: Optional[str] = Field(None, description="Account creation date", title="Created at")
+ followers_count: Optional[int] = Field(None, description="Number of followers", title="Followers count")
+ following_count: Optional[int] = Field(None, description="Number of accounts being followed", title="Following count")
+ posts_count: Optional[int] = Field(None, description="Number of posts/tweets/content items", title="Posts count")
+ verified: Optional[bool] = Field(None, description="Whether the account is verified", title="Verified")
+ is_private: Optional[bool] = Field(None, description="Whether the account is private/protected", title="Is private")
+ is_suspended: Optional[bool] = Field(None, description="Whether the account is suspended/banned", title="Is suspended")
+ associated_emails: Optional[List[str]] = Field(None, description="Email addresses associated with the account", title="Associated emails")
+ associated_phones: Optional[List[str]] = Field(None, description="Phone numbers associated with the account", title="Associated phones")
diff --git a/flowsint-types/src/flowsint_types/username.py b/flowsint-types/src/flowsint_types/username.py
index 76389513..1cab0345 100644
--- a/flowsint-types/src/flowsint_types/username.py
+++ b/flowsint-types/src/flowsint_types/username.py
@@ -1,54 +1,12 @@
from pydantic import BaseModel, Field
-from typing import Optional, List
+from typing import Optional
class Username(BaseModel):
- """Represents a username or handle on a platform with associated profile information."""
+ """Represents a username or handle on any platform."""
- username: str = Field(..., description="Username or handle", title="Username")
- platform: Optional[str] = Field(
- None, description="Platform or service where username is used", title="Platform"
- )
- display_name: Optional[str] = Field(
- None, description="Display name associated with username", title="Display Name"
- )
- created_at: Optional[str] = Field(
- None, description="Account creation date", title="Creation Date"
- )
+ value: str = Field(..., description="Username or handle string", title="Username value")
+ platform: Optional[str] = Field(None, description="Platform name, e.g., 'twitter'", title="Username platform")
last_seen: Optional[str] = Field(
- None, description="Last activity timestamp", title="Last Seen"
- )
- followers_count: Optional[int] = Field(
- None, description="Number of followers", title="Followers Count"
- )
- following_count: Optional[int] = Field(
- None, description="Number of accounts being followed", title="Following Count"
- )
- posts_count: Optional[int] = Field(
- None, description="Number of posts or content items", title="Posts Count"
- )
- verified: Optional[bool] = Field(
- None, description="Whether account is verified", title="Verified"
- )
- bio: Optional[str] = Field(
- None, description="User biography or description", title="Bio"
- )
- location: Optional[str] = Field(None, description="User location", title="Location")
- website: Optional[str] = Field(
- None, description="User website URL", title="Website"
- )
- avatar_url: Optional[str] = Field(
- None, description="Profile picture URL", title="Avatar URL"
- )
- is_private: Optional[bool] = Field(
- None, description="Whether account is private", title="Is Private"
- )
- is_suspended: Optional[bool] = Field(
- None, description="Whether account is suspended", title="Is Suspended"
- )
- associated_emails: Optional[List[str]] = Field(
- None, description="Associated email addresses", title="Associated Emails"
- )
- associated_phones: Optional[List[str]] = Field(
- None, description="Associated phone numbers", title="Associated Phones"
+ None, description="Last time this username was observed", title="Last seen at"
)