@uzuhq/code-cli 0.3.14

package/dist/cf-images-upload.js

@@ -0,0 +1,52 @@
+import { readFileSync } from 'fs';
+import { basename } from 'path';
+import { createUploadSession } from './upload-session.js';
+/**
+ * ローカルのアイコン群を Cloudflare Images にアップロードし、
+ * ファイルパス → 配信 URL の対応を返す。
+ *
+ * one-time upload URL は backend がアップロードセッション経由で発行するため、
+ * CLI は Cloudflare Images のクレデンシャルを持たない。
+ * 最終的な画像 ID は one-time URL の draft ID とは別で、アップロードレスポンスの
+ * `result.id` でしか分からないため、配信 URL はアップロード後に組み立てる。
+ * 返す URL は Icon resolver が "/original" を付加する前提の
+ * `https://imagedelivery.net/.../imageId` 形式。
+ */
+/** アップロードレスポンスから最終的な画像 ID を取り出す。 */
+export const parseUploadedImageId = (v) => {
+    if (typeof v === 'object' &&
+        v !== null &&
+        'success' in v &&
+        v.success === true &&
+        'result' in v &&
+        typeof v.result === 'object' &&
+        v.result !== null &&
+        'id' in v.result &&
+        typeof v.result.id === 'string' &&
+        v.result.id !== '') {
+        return v.result.id;
+    }
+    throw new Error(`Cloudflare Images の応答が想定外の形式です: ${JSON.stringify(v)}`);
+};
+export const uploadIconsToCfImages = async (env, token, filePaths) => {
+    if (filePaths.length === 0)
+        return new Map();
+    const session = await createUploadSession({ env, token, imageCount: filePaths.length });
+    if (session.images.length !== filePaths.length) {
+        throw new Error('アイコンのアップロード URL の発行数が一致しません');
+    }
+    const result = new Map();
+    await Promise.all(filePaths.map(async (filePath, i) => {
+        const image = session.images[i];
+        const formData = new FormData();
+        formData.append('file', new Blob([readFileSync(filePath)]), basename(filePath));
+        const res = await fetch(image.uploadURL, { method: 'POST', body: formData });
+        if (!res.ok) {
+            const detail = (await res.text()).trim();
+            throw new Error(`Cloudflare Images アップロード失敗 (${filePath}, HTTP ${res.status}): ${detail}`);
+        }
+        const imageId = parseUploadedImageId(await res.json());
+        result.set(filePath, `${session.imageDeliveryBaseURL}/${imageId}`);
+    }));
+    return result;
+};

package/dist/cli.js

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+/**
+ * @docs
+ * - ゲーム仕様: docs/docs/play_screen_v3/games.md
+ * - システム全体像: docs/docs/play_screen_v3/overview.md
+ */
+import { Command, Option } from 'commander';
+import { execSync } from 'child_process';
+import { readFileSync, existsSync, unlinkSync, createWriteStream } from 'fs';
+import { resolve } from 'path';
+import { ZipArchive } from 'archiver';
+import { pathToFileURL } from 'url';
+import { uploadGameToR2, uploadLogicToR2 } from './r2-upload.js';
+import { registerRevision } from './rest-register.js';
+import { buildServerLogic } from './build-server-logic.js';
+import { create2dGame } from './create-2d-game.js';
+import { uploadIconsToCfImages } from './cf-images-upload.js';
+import { runDevCommand } from './dev.js';
+import { DEFAULT_ENV, authBaseURL, resolveEnv, studioHost } from './auth/env.js';
+import { runLoginFlow } from './auth/login-flow.js';
+import { saveCredentials, clearCredentials, credentialsPath } from './auth/config.js';
+import { getLoginIdToken, getValidIdToken } from './auth/token-cache.js';
+import { PUBLISH_TOKEN_ENV, createPublishToken, listPublishTokens, revokePublishToken, } from './auth/publish-token.js';
+// publish / login / logout 共通の env オプション。既定 dev・help には出さない (誤って本番へ publish しないため)。
+const envOption = () => new Option('--env <env>', '接続先環境 (dev | stg | prd)').default(DEFAULT_ENV).hideHelp();
+const program = new Command();
+program.name('uzu').description('UZU ゲーム開発 CLI').version('0.2.0');
+program
+    .command('create-2d-game')
+    .description('2D エンジンを使ったゲームプロジェクトの雛形を作成')
+    .argument('<name>', 'プロジェクト名（ディレクトリ名）')
+    .action((name) => {
+    create2dGame(name);
+});
+program
+    .command('dev')
+    .description('scenario の dev server を起動し、 dev harness (iframe grid + HUD) と ' +
+    'in-memory GameRoom / SyncRoom / RelayRoom を提供する')
+    .action(async () => {
+    try {
+        await runDevCommand();
+    }
+    catch (err) {
+        console.error('[uzu dev]', err);
+        process.exit(1);
+    }
+});
+program
+    .command('publish')
+    .description('ゲームをビルドして R2 にアップロード → 登録')
+    .option('--change-notes <msg>', 'リビジョンの変更メモ', '')
+    .addOption(envOption())
+    .action(async (options) => {
+    const env = resolveEnv(options.env);
+    const cwd = process.cwd();
+    const manifestPath = resolve(cwd, 'manifest.json');
+    if (!existsSync(manifestPath)) {
+        console.error('manifest.json が見つかりません。ゲームディレクトリで実行してください。');
+        process.exit(1);
+    }
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    if (typeof manifest !== 'object' || manifest === null) {
+        console.error('manifest.json が不正な形式です。');
+        process.exit(1);
+    }
+    if (!manifest.id || !manifest.playerCount || !manifest.output) {
+        console.error('manifest.json に id と playerCount と output が必要です。');
+        process.exit(1);
+    }
+    const gameId = manifest.id;
+    const manifestCharacters = manifest.characters;
+    // characters バリデーション
+    if (manifestCharacters !== undefined) {
+        if (manifestCharacters.length === 0) {
+            console.error('characters が空の配列です。');
+            process.exit(1);
+        }
+        for (const c of manifestCharacters) {
+            if (!c.id || !c.name) {
+                console.error('characters の各要素に id と name が必要です。');
+                process.exit(1);
+            }
+        }
+    }
+    // playerCount: characters があればその長さ、なければ manifest.playerCount
+    const playerCount = manifestCharacters?.length ?? manifest.playerCount;
+    // ビルド・アップロード後に backend の 400 で落ちると手戻りが大きいので、ここで検証する
+    const rawOrientation = manifest.orientation ?? 'portrait';
+    if (rawOrientation !== 'portrait' && rawOrientation !== 'landscape') {
+        console.error(`manifest.json の orientation は portrait か landscape を指定してください (指定値: ${String(rawOrientation)})`);
+        process.exit(1);
+    }
+    const orientation = rawOrientation;
+    const buildCommand = manifest.build;
+    const outputDir = manifest.output;
+    console.log(`Publishing game: ${gameId} (players: ${playerCount}, orientation: ${orientation})`);
+    // 認証はビルド前に確認する。未ログインのまま重いビルド・アップロードまで進むと、
+    // 完了後に登録で失敗して成果物が無駄になるため、ここで先に落とす。
+    await getValidIdToken(env).catch((e) => {
+        console.error(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    });
+    // 1. Build
+    if (buildCommand) {
+        console.log('Building...');
+        execSync(buildCommand, { stdio: 'inherit', cwd });
+    }
+    // 2. ZIP (archiver で OS 非依存に生成)
+    console.log('Creating ZIP...');
+    const absoluteOutputDir = resolve(cwd, outputDir);
+    const zipPath = resolve(cwd, '__zip__.zip');
+    await new Promise((res, reject) => {
+        const output = createWriteStream(zipPath);
+        const archive = new ZipArchive({ zlib: { level: 9 } });
+        output.on('close', () => res());
+        archive.on('error', (err) => reject(err));
+        archive.pipe(output);
+        archive.directory(absoluteOutputDir, false);
+        archive.finalize();
+    });
+    console.log(`Created: ${zipPath}`);
+    // 3. R2 Upload (ZIP + 個別ファイル)
+    //    ZIP はモバイル `/__zip__` 経路用、個別ファイルは Web emulator 経路用。
+    //    Worker のメモリ上限 (128MB) を超えないよう、Worker 側で ZIP を展開せずに
+    //    R2 から直接個別ファイルを返す前提で publish 時に展開済みオブジェクトを並べる。
+    console.log('Uploading to R2...');
+    const { resourceId, revisionId, token } = await uploadGameToR2(env, zipPath, absoluteOutputDir);
+    console.log(`Uploaded to R2. revisionId: ${revisionId}, resourceId: ${resourceId}`);
+    // 4. ServerAction — serverActionLogicPath があれば logic.js ビルド + R2 保存
+    if (manifest.serverActionLogicPath) {
+        const logicEntryPoint = resolve(cwd, manifest.serverActionLogicPath);
+        const logicOutPath = resolve(cwd, '__logic__.js');
+        try {
+            console.log('Building server logic...');
+            await buildServerLogic(logicEntryPoint, logicOutPath);
+            // ビルド済み logic.js を動的 import し、default or named "logic" が存在するか検証
+            // Windows では絶対パスをそのまま渡すと ERR_UNSUPPORTED_ESM_URL_SCHEME になるため file:// URL に変換する
+            const logicModule = await import(pathToFileURL(logicOutPath).href);
+            const resolvedLogic = logicModule.default ?? logicModule.logic;
+            if (!resolvedLogic) {
+                console.error(`Error: ${manifest.serverActionLogicPath} must export a GameLogic object.\n` +
+                    `  Use either: export default logic\n` +
+                    `  Or:         export const logic: GameLogic<State> = { ... }`);
+                process.exit(1);
+            }
+            // ゲーム固有の logic.js のみを R2 に保存する。
+            // ランタイムテンプレ（GameRoom エンジン）は v3-play-server が所有し、JIT デプロイ時に
+            // この logic.js と合成される。これによりテンプレ修正が再 publish 無しで伝播する。
+            console.log('Uploading logic.js to R2...');
+            const logicJsContent = readFileSync(logicOutPath, 'utf-8');
+            await uploadLogicToR2(env, token, logicJsContent);
+        }
+        finally {
+            if (existsSync(logicOutPath))
+                unlinkSync(logicOutPath);
+        }
+    }
+    // 5. Resolve character icons (相対パス → Cloudflare Images アップロード)
+    let resolvedCharacters;
+    if (manifestCharacters) {
+        console.log('Resolving character icons...');
+        const isLocalIcon = (char) => !!char.icon && !char.icon.startsWith('http://') && !char.icon.startsWith('https://');
+        const localIconPaths = manifestCharacters.filter(isLocalIcon).map((char) => {
+            const iconAbsPath = resolve(cwd, char.icon);
+            if (!existsSync(iconAbsPath)) {
+                console.error(`アイコンファイルが見つかりません: ${char.icon}`);
+                process.exit(1);
+            }
+            return iconAbsPath;
+        });
+        const iconURLs = await uploadIconsToCfImages(env, token, localIconPaths);
+        resolvedCharacters = manifestCharacters.map((char) => {
+            if (!isLocalIcon(char))
+                return char;
+            const cfImagesUrl = iconURLs.get(resolve(cwd, char.icon));
+            if (!cfImagesUrl) {
+                console.error(`アイコンのアップロード結果が見つかりません: ${char.icon}`);
+                process.exit(1);
+            }
+            console.log(`Uploaded icon: ${char.icon}`);
+            return { ...char, icon: cfImagesUrl };
+        });
+    }
+    // 6. Register revision
+    console.log('Registering revision...');
+    const revId = await registerRevision({
+        env,
+        gameId,
+        resourceId,
+        uploadToken: token,
+        changeNotes: options.changeNotes || '',
+        playerCount,
+        orientation,
+        characters: resolvedCharacters,
+    });
+    console.log(`Registered revision: ${revId}`);
+    // 7. Cleanup
+    unlinkSync(zipPath);
+    const studioUrl = `https://${studioHost(env)}/ja/scenarios/global-id/${gameId}`;
+    console.log('\nDone!');
+    console.log(`UZU Studio: ${studioUrl}`);
+});
+program
+    .command('login')
+    .description('UZU にログインして publish 用の認証情報を保存')
+    .addOption(envOption())
+    .action(async (options) => {
+    const env = resolveEnv(options.env);
+    let result;
+    try {
+        result = await runLoginFlow(env, (url) => {
+            console.log('ブラウザで Google ログインを開きます。');
+            console.log('自動で開かない場合は次の URL を踏んでください:');
+            console.log(`  ${url}`);
+        });
+    }
+    catch (e) {
+        console.error(`ログインに失敗しました: ${e.message}`);
+        process.exit(1);
+    }
+    await saveCredentials(env, {
+        uid: result.uid,
+        email: result.email,
+        refreshToken: result.refreshToken,
+        loggedInAt: new Date().toISOString(),
+    });
+    console.log(`\nログインしました: ${result.email} (env: ${env})`);
+    console.log(`保存先: ${credentialsPath()} (mode 0600)`);
+});
+program
+    .command('logout')
+    .description('保存済みの認証情報を削除')
+    .addOption(envOption())
+    .action(async (options) => {
+    const env = resolveEnv(options.env);
+    const removed = await clearCredentials(env);
+    if (removed) {
+        console.log(`ログアウトしました (env: ${env})`);
+    }
+    else {
+        console.log(`ログイン情報はありません (env: ${env})`);
+    }
+});
+// CI / 自動化用の publish token 管理。認証は `uzu login` 済みの認証情報のみで、
+// UZU_PUBLISH_TOKEN では操作できない (漏れたトークンから新しい token を生やさせない)。
+const tokenCommand = program.command('token').description('CI 用 publish token の管理');
+const runTokenCommand = async (rawEnv, fn) => {
+    const env = resolveEnv(rawEnv);
+    try {
+        const idToken = await getLoginIdToken(env);
+        await fn({ env, baseUrl: authBaseURL(env), idToken });
+    }
+    catch (e) {
+        console.error(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+};
+tokenCommand
+    .command('create')
+    .description('publish token を発行する (平文はこの 1 回しか表示されない)')
+    .option('--name <label>', 'トークンの用途がわかる表示名', '')
+    .addOption(envOption())
+    .action(async (options) => {
+    await runTokenCommand(options.env, async ({ env, baseUrl, idToken }) => {
+        const issued = await createPublishToken(baseUrl, idToken, options.name);
+        console.log(`publish token を発行しました (env: ${env})`);
+        console.log(`  id:   ${issued.id}`);
+        console.log(`  name: ${issued.name || '(なし)'}`);
+        console.log('');
+        console.log(`  ${issued.token}`);
+        console.log('');
+        console.log('この平文は再表示できません。CI では secret に登録し、');
+        console.log(`${PUBLISH_TOKEN_ENV} として渡してください。`);
+    });
+});
+tokenCommand
+    .command('list')
+    .description('有効な publish token を一覧する')
+    .addOption(envOption())
+    .action(async (options) => {
+    await runTokenCommand(options.env, async ({ env, baseUrl, idToken }) => {
+        const tokens = await listPublishTokens(baseUrl, idToken);
+        if (tokens.length === 0) {
+            console.log(`publish token はありません (env: ${env})`);
+            return;
+        }
+        for (const t of tokens) {
+            console.log(`${t.id}  ${t.name || '(なし)'}  created=${t.createdAt}  lastUsed=${t.lastUsedAt ?? '-'}`);
+        }
+    });
+});
+tokenCommand
+    .command('revoke')
+    .description('publish token を失効させる')
+    .argument('<id>', '失効させる token の id (uzu token list で確認)')
+    .addOption(envOption())
+    .action(async (id, options) => {
+    await runTokenCommand(options.env, async ({ env, baseUrl, idToken }) => {
+        await revokePublishToken(baseUrl, idToken, id);
+        console.log(`失効しました: ${id} (env: ${env})`);
+    });
+});
+program.parse();

package/dist/create-2d-game.js

@@ -0,0 +1,56 @@
+import { mkdirSync, readFileSync, writeFileSync, readdirSync, statSync } from 'fs';
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** テンプレートディレクトリから再帰的にファイルをコピー。.tpl ファイルは置換処理を行う。 */
+const copyDir = (src, dest, replacements) => {
+    mkdirSync(dest, { recursive: true });
+    for (const entry of readdirSync(src)) {
+        const srcPath = join(src, entry);
+        const stat = statSync(srcPath);
+        if (stat.isDirectory()) {
+            copyDir(srcPath, join(dest, entry), replacements);
+            continue;
+        }
+        if (entry.endsWith('.tpl')) {
+            // テンプレートファイル: プレースホルダーを置換して拡張子を除いた名前で出力
+            let content = readFileSync(srcPath, 'utf-8');
+            for (const [key, value] of Object.entries(replacements)) {
+                content = content.replaceAll(`{{${key}}}`, value);
+            }
+            writeFileSync(join(dest, entry.replace(/\.tpl$/, '')), content);
+        }
+        else {
+            // 通常ファイル: テキストなら置換、バイナリならそのままコピー
+            const content = readFileSync(srcPath, 'utf-8');
+            let output = content;
+            for (const [key, value] of Object.entries(replacements)) {
+                output = output.replaceAll(`{{${key}}}`, value);
+            }
+            writeFileSync(join(dest, entry), output);
+        }
+    }
+};
+/** kebab-case をタイトルケースに変換 */
+const toTitle = (name) => name
+    .split('-')
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+    .join(' ');
+export const create2dGame = (name) => {
+    const dest = resolve(process.cwd(), name);
+    const templateDir = resolve(__dirname, '..', 'game-2d-template');
+    const title = toTitle(name);
+    const replacements = { name, title };
+    console.log(`Creating 2D game project: ${name}`);
+    copyDir(templateDir, dest, replacements);
+    console.log(`\nDone! Created ${name}/`);
+    console.log(`\nNext steps:`);
+    console.log(`  cd ${name}`);
+    console.log('');
+    console.log('  # ~/.npmrc に GitHub Packages の認証設定がない場合:');
+    console.log('  echo "//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN" >> ~/.npmrc');
+    console.log('  echo "@uzupj:registry=https://npm.pkg.github.com" >> ~/.npmrc');
+    console.log('');
+    console.log(`  npm install`);
+    console.log(`  npm run dev`);
+};