orca/config/scripts/assert-github-release-is-draft.test.mjs

import { readFileSync } from 'node:fs'
import { createRequire } from 'node:module'
import { join } from 'node:path'
import { describe, expect, it, vi } from 'vitest'
import { parse } from 'yaml'
import {
  matchingDesktopReleases,
  restorePublishedDesktopReleasesToDraft
} from './assert-github-release-is-draft.mjs'

const require = createRequire(import.meta.url)
const repoRoot = join(import.meta.dirname, '../..')

function jsonResponse(body, init = {}) {
  return {
    ok: init.ok ?? true,
    status: init.status ?? 200,
    statusText: init.statusText ?? 'OK',
    json: vi.fn(async () => body),
    text: vi.fn(async () => JSON.stringify(body))
  }
}

describe('matchingDesktopReleases', () => {
  it('matches tagged, untagged-name, and version-name releases', () => {
    const releases = [
      { id: 1, tag_name: 'v1.4.206', name: 'v1.4.206', draft: true },
      { id: 2, tag_name: 'untagged-abc', name: '1.4.206', draft: false },
      { id: 3, tag_name: 'v1.4.205', name: 'v1.4.205', draft: false }
    ]

    expect(matchingDesktopReleases(releases, 'v1.4.206').map((release) => release.id)).toEqual([
      1, 2
    ])
  })
})

describe('restorePublishedDesktopReleasesToDraft', () => {
  it('leaves drafts alone', async () => {
    const fetchImpl = vi
      .fn()
      .mockResolvedValueOnce(
        jsonResponse([{ id: 1, tag_name: 'v1.4.206', name: 'v1.4.206', draft: true }])
      )

    await expect(
      restorePublishedDesktopReleasesToDraft({
        repo: 'stablyai/orca',
        tag: 'v1.4.206',
        token: 'token',
        fetchImpl,
        log: vi.fn()
      })
    ).resolves.toEqual([])
    expect(fetchImpl).toHaveBeenCalledTimes(1)
  })

  it('re-drafts a published match immediately', async () => {
    const fetchImpl = vi
      .fn()
      .mockResolvedValueOnce(
        jsonResponse([{ id: 9, tag_name: 'v1.4.206', name: '1.4.206', draft: false }])
      )
      .mockResolvedValueOnce(jsonResponse({ id: 9, tag_name: 'v1.4.206', draft: true }))

    const log = vi.fn()
    await expect(
      restorePublishedDesktopReleasesToDraft({
        repo: 'stablyai/orca',
        tag: 'v1.4.206',
        token: 'token',
        fetchImpl,
        log
      })
    ).resolves.toEqual([{ id: 9, tag_name: 'v1.4.206', draft: true }])

    expect(fetchImpl).toHaveBeenNthCalledWith(
      2,
      'https://api.github.com/repos/stablyai/orca/releases/9',
      expect.objectContaining({
        method: 'PATCH',
        body: JSON.stringify({ draft: true, make_latest: 'false' })
      })
    )
    expect(log).toHaveBeenCalledWith('Restored GitHub release 9 (v1.4.206) to draft.')
  })

  it('fails closed when no matching release exists', async () => {
    const fetchImpl = vi.fn().mockResolvedValueOnce(jsonResponse([]))

    await expect(
      restorePublishedDesktopReleasesToDraft({
        repo: 'stablyai/orca',
        tag: 'v1.4.206',
        token: 'token',
        fetchImpl
      })
    ).rejects.toThrow('No GitHub release named v1.4.206 was found after artifact upload')
  })
})

describe('release draft workflow contract', () => {
  it('keeps GitHub releases draft until publish-release undrafts complete assets', () => {
    const releaseWorkflow = parse(
      readFileSync(join(repoRoot, '.github/workflows/release-cut.yml'), 'utf8')
    )
    const macWorkflow = parse(
      readFileSync(join(repoRoot, '.github/workflows/release-mac-build.yml'), 'utf8')
    )
    const electronBuilderConfig = require('../electron-builder.config.cjs')
    const cutCheckout = releaseWorkflow.jobs.cut.steps.find((step) => step.name === 'Checkout ref')
    const linuxDraftStep = releaseWorkflow.jobs.build.steps.find(
      (step) => step.name === 'Verify release remains draft after artifact upload'
    )
    const publishRelease = releaseWorkflow.jobs['publish-release'].steps.find(
      (step) => step.name === 'Publish release'
    )
    const macSteps = macWorkflow.jobs['build-mac'].steps
    const abortParentStep = macSteps.find(
      (step) => step.name === 'Abort if the parent release-cut run was cancelled'
    )
    const macPublishStep = macSteps.find(
      (step) => step.name === 'Publish release artifacts (macOS)'
    )
    const macDraftStep = macSteps.find(
      (step) => step.name === 'Verify release remains draft after artifact upload'
    )

    expect(electronBuilderConfig.publish.releaseType).toBe('draft')
    expect(cutCheckout.with['fetch-tags']).toBe(true)
    expect(linuxDraftStep.shell).toBe('bash')
    expect(linuxDraftStep.run).toContain('assert-github-release-is-draft.mjs')
    expect(linuxDraftStep.run).toContain('needs.cut.outputs.tag')
    expect(publishRelease.run).toContain('gh release edit')
    expect(publishRelease.run).toContain('--draft=false')
    expect(macSteps.indexOf(abortParentStep)).toBeLessThan(macSteps.indexOf(macPublishStep))
    expect(abortParentStep.env.PARENT_RUN).toBe('${{ inputs.release_run_id }}')
    expect(abortParentStep.run).toContain('refusing to publish mac artifacts')
    expect(macDraftStep.shell).toBe('bash')
    expect(macDraftStep.run).toContain('assert-github-release-is-draft.mjs')
    expect(macDraftStep.run).toContain('inputs.tag')
    expect(macPublishStep.with.command).toContain('-c.publish.releaseType=draft')

    const linuxCommands = releaseWorkflow.jobs.build.strategy.matrix.include
      .filter((entry) => String(entry.platform).startsWith('linux'))
      .map((entry) => entry.release_command)
    expect(linuxCommands.length).toBe(2)
    for (const command of linuxCommands) {
      expect(command).toContain('-c.publish.releaseType=draft')
    }

    const createRestore = releaseWorkflow.jobs['create-release'].steps.find(
      (step) => step.name === 'Restore draft-release scripts from the workflow ref'
    )
    const buildRestore = releaseWorkflow.jobs.build.steps.find(
      (step) => step.name === 'Restore draft-publish scripts from the workflow ref'
    )
    const macRestore = macSteps.find(
      (step) => step.name === 'Restore draft-publish scripts from the workflow ref'
    )
    expect(createRestore.run).toContain('create-draft-release.mjs')
    expect(buildRestore.run).toContain('assert-github-release-is-draft.mjs')
    expect(macRestore.run).toContain('assert-github-release-is-draft.mjs')
  })
})