siftlode/frontend/src/components/Channels.tsx

import { useState } from "react";
import { Trans, useTranslation } from "react-i18next";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import {
  ArrowDown,
  ArrowUp,
  Check,
  ExternalLink,
  Eye,
  EyeOff,
  History,
  Plus,
  RefreshCw,
  UserMinus,
  X,
} from "lucide-react";
import { api, HttpError, type ManagedChannel, type Tag } from "../lib/api";
import { formatEta } from "../lib/format";
import { notify } from "../lib/notifications";
import Tooltip from "./Tooltip";
import Avatar from "./Avatar";
import DataTable, { type Column } from "./DataTable";
import { useConfirm } from "./ConfirmProvider";

export type ChannelStatusFilter = "all" | "needs_full" | "fully_synced" | "hidden";

const STATUS_FILTERS: { id: ChannelStatusFilter; labelKey: string }[] = [
  { id: "all", labelKey: "channels.filters.all" },
  { id: "needs_full", labelKey: "channels.filters.needsFull" },
  { id: "fully_synced", labelKey: "channels.filters.fullySynced" },
  { id: "hidden", labelKey: "channels.filters.hidden" },
];

export default function Channels({
  canWrite,
  isAdmin,
  onViewChannel,
  statusFilter,
  setStatusFilter,
  onOpenWizard,
}: {
  canWrite: boolean;
  isAdmin: boolean;
  onViewChannel: (id: string, name: string) => void;
  statusFilter: ChannelStatusFilter;
  setStatusFilter: (f: ChannelStatusFilter) => void;
  onOpenWizard: () => void;
}) {
  const { t } = useTranslation();
  const qc = useQueryClient();
  const confirm = useConfirm();

  // A YouTube-gated action (sync, backfill, unsubscribe) that 403s means the user hasn't
  // granted the needed scope — surface that with a "Connect" action instead of a vague fail.
  const notifyActionError = (err: unknown, fallbackKey: string) => {
    if (err instanceof HttpError && err.status === 403) {
      notify({
        level: "error",
        message: t("channels.notify.needYouTube"),
        action: { label: t("channels.notify.connect"), onClick: onOpenWizard },
      });
    } else {
      notify({ level: "error", message: t(fallbackKey) });
    }
  };
  const channelsQuery = useQuery({ queryKey: ["channels"], queryFn: api.channels });
  const tagsQuery = useQuery({ queryKey: ["tags"], queryFn: api.tags });
  const statusQuery = useQuery({ queryKey: ["my-status"], queryFn: api.myStatus });
  const [newTag, setNewTag] = useState("");

  const invalidate = () => {
    qc.invalidateQueries({ queryKey: ["channels"] });
    qc.invalidateQueries({ queryKey: ["tags"] });
    qc.invalidateQueries({ queryKey: ["my-status"] });
  };

  const userTags = (tagsQuery.data ?? []).filter((t) => !t.system);

  const patch = useMutation({
    mutationFn: (v: {
      id: string;
      body: { priority?: number; hidden?: boolean; deep_requested?: boolean };
    }) => api.updateChannel(v.id, v.body),
    // Requesting full history may have just pulled in a channel's recent uploads, so
    // refresh the per-user status and feed too — not only the channel list.
    onSuccess: () => {
      qc.invalidateQueries({ queryKey: ["channels"] });
      qc.invalidateQueries({ queryKey: ["my-status"] });
      qc.invalidateQueries({ queryKey: ["feed"] });
      qc.invalidateQueries({ queryKey: ["feed-count"] });
    },
  });
  // Priority is updated optimistically in place and NOT re-sorted/refetched, so the list
  // doesn't jump (the server list is priority-sorted; refetching would reorder rows and
  // lose your scroll position). The new order takes effect next time the page loads.
  const bumpPriority = (id: string, current: number, delta: number) => {
    const next = current + delta;
    qc.setQueryData<ManagedChannel[]>(["channels"], (old) =>
      (old ?? []).map((ch) => (ch.id === id ? { ...ch, priority: next } : ch))
    );
    api
      .updateChannel(id, { priority: next })
      .catch(() => qc.invalidateQueries({ queryKey: ["channels"] }));
  };

  // Tagging is updated optimistically in place (no refetch of the whole channel list, which
  // made the toggle feel ~2s slow); only revert by refetching if the server call fails.
  const toggleTag = (id: string, tagId: number, hasTag: boolean) => {
    qc.setQueryData<ManagedChannel[]>(["channels"], (old) =>
      (old ?? []).map((ch) =>
        ch.id === id
          ? {
              ...ch,
              tag_ids: hasTag
                ? ch.tag_ids.filter((x) => x !== tagId)
                : [...ch.tag_ids, tagId],
            }
          : ch
      )
    );
    const call = hasTag
      ? api.detachChannelTag(id, tagId)
      : api.attachChannelTag(id, tagId);
    call.catch(() => qc.invalidateQueries({ queryKey: ["channels"] }));
  };
  const syncSubs = useMutation({
    mutationFn: () => api.syncSubscriptions(),
    onSuccess: (r: { subscriptions?: number }) => {
      invalidate();
      notify({ level: "success", message: t("channels.notify.synced", { count: r.subscriptions ?? 0 }) });
    },
    onError: (e) => notifyActionError(e, "channels.notify.syncFailed"),
  });
  const createTag = useMutation({
    mutationFn: (name: string) => api.createTag({ name, category: "other" }),
    onSuccess: () => {
      setNewTag("");
      qc.invalidateQueries({ queryKey: ["tags"] });
    },
  });
  const deleteTag = useMutation({
    mutationFn: (id: number) => api.deleteTag(id),
    onSuccess: () => invalidate(),
  });
  const unsubscribe = useMutation({
    mutationFn: (id: string) => api.unsubscribeChannel(id),
    onSuccess: () => {
      qc.invalidateQueries({ queryKey: ["channels"] });
      qc.invalidateQueries({ queryKey: ["my-status"] });
      notify({ level: "success", message: t("channels.notify.unsubscribed") });
    },
    onError: (e) => notifyActionError(e, "channels.notify.unsubscribeFailed"),
  });
  const resetBackfill = useMutation({
    mutationFn: (id: string) => api.resetChannelBackfill(id),
    onSuccess: () => {
      qc.invalidateQueries({ queryKey: ["channels"] });
      qc.invalidateQueries({ queryKey: ["my-status"] });
      notify({ level: "success", message: t("channels.notify.resetDone") });
    },
    onError: (e) => notifyActionError(e, "channels.notify.resetFailed"),
  });
  const deepAll = useMutation({
    mutationFn: () => api.deepAll(true),
    onSuccess: (r: { updated?: number }) => {
      qc.invalidateQueries({ queryKey: ["channels"] });
      qc.invalidateQueries({ queryKey: ["my-status"] });
      notify({
        level: "success",
        message: t("channels.notify.fullHistoryRequested", { count: r.updated ?? 0 }),
      });
    },
    onError: (e) => notifyActionError(e, "channels.notify.fullHistoryFailed"),
  });

  // The Sync-status filter stays a top-level chip set (not a column filter) because the
  // header's "go to full history" deep-link drives it; the DataTable then handles name
  // search, tag filtering, sort and pagination over whatever the status chip leaves.
  const channels = (channelsQuery.data ?? []).filter((c) =>
    statusFilter === "needs_full"
      ? !c.backfill_done
      : statusFilter === "fully_synced"
        ? c.backfill_done
        : statusFilter === "hidden"
          ? c.hidden
          : true
  );
  const s = statusQuery.data;

  const onView = (c: ManagedChannel) =>
    onViewChannel(c.id, c.title ?? t("channels.row.thisChannel"));
  const onUnsub = async (c: ManagedChannel) => {
    const ok = await confirm({
      title: t("channels.row.unsubscribeOnYoutube"),
      message: t("channels.confirmUnsubscribe", { name: c.title ?? c.id }),
      confirmLabel: t("channels.row.unsubscribeOnYoutube"),
      danger: true,
    });
    if (ok) unsubscribe.mutate(c.id);
  };
  const onReset = async (c: ManagedChannel) => {
    const ok = await confirm({
      title: t("channels.row.backfillThis"),
      message: t("channels.confirmReset", { name: c.title ?? c.id }),
      confirmLabel: t("channels.row.backfillThis"),
    });
    if (ok) resetBackfill.mutate(c.id);
  };

  const columns: Column<ManagedChannel>[] = [
    {
      key: "priority",
      header: t("channels.cols.priority"),
      align: "center",
      width: "56px",
      sortable: true,
      hideInCard: true,
      sortValue: (c) => c.priority,
      render: (c) => <PriorityCell c={c} onPriority={(d) => bumpPriority(c.id, c.priority, d)} />,
    },
    {
      key: "channel",
      header: t("channels.cols.channel"),
      sortable: true,
      sortValue: (c) => (c.title ?? c.id).toLowerCase(),
      filter: { kind: "text", get: (c) => `${c.title ?? ""} ${c.handle ?? ""}` },
      cardPrimary: true,
      render: (c) => <NameCell c={c} onView={() => onView(c)} />,
    },
    {
      key: "stored",
      header: t("channels.cols.stored"),
      align: "right",
      width: "84px",
      sortable: true,
      sortValue: (c) => c.stored_videos,
      render: (c) => <span className="text-muted tabular-nums">{c.stored_videos.toLocaleString()}</span>,
    },
    {
      key: "subs",
      header: t("channels.cols.subs"),
      align: "right",
      width: "92px",
      sortable: true,
      sortValue: (c) => c.subscriber_count ?? -1,
      render: (c) => (
        <span className="text-muted tabular-nums">
          {c.subscriber_count != null ? c.subscriber_count.toLocaleString() : "—"}
        </span>
      ),
    },
    {
      key: "sync",
      header: t("channels.cols.sync"),
      width: "130px",
      cardLabel: false,
      render: (c) => <SyncCell c={c} />,
    },
    {
      key: "tags",
      header: t("channels.cols.tags"),
      width: "360px",
      cardLabel: false,
      filter: {
        kind: "multi",
        options: userTags.map((tg) => ({ value: String(tg.id), label: tg.name })),
        // OR semantics: show channels carrying any of the selected tags.
        test: (c, values) => values.some((v) => c.tag_ids.includes(Number(v))),
      },
      render: (c) => (
        <TagsCell
          c={c}
          userTags={userTags}
          onToggleTag={(tagId) => toggleTag(c.id, tagId, c.tag_ids.includes(tagId))}
        />
      ),
    },
    {
      key: "actions",
      header: t("channels.cols.actions"),
      align: "right",
      width: "104px",
      cardLabel: false,
      render: (c) => (
        <ActionsCell
          c={c}
          isAdmin={isAdmin}
          canWrite={canWrite}
          onHide={() => patch.mutate({ id: c.id, body: { hidden: !c.hidden } })}
          onDeep={() => patch.mutate({ id: c.id, body: { deep_requested: !c.deep_requested } })}
          onReset={() => onReset(c)}
          onUnsubscribe={() => onUnsub(c)}
        />
      ),
    },
  ];

  // Status chips sit in the table's controls row (next to paging) — compact and close to
  // where they act.
  const statusChips = (
    <div className="flex flex-wrap items-center gap-1.5">
      {STATUS_FILTERS.map((f) => (
        <button
          key={f.id}
          onClick={() => setStatusFilter(f.id)}
          className={`text-xs px-2.5 py-1 rounded-full border transition ${
            statusFilter === f.id
              ? "bg-accent text-accent-fg border-accent"
              : "bg-card border-border text-muted hover:border-accent"
          }`}
        >
          {t(f.labelKey)}
        </button>
      ))}
    </div>
  );

  return (
    <div className="p-4 max-w-7xl mx-auto">
      {/* Per-user sync status + catalog-wide actions on one row (search/tags filtering
          now lives in the table headers). */}
      <div className="flex items-start justify-between gap-4 flex-wrap mb-4">
        <div className="flex flex-wrap items-center gap-x-5 gap-y-1 text-sm text-muted">
          {s && (
            <>
              <Stat label={t("channels.stats.channels")} value={s.channels_total} hint={t("channels.stats.channelsHint")} />
              <Stat
                label={t("channels.stats.recentSynced")}
                value={`${s.channels_recent_synced}/${s.channels_total}`}
                hint={t("channels.stats.recentSyncedHint")}
              />
              <Stat
                label={t("channels.stats.fullHistory")}
                value={`${s.channels_deep_done}/${s.channels_deep_requested}`}
                hint={t("channels.stats.fullHistoryHint")}
              />
              {s.deep_pending_count > 0 && (
                <Stat
                  label={t("channels.stats.left")}
                  value={formatEta(s.deep_eta_seconds)}
                  hint={t("channels.stats.leftHint", { count: s.deep_pending_count })}
                />
              )}
              <Stat label={t("channels.stats.myVideos")} value={s.my_videos.toLocaleString()} hint={t("channels.stats.myVideosHint")} />
              <Stat
                label={t("channels.stats.quotaLeft")}
                value={s.quota_remaining_today.toLocaleString()}
                hint={t("channels.stats.quotaLeftHint")}
              />
            </>
          )}
        </div>
        <div className="flex items-center gap-2 shrink-0">
        <Tooltip
          side="bottom"
          hint={t("channels.syncSubscriptionsHint")}
        >
          <button
            onClick={() => syncSubs.mutate()}
            disabled={syncSubs.isPending}
            className="glass-card glass-hover flex items-center gap-2 px-3 py-2 rounded-xl text-sm disabled:opacity-50 transition"
          >
            <RefreshCw className={`w-4 h-4 ${syncSubs.isPending ? "animate-spin" : ""}`} />
            {t("channels.syncSubscriptions")}
          </button>
        </Tooltip>
        <Tooltip
          side="bottom"
          hint={t("channels.backfillEverythingHint")}
        >
          <button
            onClick={() => deepAll.mutate()}
            disabled={deepAll.isPending}
            className="glass-card glass-hover flex items-center gap-2 px-3 py-2 rounded-xl text-sm disabled:opacity-50 transition"
          >
            <History className={`w-4 h-4 ${deepAll.isPending ? "animate-pulse" : ""}`} />
            {t("channels.backfillEverything")}
          </button>
        </Tooltip>
        </div>
      </div>

      <p className="text-xs text-muted mb-4 leading-relaxed">
        <Trans
          i18nKey="channels.intro"
          components={[
            <b className="text-fg/80" />,
            <b className="text-fg/80" />,
            <b className="text-fg/80" />,
          ]}
        />
      </p>

      {/* Your tags */}
      <div className="flex flex-wrap items-center gap-1.5 mb-4">
        <Tooltip hint={t("channels.tags.yourTagsHint")}>
          <span className="text-xs uppercase tracking-wide text-muted mr-1 cursor-help underline decoration-dotted decoration-muted/40 underline-offset-4">
            {t("channels.tags.yourTags")}
          </span>
        </Tooltip>
        {userTags.map((t) => (
          <span
            key={t.id}
            className="inline-flex items-center gap-1 text-xs px-2 py-1 rounded-full bg-card border border-border"
          >
            {t.name}
            <button onClick={() => deleteTag.mutate(t.id)} className="text-muted hover:text-red-400">
              <X className="w-3 h-3" />
            </button>
          </span>
        ))}
        <form
          onSubmit={(e) => {
            e.preventDefault();
            if (newTag.trim()) createTag.mutate(newTag.trim());
          }}
          className="inline-flex items-center gap-1"
        >
          <input
            value={newTag}
            onChange={(e) => setNewTag(e.target.value)}
            placeholder={t("channels.tags.newTag")}
            className="w-24 bg-card border border-border rounded-full px-2.5 py-1 text-xs outline-none focus:border-accent"
          />
          <button type="submit" className="text-muted hover:text-accent" title={t("channels.tags.createTag")}>
            <Plus className="w-4 h-4" />
          </button>
        </form>
      </div>

      {/* Channel table */}
      {channelsQuery.isLoading ? (
        <div className="text-muted py-8">{t("channels.loading")}</div>
      ) : (
        <DataTable
          rows={channels}
          columns={columns}
          rowKey={(c) => c.id}
          persistKey="siftlode.channelsTable"
          controlsPosition="top"
          controlsLeading={statusChips}
          rowClassName={(c) => (c.hidden ? "opacity-60" : "")}
          emptyText={t("channels.empty")}
        />
      )}
    </div>
  );
}

function Stat({
  label,
  value,
  hint,
}: {
  label: string;
  value: string | number;
  hint?: string;
}) {
  return (
    <Tooltip hint={hint ?? ""}>
      <span className={hint ? "cursor-help" : ""}>
        <span className="text-fg font-semibold">{value}</span> {label}
      </span>
    </Tooltip>
  );
}

function SyncBadge({ ok, label, hint }: { ok: boolean; label: string; hint?: string }) {
  return (
    <Tooltip hint={hint ?? ""}>
      <span
        className={`inline-flex items-center gap-1 text-[10px] px-1.5 py-0.5 rounded-full border ${
          ok ? "border-accent/40 text-accent" : "border-border text-muted"
        }`}
      >
        {ok && <Check className="w-3 h-3" />}
        {label}
      </span>
    </Tooltip>
  );
}

function PriorityCell({ c, onPriority }: { c: ManagedChannel; onPriority: (delta: number) => void }) {
  const { t } = useTranslation();
  return (
    <Tooltip hint={t("channels.row.priorityHint")}>
      <div className="inline-flex flex-col items-center cursor-help">
        <button onClick={() => onPriority(1)} className="text-muted hover:text-accent" aria-label={t("channels.row.raisePriority")}>
          <ArrowUp className="w-3.5 h-3.5" />
        </button>
        <span className="text-xs text-muted tabular-nums">{c.priority}</span>
        <button onClick={() => onPriority(-1)} className="text-muted hover:text-accent" aria-label={t("channels.row.lowerPriority")}>
          <ArrowDown className="w-3.5 h-3.5" />
        </button>
      </div>
    </Tooltip>
  );
}

function NameCell({ c, onView }: { c: ManagedChannel; onView: () => void }) {
  const { t } = useTranslation();
  const ytUrl = c.handle
    ? `https://www.youtube.com/@${c.handle.replace(/^@/, "")}`
    : `https://www.youtube.com/channel/${c.id}`;
  return (
    <div className="flex items-center gap-2 min-w-0">
      <Avatar src={c.thumbnail_url} fallback={c.title ?? ""} className="w-8 h-8 rounded-full shrink-0" />
      <button
        onClick={onView}
        onAuxClick={(e) => {
          // Middle-click opens the channel's YouTube page in a new tab; left-click
          // keeps opening the in-app channel detail.
          if (e.button === 1) {
            e.preventDefault();
            window.open(ytUrl, "_blank", "noopener,noreferrer");
          }
        }}
        onMouseDown={(e) => {
          if (e.button === 1) e.preventDefault(); // suppress middle-click autoscroll
        }}
        className="text-sm font-medium truncate hover:text-accent text-left min-w-0"
      >
        {c.title ?? c.id}
      </button>
      <Tooltip hint={t("channels.row.openOnYouTube")}>
        <a
          href={ytUrl}
          target="_blank"
          rel="noopener noreferrer"
          className="text-muted hover:text-accent shrink-0"
          aria-label={t("channels.row.openOnYouTube")}
        >
          <ExternalLink className="w-3.5 h-3.5" />
        </a>
      </Tooltip>
    </div>
  );
}

// Status only — the backfill *action* lives in the Actions column. When both recent and
// full history are in, collapse to a single "fully synced" chip; otherwise show what's
// present plus the missing/queued state.
function SyncCell({ c }: { c: ManagedChannel }) {
  const { t } = useTranslation();
  if (c.recent_synced && c.backfill_done) {
    return <SyncBadge ok label={t("channels.row.fullySynced")} hint={t("channels.row.fullySyncedHint")} />;
  }
  return (
    <div className="flex flex-wrap items-center gap-1">
      <SyncBadge
        ok={c.recent_synced}
        label={t("channels.row.recent")}
        hint={c.recent_synced ? t("channels.row.recentSyncedHint") : t("channels.row.recentNotSyncedHint")}
      />
      {c.backfill_done ? (
        <SyncBadge ok label={t("channels.row.full")} hint={t("channels.row.fullHint")} />
      ) : c.deep_requested ? (
        <SyncBadge ok={false} label={t("channels.row.fullHistoryQueued")} hint={t("channels.row.queuedRequestedHint")} />
      ) : c.deep_in_queue ? (
        <SyncBadge ok={false} label={t("channels.row.fullHistoryComing")} hint={t("channels.row.queuedByOtherHint")} />
      ) : (
        <SyncBadge ok={false} label={t("channels.row.full")} hint={t("channels.row.fullNotFetchedHint")} />
      )}
    </div>
  );
}

function TagsCell({
  c,
  userTags,
  onToggleTag,
}: {
  c: ManagedChannel;
  userTags: Tag[];
  onToggleTag: (tagId: number) => void;
}) {
  if (userTags.length === 0) return null;
  return (
    <div className="flex flex-wrap items-center gap-1">
      {userTags.map((tg) => {
        const on = c.tag_ids.includes(tg.id);
        return (
          <button
            key={tg.id}
            onClick={() => onToggleTag(tg.id)}
            className={`text-[10px] px-1.5 py-0.5 rounded-full border transition ${
              on
                ? "bg-accent text-accent-fg border-accent"
                : "bg-card border-border text-muted hover:border-accent"
            }`}
          >
            {tg.name}
          </button>
        );
      })}
    </div>
  );
}

function ActionsCell({
  c,
  isAdmin,
  canWrite,
  onHide,
  onDeep,
  onReset,
  onUnsubscribe,
}: {
  c: ManagedChannel;
  isAdmin: boolean;
  canWrite: boolean;
  onHide: () => void;
  onDeep: () => void;
  onReset: () => void;
  onUnsubscribe: () => void;
}) {
  const { t } = useTranslation();
  // Admins get a "reset" trigger that re-fetches the channel from scratch regardless of
  // state — always actionable. Regular users get the per-user "request full history" opt-in,
  // which only applies until the back-catalog is in (or already coming for everyone).
  const done = c.backfill_done;
  const requested = !done && c.deep_requested;
  const optInActionable = !done && !c.deep_in_queue;
  const backfillHint = isAdmin
    ? t("channels.row.resetHint")
    : c.deep_in_queue
      ? t("channels.row.queuedByOtherHint")
      : requested
        ? t("channels.row.queuedRequestedHint")
        : done
          ? t("channels.row.fullHint")
          : t("channels.row.backfillThisHint");
  const enabled = isAdmin || optInActionable;
  return (
    <div className="inline-flex items-center gap-2">
      <Tooltip hint={backfillHint}>
        <button
          onClick={!enabled ? undefined : isAdmin ? onReset : onDeep}
          disabled={!enabled}
          className={`shrink-0 transition ${
            requested
              ? "text-accent"
              : enabled
                ? "text-muted hover:text-fg"
                : "text-muted/40 cursor-default"
          }`}
          aria-label={isAdmin ? t("channels.row.resetBackfill") : t("channels.row.backfillThis")}
        >
          <History className="w-4 h-4" />
        </button>
      </Tooltip>
      <Tooltip hint={c.hidden ? t("channels.row.hiddenHint") : t("channels.row.hideHint")}>
        <button onClick={onHide} className="text-muted hover:text-fg shrink-0" aria-label={c.hidden ? t("channels.row.unhide") : t("channels.row.hideFromFeed")}>
          {c.hidden ? <EyeOff className="w-4 h-4" /> : <Eye className="w-4 h-4" />}
        </button>
      </Tooltip>
      {canWrite && (
        <Tooltip hint={t("channels.row.unsubscribeHint")}>
          <button
            onClick={onUnsubscribe}
            className="text-muted hover:text-red-400 shrink-0"
            aria-label={t("channels.row.unsubscribeOnYoutube")}
          >
            <UserMinus className="w-4 h-4" />
          </button>
        </Tooltip>
      )}
    </div>
  );
}