"""playback_sources.animated_thumbnail_url — animowane miniaturki dla hold-to-preview

Revision ID: 0004_animated_thumbnail
Revises: 0003_playback_dead
Create Date: 2026-05-04

Mobile (`ScenesScreen`, `MergeQueueScreen`) ma hold-to-preview: po przytrzymaniu kciuka
na thumbie pokazuje animowany webp/gif zamiast statycznego obrazka. Pole jest opcjonalne —
nie każde źródło tube je dostarcza; jeśli null → mobile fallbackuje do `thumbnail_url`.

Bez tej kolumny endpointy które ją zwracały (admin merge-candidates, scene detail) musiały
być sztucznie ograniczane (vide DEPLOY_BACKLOG.md). Po tej migracji można wrócić do
pełnej projekcji w `app/api/admin.py`.
"""
from collections.abc import Sequence

import sqlalchemy as sa
from alembic import op

revision: str = "0004_animated_thumbnail"
down_revision: str | None = "0003_playback_dead"
branch_labels: str | Sequence[str] | None = None
depends_on: str | Sequence[str] | None = None


def upgrade() -> None:
    op.add_column(
        "playback_sources",
        sa.Column("animated_thumbnail_url", sa.String(length=2048), nullable=True),
    )


def downgrade() -> None:
    op.drop_column("playback_sources", "animated_thumbnail_url")
