Migrate clip/convert to V3 actions; add background clip support, redirect legacy route; update frontend guide

tests/e2e/test_e2e_v3_action_download.py

@@ -7,8 +7,8 @@ API_KEY = "PMM4n50teUCaOMMTN8qOJA"
 ACCOUNT_ID = "Q8lR8Ai8hx2FjbQ3C_EH1Q" # OSIT
 
 # IDs for testing ID Vision resolution
-HOSTED_FILE_ID = "PUwhbT2tMgU" 
-EVENT_FILE_ID = "cFyCd7FPZe9"
+HOSTED_FILE_ID = "PUwhbT2tMgU"
+EVENT_FILE_ID = "2e_MFBgY5eg"
 ARCHIVE_CONTENT_ID = "UjKzrk-GKu5"
 
 # Hash for testing content-addressable storage
@@ -18,7 +18,7 @@ def test_download_by_id(label, test_id):
     print(f"--- Testing Download via {label}: {test_id} ---")
     url = f"{BASE_URL}/{test_id}/download"
     headers = {"X-Aether-API-Key": API_KEY, "x-account-id": ACCOUNT_ID}
-    
+
     try:
         response = requests.get(url, headers=headers, stream=True)
         print(f"Status: {response.status_code}")
@@ -35,7 +35,7 @@ def test_download_by_id(label, test_id):
 def test_download_by_hash_query():
     print(f"\n--- Testing Hash Download via Query Param API Key ---")
     url = f"{BASE_URL}/hash/{FILE_HASH}/download?api_key={API_KEY}"
-    
+
     try:
         response = requests.get(url)
         print(f"Status: {response.status_code}")
@@ -57,7 +57,7 @@ def test_download_streaming():
         "x-account-id": ACCOUNT_ID,
         "Range": "bytes=0-10"
     }
-    
+
     try:
         response = requests.get(url, headers=headers)
         print(f"Status: {response.status_code} (Expected 206)")
@@ -79,7 +79,7 @@ if __name__ == "__main__":
         test_download_by_hash_query(),
         test_download_streaming()
     ]
-    
+
     if all(results):
         print("\n🎉 ALL DOWNLOAD PATTERNS VERIFIED!")
     else:

tests/unit/test_unit_media_methods.py

@@ -0,0 +1,97 @@
+import sys
+import os
+import asyncio
+from types import SimpleNamespace
+from unittest.mock import MagicMock, patch
+
+# Add project root to path
+sys.path.append(os.getcwd())
+
+# Mock configuration and low-level deps BEFORE importing the target module
+mock_config = MagicMock()
+mock_settings = MagicMock()
+mock_settings.FILES_PATH = {
+    'hosted_files_root': '/tmp',
+    'hosted_tmp_root': '/tmp'
+}
+mock_config.settings = mock_settings
+sys.modules['app.config'] = mock_config
+sys.modules['app.lib_general'] = MagicMock()
+sys.modules['app.db_sql'] = MagicMock()
+
+from app.methods import lib_media
+
+
+def test_clip_video_method():
+    print('--- test_clip_video_method ---')
+
+    hosted_obj = SimpleNamespace(hash_sha256='aa11bb22cc33ddeeff00112233445566778899aa', extension='mp4')
+
+    # Prepare mocked behaviors
+    async def _async_save(*args, **kwargs):
+        return {'saved': True, 'hash_sha256': 'newhash'}
+
+    with patch.object(lib_media, 'load_hosted_file_obj', side_effect=[hosted_obj, {'id': 'EXIST_ID', 'hosted_file_id': 'EXIST_ID', 'filename': 'clip.mp4'}]) as mock_load, \
+         patch.object(lib_media, 'save_file_to_hosted_file', new=_async_save) as mock_save, \
+         patch('subprocess.run', return_value=None) as mock_run, \
+         patch('os.path.exists', return_value=True) as mock_exists, \
+         patch.object(lib_media, 'sql_select', return_value={'id': 'EXIST_ID'}) as mock_sql:
+
+        res = asyncio.run(lib_media.clip_video_method(
+            hosted_file_id='SOME_ID',
+            start_time='00:00:01',
+            end_time='00:00:05',
+            account_id=1,
+            link_to_type='archive_content',
+            link_to_id=1,
+        ))
+
+        print('Result:', res)
+        assert isinstance(res, dict)
+        assert res.get('id') == 'EXIST_ID'
+
+
+def test_convert_file_method():
+    print('--- test_convert_file_method ---')
+
+    hosted_obj = SimpleNamespace(hash_sha256='ff22ee33dd44cc55bb66aa77cc88dd99ee001122', extension='pdf', content_type='application/pdf')
+
+    class DummyImage:
+        def save(self, path, **kwargs):
+            with open(path, 'wb') as f:
+                f.write(b'PNGDATA')
+
+    async def _async_save2(*args, **kwargs):
+        return {'saved': True, 'hash_sha256': 'newhash2'}
+
+    # Provide a dummy pdf2image module to satisfy the runtime import inside the function
+    sys.modules['pdf2image'] = MagicMock()
+    sys.modules['pdf2image'].convert_from_path = lambda *a, **k: [DummyImage()]
+
+    with patch.object(lib_media, 'load_hosted_file_obj', side_effect=[hosted_obj, {'id': 'EXIST_ID2', 'hosted_file_id': 'EXIST_ID2', 'filename': 'conv.webp'}]) as mock_load, \
+         patch.object(lib_media, 'save_file_to_hosted_file', new=_async_save2) as mock_save, \
+         patch('os.path.exists', return_value=True) as mock_exists, \
+         patch.object(lib_media, 'sql_select', return_value={'id': 'EXIST_ID2'}) as mock_sql, \
+         patch.object(lib_media, 'create_hosted_file_obj', return_value='NEW_ID') as mock_create:
+
+        res = asyncio.run(lib_media.convert_file_method(
+            hosted_file_id='SOME_ID',
+            link_to_type='archive_content',
+            link_to_id=1,
+            account_id=1,
+            to_type='webp'
+        ))
+
+        print('Result:', res)
+        assert isinstance(res, dict)
+        assert res.get('id') == 'EXIST_ID2'
+
+
+if __name__ == '__main__':
+    try:
+        test_clip_video_method()
+        test_convert_file_method()
+        print('\n🎉 MEDIA METHOD TESTS PASSED')
+    except AssertionError as e:
+        print('\n❌ TEST FAILED:', e)
+        raise