Skip to content

Official Codebase of 3DCodeVerse

Python
2.6 KB
Raw Blame
/**
 * Node-side environment for the scene host drivers: browser launch and
 * workspace serving.  Thin ESM adapters over the two CJS runtime modules —
 * `gpu_launch.cjs` (GPU-verified headless Chrome) and `serve.cjs` (loopback
 * static server + import map).  Consumers: `lib/host_page.mjs` (scenes) and
 * `render_glb.mjs` (objects) — no other module reaches for the CJS files.
 */

import fs from 'node:fs';
import path from 'node:path';
import { createRequire } from 'node:module';
import { fileURLToPath } from 'node:url';

const require_ = createRequire(import.meta.url);
export const RUNTIME_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');

const gpuLaunch = require_(path.join(RUNTIME_ROOT, 'gpu_launch.cjs'));
const serve = require_(path.join(RUNTIME_ROOT, 'serve.cjs'));

// launchBrowser({gpu}) — see gpu_launch.cjs.  serveDirs({root, mounts, routes}) — the object
// renderer serves the GLB's directory this way; scenes go through `serveWorkspace` below.
// importMapHtml() resolves 'three' and 'three/addons/*' to the local runtime copy, which is
// served under RUNTIME_MOUNT ('/__runtime/').
export const { launchBrowser } = gpuLaunch;
export const { serveDirs, importMapHtml, RUNTIME_MOUNT } = serve;

/**
 * Serve a workspace on 127.0.0.1:0 with these mounts:
 *   /src/** /public/**      → <ws>/src, <ws>/public
 *   /assets/**              → <ws>/public/assets  (contract: '/assets/x.glb')
 *   <RUNTIME_MOUNT>/**      → runtime_js (node_modules/three, lib/*.mjs)
 *   /__host.html            → generated host page (import map + scene_host.mjs)
 *   /__census.glb           → `glb` (an offline scene's census GLB, lib/glb_scene.mjs), when given
 * @returns {Promise<{server, base: string, close: () => Promise<void>}>}
 */
export async function serveWorkspace(wsRoot, { hostHtml = '', glb = null } = {}) {
  wsRoot = path.resolve(wsRoot);
  const srv = await serve.serveDirs({
    // explicit mounts, no `root`: the workspace root also holds spec.json, run_state.json,
    // events.jsonl, .git/ and artifacts/ — generated scene code must not be able to GET them.
    mounts: {
      '/src/': path.join(wsRoot, 'src'),
      '/public/': path.join(wsRoot, 'public'),
      '/assets/': path.join(wsRoot, 'public', 'assets'),
    },
    routes: {
      '/__host.html': { body: hostHtml, type: 'text/html; charset=utf-8' },
      // one file by exact path: artifacts/ itself stays unserved
      ...(glb ? { '/__census.glb': { body: fs.readFileSync(glb), type: 'model/gltf-binary' } } : {}),
    },
  });
  return { server: srv.server, base: srv.base, close: srv.close };
}