openzoo 0.51.4 → 0.51.5

package/transmute/lib/cli.js

@@ -1,293 +0,0 @@
-// The openzoo-transmute command line.
-//
-// The openzoo package can mount these subcommands in its own bin without
-// duplicating anything:
-//
-//   case 'build': case 'deploy': case 'serve':
-//     await (await import('openzoo-transmute/lib/cli.js')).run(process.argv.slice(2));
-//
-// `run(argv)` resolves to the exit code (0 = ok) and also sets
-// `process.exitCode` when non-zero; it never calls `process.exit` itself so a
-// `serve` keeps the event loop (and the http server) alive.
-import fs from 'node:fs';
-import path from 'node:path';
-import { PublicKey } from '@solana/web3.js';
-import { readDeployment } from './vercel.js';
-import { build } from './build.js';
-import { deploy, deployRuntime, resolveOutDir, clusterLabel } from './deploy.js';
-import { startGateway, DEFAULT_PORT } from './gateway.js';
-import { startHub, DEFAULT_HUB_PORT } from './hub.js';
-import { connect, getProgramInfo, getSiteInfo, readManifest } from './solana.js';
-import { loadWallet, rpcUrl } from './wallet.js';
-import { MANIFEST_PATH } from './wire.js';
-
-export const USAGE = `openzoo-transmute — Vercel app → Solana program + asset accounts
-
-usage:
-  openzoo-transmute build   [dir] [--target shared|program] [--out .zoo-out] [--name <crate>] [--arch v0|v3] [--cluster <c>] [--skip-cargo]
-                            --target shared (default): bytecode for the shared zoo-vm runtime — a site is data accounts only (≈0.05–0.1 SOL)
-                            --target program: your own Pinocchio program per site (≈1 SOL+)
-  openzoo-transmute deploy  [dir|outDir] [--cluster mainnet|devnet|localnet|<url>] [--keypair <path>] [--yes] [--runtime <zoo-vm id>]
-                            [--program <id>] [--concurrency 4] [--skip-assets] [--force] [--headroom 1.5]
-  openzoo-transmute serve   <siteId|programId> [--runtime <zoo-vm id>] [--cluster <c>] [--port ${DEFAULT_PORT}] [--keypair <path>] [--host 127.0.0.1] [--quiet]
-  openzoo-transmute runtime deploy [--cluster <c>] [--keypair <path>] [--yes] [--program-keypair zoo-vm-keypair.json] [--so <path>]
-                            deploy (or upgrade) the shared zoo-vm runtime once per cluster
-  openzoo-transmute runtime status <zoo-vm id> [--cluster <c>]
-  openzoo-transmute hub     [--cluster mainnet] [--port 8080] [--host 0.0.0.0] [--public-url <https://…>]
-                            hosted explorer for EVERY program on the cluster (/s/<programId>), read-only
-  openzoo-transmute inspect [dir]                 print the Vercel model + eligibility report
-  openzoo-transmute status  <programId> [--cluster <c>]
-  openzoo-transmute help
-
-clusters: mainnet (default, needs --yes to deploy), devnet, testnet, localnet, or an RPC URL.
-env: OPENZOO_CLUSTER, OPENZOO_RPC (mainnet RPC), OPENZOO_KEYPAIR / OPENZOO_WALLET (signer), OPENZOO_VM_PROGRAM (shared runtime id).
-`;
-
-/** `--k v`, `--k=v`, `--flag`, `--no-flag`; everything else is positional. */
-export function parseArgs(argv) {
-  const flags = {};
-  const positionals = [];
-  const boolFlags = new Set(['yes', 'skip-cargo', 'skip-assets', 'force', 'quiet', 'help', 'json', 'version']);
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === '--') { positionals.push(...argv.slice(i + 1)); break; }
-    if (a.startsWith('--')) {
-      const eq = a.indexOf('=');
-      let key = eq >= 0 ? a.slice(2, eq) : a.slice(2);
-      let val;
-      if (eq >= 0) val = a.slice(eq + 1);
-      else if (key.startsWith('no-')) { key = key.slice(3); val = false; }
-      else if (boolFlags.has(key) || i + 1 >= argv.length || argv[i + 1].startsWith('--')) val = true;
-      else val = argv[++i];
-      flags[key] = val;
-      flags[key.replace(/-([a-z])/g, (_, c) => c.toUpperCase())] = val;
-    } else if (a === '-h') flags.help = true;
-    else if (a === '-y') flags.yes = true;
-    else positionals.push(a);
-  }
-  return { cmd: positionals[0] || 'help', positionals: positionals.slice(1), flags };
-}
-
-function fmtBytes(n) { return n == null ? '?' : n.toLocaleString() + ' B'; }
-
-export function inspectText(deployment, report = null) {
-  const lines = [];
-  lines.push(`${deployment.root}`);
-  lines.push(`source: ${deployment.source}${deployment.framework ? ` · framework: ${deployment.framework}` : ''} · static dir: ${deployment.staticDir ? path.relative(deployment.root, deployment.staticDir) || '.' : '-'}`);
-  for (const n of deployment.notes) lines.push(`note: ${n}`);
-  lines.push('');
-  lines.push(`functions (${deployment.functions.length}):`);
-  const inel = new Map((report?.ineligible || []).map((i) => [i.name, i]));
-  const elig = new Set((report?.eligible || []).map((e) => (typeof e === 'string' ? e : e.name)));
-  for (const f of deployment.functions) {
-    const mark = report ? (inel.has(f.name) ? '✗' : elig.has(f.name) ? '✓' : '?') : ' ';
-    const meth = f.methods ? f.methods.join(',') : 'any';
-    lines.push(`  ${mark} ${f.routePath.padEnd(32)} ${f.style.padEnd(12)} ${f.runtime.padEnd(11)} ${String(f.maxDuration + 's').padEnd(5)} ${String(f.memory + 'MB').padEnd(7)} ${meth}${f.params.length ? `  params=${f.params.join(',')}` : ''}${f.middleware ? '  middleware' : ''}${f.prerender ? '  ISR' : ''}`);
-    lines.push(`      ${f.sourceFile ? path.relative(deployment.root, f.sourceFile) : '(no source)'}${Object.keys(f.environment || {}).length ? `  env=${Object.keys(f.environment).join(',')}` : ''}`);
-    const r = inel.get(f.name);
-    if (r) lines.push(`      ineligible: ${r.reason}${r.line ? ` (line ${r.line})` : ''}`);
-  }
-  if (deployment.crons.length) { lines.push(''); lines.push(`crons (${deployment.crons.length}) — not transmuted, Solana has no scheduler:`); for (const c of deployment.crons) lines.push(`  ${c.schedule || '?'}  ${c.path || ''}`); }
-  lines.push('');
-  const total = deployment.staticFiles.reduce((n, f) => n + f.size, 0);
-  lines.push(`static files (${deployment.staticFiles.length}, ${fmtBytes(total)}):`);
-  for (const f of deployment.staticFiles.slice(0, 60)) lines.push(`  ${f.path.padEnd(48)} ${f.contentType.padEnd(32)} ${fmtBytes(f.size)}`);
-  if (deployment.staticFiles.length > 60) lines.push(`  … ${deployment.staticFiles.length - 60} more`);
-  if (report) {
-    lines.push('');
-    lines.push(`eligibility: ${report.eligible.length} eligible, ${report.ineligible.length} ineligible, ${report.warnings.length} warning(s)`);
-    for (const w of report.warnings) lines.push(`  ! ${typeof w === 'string' ? w : w.message || JSON.stringify(w)}`);
-  }
-  const routes = deployment.config?.routes || [];
-  if (routes.length) {
-    lines.push('');
-    lines.push(`routes (${routes.length}):`);
-    for (const r of routes) lines.push('  ' + (r.handle ? `[handle: ${r.handle}]` : `${r.src} → ${r.dest || (r.status ? `status ${r.status}` : '(headers)')}${r.continue ? ' (continue)' : ''}`));
-  }
-  return lines.join('\n');
-}
-
-async function tryTransmute(deployment) {
-  try {
-    const mod = await import('./compile/index.js');
-    if (typeof mod.transmute !== 'function') return null;
-    const r = await mod.transmute(deployment, { name: 'inspect', dryRun: true });
-    return r?.report || null;
-  } catch (e) {
-    if (e?.code === 'ERR_MODULE_NOT_FOUND') return null;
-    return { eligible: [], ineligible: [], warnings: [`compiler failed: ${e?.message || e}`] };
-  }
-}
-
-export const DEFAULT_TARGET = 'shared';
-
-/** `--runtime` is the zoo-vm program id (shared) — or, for `--target program`, a zoo-host checkout path. */
-function runtimeFlag(f) {
-  const v = f.runtime;
-  if (typeof v !== 'string') return { runtime: process.env.OPENZOO_VM_PROGRAM || null, runtimePath: f.runtimePath || undefined };
-  if (fs.existsSync(v) && fs.existsSync(path.join(v, 'Cargo.toml'))) return { runtime: process.env.OPENZOO_VM_PROGRAM || null, runtimePath: v };
-  new PublicKey(v);
-  return { runtime: v, runtimePath: f.runtimePath || undefined };
-}
-
-async function cmdBuild(p, f, log) {
-  const target = f.target || process.env.OPENZOO_TARGET || DEFAULT_TARGET;
-  if (!['shared', 'program'].includes(target)) throw new Error(`--target must be shared or program (got ${target})`);
-  const { runtime, runtimePath } = runtimeFlag(f);
-  const r = await build(p[0] || '.', { out: f.out, name: f.name, arch: f.arch, cluster: f.cluster, target, runtime, runtimePath, skipCargo: !!f.skipCargo, log });
-  if (f.json) log(JSON.stringify({ outDir: r.outDir, target: r.target || 'program', soPath: r.soPath, codePath: r.codePath || null, codeSize: r.codeSize || null, arch: r.arch, report: r.report, costEstimate: { sol: r.costEstimate.sol, totalSol: r.costEstimate.totalSol, source: r.costEstimate.source } }, null, 2));
-  return r.report.ineligible.length && !r.report.eligible.length && r.manifest.routes.length === 0 && r.deployment.functions.length ? 2 : 0;
-}
-
-async function cmdDeploy(p, f, log) {
-  const { runtime } = runtimeFlag(f);
-  const r = await deploy({ outDir: p[0] || '.', cluster: f.cluster, keypair: f.keypair, programId: f.program, runtime, yes: !!f.yes, concurrency: f.concurrency ? Number(f.concurrency) : undefined, skipAssets: !!f.skipAssets, force: !!f.force, headroom: f.headroom, log });
-  if (f.json) log(JSON.stringify(r, null, 2));
-  return 0;
-}
-
-async function cmdServe(p, f, log) {
-  let programId = p[0];
-  let { runtime } = runtimeFlag(f);
-  if (!programId) {
-    // Fall back to the last deploy in ./ or ./.zoo-out.
-    try {
-      const d = JSON.parse(fs.readFileSync(path.join(resolveOutDir('.'), '.zoo', 'deploy.json'), 'utf8'));
-      programId = d.target === 'shared' ? d.site : d.programId;
-      if (d.target === 'shared' && !runtime) runtime = d.runtime;
-    } catch { /* none */ }
-    if (!programId) throw new Error('usage: serve <siteId|programId> [--runtime <zoo-vm id>] (no .zoo/deploy.json found to infer it from)');
-  }
-  new PublicKey(programId); // validate
-  // Shared runtime: the positional is the site id, the program is zoo-vm.
-  let site = null;
-  if (runtime) { site = programId; programId = runtime; }
-  let keypair = null, walletPath = null;
-  if (f.keypair !== false) {
-    try { const w = loadWallet({ keypair: typeof f.keypair === 'string' ? f.keypair : undefined }); keypair = w.keypair; walletPath = w.path; }
-    catch (e) { if (typeof f.keypair === 'string') throw e; log(`no wallet found (${String(e.message).split(';')[0]}); mutating requests will answer 402`); }
-  }
-  const port = f.port != null ? Number(f.port) : DEFAULT_PORT;
-  const host = f.host || '127.0.0.1';
-  if (keypair && !/^(127\.0\.0\.1|localhost|::1|\[::1\])$/.test(host)) log(`warning: binding ${host} with a signer: anyone who can reach this gateway can send transactions paid by ${keypair.publicKey.toBase58()}; use --no-keypair unless that is intended`);
-  const gw = await startGateway({ programId, site, cluster: f.cluster, port, host, keypair, log, quiet: !!f.quiet });
-  const m = gw.state.manifest;
-  log(`openzoo-transmute gateway → ${gw.url}/  (explorer ${gw.url}/.zoo/, manifest ${gw.url}${MANIFEST_PATH})`);
-  log(`${site ? `site ${site} on runtime ${programId}` : `program ${programId}`} on ${gw.state.cluster} · ${m.routes.length} function(s), ${m.static ? m.static.length : '?'} asset(s) · signer ${keypair ? keypair.publicKey.toBase58() + (walletPath ? ` (${walletPath})` : '') : 'none (reads only)'}`);
-  for (const r of m.routes) log(`  ${(r.methods && r.methods.length ? r.methods.join('|') : 'ANY').padEnd(16)} ${r.routePath}`);
-  const stop = () => gw.close().then(() => process.exit(0));
-  process.once('SIGINT', stop);
-  process.once('SIGTERM', stop);
-  return 0;
-}
-
-async function cmdInspect(p, f, log) {
-  const deployment = readDeployment(p[0] || '.');
-  const report = await tryTransmute(deployment);
-  if (f.json) log(JSON.stringify({ ...deployment, report }, null, 2));
-  else {
-    log(inspectText(deployment, report));
-    if (!report) log('\n(compiler not available: eligibility not checked)');
-  }
-  return 0;
-}
-
-async function cmdStatus(p, f, log) {
-  if (!p[0]) throw new Error('usage: status <siteId|programId> [--runtime <zoo-vm id>] [--cluster <c>]');
-  const { runtime } = runtimeFlag(f);
-  const rpc = rpcUrl(f.cluster);
-  const connection = connect(rpc);
-  if (runtime) {
-    const site = new PublicKey(p[0]);
-    const [info, manifest] = await Promise.all([getSiteInfo(connection, new PublicKey(runtime), site), readManifest(connection, new PublicKey(runtime), site).catch(() => null)]);
-    const out = { site: site.toBase58(), runtime, cluster: clusterLabel(f.cluster), rpc: rpc.replace(/\?.*$/, ''), exists: info.exists, authority: info.authority ? info.authority.toBase58() : null, account: info.pda.toBase58(), manifest: manifest ? { name: manifest.name, routes: manifest.routes?.length ?? 0, static: manifest.static?.length ?? 0, deployedAt: manifest.deployedAt } : null };
-    if (f.json) { log(JSON.stringify(out, null, 2)); return info.exists ? 0 : 1; }
-    log(`site        ${out.site} on runtime ${runtime} (${out.cluster})`);
-    if (!info.exists) { log('status      NOT DEPLOYED'); return 1; }
-    log(`authority   ${out.authority}`);
-    log(`account     ${out.account}`);
-    if (manifest) { log(`manifest    ${manifest.name || ''} · ${out.manifest.routes} function(s), ${out.manifest.static} asset(s) · deployed ${manifest.deployedAt || '?'}`); for (const r of manifest.routes || []) log(`  ${(r.methods && r.methods.length ? r.methods.join('|') : 'ANY').padEnd(16)} ${r.routePath}`); }
-    else log(`manifest    none at ${MANIFEST_PATH}`);
-    return 0;
-  }
-  const programId = new PublicKey(p[0]);
-  const [info, slot, manifest] = await Promise.all([getProgramInfo(connection, programId), connection.getSlot('confirmed'), readManifest(connection, programId).catch(() => null)]);
-  const out = {
-    programId: programId.toBase58(), cluster: clusterLabel(f.cluster), rpc: rpc.replace(/\?.*$/, ''), slot,
-    exists: info.exists, executable: info.executable ?? null, authority: info.authority ? info.authority.toBase58() : null,
-    deploySlot: info.slot, maxDataLen: info.maxDataLen, programData: info.programData.toBase58(),
-    manifest: manifest ? { name: manifest.name, framework: manifest.framework, routes: manifest.routes?.length ?? 0, static: manifest.static?.length ?? 0, deployedAt: manifest.deployedAt, arch: manifest.arch } : null,
-  };
-  if (f.json) { log(JSON.stringify(out, null, 2)); return info.exists ? 0 : 1; }
-  log(`program     ${out.programId} on ${out.cluster} (${out.rpc}) @ slot ${slot}`);
-  if (!info.exists) { log('status      NOT DEPLOYED'); return 1; }
-  log(`status      deployed at slot ${out.deploySlot}${out.executable === false ? ' (not executable!)' : ''}`);
-  log(`authority   ${out.authority || 'none (immutable)'}`);
-  log(`programData ${out.programData} (max ${out.maxDataLen?.toLocaleString()} B)`);
-  if (manifest) {
-    log(`manifest    ${manifest.name || ''} ${manifest.framework || ''} · ${out.manifest.routes} function(s), ${out.manifest.static} asset(s) · deployed ${manifest.deployedAt || '?'}${manifest.arch ? ` (${manifest.arch})` : ''}`);
-    for (const r of manifest.routes || []) log(`  ${(r.methods && r.methods.length ? r.methods.join('|') : 'ANY').padEnd(16)} ${r.routePath}`);
-  } else log(`manifest    none at ${MANIFEST_PATH}`);
-  return 0;
-}
-
-/**
- * Run the CLI. Returns the exit code; prints errors to stderr.
- * @param {string[]} argv  arguments after the program name
- * @param {{log?:Function, error?:Function}} io
- */
-async function cmdHub(p, f, log) {
-  // The hosted explorer: every program on the cluster from one public host,
-  // read-only by default (a public signer would be a drain). --keypair opts in.
-  const cluster = f.cluster || process.env.OPENZOO_CLUSTER || 'mainnet';
-  // A signer makes the demo real (visitors can POST). It is bounded: a per-IP
-  // rate limit and a daily SOL budget (OPENZOO_HUB_WRITE_BUDGET_SOL), so a
-  // public hub can sign without being drained. Keypair from --keypair or the
-  // OPENZOO_HUB_KEYPAIR secret (JSON byte array).
-  let keypair = null;
-  if (typeof f.keypair === 'string') keypair = loadWallet({ keypair: f.keypair }).keypair;
-  else if (process.env.OPENZOO_HUB_KEYPAIR) { const { Keypair } = await import('@solana/web3.js'); keypair = Keypair.fromSecretKey(Uint8Array.from(JSON.parse(process.env.OPENZOO_HUB_KEYPAIR))); }
-  if (keypair) log(`hub signs writes with ${keypair.publicKey.toBase58()} (budget ${process.env.OPENZOO_HUB_WRITE_BUDGET_SOL || '0.05'} SOL/day, ${process.env.OPENZOO_HUB_WRITES_PER_MIN || '3'} writes/min/ip)`);
-  const port = f.port != null ? Number(f.port) : Number(process.env.PORT || DEFAULT_HUB_PORT);
-  const h = await startHub({ cluster, port, host: f.host || '0.0.0.0', keypair, log, quiet: !!f.quiet, publicUrl: f.publicUrl || process.env.OPENZOO_HUB_URL || null, maxSites: f.maxSites ? Number(f.maxSites) : undefined });
-  log(`openzoo hub → ${h.url}/.hub  (cluster ${cluster}; sites at ${h.url}/s/<programId>)`);
-  const stop = () => h.close().then(() => process.exit(0));
-  process.once('SIGINT', stop);
-  process.once('SIGTERM', stop);
-  return 0;
-}
-
-async function cmdRuntime(p, f, log) {
-  const sub = p[0];
-  if (sub === 'deploy') {
-    const r = await deployRuntime({ cluster: f.cluster, keypair: f.keypair, yes: !!f.yes, programKeypair: f.programKeypair, so: f.so, headroom: f.headroom, log });
-    if (f.json) log(JSON.stringify(r, null, 2));
-    return 0;
-  }
-  if (sub === 'status') {
-    if (!p[1]) throw new Error('usage: runtime status <zoo-vm id> [--cluster <c>]');
-    return cmdStatus([p[1]], { ...f, runtime: undefined }, log);
-  }
-  throw new Error('usage: runtime deploy|status');
-}
-
-export async function run(argv = process.argv.slice(2), io = {}) {
-  const log = io.log ?? console.log;
-  const error = io.error ?? console.error;
-  const { cmd, positionals, flags } = parseArgs(argv);
-  if (flags.version) { log(JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version); return 0; }
-  if (flags.help || cmd === 'help' || cmd === '--help') { log(USAGE); return 0; }
-  const commands = { build: cmdBuild, deploy: cmdDeploy, serve: cmdServe, inspect: cmdInspect, status: cmdStatus, hub: cmdHub, runtime: cmdRuntime };
-  const fn = commands[cmd];
-  if (!fn) { error(`unknown command: ${cmd}\n`); error(USAGE); process.exitCode = 1; return 1; }
-  try {
-    const code = (await fn(positionals, flags, log)) || 0;
-    if (code) process.exitCode = code;
-    return code;
-  } catch (e) {
-    error(`error: ${e?.message || e}`);
-    if (process.env.OPENZOO_DEBUG && e?.stack) error(e.stack);
-    process.exitCode = 1;
-    return 1;
-  }
-}