How to Track New Releases from a Record Label

const API_KEY = process.env.SONOVAULT_API_KEY!;
const BASE    = "https://api.sonovault.now/v1";

interface LabelSearchResult {
  id:            number;
  name:          string;
  release_count: number;
}

interface Release {
  id:           number;
  title:        string;
  artist_name:  string;
  release_date: string;
  track_count:  number;
}

interface Track {
  id:      number;
  title:   string;
  isrc:    string | null;
  artists: { name: string; is_primary: boolean }[];
  genres:  { name: string }[];
  release_id:    number;
  release_title: string;
}

async function api(path: string) {
  const res = await fetch(`${BASE}${path}`, {
    headers: { "x-api-key": API_KEY },
  });
  if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
  return res.json();
}

// Step 1: Find the label
const { results } = await api("/labels/search?name=Drumcode");
const label = results[0] as LabelSearchResult;
console.log(`Found: ${label.name} (id: ${label.id}, ${label.release_count} releases)`);

// Step 2: Get the full catalog
const detail = await api(`/labels/${label.id}`);
const releases = detail.releases as Release[];
const tracks   = detail.tracks as Track[];

// Step 3: Show recent releases
console.log(`\nLatest releases from ${label.name}:\n`);
releases.slice(0, 10).forEach((r) => {
  console.log(
    `  ${r.release_date}  ${r.artist_name} — ${r.title} (${r.track_count} tracks)`
  );
});

// Step 4: Show recent tracks with metadata
console.log(`\nLatest tracks:\n`);
tracks.slice(0, 20).forEach((t, i) => {
  const artist = t.artists.find(a => a.is_primary)?.name ?? t.artists[0]?.name;
  const genre  = t.genres[0]?.name ?? "";
  console.log(
    `  ${i + 1}. ${artist} — ${t.title}${genre ? ` [${genre}]` : ""}`
  );
});

import fs from "node:fs";

const LABEL_ID    = 482;  // Drumcode
const STATE_FILE  = "./last-seen.json";

// Load previously seen track IDs
const seen: Set<number> = new Set(
  fs.existsSync(STATE_FILE)
    ? JSON.parse(fs.readFileSync(STATE_FILE, "utf-8"))
    : []
);

// Fetch current catalog
const detail = await api(`/labels/${LABEL_ID}`);
const tracks = detail.tracks as Track[];

// Find new tracks
const newTracks = tracks.filter(t => !seen.has(t.id));

if (newTracks.length > 0) {
  console.log(`${newTracks.length} new track(s) on Drumcode:\n`);
  newTracks.forEach(t => {
    const artist = t.artists.find(a => a.is_primary)?.name;
    console.log(`  ${artist} — ${t.title}`);
  });

  // Send a webhook, email, Slack message, etc.
  // await notify(newTracks);
}

// Save current state
fs.writeFileSync(STATE_FILE, JSON.stringify(tracks.map(t => t.id)));