@genex-ai/cli-demo 1.4.0 → 1.4.1-dev.375

package/dist/index.js

@@ -8,7 +8,7 @@ import fs from "fs";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var RAW_CHANNEL = "latest";
+var RAW_CHANNEL = "dev";
 var CLI_CHANNEL = RAW_CHANNEL === "dev" ? "dev" : "latest";
 var STANDS = {
   prod: { api: "https://api.genex.games", dashboard: "https://genex.games" },
@@ -4890,6 +4890,157 @@ async function runMakeRemixable(opts) {
   }
 }
 
+// src/commands/domain.ts
+var SUBCOMMANDS = ["add", "list", "verify", "remove"];
+function statusWord(d) {
+  if (d.status === "active") return c.green("live");
+  if (d.status === "failed") return c.red("stopped");
+  return c.dim("waiting for DNS");
+}
+async function runDomain(opts) {
+  const log = createLogger({ quiet: opts.quiet });
+  const sub = (opts.name ?? "list").trim();
+  if (!SUBCOMMANDS.includes(sub)) {
+    log.error(`Unknown subcommand \`${sub}\`. Use: ${SUBCOMMANDS.join(", ")}.`);
+    process.exitCode = 1;
+    return;
+  }
+  const needsHost = sub !== "list";
+  const hostname = opts.hostname?.trim();
+  if (needsHost && !hostname) {
+    log.error(`\`genex domain ${sub}\` needs a hostname, e.g. ${c.cyan(`genex domain ${sub} play.yourdomain.com`)}.`);
+    process.exitCode = 1;
+    return;
+  }
+  const meta = await readProject();
+  if (!meta?.id) {
+    log.error("This folder isn't linked to a game.");
+    log.dim(`  Run ${c.cyan("genex link")} (or ${c.cyan("genex list")} to find the slug) first.`);
+    process.exitCode = 1;
+    return;
+  }
+  const apiUrl = getApiUrl(opts.apiUrl ?? meta.apiUrl);
+  let token = opts.token ?? await readUserToken(opts.envPath);
+  if (!token) {
+    if (opts.noAuth) {
+      log.error("Not signed in. Re-run without --no-auth to connect.");
+      process.exitCode = 1;
+      return;
+    }
+    log.plain("Not signed in \u2014 connecting\u2026");
+    try {
+      token = await authorize(apiUrl, getAuthUrl(opts.authUrl), {
+        log,
+        inlineWaitMs: opts.timeoutSec ? opts.timeoutSec * 1e3 : void 0
+      });
+    } catch (err) {
+      if (err instanceof AuthPendingError) {
+        printAuthHandoff(log, err);
+        log.dim(`Then re-run ${c.cyan(`genex domain ${sub}`)}.`);
+        return;
+      }
+      log.error(`Sign-in didn't complete: ${err instanceof Error ? err.message : String(err)}`);
+      process.exitCode = 1;
+      return;
+    }
+    await writeUserToken(token, opts.envPath);
+  }
+  const base = `${apiUrl}/api/projects/${encodeURIComponent(meta.id)}/domains`;
+  const auth = { Authorization: `Bearer ${token}` };
+  const call = (url, init2) => apiFetch(url, { ...init2, headers: { ...auth, "Content-Type": "application/json", ...init2?.headers ?? {} } });
+  let res;
+  try {
+    if (sub === "list") res = await call(base);
+    else if (sub === "add") res = await call(base, { method: "POST", body: JSON.stringify({ hostname }) });
+    else if (sub === "verify")
+      res = await call(`${base}/${encodeURIComponent(hostname)}/verify`, { method: "POST" });
+    else res = await call(`${base}/${encodeURIComponent(hostname)}`, { method: "DELETE" });
+  } catch (err) {
+    log.error(`Couldn't reach the API at ${apiUrl}.`);
+    log.dim(`  ${String(err)}`);
+    process.exitCode = 1;
+    return;
+  }
+  if (!res.ok) {
+    if (await printedStructuredError(res)) {
+      process.exitCode = 1;
+      return;
+    }
+    const body = await res.json().catch(() => null);
+    if (res.status === 503) {
+      log.error("Custom domains aren't available on this Genex environment yet.");
+    } else if (res.status === 404) {
+      log.error(sub === "list" || sub === "add" ? "That game wasn't found on this account." : `${hostname} isn't connected to this game.`);
+    } else {
+      log.error(body?.message ?? body?.error ?? `Request failed (${res.status}).`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+  const data = await res.json();
+  if (opts.json) {
+    log.plain(JSON.stringify(data, null, 2));
+    return;
+  }
+  if (sub === "list") {
+    const rows = data.domains ?? [];
+    if (rows.length === 0) {
+      log.plain("No domains connected to this game.");
+      log.dim(`  ${c.cyan("genex domain add play.yourdomain.com")} to connect one.`);
+      return;
+    }
+    for (const d of rows) log.plain(`  ${d.hostname.padEnd(34)} ${statusWord(d)}`);
+    return;
+  }
+  if (sub === "add") {
+    if (data.supported === false) {
+      log.plain(String(data.message ?? "That domain's DNS host doesn't support one-click setup."));
+      const manual = data.manual;
+      const records = Array.isArray(manual?.records) ? manual.records : [];
+      if (records.length > 0) {
+        log.plain("");
+        log.plain("  Add these two records at your DNS host:");
+        log.plain("");
+        for (const r of records) {
+          log.plain(`    ${c.cyan(String(r.type ?? ""))}  ${String(r.name ?? "")}`);
+          log.plain(`          ${String(r.value ?? "")}`);
+        }
+        log.plain("");
+        if (manual?.apexHint) {
+          log.dim("  At a root domain your host may call the first one ALIAS or ANAME.");
+        }
+        log.dim(`  Then run: genex domain verify ${String(data.hostname ?? "")}`);
+        log.dim("  DNS can take a few minutes to spread.");
+        return;
+      }
+      log.dim("  Your game stays reachable at its usual address.");
+      return;
+    }
+    const applyUrl = String(data.applyUrl ?? "");
+    const providerName = String(data.providerName ?? "your DNS host");
+    log.success(`${data.hostname} can be connected through ${providerName}.`);
+    log.plain("");
+    log.plain(`  Approve the DNS change here: ${c.cyan(applyUrl)}`);
+    log.plain("");
+    log.dim("  One click writes the records. Nothing to copy or paste.");
+    if (!applyUrl.startsWith("https://")) {
+      log.warn("That DNS host returned a setup link we could not verify \u2014 not opening it.");
+    } else if (!opts.noOpen) {
+      openBrowser(applyUrl, () => log.dim("  (Couldn't open a browser \u2014 use the link above.)"));
+    }
+    log.dim(`  Then ${c.cyan(`genex domain verify ${String(data.hostname)}`)} once you have approved it.`);
+    return;
+  }
+  if (sub === "verify") {
+    const status = String(data.status ?? "");
+    if (status === "active") log.success(`${hostname} is live.`);
+    else if (status === "failed") log.error(`${hostname} is stopped \u2014 its verification record is missing.`);
+    else log.plain(`${hostname} isn't verified yet \u2014 DNS changes can take a few minutes to spread.`);
+    return;
+  }
+  log.success(`${hostname} disconnected.`);
+}
+
 // src/lib/promote.ts
 async function promoteBuild(apiUrl, projectId, token, log) {
   let res;
@@ -19018,6 +19169,10 @@ ${c.bold("Usage")}
   genex publish [options]            Build + push + make live, then list it in the gallery.
   genex make-remixable [options]     Make THIS game remixable by everyone \u2014 migrates a
                                      private source onto a public managed genex repo.
+  genex domain <sub> [host]          Play this game on a domain you own:
+                                     add | list | verify | remove. "add" opens a
+                                     one-click approval at your DNS host \u2014 no
+                                     records to copy or paste.
   genex model "<prompt>" [options]   Generate a 3D model (GLB); prints a public asset URL.
   genex skybox "<prompt>" [options]  Generate a skybox (equirect); prints a public asset URL.
   genex sfx "<prompt>" [options]     Generate a sound effect (mp3); prints a public asset URL.
@@ -19259,6 +19414,8 @@ ${c.bold("Examples")}
   genex publish
   genex publish --categories games,vfx
   genex make-remixable
+  genex domain add play.mygame.com
+  genex domain list
   genex publish --no-push --title "My Game"
   genex model "weathered wooden barrel with iron bands"
   genex skybox "golden hour over a misty mountain range"
@@ -19382,6 +19539,9 @@ function parseArgs(argv) {
       case "--no-auth":
         parsed.options.noAuth = true;
         break;
+      case "--no-open":
+        parsed.options.noOpen = true;
+        break;
       case "--no-push":
         parsed.options.noPush = true;
         break;
@@ -19516,6 +19676,12 @@ function parseArgs(argv) {
           } else {
             (parsed.options.selectors ??= []).push(arg);
           }
+        } else if (parsed.command === "domain") {
+          if (!parsed.options.hostname) parsed.options.hostname = arg;
+          else {
+            parsed.error = `Unexpected argument: ${arg}`;
+            return parsed;
+          }
         } else if (parsed.command === "animations") {
           parsed.options.query = parsed.options.query ? `${parsed.options.query} ${arg}` : arg;
         } else {
@@ -19851,6 +20017,9 @@ async function main() {
       case "make-remixable":
         await runMakeRemixable(parsed.options);
         break;
+      case "domain":
+        await runDomain(parsed.options);
+        break;
       case "controller":
         await runController({ ...parsed.options, kind: parsed.options.name });
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.4.0",
+  "version": "1.4.1-dev.375",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-ai-skybox/SKILL.md

@@ -116,7 +116,7 @@ scene.background = texture; // keep the raw texture for the visible sky
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this skybox generation. Tell the user the facts the CLI printed: their balance, this
   generation's cost, and when their credits refill. Then offer to continue the build

package/templates/skills/genex-ai-texture/SKILL.md

@@ -225,7 +225,7 @@ first one is the one a screenshot of the whole arena will not show you.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this texture generation. Tell the user the facts the CLI printed: their balance,
   this generation's cost, and when their credits refill. Then offer to continue the

package/templates/skills/genex-ai-video/SKILL.md

@@ -151,7 +151,7 @@ set belongs to `$genex-ai-hud` — both build on `npx genex image`/`video`.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
 - **Nothing plays / black surface** — the first `video.play()` must run inside a user

package/templates/skills/genex-getting-started/SKILL.md

@@ -159,7 +159,7 @@ and re-link the clone to the same live game:
 ```bash
 git clone <the game's repo url> my-game && cd my-game
 npm install
-npx @genex-ai/cli-demo@latest link <slug>   # slug = the name in the play URL
+npx @genex-ai/cli-demo@dev link <slug>   # slug = the name in the play URL
 ```
 
 Don't know the slug? **`npx genex list`** prints every game on your account —
@@ -186,7 +186,7 @@ Safe to run any time — genex-owned skills are refreshed to the latest version,
 and your own files are never touched:
 
 ```bash
-npx @genex-ai/cli-demo@latest init
+npx @genex-ai/cli-demo@dev init
 ```
 
 Use `--force` only if you intentionally want your own existing files overwritten

package/templates/skills/genex-threejs-visual-validation/SKILL.md

@@ -134,9 +134,13 @@ everything twice.
    visible; the lock may only ever engage from the Play/Resume click or a
    gameplay canvas click (the phase binding `setPaused(phase !== "playing")` is
    what guarantees this — check it rides `setPhase`, not the render loop).
-   Headless caveat: `requestPointerLock` throws in headless Chromium —
-   assert the wiring and the unlocked cue in a screenshot, and say plainly that
-   the lock itself needs one manual click (do the both-axes look check there).
+   Headless caveat, measured on Chromium 151: `requestPointerLock` does NOT
+   throw — it locks, with or without a user gesture, so the lock and the
+   unlocked cue ARE yours to assert headless. What does not survive is the
+   both-axes look check: synthesised mouse movement cancels to a net zero
+   delta, so turning right then left proves nothing about direction. Assert the
+   wiring and the cue in a screenshot, and say plainly that confirming which way
+   the view turns needs one manual pass with a real mouse.
 7. **Ask the scene the three things the screenshot cannot answer** (below). Run it
    once, in the same browser you already have open.
 

package/templates/skills/genex-updates/SKILL.md

@@ -38,7 +38,7 @@ update, so update immediately.)
 Run exactly the command the nudge printed, from the game project root:
 
 ```bash
-npm i -D @genex-ai/cli-demo@latest   # the genex CLI (a dev dependency)
+npm i -D @genex-ai/cli-demo@dev   # the genex CLI (a dev dependency)
 npm i @genex-ai/embed-sdk@latest     # identity/saves SDK (ships inside the game)
 npm i @genex-ai/multiplayer@latest   # multiplayer SDK (only if the game uses it)
 ```