misskey/.claude/skills/working-on-backend/scripts/prepare-generate.mjs

/*
 * typeorm migration:generate の前準備をまとめて実行する (冪等・クロスプラットフォーム)。
 * リポジトリルートから実行: node .claude/skills/working-on-backend/scripts/prepare-generate.mjs
 *
 * generate はエンティティのビルド出力 (built/)、コンパイル済み設定 (built/.config.json)、
 * 稼働中の DB を必要とする。手で 5 段並べると取りこぼすのでここに集約する。
 * migration:create (空雛形) しか使わないなら DB もビルドも不要なのでこのスクリプトは不要。
 *
 * Node で書いているのは pure Windows (bash の無い環境) でも動かすため。node はこのリポジトリの
 * ランタイムなので必ず存在し、build-pre.mjs / compile_config.js と同じ流儀に揃う。
 */

import { execSync } from 'node:child_process';
import { existsSync } from 'node:fs';
import { fileURLToPath } from 'node:url';
import { dirname, resolve } from 'node:path';

// このファイルの 4 つ上が repo root
const root = resolve(dirname(fileURLToPath(import.meta.url)), '../../../..');
process.chdir(root);

function step(msg) { console.log(`\n==> ${msg}`); }
function run(cmd) { console.log(`$ ${cmd}`); execSync(cmd, { stdio: 'inherit' }); }
function fail(msg) { console.error(`ERROR: ${msg}`); process.exit(1); }

step('1/5 設定ファイルの確認');
if (!existsSync('.config/default.yml')) {
	fail([
		'.config/default.yml が存在しません。',
		'  .config/example.yml を .config/default.yml にコピーしてから再実行してください:',
		'    Unix系:     cp .config/example.yml .config/default.yml',
		'    PowerShell: Copy-Item .config/example.yml .config/default.yml',
		'  コピー後、db.user / pass / db を .config/docker.env と一致させてください',
		'  (example.yml の既定値は docker.env の例と一致するので、独自 DB を使わなければそのままで可)。',
	].join('\n'));
}
// compose.local-db.yml の db サービスは .config/docker.env を env_file に要求する
if (!existsSync('.config/docker.env')) {
	fail([
		'.config/docker.env が存在しません (compose.local-db.yml の db が要求)。',
		'  例 (.config/default.yml の db.user / db.pass / db.db と一致させる):',
		'  POSTGRES_USER=example-misskey-user',
		'  POSTGRES_PASSWORD=example-misskey-pass',
		'  POSTGRES_DB=misskey',
	].join('\n'));
}
console.log('OK: .config/default.yml と .config/docker.env あり');

step('2/5 built/meta.json の生成 (build-pre)');
run('pnpm build-pre');

step('3/5 設定のコンパイル (compile-config -> built/.config.json)');
run('pnpm --filter backend compile-config');

step('4/5 backend のビルド (エンティティを built/ へ反映)');
run('pnpm --filter backend build');

step('5/5 ローカル DB の起動 (postgres のみ・healthcheck 完了まで待機)');
// migration:generate が必要とするのは postgres だけ。db サービスに絞れば meilisearch.env 等が無くても動く。
// --wait は compose の pg_isready healthcheck 完了まで待つ。直後の migration:generate が
// DB 未起動で失敗しないために必須。--wait は Docker Compose v2.1.1 (2021-11) で導入されており、
// このリポジトリが前提とする v2 の `docker compose` なら標準で使える (EOL の `docker-compose` v1 は対象外)。
run('docker compose -f compose.local-db.yml up -d --wait db');

console.log('\n準備完了。次を実行できます:');
console.log('  pnpm --filter backend exec typeorm migration:generate -d ormconfig.js -o --esm migration/<PascalName>');