soulsync/webui/static/video/video-side.js

/*
 * SoulSync — Video side shell controller.
 *
 * ISOLATION CONTRACT: the music side never imports or references anything here.
 * This file is a self-contained IIFE (no globals) wired entirely via
 * addEventListener (no inline onclick), so it cannot affect the music side and
 * a merge can't touch it. It only drives shared SHELL behaviour:
 *   - the Music ↔ Video header toggle (+ remembers the side in localStorage)
 *   - showing/hiding the video sidebar nav vs the music nav (CSS does the work
 *     off body[data-side]; this just flips the attribute)
 *   - a placeholder content host for the video pages (real pages land later)
 *
 * The actual video domain (data model, services, pages, DB) lives elsewhere and
 * is built on top of this shell.
 */
(function () {
    'use strict';

    // Captured at SCRIPT-EVAL time — before music's router boots (on
    // DOMContentLoaded) and may rewrite an unknown /video-detail/... URL to
    // /dashboard. This is the real path the user reloaded/deep-linked.
    var BOOT_PATH = window.location.pathname;

    var SIDE_KEY = 'soulsync_side';
    var MUSIC_SUBTITLE = 'Music Sync & Manager';
    var VIDEO_SUBTITLE = 'Movies, TV & YouTube';
    var DEFAULT_VIDEO_PAGE = 'video-dashboard';

    // ── URL routing — REAL links, mirroring music's /artist-detail/<source>/<id>.
    // A drill-in is a genuine <a href="/video-detail/<source>/<kind>/<id>"> so
    // reload / Back / Forward / open-in-new-tab all work. ``source`` is 'library'
    // (a video.db id) today; 'tmdb' (a search result not yet in the library) later.
    var DETAIL_BASE = '/video-detail/';
    var DETAIL_PAGES = { 'video-show-detail': 1, 'video-movie-detail': 1, 'video-person-detail': 1 };

    function buildDetailPath(source, kind, id) {
        return DETAIL_BASE + encodeURIComponent(source || 'library') + '/' + kind + '/' + id;
    }
    function parseDetailPath(pathname) {
        if (!pathname || pathname.indexOf(DETAIL_BASE) !== 0) return null;
        var p = pathname.slice(DETAIL_BASE.length).split('/').filter(Boolean);
        if (p.length < 3) return null;
        var kind = p[1], id = parseInt(p[2], 10);
        if ((kind !== 'movie' && kind !== 'show' && kind !== 'person') || isNaN(id)) return null;
        return { source: decodeURIComponent(p[0]), kind: kind, id: id };
    }
    // Restore a detail from the URL (popstate / initial load) WITHOUT re-pushing.
    function restoreDetail(r) {
        if (readSide() !== 'video') { persistSide('video'); applySide('video'); }
        document.dispatchEvent(new CustomEvent('soulsync:video-open-detail',
            { detail: { kind: r.kind, id: r.id, source: r.source, _restore: true } }));
    }
    function onPopState() {
        var r = parseDetailPath(window.location.pathname);
        if (r) { restoreDetail(r); return; }
        // Left the detail URL — if we're still on the video side showing a detail,
        // fall back to the library (Back out of the detail).
        if (document.body.getAttribute('data-side') === 'video' &&
            DETAIL_PAGES[document.body.getAttribute('data-video-page')]) {
            navigate('video-library');
        }
    }

    // The video sidebar pages. Pages flagged shared: true are "same as music"
    // (Import / Issues / Help) — wired to reuse the music pages in a later step;
    // for now every page renders the placeholder.
    var VIDEO_PAGES = [
        { id: 'video-dashboard', label: 'Dashboard' },
        { id: 'video-search', label: 'Search' },
        { id: 'video-discover', label: 'Discover' },
        { id: 'video-library', label: 'Library' },
        { id: 'video-watchlist', label: 'Watchlist' },
        { id: 'video-wishlist', label: 'Wishlist' },
        { id: 'video-downloads', label: 'Downloads' },
        { id: 'video-calendar', label: 'Calendar' },
        { id: 'video-tools', label: 'Tools' },
        { id: 'video-import', label: 'Import', shared: true },
        { id: 'video-settings', label: 'Settings' },
        { id: 'video-issues', label: 'Issues', shared: true },
        { id: 'video-help', label: 'Help & Docs', shared: true },
        // Drill-in detail pages — reachable from cards, not the sidebar nav.
        { id: 'video-show-detail', label: 'Show' },
        { id: 'video-movie-detail', label: 'Movie' },
        { id: 'video-person-detail', label: 'Person' },
    ];

    // "Shared" video pages reuse the REAL music page (shown identically on the
    // video side for now) instead of a video subpage: video page id -> music
    // page id. CSS reveals the music page; we trigger its loader once shown.
    var SHARED_PAGES = { 'video-settings': 'settings' };

    function readSide() {
        try {
            return localStorage.getItem(SIDE_KEY) === 'video' ? 'video' : 'music';
        } catch (e) {
            return 'music';
        }
    }

    function persistSide(side) {
        try { localStorage.setItem(SIDE_KEY, side); } catch (e) { /* ignore */ }
    }

    function pageMeta(pageId) {
        for (var i = 0; i < VIDEO_PAGES.length; i++) {
            if (VIDEO_PAGES[i].id === pageId) return VIDEO_PAGES[i];
        }
        return VIDEO_PAGES[0];
    }

    function setActiveNav(pageId) {
        var navButtons = document.querySelectorAll('.video-nav .nav-button[data-video-page]');
        for (var i = 0; i < navButtons.length; i++) {
            navButtons[i].classList.toggle(
                'active', navButtons[i].getAttribute('data-video-page') === pageId);
        }
    }

    function renderPlaceholder(slot, meta) {
        // Built from our own static constants only — no user input.
        var h2 = document.createElement('h2');
        h2.className = 'header-title';
        var span = document.createElement('span');
        span.textContent = 'Video · ' + meta.label;
        h2.appendChild(span);
        var note = document.createElement('p');
        note.className = 'video-placeholder-note';
        note.textContent = 'The ' + meta.label + ' page for the video side is coming soon.';
        slot.textContent = '';
        slot.appendChild(h2);
        slot.appendChild(note);
    }

    // Show one video page: reveal its built .video-subpage if one exists, else
    // fall back to the placeholder slot. Then announce it so per-page data
    // modules (e.g. video-dashboard.js) can populate themselves — they listen
    // for this event instead of being called directly, keeping each isolated.
    function showPage(pageId) {
        var meta = pageMeta(pageId);
        // Drives the CSS that reveals shared music pages (e.g. Settings) and
        // hides the video host for them.
        document.body.setAttribute('data-video-page', meta.id);

        var sharedMusicId = SHARED_PAGES[meta.id];
        if (sharedMusicId) {
            // The real music page is shown by CSS; load its data the same way a
            // music-side navigation would. (loadPageData is a shared global.)
            if (typeof loadPageData === 'function') loadPageData(sharedMusicId);
            document.dispatchEvent(new CustomEvent('soulsync:video-page-shown', { detail: meta.id }));
            return;
        }

        var host = document.getElementById('video-page-host');
        if (!host) return;
        var matched = null;
        var subpages = host.querySelectorAll('.video-subpage');
        for (var i = 0; i < subpages.length; i++) {
            var isMatch = subpages[i].getAttribute('data-video-subpage') === meta.id;
            subpages[i].hidden = !isMatch;
            if (isMatch) matched = subpages[i];
        }
        var slot = document.getElementById('video-placeholder-slot');
        if (slot) {
            slot.hidden = !!matched;
            if (!matched) renderPlaceholder(slot, meta);
        }
        document.dispatchEvent(new CustomEvent('soulsync:video-page-shown', { detail: meta.id }));
    }

    function navigate(pageId) {
        setActiveNav(pageId);
        showPage(pageId);
        // Moving off a detail via the sidebar/nav drops the detail URL so a reload
        // doesn't re-open it (detail pages keep their own URL via pushState).
        if (!DETAIL_PAGES[pageId] && parseDetailPath(window.location.pathname)) {
            try { history.replaceState(null, '', '/'); } catch (e) { /* ignore */ }
        }
    }

    function applySide(side) {
        document.body.setAttribute('data-side', side);
        var subtitle = document.querySelector('.sidebar-header .app-subtitle');
        if (subtitle) subtitle.textContent = side === 'video' ? VIDEO_SUBTITLE : MUSIC_SUBTITLE;
        var toggleButtons = document.querySelectorAll('.side-toggle-btn');
        for (var i = 0; i < toggleButtons.length; i++) {
            toggleButtons[i].classList.toggle(
                'active', toggleButtons[i].getAttribute('data-side-target') === side);
        }
        if (side === 'video') {
            var active = document.querySelector('.video-nav .nav-button.active');
            navigate(active ? active.getAttribute('data-video-page') : DEFAULT_VIDEO_PAGE);
        }
    }

    function switchSide(side) {
        if (side !== 'music' && side !== 'video') return;
        persistSide(side);
        applySide(side);
        if (side === 'music' && parseDetailPath(window.location.pathname)) {
            try { history.replaceState(null, '', '/'); } catch (e) { /* ignore */ }
        }
    }

    function init() {
        // Deep-linked detail path captured at eval time (music may already have
        // rewritten window.location to /dashboard by now).
        var bootDetail = parseDetailPath(BOOT_PATH);

        var toggleButtons = document.querySelectorAll('.side-toggle-btn');
        for (var i = 0; i < toggleButtons.length; i++) {
            (function (btn) {
                btn.addEventListener('click', function () {
                    switchSide(btn.getAttribute('data-side-target'));
                });
            })(toggleButtons[i]);
        }

        var navButtons = document.querySelectorAll('.video-nav .nav-button[data-video-page]');
        for (var j = 0; j < navButtons.length; j++) {
            (function (btn) {
                btn.addEventListener('click', function (e) {
                    e.preventDefault();
                    navigate(btn.getAttribute('data-video-page'));
                });
            })(navButtons[j]);
        }

        // In-page jumps (e.g. dashboard Quick Action tiles) navigate the same
        // way as the sidebar nav, via data-video-goto. No inline onclick.
        var gotos = document.querySelectorAll('[data-video-goto]');
        for (var k = 0; k < gotos.length; k++) {
            (function (el) {
                el.addEventListener('click', function (e) {
                    e.preventDefault();
                    navigate(el.getAttribute('data-video-goto'));
                });
            })(gotos[k]);
        }

        // Drill-in: a card fires soulsync:video-open-detail {kind, id, source}. We
        // navigate to the matching detail subpage (video-detail.js loads the data)
        // and push a real URL — unless we're restoring from the URL (_restore).
        document.addEventListener('soulsync:video-open-detail', function (e) {
            var d = e && e.detail; if (!d) return;
            if (d.kind === 'movie') navigate('video-movie-detail');
            else if (d.kind === 'show') navigate('video-show-detail');
            else if (d.kind === 'person') navigate('video-person-detail');
            else return;
            if (!d._restore) {
                var path = buildDetailPath(d.source, d.kind, d.id);
                if (window.location.pathname !== path) {
                    history.pushState({ videoDetail: { kind: d.kind, id: d.id, source: d.source || 'library' } },
                        '', path);
                }
            }
        });

        // The detail "← Library" back button is real Back (returns to wherever you
        // drilled in from); falls back to the library if there's no in-app history.
        document.addEventListener('click', function (e) {
            var back = e.target.closest('[data-video-detail-back]');
            if (!back) return;
            e.preventDefault();
            if (history.state && history.state.videoDetail) history.back();
            else navigate('video-library');
        });

        window.addEventListener('popstate', onPopState);

        var defaultNav = document.querySelector(
            '.video-nav .nav-button[data-video-page="' + DEFAULT_VIDEO_PAGE + '"]');
        if (defaultNav) defaultNav.classList.add('active');

        applySide(bootDetail ? 'video' : readSide());

        // Deep link / reload straight to a detail URL → restore it. Deferred to a
        // macrotask so EVERY script's DOMContentLoaded handler has registered
        // first (video-detail.js loads after us and must be listening for the
        // open-detail event), and so it lands AFTER music's initial routing — then
        // we re-assert the real URL it clobbered.
        if (bootDetail) {
            var bootPath = buildDetailPath(bootDetail.source, bootDetail.kind, bootDetail.id);
            var reassert = function () {
                // Re-assert the URL only while we're still showing this detail (so a
                // late async music redirect can't strand us on /dashboard) — never
                // fights real navigation away.
                if (DETAIL_PAGES[document.body.getAttribute('data-video-page')] &&
                    window.location.pathname !== bootPath) {
                    try { history.replaceState({ videoDetail: bootDetail }, '', bootPath); } catch (e) { /* ignore */ }
                }
            };
            setTimeout(function () {
                reassert();
                restoreDetail(bootDetail);
                [120, 350, 700].forEach(function (ms) { setTimeout(reassert, ms); });
            }, 0);
        }
    }

    if (document.readyState === 'loading') {
        document.addEventListener('DOMContentLoaded', init);
    } else {
        init();
    }
})();