Function addTrackToLibrary

static/js/catalog.js:250–284

(track)

// ─── Track management ───

export function addTrackToLibrary(track) {
  // track: { id, title, channel, thumb, stems, status, sourceUrl }
  const existingId = findTrackBySource(track.sourceUrl, track.id);
  if (existingId) {
    const trash = getTrashFolder();
    const inTrash = trash?.items.includes(existingId);
    if (inTrash) {
      // Old track was trashed — delete it silently so the new import lands
      // in the library instead of inheriting the trash placement.
      delete tracks[existingId];
      for (const f of folders) f.items = f.items.filter((id) => id !== existingId);
    } else {
      replaceTrackId(existingId, track.id);
    }
  }
  const existing = tracks[track.id] || {};
  tracks[track.id] = {
    ...existing,
    ...track,
    createdAt: existing.createdAt ?? track.createdAt ?? (Date.now() / 1000),
    favorite: existing.favorite ?? false,
  };
  const alreadyPlaced = folders.some((folder) => folder.items.includes(track.id));
  if (!alreadyPlaced) {
    // Put into first non-trash folder or create an "Unsorted" folder.
    let target = folders.find((folder) => folder.id !== TRASH_ID);
    if (!target) {
      target = makeFolder({ id: "f-unsorted", name: "Unsorted" });
      folders.unshift(target);
    }
    target.items.unshift(track.id);
  }
  saveState();
  render();
}

export function updateTrackStatus(trackId, status) {
  if (tracks[trackId]) {