Skip to content

3D engine that AI agents drive

6.1 KB
Raw Blame
import { readFile, writeFile, mkdir, copyFile, cp } from 'node:fs/promises';
import { existsSync } from 'node:fs';
import { spawnSync } from 'node:child_process';
import { createHash } from 'node:crypto';
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
import { changelogWithUnreleased, readChangelogData } from './changelog-fragments.mjs';
import { plainGuide } from './plain-guide.mjs';
import { buildApiReference } from './api-reference.mjs';
import { publishedDocuments } from './published-documents.mjs';

const root = fileURLToPath(new URL('..', import.meta.url));
const metadata = JSON.parse(await readFile(resolve(root, 'package.json'), 'utf8'));
if (!/^\d+\.\d+\.\d+(?:-[a-z0-9.-]+)?$/.test(metadata.version)) throw new Error('Release version must be valid semver.');
if (metadata.name !== '@codepawlhq/crucible') throw new Error('Unexpected package name.');

function run(executable, argumentsList, capture = false) {
  const result = spawnSync(executable, argumentsList, { cwd: root, windowsHide: true, encoding: 'utf8', stdio: capture ? 'pipe' : 'inherit' });
  if (result.status !== 0) throw new Error(`Release command failed: ${result.error?.message ?? result.stderr ?? executable}`);
  return result.stdout?.trim();
}

const commit = run('git', ['rev-parse', 'HEAD'], true);
if (process.argv.includes('--require-clean') && run('git', ['status', '--porcelain'], true)) throw new Error('Commit release changes before production preparation.');
run(process.execPath, ['node_modules/vite/bin/vite.js', 'build', '--config', 'config/vite.lib.config.js']);
// The standalone module goes into build/ before npm pack, so the package carries it.
run(process.execPath, ['node_modules/vite/bin/vite.js', 'build', '--config', 'config/vite.browser.config.js']);
const releases = resolve(root, 'public/releases');
await mkdir(releases, { recursive: true });
const npmCli = process.env.npm_execpath ?? resolve(dirname(process.execPath), 'node_modules/npm/bin/npm-cli.js');
if (!existsSync(npmCli)) throw new Error('npm CLI unavailable. Run preparation through npm run prepare:release.');
const packResult = JSON.parse(run(process.execPath, [npmCli, 'pack', '--ignore-scripts', '--json', '--pack-destination', releases], true));
const packed = Array.isArray(packResult) ? packResult[0] : packResult[metadata.name];
if (!packed?.filename) throw new Error('npm pack did not return a package archive.');
const tarball = `/releases/${packed.filename}`;
let archive = await readFile(resolve(releases, packed.filename));
let integrity = `sha512-${createHash('sha512').update(archive).digest('base64')}`;
await cp(resolve(root, 'build'), resolve(releases, metadata.version), { recursive: true });
// The site keeps its old file name. The bytes must equal the npm file, so a CDN and the site serve the same module.
const standaloneBytes = await readFile(resolve(root, 'build/67.standalone.js'));
const siteModulePath = resolve(releases, metadata.version, '67.module.js');
await writeFile(siteModulePath, standaloneBytes);
const sha512 = (bytes) => createHash('sha512').update(bytes).digest('hex');
if (sha512(await readFile(siteModulePath)) !== sha512(standaloneBytes)) throw new Error('The site copy of the standalone module differs from build/67.standalone.js.');
// The site shows pending change notes above the released sections. Nothing here is kept by hand.
const changelogText = await readFile(resolve(root, 'CHANGELOG.md'), 'utf8');
await writeFile(resolve(root, 'public/changelog.md'), await changelogWithUnreleased(changelogText));
await writeFile(resolve(root, 'public/changelog.json'), `${JSON.stringify(await readChangelogData({ changelogText, version: metadata.version }), null, 2)}
`);
await writeFile(resolve(root, 'public/guide.md'), await plainGuide(root));
await writeFile(resolve(root, 'public/api-reference.json'), `${JSON.stringify(await buildApiReference())}
`);
await copyFile(resolve(root, 'docs/gltf.md'), resolve(root, 'public/gltf.md'));

for (const name of publishedDocuments) {
  await copyFile(resolve(root, 'docs', name), resolve(root, 'public', name));
}

let registryVersion = null;
let registryPublished = false;
let publishedPackage;
try {
  const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(metadata.name)}`, { signal: AbortSignal.timeout(5000) });
  if (response.ok) {
    const registry = await response.json();
    registryVersion = registry['dist-tags']?.latest ?? null;
    publishedPackage = registry.versions?.[metadata.version];
    registryPublished = Boolean(publishedPackage);
  }
} catch {
  // The downloadable package remains usable when the external registry is unavailable.
}

if (publishedPackage) {
  const canonicalURL = new URL(publishedPackage.dist.tarball);
  if (canonicalURL.origin !== 'https://registry.npmjs.org') throw new Error('Unexpected registry archive origin.');
  const response = await fetch(canonicalURL, { signal: AbortSignal.timeout(30000) });
  if (!response.ok) throw new Error(`Canonical package download failed: HTTP ${response.status}.`);
  archive = Buffer.from(await response.arrayBuffer());
  integrity = `sha512-${createHash('sha512').update(archive).digest('base64')}`;
  if (integrity !== publishedPackage.dist.integrity) throw new Error('Canonical package integrity verification failed.');
  await writeFile(resolve(releases, packed.filename), archive);
}

const release = {
  version: metadata.version,
  packageName: metadata.name,
  packageAlias: 'crucible',
  commit,
  installCommand: registryPublished ? `npm install crucible@npm:${metadata.name}@${metadata.version}` : `npm install crucible@https://crucible.codepawl.com${tarball}`,
  tarball,
  module: `/releases/${metadata.version}/67.module.js`,
  registryPublished,
  registryVersion,
  integrity,
  packageBytes: archive.length,
  api: './docs.html#renderer-reference',
  changelog: '/changelog.md',
  changelogData: '/changelog.json',
};
await writeFile(resolve(root, 'public/release.json'), `${JSON.stringify(release, null, 2)}\n`);
console.log(`Prepared ${metadata.name}@${metadata.version}: ${packed.size} bytes, commit ${commit.slice(0, 8)}, registry published ${registryPublished}.`);