Preview & Waveform Workflow

# Server-only
ADN_API_KEY=adn_...        # API Access key (server-side)
ADN_COLLECTION_ID=...      # collection to upload into

# Safe to expose to the browser
PUBLIC_ADN_PLAYER_KEY=adn_player_...   # Client-Side Player key, scoped to the collection

// upload.mjs — standard upload lifecycle (server-side).
const API = 'https://api.audiodelivery.net/v1';

export async function uploadTrack(bytes, fileName) {
  const session = await fetch(`${API}/upload_session`, {
    method: 'POST',
    headers: { Authorization: `Bearer ${process.env.ADN_API_KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ collection_id: process.env.ADN_COLLECTION_ID }),
  }).then((r) => r.json());

  // Per-track create — no Bearer, the session ID authorizes it.
  const { track_id, track_upload } = await fetch(
    `${API}/upload/${session.upload_session_id}/track`,
    { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ file_name: fileName }) },
  ).then((r) => r.json());

  await fetch(track_upload.upload_url, { method: track_upload.method, body: bytes });

  // Wait until ready (a default waveform is generated during processing).
  let status;
  do {
    await new Promise((r) => setTimeout(r, 5000));
    const t = await fetch(`${API}/track/${track_id}`, {
      headers: { Authorization: `Bearer ${process.env.ADN_API_KEY}` },
    }).then((r) => r.json());
    status = t.track?.track_status_id;
  } while (!['ready', 'incomplete', 'error'].includes(status));

  return { track_id, status };
}

// Add a short public preview clip to an already-processed track.
// Types: "transcode" (full-length) or "preview" (clip). See the Variants API.
await fetch(`https://api.audiodelivery.net/v1/track/${track_id}/variant`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.ADN_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    index: 'preview',
    variant_type_id: 'preview',
    // codec settings optional; defaults to aac / 128kbps
  }),
});
// The track re-enters "processing" and returns to "ready" when the clip is built.

// server.mjs — mint a play session for the waveform + preview.
// Request only the "preview" variant for the public teaser; add "hq" for entitled users.
app.get('/api/preview/:trackId', async (req, res) => {
  const variants = (await isEntitled(req)) ? ['hq', 'preview'] : ['preview'];
  const session = await fetch('https://api.audiodelivery.net/v1/play_session/track', {
    method: 'POST',
    headers: { Authorization: `Bearer ${process.env.ADN_API_KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ track_id: req.params.trackId, variants, expires_in: 600 }),
  }).then((r) => r.json());
  // first_track.levels feeds the waveform; first_track.variants[].url are signed audio URLs.
  res.json({
    levels: session.first_track.levels.levels,
    variants: session.first_track.variants,
  });
});

<!-- Render the waveform from the levels array and play the preview. -->
<audiodn-waveform id="wf" variant="vertical" height="100" line-width="2" gap="3"></audiodn-waveform>
<audio id="audio" controls></audio>

<script type="module">
  import '@audiodn/components/waveform';

  const data = await fetch('/api/preview/TRACK_ID').then((r) => r.json());

  // Feed amplitude data (0–1 values) to the waveform component.
  document.getElementById('wf').levels = data.levels;

  // Play the preview variant's signed URL.
  const preview = data.variants.find((v) => v.variant.index === 'preview');
  document.getElementById('audio').src = preview.url;
</script>