feat: telegram commands, app settings, bot polling, webhook handling, UI improvements

Adds telegram bot command system with 13 commands (search, latest, random, etc.),
webhook/polling handlers, rate limiting, app settings page, and various UI/UX
improvements across all entity pages.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

packages/server/src/notify_bridge_server/api/template_configs.py

@@ -1,5 +1,7 @@
 """Template configuration CRUD API routes."""
 
+import logging
+
 from fastapi import APIRouter, Depends, HTTPException, status
 from pydantic import BaseModel
 from sqlmodel import select
@@ -11,103 +13,12 @@ from jinja2 import TemplateSyntaxError, UndefinedError, StrictUndefined
 from ..auth.dependencies import get_current_user
 from ..database.engine import get_session
 from ..database.models import TemplateConfig, User
+from ..services.sample_context import _SAMPLE_CONTEXT
+
+_LOGGER = logging.getLogger(__name__)
 
 router = APIRouter(prefix="/api/template-configs", tags=["template-configs"])
 
-# Sample asset matching what build_asset_detail() actually returns
-_SAMPLE_ASSET = {
-    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-    "filename": "IMG_001.jpg",
-    "type": "IMAGE",
-    "created_at": "2026-03-19T10:30:00",
-    "owner": "Alice",
-    "owner_id": "user-uuid-1",
-    "description": "Family picnic",
-    "people": ["Alice", "Bob"],
-    "is_favorite": True,
-    "rating": 5,
-    "latitude": 48.8566,
-    "longitude": 2.3522,
-    "city": "Paris",
-    "state": "Ile-de-France",
-    "country": "France",
-    "url": "https://immich.example.com/photos/abc123",
-    "public_url": "https://immich.example.com/share/abc123/photos/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
-    "download_url": "https://immich.example.com/api/assets/abc123/original",
-    "photo_url": "https://immich.example.com/api/assets/abc123/thumbnail",
-}
-
-_SAMPLE_VIDEO_ASSET = {
-    **_SAMPLE_ASSET,
-    "id": "d4e5f6a7-b8c9-0123-defg-456789abcdef",
-    "filename": "VID_002.mp4",
-    "type": "VIDEO",
-    "is_favorite": False,
-    "rating": None,
-    "photo_url": None,
-    "public_url": "https://immich.example.com/share/abc123/photos/d4e5f6a7-b8c9-0123-defg-456789abcdef",
-    "playback_url": "https://immich.example.com/api/assets/def456/video",
-}
-
-_SAMPLE_COLLECTION = {
-    "name": "Family Photos",
-    "url": "https://immich.example.com/share/abc123",
-    "public_url": "https://immich.example.com/share/abc123",
-    "asset_count": 42,
-    "shared": True,
-}
-
-# Full context covering ALL possible template variables
-_SAMPLE_CONTEXT = {
-    # Core event fields (always present)
-    "collection_id": "b2eeeaa4-bba0-477a-a06f-5cb9e21818e8",
-    "collection_name": "Family Photos",
-    "collection_url": "https://immich.example.com/share/abc123",
-    "event_type": "assets_added",
-    "timestamp": "2026-03-19T10:30:00+00:00",
-    "service_name": "Immich",
-    "service_type": "immich",
-    # Immich aliases (always present alongside collection_*)
-    "album_name": "Family Photos",
-    "album_id": "b2eeeaa4-bba0-477a-a06f-5cb9e21818e8",
-    "album_url": "https://immich.example.com/share/abc123",
-    "old_album_name": "Old Album",
-    "new_album_name": "New Album",
-    "change_type": "assets_added",
-    "added_count": 3,
-    "removed_count": 1,
-    "added_assets": [_SAMPLE_ASSET, _SAMPLE_VIDEO_ASSET],
-    "removed_assets": ["asset-id-1", "asset-id-2"],
-    "people": ["Alice", "Bob"],
-    "shared": True,
-    "target_type": "telegram",
-    "has_videos": True,
-    "has_photos": True,
-    # Rename fields (always present, empty for non-rename events)
-    "old_name": "Old Album",
-    "new_name": "New Album",
-    "old_shared": False,
-    "new_shared": True,
-    # Public share URLs (may be empty if no shared link exists)
-    "public_url": "https://immich.example.com/share/abc123",
-    "protected_url": "",
-    "album_url": "https://immich.example.com/albums/b2eeeaa4",
-    # Common date/location (set when all assets share the same value)
-    "common_date": "19.03.2026",
-    "common_location": "Paris, France",
-    # Date format strings (from template config)
-    "date_format": "%d.%m.%Y, %H:%M UTC",
-    "date_only_format": "%d.%m.%Y",
-    # Scheduled/periodic variables (for those templates)
-    "collections": [_SAMPLE_COLLECTION, {**_SAMPLE_COLLECTION, "name": "Vacation 2025", "asset_count": 120}],
-    "albums": [_SAMPLE_COLLECTION, {**_SAMPLE_COLLECTION, "name": "Vacation 2025", "asset_count": 120}],
-    "assets": [_SAMPLE_ASSET, {**_SAMPLE_ASSET, "id": "x1y2z3", "filename": "IMG_002.jpg", "city": "London", "country": "UK", "public_url": "https://immich.example.com/share/abc123/photos/x1y2z3"}],
-    "date": "2026-03-19",
-    "photo_count": 30,
-    "video_count": 5,
-    "owner": "Alice",
-}
-
 
 class TemplateConfigCreate(BaseModel):
     provider_type: str
@@ -335,6 +246,32 @@ async def preview_config(
         raise HTTPException(status_code=400, detail=f"Template error: {e}")
 
 
+class DateFormatPreviewRequest(BaseModel):
+    date_format: str = "%d.%m.%Y, %H:%M UTC"
+    date_only_format: str = "%d.%m.%Y"
+
+
+@router.post("/preview-date-format")
+async def preview_date_format(
+    body: DateFormatPreviewRequest,
+    user: User = Depends(get_current_user),
+):
+    """Preview what date/datetime formats look like with sample data."""
+    from datetime import datetime, timezone
+    sample_dt = datetime(2026, 3, 19, 14, 30, 0, tzinfo=timezone.utc)
+    sample_date = datetime(2026, 3, 19)
+    result: dict[str, str | None] = {}
+    for key, fmt, sample in [
+        ("date_format", body.date_format, sample_dt),
+        ("date_only_format", body.date_only_format, sample_date),
+    ]:
+        try:
+            result[key] = sample.strftime(fmt)
+        except (ValueError, TypeError):
+            result[key] = None
+    return result
+
+
 class PreviewRequest(BaseModel):
     template: str
     target_type: str = "telegram"  # "telegram" or "webhook"