Trim videos, create JPG posters and download MP4s

// Node.js 20+; keep these credentials on your server.
const api = 'https://api.stackshift.cloud/api/v1';
const headers = {
  Authorization: `Bearer ${process.env.STACKSHIFT_ASSETS_TOKEN}`,
  'X-Asset-Space-ID': process.env.STACKSHIFT_ASSET_SPACE_ID,
  'Content-Type': 'application/json',
};
async function request(path, init = {}) {
  const response = await fetch(api + path, {
    ...init, headers: { ...headers, ...init.headers },
    signal: AbortSignal.timeout(60_000),
  });
  const body = await response.json();
  if (!response.ok || body.success === false) {
    throw new Error(`Assets request failed: HTTP ${response.status}`);
  }
  return body.data;
}
async function render(assetId, definition) {
  const submitted = await request(`/assets/${assetId}/transforms`, {
    method: 'POST', body: JSON.stringify({ definition }),
  });
  // Persist submitted.job_id in your application for recovery after a restart.
  const deadline = Date.now() + 10 * 60_000;
  while (Date.now() < deadline) {
    const job = await request(`/assets/jobs/${submitted.job_id}`);
    if (job.status === 'completed') {
      if (!job.result?.id || job.result.status !== 'available') {
        throw new Error('Job completed without an available derivative');
      }
      return job.result;
    }
    if (job.status === 'failed' || job.status === 'canceled') {
      throw new Error(`Render ${job.status}; inspect job ${submitted.job_id}`);
    }
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error(`Still processing; resume polling job ${submitted.job_id}`);
}

const videoId = process.env.VIDEO_ASSET_ID;
const clip = await render(videoId, {
  version: 2,
  media_kind: 'video',
  operations: [{ type: 'trim', start_seconds: 5, end_seconds: 20 }],
  output: { kind: 'video', format: 'mp4', muted: false, encoding: 'balanced' },
});
const clipId = clip.id;

const poster = await render(videoId, {
  version: 2,
  media_kind: 'video',
  operations: [{ type: 'timestamp', timestamp_seconds: 12.5 }],
  output: { kind: 'thumbnail', format: 'jpeg', quality: 90 },
});
const posterId = poster.id;

curl --fail-with-body \
  -H "Authorization: Bearer $STACKSHIFT_ASSETS_TOKEN" \
  -H "X-Asset-Space-ID: $STACKSHIFT_ASSET_SPACE_ID" \
  "https://api.stackshift.cloud/api/v1/assets/$ASSET_ID/derivatives/$OUTPUT_ID?download=true" \
  --output clip.mp4

const signed = await request(
  `/assets/${videoId}/derivatives/${clipId}/signed-url`,
  { method: 'POST' },
);
// Pass signed.url to the external provider; do not log it.
// signed.expires_at tells you when the grant expires.

const savedClip = await request(
  `/assets/${videoId}/derivatives/${clipId}/save`,
  { method: 'POST' },
);
// Store savedClip.id in your application database.