Build and deploy an app

# For a new React project; skip creation if you already have a frontend.
bun create vite operations-portal --template react-ts
cd operations-portal
bun install
bun add -d @permute/sdk

# Edit src, then build the complete site with relative asset URLs.
bun run build --base=./

// Save as deploy.ts in your frontend project. Running it publishes the build.
import { PermuteClient, type AppUploadFile, type ResourceVersionState } from '@permute/sdk';
import { readdir, readFile } from 'node:fs/promises';
import { join } from 'node:path';

function required(name: string): string {
  const value = process.env[name]?.trim();
  if (!value) throw new Error('Set ' + name + ' before running this script');
  return value;
}

const client = new PermuteClient({
  apiKey: required('PERMUTE_API_KEY'),
  baseUrl: process.env.PERMUTE_API_BASE_URL, // Defaults to https://api.permute.ai.
}).withWorkspace(required('PERMUTE_WORKSPACE_ID'));
const appId = process.env.PERMUTE_APP_ID;
const rollbackRevisionId = process.env.PERMUTE_ROLLBACK_REVISION_ID;
if (rollbackRevisionId && !appId) throw new Error('Set PERMUTE_APP_ID when rolling back');

let app = appId
  ? await client.apps.get(appId)
  : await client.apps.create({ name: 'Operations portal', key: 'operations-portal', description: '' });
console.log('App ID:', app.id);

const deadline = Date.now() + 10 * 60_000;
while (app.deployment?.status !== 'live') {
  if (!app.deployment) throw new Error('This app has no hosting deployment');
  if (['failed', 'deleting', 'deleted'].includes(app.deployment.status)) {
    throw new Error(app.deployment.error ?? 'App cannot be published: ' + app.deployment.status);
  }
  if (Date.now() >= deadline) throw new Error('Provisioning timed out; inspect this app before retrying');
  await new Promise((resolve) => setTimeout(resolve, 2000));
  app = await client.apps.get(app.id);
}

async function readBuild(directory: string, prefix = ''): Promise<AppUploadFile[]> {
  const files: AppUploadFile[] = [];
  for (const entry of await readdir(directory, { withFileTypes: true })) {
    const path = prefix + entry.name;
    if (entry.isDirectory()) files.push(...await readBuild(join(directory, entry.name), path + '/'));
    else if (entry.isFile()) files.push({ path, data: await readFile(join(directory, entry.name)) });
    else throw new Error('Build contains a symbolic link or unsupported entry: ' + path);
  }
  return files;
}

let ready: ResourceVersionState;
if (rollbackRevisionId) {
  const current = await client.revisions.list(app.id);
  ready = await client.revisions.restore(app.id, rollbackRevisionId, { expectedVersion: current.version });
} else {
  // 1. Upload bytes. This does not change the draft or the live app.
  const files = await client.apps.uploadFiles(app.id, await readBuild('./dist'));

  // 2. Save the COMPLETE file list as a draft, preserving app settings.
  const saved = await client.apps.saveSite(app.id, {
    site: { files, spa: true },
    expectedDraft: app.draft,
  });
  ready = await client.revisions.list(app.id);
  if (ready.draft?.revisionId !== saved.draft.revisionId || ready.draft.sequence !== saved.draft.sequence) {
    throw new Error('Another author changed the draft; review before publishing');
  }
}

// 3. Publish the exact draft we saved or restored. Content updates need no hosting rollout.
console.log('Previous live revision:', ready.published?.revisionId);
const published = await client.revisions.publish(app.id, { expectedVersion: ready.version });
console.log('Live app:', app.deployment.url);
console.log('Published revision:', published.published?.revisionId);