Anthias/website/scripts/fetch-screenshots.ts

#!/usr/bin/env bun
/**
 * Pulls the latest successful marketing-screenshots workflow
 * artifact into assets/images/screenshots/ for local Hugo builds.
 *
 * The CI deploy pipeline (.github/workflows/deploy-website.yaml)
 * does the same thing during production builds; this script exists
 * so contributors can preview the home-page slider with real
 * captures without a custom CI run. Files land gitignored so the
 * fetch is idempotent and never accidentally committed.
 *
 * Requires the `gh` CLI to be installed and authenticated. Targets
 * the upstream `Screenly/Anthias` repo by default so contributors
 * working from a fork still get the canonical artifact (the upstream
 * is the only place marketing-screenshots.yaml runs on a schedule).
 * Override with `--repo <owner>/<repo>` to pull from a different
 * repo. Run from the `website/` directory:
 *
 *   bun run screenshots:fetch
 *
 * Pass `--ref <branch>` to pull from a non-master branch's most
 * recent run (handy when developing the capture pipeline itself).
 */
import {
  copyFileSync,
  mkdirSync,
  mkdtempSync,
  readdirSync,
  rmSync,
} from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'

const DEST = 'assets/images/screenshots'
const DEFAULT_REPO = 'Screenly/Anthias'

const args = Bun.argv.slice(2)
let branch = 'master'
let repo = DEFAULT_REPO
for (let i = 0; i < args.length; i++) {
  if (args[i] === '--ref' && i + 1 < args.length) {
    branch = args[++i]!
  } else if (args[i] === '--repo' && i + 1 < args.length) {
    repo = args[++i]!
  }
}

async function sh(cmd: string[]): Promise<string> {
  const proc = Bun.spawn(cmd, { stdout: 'pipe', stderr: 'pipe' })
  const stdout = await new Response(proc.stdout).text()
  const stderr = await new Response(proc.stderr).text()
  const status = await proc.exited
  if (status !== 0) {
    throw new Error(
      `command failed (${status}): ${cmd.join(' ')}\n${stderr}`,
    )
  }
  return stdout.trim()
}

const runId = await sh([
  'gh',
  'run',
  'list',
  '--repo',
  repo,
  '--workflow=marketing-screenshots.yaml',
  `--branch=${branch}`,
  '--status=success',
  '--limit=1',
  '--json',
  'databaseId',
  '--jq',
  '.[0].databaseId // ""',
])

if (!runId) {
  console.error(
    `No successful marketing-screenshots run on '${branch}' in ${repo}.\n` +
      `Trigger one with:\n` +
      `  gh workflow run marketing-screenshots.yaml --repo ${repo} --ref ${branch}\n` +
      `…or pass --ref <branch> / --repo <owner>/<repo> to look elsewhere.`,
  )
  process.exit(1)
}

console.log(
  `Fetching marketing-screenshots artifact from run ${runId} in ${repo}`,
)
const tmp = mkdtempSync(join(tmpdir(), 'anthias-screenshots-'))
try {
  await sh([
    'gh',
    'run',
    'download',
    runId,
    '--repo',
    repo,
    '--name',
    'marketing-screenshots',
    '--dir',
    tmp,
  ])
  rmSync(DEST, { recursive: true, force: true })
  mkdirSync(DEST, { recursive: true })
  let copied = 0
  for (const name of readdirSync(tmp)) {
    if (!name.endsWith('.png')) continue
    copyFileSync(join(tmp, name), join(DEST, name))
    copied++
  }
  console.log(`Installed ${copied} screenshots → ${DEST}/`)
} finally {
  rmSync(tmp, { recursive: true, force: true })
}