aeglis 1.0.0__py3-none-any.whl

aeglis/__init__.py

@@ -0,0 +1,98 @@
+import os
+import json
+import hmac
+import hashlib
+import requests
+
+class AeglisError(Exception):
+    """Custom exception for Aeglis API errors"""
+    pass
+
+class Aeglis:
+    def __init__(self, api_key: str):
+        """
+        Initialize the Aeglis SDK.
+        :param api_key: Your B2B API Key from the Aeglis Dashboard.
+        """
+        if not api_key:
+            raise ValueError("Aeglis Initialization Error: API key is required.")
+            
+        self.api_key = api_key
+        self.base_url = "https://api.aeglis.com/v3/api"
+        
+        # Use a session for connection pooling (faster subsequent requests)
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {self.api_key}"
+        })
+
+    def scan(self, input_text: str, end_user_id: str = "anonymous") -> dict:
+        """
+        🛡️ QUICK SCAN (Synchronous)
+        Best for short text, URLs, and chat moderation.
+        """
+        if not input_text:
+            raise ValueError("Aeglis Error: input_text is required for Quick Scan.")
+            
+        payload = {
+            "input_text": input_text,
+            "end_user_id": end_user_id
+        }
+        
+        response = self.session.post(f"{self.base_url}/scan", json=payload)
+        
+        if not response.ok:
+            raise AeglisError(f"API Error: {response.text}")
+            
+        return response.json()
+
+    def deep_scan(self, file_path: str, input_text: str = "", end_user_id: str = "anonymous") -> dict:
+        """
+        🔍 DEEP SCAN (Asynchronous File Scanning)
+        Triggers your configured Webhook upon completion.
+        """
+        if not os.path.exists(file_path):
+            raise FileNotFoundError(f"Aeglis Error: File not found at {file_path}")
+            
+        # Using context manager to safely open and read the file
+        with open(file_path, "rb") as f:
+            files = {"file": f}
+            
+            # Form data matches FastAPI Form(...) requirements
+            data = {}
+            if input_text:
+                data["input_text"] = input_text
+            if end_user_id:
+                data["end_user_id"] = end_user_id
+                
+            response = self.session.post(f"{self.base_url}/deep-scan", files=files, data=data)
+            
+        if not response.ok:
+            raise AeglisError(f"API Error: {response.text}")
+            
+        return response.json()
+
+    def verify_webhook(self, raw_payload: bytes, signature_header: str, webhook_secret: str) -> dict:
+        """
+        ⚡ WEBHOOK VERIFICATION (Security)
+        Verifies the incoming HMAC SHA-256 signature to prevent spoofing.
+        """
+        if not raw_payload or not signature_header or not webhook_secret:
+            raise ValueError("Aeglis Webhook Error: Missing payload, signature, or secret.")
+            
+        # Ensure payload is bytes (raw) for accurate hashing
+        if isinstance(raw_payload, str):
+            raw_payload = raw_payload.encode('utf-8')
+            
+        secret_bytes = webhook_secret.encode('utf-8')
+        
+        # Generate the signature using your 'v1=' standard
+        expected_hash = hmac.new(secret_bytes, raw_payload, hashlib.sha256).hexdigest()
+        expected_signature = f"v1={expected_hash}"
+        
+        # Prevent Timing Attacks using compare_digest
+        if not hmac.compare_digest(expected_signature, signature_header):
+            raise AeglisError("Signature Mismatch: Possible spoofing attack blocked.")
+            
+        # If safe, decode and return as a Python dictionary
+        return json.loads(raw_payload.decode('utf-8'))

aeglis-1.0.0.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.1
+Name: aeglis
+Version: 1.0.0
+Summary: Official Python SDK for the Aeglis Security API
+Home-page: https://developer.aeglis.com
+Author: Aeglis Systems
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.1
+

aeglis-1.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+aeglis/__init__.py,sha256=zsVWruwDyyMXMfVFV__lh6zwbADY-6rX4L6qWbxYkJM,3755
+aeglis-1.0.0.dist-info/METADATA,sha256=PkPmhvk72obVyaqJYYyoCToQMgHqbSHgOj5r7jBrzXQ,425
+aeglis-1.0.0.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
+aeglis-1.0.0.dist-info/top_level.txt,sha256=V7u1B22gMCYbbt4JZK6_9RISYhUET4rT8-xPbNzH5ao,7
+aeglis-1.0.0.dist-info/RECORD,,

aeglis-1.0.0.dist-info/WHEEL

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

aeglis-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+aeglis