castle-web-cli 0.4.1 → 0.4.2

package/src/index.ts

@@ -1,143 +0,0 @@
-#!/usr/bin/env node
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { login } from './login.js';
-import { serve } from './serve.js';
-import { push } from './push.js';
-import { init } from './init.js';
-import { savePreviewImage, savePreviewIfNeeded } from './preview.js';
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-const FLAGS_WITH_VALUES = new Set(['--port', '--out']);
-
-function findPositionalDir(): string {
-  for (let i = 1; i < args.length; i++) {
-    if (args[i].startsWith('--')) {
-      if (FLAGS_WITH_VALUES.has(args[i])) i++;
-      continue;
-    }
-    return args[i];
-  }
-  return '.';
-}
-
-function getFlagValue(flag: string): string | undefined {
-  const idx = args.indexOf(flag);
-  return idx >= 0 ? args[idx + 1] : undefined;
-}
-
-function readServeWsPort(dir: string): number | undefined {
-  try {
-    const serveJson = JSON.parse(fs.readFileSync(path.join(path.resolve(dir), '.castle', 'serve.json'), 'utf-8'));
-    return serveJson.wsPort;
-  } catch {
-    return undefined;
-  }
-}
-
-function getWsPort(dir: string): number {
-  const explicit = getFlagValue('--port');
-  if (explicit) return parseInt(explicit, 10);
-  const fromServe = readServeWsPort(dir);
-  if (fromServe) return fromServe;
-  return 3738;
-}
-
-function usage() {
-  console.log(`Usage:
-  castle-web init <dir>
-  castle-web serve [dir] [--port PORT] [--open]
-  castle-web restart [--port PORT]
-  castle-web screenshot [--out FILE] [--port PORT]
-  castle-web save-preview-image [dir] [--port PORT] [--no-restart]
-  castle-web push [dir]
-  castle-web login`);
-  process.exit(1);
-}
-
-async function main() {
-  switch (command) {
-    case 'init': {
-      const dir = args[1];
-      if (!dir) { console.error('Usage: castle-web init <dir>'); process.exit(1); }
-      init(dir);
-      break;
-    }
-    case 'serve': {
-      const dir = findPositionalDir();
-      const port = getFlagValue('--port');
-      const open = args.includes('--open');
-      await serve(dir, { port, open });
-      break;
-    }
-    case 'push': {
-      const dir = findPositionalDir();
-      await push(dir);
-      const wsPort = getWsPort(dir);
-      await savePreviewIfNeeded(dir, wsPort);
-      break;
-    }
-    case 'restart': {
-      const dir = findPositionalDir();
-      const wsPort = getWsPort(dir);
-      const { default: WS } = await import('ws');
-      const ws = new WS(`ws://localhost:${wsPort}`);
-      ws.on('open', () => {
-        ws.send(JSON.stringify({ type: 'restart' }));
-        setTimeout(() => { ws.close(); process.exit(0); }, 100);
-      });
-      ws.on('error', () => { console.error('Could not connect. Is castle-web serve running?'); process.exit(1); });
-      break;
-    }
-    case 'screenshot': {
-      const dir = findPositionalDir();
-      const outFile = getFlagValue('--out') ?? 'screenshot.png';
-      const wsPort = getWsPort(dir);
-      const requestId = Math.random().toString(36).slice(2);
-      const { default: WS } = await import('ws');
-      const ws = new WS(`ws://localhost:${wsPort}`);
-      ws.on('open', () => {
-        ws.send(JSON.stringify({ type: 'screenshot_request', requestId }));
-      });
-      const timeout = setTimeout(() => {
-        console.error('Screenshot timed out. Is castle-web serve running?');
-        ws.close();
-        process.exit(1);
-      }, 3000);
-      ws.on('message', (raw: Buffer) => {
-        try {
-          const msg = JSON.parse(raw.toString());
-          if (msg.type === 'screenshot_response' && msg.requestId === requestId) {
-            clearTimeout(timeout);
-            const base64 = msg.data.replace(/^data:image\/png;base64,/, '');
-            fs.writeFileSync(outFile, Buffer.from(base64, 'base64'));
-            console.log(`Saved ${outFile}`);
-            ws.close();
-            process.exit(0);
-          }
-        } catch {}
-      });
-      break;
-    }
-    case 'save-preview-image': {
-      const dir = findPositionalDir();
-      const wsPort = getWsPort(dir);
-      const noRestart = args.includes('--no-restart');
-      await savePreviewImage(dir, wsPort, noRestart);
-      process.exit(0);
-    }
-    case 'login':
-      await login();
-      break;
-    default:
-      usage();
-  }
-}
-
-main().catch((e) => {
-  console.error(e.message ?? e);
-  process.exit(1);
-});

package/src/init.ts

@@ -1,71 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-
-const INDEX_HTML = `<!DOCTYPE html>
-<html>
-<head>
-  <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
-  <title>My Castle Game</title>
-</head>
-<body>
-  <script type="module" src="game.js"></script>
-</body>
-</html>
-`;
-
-const GAME_JS = `import { setup, initCard } from 'castle-web-sdk';
-
-setup();
-const card = initCard();
-
-const el = document.createElement('div');
-el.style.cssText = \`
-  width: 100%; height: 100%;
-  display: flex; align-items: center; justify-content: center;
-  font-family: system-ui; color: #fff; font-size: 24px;
-\`;
-el.textContent = 'Hello Castle!';
-card.appendChild(el);
-`;
-
-const CLAUDE_MD = `@node_modules/castle-web-cli/AGENTS.md
-@node_modules/castle-web-sdk/AGENTS.md
-`;
-
-export async function init(dir: string) {
-  const projectDir = path.resolve(dir);
-
-  if (fs.existsSync(projectDir) && fs.readdirSync(projectDir).length > 0) {
-    console.error(`Directory "${dir}" is not empty.`);
-    process.exit(1);
-  }
-
-  fs.mkdirSync(projectDir, { recursive: true });
-  fs.writeFileSync(path.join(projectDir, 'index.html'), INDEX_HTML);
-  fs.writeFileSync(path.join(projectDir, 'game.js'), GAME_JS);
-  fs.writeFileSync(path.join(projectDir, 'CLAUDE.md'), CLAUDE_MD);
-
-  const packageJson = {
-    name: path.basename(projectDir),
-    private: true,
-    type: 'module',
-    dependencies: {
-      'castle-web-sdk': '*',
-    },
-    devDependencies: {
-      'castle-web-cli': '*',
-    },
-  };
-  fs.writeFileSync(path.join(projectDir, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n');
-
-  const { execSync } = await import('child_process');
-  execSync('npm install', { cwd: projectDir, stdio: 'inherit' });
-
-  console.log(`Created project in ${projectDir}/`);
-  console.log('');
-  console.log('Next steps:');
-  console.log(`  cd ${dir}`);
-  console.log('  npx castle-web-cli serve --open');
-  console.log('  npx castle-web-cli login');
-  console.log('  npx castle-web-cli push');
-}

package/src/login.ts

@@ -1,24 +0,0 @@
-import * as api from './api.js';
-import * as config from './config.js';
-
-export async function login(): Promise<void> {
-  const { pollToken, url } = await api.startCLILogin();
-  console.log(`Opening browser to log in: ${url}`);
-  const { default: open } = await import('open');
-  await open(url);
-  console.log('Waiting for login...');
-
-  const MAX_POLLS = 600;
-  for (let i = 0; i < MAX_POLLS; i++) {
-    await new Promise((r) => setTimeout(r, 1000));
-    const user = await api.pollForCLILogin(pollToken);
-    if (user) {
-      config.setToken(user.token);
-      console.log(`Logged in as @${user.username}`);
-      return;
-    }
-  }
-
-  console.error('Login timed out.');
-  process.exit(1);
-}

package/src/preview.ts

@@ -1,94 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import * as api from './api.js';
-import * as config from './config.js';
-
-function connectWS(wsPort: number): Promise<any> {
-  return new Promise(async (resolve, reject) => {
-    const { default: WS } = await import('ws');
-    const ws = new WS(`ws://localhost:${wsPort}`);
-    ws.on('error', () => reject(new Error('Could not connect. Is castle-web serve running?')));
-    ws.on('open', () => resolve(ws));
-  });
-}
-
-function takeScreenshot(ws: any): Promise<string> {
-  return new Promise((resolve, reject) => {
-    const requestId = Math.random().toString(36).slice(2);
-    const timeout = setTimeout(() => {
-      reject(new Error('Screenshot timed out.'));
-    }, 10000);
-    ws.on('message', (raw: Buffer) => {
-      try {
-        const msg = JSON.parse(raw.toString());
-        if (msg.type === 'screenshot_response' && msg.requestId === requestId) {
-          clearTimeout(timeout);
-          resolve(msg.data.replace(/^data:image\/png;base64,/, ''));
-        }
-      } catch {}
-    });
-    ws.send(JSON.stringify({ type: 'screenshot_request', requestId }));
-  });
-}
-
-function waitForRestart(ws: any): Promise<void> {
-  return new Promise((resolve) => {
-    ws.send(JSON.stringify({ type: 'restart' }));
-    setTimeout(resolve, 2000);
-  });
-}
-
-export async function savePreviewImage(dir: string, wsPort: number, noRestart = false): Promise<void> {
-  const projectDir = path.resolve(dir);
-  const castleJsonPath = path.join(projectDir, 'castle.json');
-  if (!fs.existsSync(castleJsonPath)) {
-    console.error('No castle.json found. Push the deck first.');
-    process.exit(1);
-  }
-  const castleJson = JSON.parse(fs.readFileSync(castleJsonPath, 'utf-8'));
-
-  if (!config.getToken()) {
-    console.error('Not logged in. Run `castle-web login` first.');
-    process.exit(1);
-  }
-
-  const ws = await connectWS(wsPort);
-  if (!noRestart) await waitForRestart(ws);
-  const base64 = await takeScreenshot(ws);
-  ws.close();
-
-  fs.writeFileSync(path.join(projectDir, 'preview.png'), Buffer.from(base64, 'base64'));
-  console.log('Saved preview.png');
-
-  const file = await api.uploadBase64(base64, 'preview.png');
-  await api.updateCardCustomBackgroundImage(castleJson.cardId, file.fileId);
-  console.log('Set deck preview image.');
-}
-
-export async function savePreviewIfNeeded(dir: string, wsPort: number): Promise<void> {
-  const projectDir = path.resolve(dir);
-  if (fs.existsSync(path.join(projectDir, 'preview.png'))) {
-    return;
-  }
-  let ws: any;
-  try {
-    ws = await connectWS(wsPort);
-    await waitForRestart(ws);
-    const base64 = await takeScreenshot(ws);
-    ws.close();
-
-    const castleJsonPath = path.join(projectDir, 'castle.json');
-    if (!fs.existsSync(castleJsonPath)) return;
-    const castleJson = JSON.parse(fs.readFileSync(castleJsonPath, 'utf-8'));
-
-    fs.writeFileSync(path.join(projectDir, 'preview.png'), Buffer.from(base64, 'base64'));
-    console.log('Saved preview.png');
-
-    const file = await api.uploadBase64(base64, 'preview.png');
-    await api.updateCardCustomBackgroundImage(castleJson.cardId, file.fileId);
-    console.log('Set deck preview image.');
-  } catch (e: any) {
-    if (ws) ws.close();
-    console.log(`Preview skipped: ${e?.message ?? e}`);
-  }
-}

package/src/push.ts

@@ -1,118 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { nanoid } from 'nanoid';
-import * as api from './api.js';
-import * as config from './config.js';
-import { bundleProject } from './bundle.js';
-
-interface CastleJson {
-  deckId: string;
-  cardId: string;
-}
-
-function readCastleJson(dir: string): CastleJson | null {
-  const p = path.join(dir, 'castle.json');
-  if (!fs.existsSync(p)) return null;
-  return JSON.parse(fs.readFileSync(p, 'utf-8'));
-}
-
-function buildSceneData(bundle: string): any {
-  return {
-    experimentalWeb: {
-      enabled: true,
-      bundle,
-    },
-    snapshot: {
-      sceneProperties: {
-        backgroundColor: { r: 0, g: 0, b: 0, a: 1 },
-        coordinateSystemVersion: 2,
-      },
-      actors: [],
-      library: {},
-      linkTargetDeckIds: [],
-    },
-  };
-}
-
-export async function push(dir: string) {
-  if (!config.getToken()) {
-    console.error('Not logged in. Run `castle-web login` first.');
-    process.exit(1);
-  }
-
-  const projectDir = path.resolve(dir);
-  if (!fs.existsSync(path.join(projectDir, 'index.html'))) {
-    console.error(`No index.html found in ${projectDir}`);
-    process.exit(1);
-  }
-
-  let castleJson = readCastleJson(projectDir);
-
-  console.log('Bundling...');
-  const bundle = await bundleProject(projectDir);
-  const sizeKB = bundle.length / 1024;
-  console.log(`Bundle size: ${sizeKB.toFixed(1)}KB`);
-  if (sizeKB > 1024) {
-    console.warn(`Warning: Bundle is ${(sizeKB / 1024).toFixed(1)}MB. Large bundles may load slowly.`);
-  }
-
-  const sceneData = buildSceneData(bundle);
-  const isNew = !castleJson;
-  const cardId = castleJson?.cardId ?? nanoid(12);
-  const deckId = castleJson?.deckId ?? nanoid(12);
-
-  // Upload scene data to S3
-  const configs = await api.createSceneDataUploadConfig([cardId]);
-  if (!configs?.length) {
-    console.error('Failed to get upload config.');
-    process.exit(1);
-  }
-
-  const uploadConfig = configs[0];
-  const formData = new FormData();
-  formData.append('Content-Type', 'application/json');
-  for (const [k, v] of Object.entries(uploadConfig.postFields)) {
-    formData.append(k, `${v}`);
-  }
-  formData.append('file', new Blob([JSON.stringify(sceneData)]));
-
-  const s3Res = await fetch(uploadConfig.postUrl, {
-    method: 'POST',
-    body: formData,
-    signal: AbortSignal.timeout(30000),
-  });
-  if (s3Res.status >= 300) {
-    throw new Error(`Upload failed: HTTP ${s3Res.status}`);
-  }
-
-  // Create or update via updateCardAndDeckV2
-  const title = path.basename(path.resolve(projectDir));
-  try {
-    const result = await api.updateCardAndDeckV2(
-      { deckId, title, visibility: 'unlisted' },
-      { cardId, blocks: [], uploadId: uploadConfig.uploadId, makeInitialCard: true }
-    );
-
-    if (isNew) {
-      const newCastleJson = { deckId: result.deckId, cardId: result.cardId };
-      fs.writeFileSync(
-        path.join(projectDir, 'castle.json'),
-        JSON.stringify(newCastleJson, null, 2) + '\n',
-        'utf-8'
-      );
-      console.log(`Created deck "${title}" (${result.deckId}). Saved castle.json.`);
-    } else {
-      console.log('Pushed to Castle.');
-    }
-  } catch (e: any) {
-    const code = e?.extensions?.code ?? '';
-    if (code === 'LOGIN_REQUIRED') {
-      console.error('Not logged in. Run `castle-web login` first.');
-    } else if (code === 'DECK_INVALID_PERMISSIONS') {
-      console.error('You do not have permission to push to this deck.');
-    } else {
-      throw e;
-    }
-    process.exit(1);
-  }
-}

package/src/serve.ts

@@ -1,134 +0,0 @@
-import * as fs from 'fs';
-import * as net from 'net';
-import * as path from 'path';
-import { createServer, type Plugin } from 'vite';
-import { WebSocketServer, WebSocket } from 'ws';
-
-function isPortFree(port: number): Promise<boolean> {
-  return new Promise((resolve) => {
-    const srv = net.createServer();
-    srv.once('error', () => resolve(false));
-    srv.listen(port, () => { srv.close(() => resolve(true)); });
-  });
-}
-
-async function findFreePorts(startPort: number): Promise<{ port: number; wsPort: number }> {
-  for (let p = startPort; p < startPort + 100; p += 2) {
-    if (await isPortFree(p) && await isPortFree(p + 1)) {
-      return { port: p, wsPort: p + 1 };
-    }
-  }
-  throw new Error(`No free port pair found starting from ${startPort}`);
-}
-
-function castlePlugin(wsPort: number): Plugin {
-  return {
-    name: 'castle-dev',
-    configureServer(server) {
-      server.middlewares.use((req, res, next) => {
-        if (req.url === '/__castle/ws-port') {
-          res.writeHead(200, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ port: wsPort }));
-          return;
-        }
-        next();
-      });
-    },
-  };
-}
-
-export async function serve(
-  dir: string,
-  options: { port?: string; open?: boolean } = {}
-) {
-  const projectDir = path.resolve(dir);
-  if (!fs.existsSync(projectDir)) {
-    console.error(`Directory not found: ${projectDir}`);
-    process.exit(1);
-  }
-  if (!fs.existsSync(path.join(projectDir, 'index.html'))) {
-    console.error(`No index.html found in ${projectDir}`);
-    process.exit(1);
-  }
-
-  const startPort = parseInt(options.port ?? '3737', 10);
-  const { port, wsPort } = options.port
-    ? { port: startPort, wsPort: startPort + 1 }
-    : await findFreePorts(startPort);
-
-  // Local WebSocket server for SDK communication
-  const castleDir = path.join(projectDir, '.castle');
-  if (!fs.existsSync(castleDir)) fs.mkdirSync(castleDir, { recursive: true });
-  const logFile = path.join(castleDir, 'logs.txt');
-  const screenshotsDir = path.join(castleDir, 'screenshots');
-
-  const serveJsonPath = path.join(castleDir, 'serve.json');
-  fs.writeFileSync(serveJsonPath, JSON.stringify({ port, wsPort }) + '\n');
-  process.on('exit', () => { try { fs.unlinkSync(serveJsonPath); } catch {} });
-  process.on('SIGINT', () => process.exit());
-  process.on('SIGTERM', () => process.exit());
-
-  startWSServer(wsPort, logFile, screenshotsDir);
-
-  const vite = await createServer({
-    root: projectDir,
-    plugins: [castlePlugin(wsPort)],
-    server: {
-      port,
-      strictPort: true,
-      open: options.open ? true : undefined,
-      hmr: false,
-      fs: { strict: false },
-    },
-    logLevel: 'info',
-  });
-
-  await vite.listen();
-  vite.printUrls();
-}
-
-function startWSServer(port: number, logFile: string, screenshotsDir: string): WebSocketServer {
-  const wss = new WebSocketServer({ port });
-  const clients = new Set<WebSocket>();
-
-  wss.on('connection', (ws) => {
-    clients.add(ws);
-
-    ws.on('message', (raw) => {
-      try {
-        const msg = JSON.parse(raw.toString());
-
-        if (msg.type === 'restart' || msg.type === 'screenshot_request') {
-          const fwd = JSON.stringify(msg);
-          for (const c of clients) {
-            if (c !== ws && c.readyState === WebSocket.OPEN) c.send(fwd);
-          }
-        }
-
-        if (msg.type === 'log') {
-          const line = `[${msg.level}] ${msg.msg}\n`;
-          fs.appendFileSync(logFile, line);
-          if (msg.level === 'error') process.stderr.write(line);
-          else process.stdout.write(line);
-        }
-
-        if (msg.type === 'screenshot_response') {
-          if (!fs.existsSync(screenshotsDir)) fs.mkdirSync(screenshotsDir, { recursive: true });
-          const filename = `screenshot-${Date.now()}.png`;
-          const filepath = path.join(screenshotsDir, filename);
-          const base64 = msg.data.replace(/^data:image\/png;base64,/, '');
-          fs.writeFileSync(filepath, Buffer.from(base64, 'base64'));
-          console.log(`Screenshot saved: ${filepath}`);
-          const fwd = JSON.stringify(msg);
-          for (const c of clients) {
-            if (c !== ws && c.readyState === WebSocket.OPEN) c.send(fwd);
-          }
-        }
-      } catch {}
-    });
-
-    ws.on('close', () => { clients.delete(ws); });
-  });
-
-  return wss;
-}

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "declaration": true
-  },
-  "include": ["src"]
-}