SpacetimeDB/docs/scripts/generate-cli-docs.mjs

#!/usr/bin/env node
import { createWriteStream, promises as fs } from 'node:fs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
import { spawn } from 'node:child_process';

function getRepoRoot() {
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = path.dirname(__filename);
  return path.resolve(__dirname, '../..');
}

function runCargoAndAppend({ cwd, outFilePath }) {
  return new Promise((resolve, reject) => {
    const outStream = createWriteStream(outFilePath, { flags: 'a' });

    const child = spawn(
      'cargo',
      ['run', '--features', 'markdown-docs', '-p', 'spacetimedb-cli'],
      {
        cwd,
        stdio: ['ignore', 'pipe', 'inherit'],
      },
    );

    child.on('error', err => {
      outStream.end();
      reject(err);
    });

    child.stdout.pipe(outStream);

    child.on('close', code => {
      outStream.end();
      if (code === 0) resolve();
      else reject(new Error(`cargo exited with code ${code ?? 'unknown'}`));
    });
  });
}

async function main() {
  const repoRoot = getRepoRoot();

  const outFile = path.join(
    repoRoot,
    'docs',
    'docs',
    '09000-reference',
    '00100-cli-reference',
    '00100-cli-reference.md',
  );

  const header = `---\ntitle: CLI Reference\nslug: /cli-reference\n---\n\n`;

  await fs.writeFile(outFile, header, 'utf8');
  await runCargoAndAppend({ cwd: repoRoot, outFilePath: outFile });
}

main().catch(err => {
  console.error(err?.stack ?? String(err));
  process.exit(1);
});