feat: UX & notification improvements — icons, events, chat names, link validation, templates

- Show entity icons on all cards with fallback defaults (providers, trackers, targets, bots)
- Enrich EventLog with provider_name, tracker_name, assets_count; add DB migration
- Dashboard events: filtering (type, provider, search), sorting, pagination, dynamic page size
- Friendly chat names on telegram target cards (resolve from TelegramChat table)
- Test message button on bot chat items with locale-aware messages
- Album public link validation on tracker save with auto-create dialog
- Support albums without public links: conditional <a href> in templates
- Fetch shared links during poll, enrich events with public_url/protected_url
- Per-asset public_url in template context ({share_url}/photos/{asset_id})
- Common date/location detection: common_date + common_location context vars
- Dual date formats: date_format (datetime) + date_only_format (date only)
- Template clone button, HTML link rendering in template preview
- Fix Telegram asset download 401: pass x-api-key headers through client
- Fix provider external_url matching for API key scoping
- Fix event timestamp timezone (append Z suffix for UTC)
- Localize event filter controls, test messages (EN/RU)
- Template variable UI helpers updated with all new fields
- CLAUDE.md: template system sync rules documentation

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

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

@@ -32,6 +32,7 @@ _SAMPLE_ASSET = {
     "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",
 }
@@ -44,12 +45,14 @@ _SAMPLE_VIDEO_ASSET = {
     "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,
 }
@@ -85,10 +88,24 @@ _SAMPLE_CONTEXT = {
     "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}],
-    "assets": [_SAMPLE_ASSET, {**_SAMPLE_ASSET, "filename": "IMG_002.jpg", "city": "London", "country": "UK"}],
+    "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",
 }
 
 
@@ -106,6 +123,7 @@ class TemplateConfigCreate(BaseModel):
     scheduled_assets_message: str | None = None
     memory_mode_message: str | None = None
     date_format: str | None = None
+    date_only_format: str | None = None
 
 
 TemplateConfigUpdate = TemplateConfigCreate  # Same shape, all optional
@@ -142,10 +160,15 @@ async def get_template_variables():
         "collection_id": "Collection ID (UUID)",
         "collection_name": "Collection name",
         "collection_url": "Public share URL (empty if not shared)",
+        "public_url": "Public share link URL (empty if no link exists)",
+        "protected_url": "Password-protected share link URL (empty if none)",
         "added_count": "Number of assets added",
         "removed_count": "Number of assets removed",
         "people": "Detected people names (list, use {{ people | join(', ') }})",
         "shared": "Whether collection is shared (boolean)",
+        "photo_count": "Total photo count in album",
+        "video_count": "Total video count in album",
+        "owner": "Album owner name",
         "target_type": "Target type: 'telegram' or 'webhook'",
         "has_videos": "Whether added assets contain videos (boolean)",
         "has_photos": "Whether added assets contain photos (boolean)",
@@ -177,6 +200,7 @@ async def get_template_variables():
         "city": "City name",
         "state": "State/region name",
         "country": "Country name",
+        "public_url": "Per-asset public share URL (empty if no album link)",
         "url": "Public viewer URL (if shared)",
         "download_url": "Direct download URL (if shared)",
         "photo_url": "Preview image URL (images only, if shared)",
@@ -185,6 +209,7 @@ async def get_template_variables():
     album_fields = {
         "name": "Collection/album name",
         "url": "Share URL",
+        "public_url": "Public share link URL",
         "asset_count": "Total assets in collection",
         "shared": "Whether collection is shared",
     }
@@ -196,7 +221,12 @@ async def get_template_variables():
     return {
         "message_assets_added": {
             "description": "Notification when new assets are added to a collection",
-            "variables": {**event_vars, "added_assets": "List of asset dicts (use {% for asset in added_assets %})"},
+            "variables": {
+                **event_vars,
+                "added_assets": "List of asset dicts (use {% for asset in added_assets %})",
+                "common_date": "Shared date if all assets have the same date (formatted via date_only_format, empty otherwise)",
+                "common_location": "Shared location if all assets are from the same place (e.g. 'Paris, France', empty otherwise)",
+            },
             "asset_fields": asset_fields,
         },
         "message_assets_removed": {
@@ -308,6 +338,8 @@ async def preview_config(
 class PreviewRequest(BaseModel):
     template: str
     target_type: str = "telegram"  # "telegram" or "webhook"
+    date_format: str = "%d.%m.%Y, %H:%M UTC"
+    date_only_format: str = "%d.%m.%Y"
 
 
 @router.post("/preview-raw")
@@ -334,7 +366,14 @@ async def preview_raw(
 
     # Pass 2: render with strict undefined to catch unknown variables
     try:
-        ctx = {**_SAMPLE_CONTEXT, "target_type": body.target_type}
+        from datetime import datetime
+        ctx = {**_SAMPLE_CONTEXT, "target_type": body.target_type,
+               "date_format": body.date_format, "date_only_format": body.date_only_format}
+        # Format common_date using the provided date_only_format
+        try:
+            ctx["common_date"] = datetime(2026, 3, 19).strftime(body.date_only_format)
+        except (ValueError, TypeError):
+            ctx["common_date"] = "19.03.2026"
         strict_env = SandboxedEnvironment(autoescape=False, undefined=StrictUndefined)
         tmpl = strict_env.from_string(body.template)
         rendered = tmpl.render(**ctx)