feat: add WebPreviews blocks

apps/api/src/router.py

@@ -10,6 +10,7 @@ from src.routers.ee import cloud_internal, payments
 from src.routers.install import install
 from src.services.dev.dev import isDevModeEnabledOrRaise
 from src.services.install.install import isInstallModeEnabled
+from src.routers.utils import router as utils_router
 
 
 v1_router = APIRouter(prefix="/api/v1")
@@ -61,3 +62,5 @@ v1_router.include_router(
     tags=["install"],
     dependencies=[Depends(isInstallModeEnabled)],
 )
+
+v1_router.include_router(utils_router, prefix="/utils", tags=["utils"])

apps/api/src/routers/utils.py

@@ -0,0 +1,12 @@
+from fastapi import APIRouter, HTTPException, Query
+from src.services.utils.link_preview import fetch_link_preview
+
+router = APIRouter()
+
+@router.get("/link-preview")
+async def link_preview(url: str = Query(..., description="URL to preview")):
+    try:
+        data = await fetch_link_preview(url)
+        return data
+    except Exception as e:
+        raise HTTPException(status_code=400, detail=f"Failed to fetch link preview: {str(e)}") 

apps/api/src/services/utils/link_preview.py

@@ -0,0 +1,70 @@
+import httpx
+from bs4 import BeautifulSoup, Tag
+from typing import Optional, Dict
+from urllib.parse import urljoin, urlparse
+
+async def fetch_link_preview(url: str) -> Dict[str, Optional[str]]:
+    async with httpx.AsyncClient(follow_redirects=True, timeout=10) as client:
+        response = await client.get(url)
+        response.raise_for_status()
+        html = response.text
+
+    soup = BeautifulSoup(html, 'html.parser')
+
+    def get_meta(property_name: str, attr: str = 'property') -> Optional[str]:
+        tag = soup.find('meta', attrs={attr: property_name})
+        if tag and isinstance(tag, Tag) and tag.has_attr('content'):
+            content = tag['content']
+            if isinstance(content, str):
+                return content
+        return None
+
+    # Title
+    title = soup.title.string.strip() if soup.title and soup.title.string else None
+    # Description
+    description = get_meta('og:description') or get_meta('description', 'name')
+    # OG Image
+    og_image = get_meta('og:image')
+    if og_image and isinstance(og_image, str) and not og_image.startswith('http'):
+        og_image = urljoin(url, og_image)
+    # Favicon (robust)
+    favicon = None
+    icon_rels = [
+        'icon',
+        'shortcut icon',
+        'apple-touch-icon',
+        'apple-touch-icon-precomposed',
+    ]
+    for link in soup.find_all('link'):
+        if not isinstance(link, Tag):
+            continue
+        rels = link.get('rel')
+        href = link.get('href')
+        if rels and href:
+            rels_lower = [r.lower() for r in rels]
+            if any(rel in rels_lower for rel in icon_rels):
+                if isinstance(href, str):
+                    favicon = href
+                    break
+    # Fallback to /favicon.ico if not found
+    if not favicon:
+        parsed = urlparse(url)
+        favicon = f"{parsed.scheme}://{parsed.netloc}/favicon.ico"
+    elif favicon and not favicon.startswith('http'):
+        favicon = urljoin(url, favicon)
+    # OG Title
+    og_title = get_meta('og:title')
+    # OG Type
+    og_type = get_meta('og:type')
+    # OG URL
+    og_url = get_meta('og:url')
+
+    return {
+        'title': og_title or title,
+        'description': description,
+        'og_image': og_image,
+        'favicon': favicon,
+        'og_type': og_type,
+        'og_url': og_url or url,
+        'url': url,
+    }