arcadible 0.1.18 → 0.1.20

package/bin/arc-default.js

@@ -30,13 +30,17 @@ const main = function (argv) {
     yargs(hideBin(argv))
       .scriptName(CMD)
       .usage("$0 <command> [options]")
-      .command("init", "Initialize a project")
-      .command("validate", "Validate project workspace")
-      .command("deploy", "Deploy to Arcadible")
-      .command("inspect", "Inspect project metadata")
+      .command("init", "Initialize project")
+      .command("inspect", "Inspect project")
+      .command("validate", "Validate project")
+      .command("build", "Build project")
+      .command("pack", "Package project")
+      .command("deploy", "Deploy project")
+      .command("open", "Open a game's store page")
+      .command("play", "Play a game")
       .command("login", "Log in to Arcadible")
-      .command("logout", "Log out of Arcadible")
       .command("whoami", "Show Arcadible account")
+      .command("logout", "Log out of Arcadible")
       .help("help")
       .alias("help", "h")
       .version(pkg.version)

package/bin/arc-deploy.js

@@ -42,8 +42,8 @@ const SUBCMD = "deploy";
 // [define]
 
 const conf = {
-  git: false,
   json: false,
+  method: "direct",
   quiet: false,
   ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
 };
@@ -97,7 +97,7 @@ const handler = function ({ json, pb, quiet, sw }) {
 // [function]
 
 const start = function (argv) {
-  const git = argv.git;
+  const git = argv.method === "git";
   const json = argv.json;
   const quiet = argv.quiet;
   const root = resolve(process.cwd(), argv.cwd);
@@ -110,7 +110,7 @@ const start = function (argv) {
         throw new Error(phrase.issuesFound(count));
       }
       sw.stop();
-      sw = new SpinnerWheel("Checking login... %s");
+      sw = new SpinnerWheel("Checking... %s");
       return whoami({ handler: handler({ json, pb, quiet, sw }) });
     })
     .then((current) => {
@@ -211,12 +211,15 @@ const main = function (argv) {
   return start(
     yargs(hideBin(argv))
       .scriptName(`${CMD} ${SUBCMD}`)
-      .usage("$0 [options]")
-      .option("git", {
-        default: conf.git,
-        describe: "Deploy using Git workflow",
-        type: "boolean",
-      })
+      .usage("$0 [method] [options]")
+      .command("$0 [method]", false, (cli) =>
+        cli.positional("method", {
+          choices: ["direct", "git"],
+          default: conf.method,
+          describe: "Deploy method",
+          type: "string",
+        }),
+      )
       .option("json", {
         alias: "j",
         default: conf.json,

package/bin/arc-init.js

@@ -73,14 +73,13 @@ const handler = function ({ json, quiet, sw }) {
 const start = function (argv) {
   const json = argv.json;
   const quiet = argv.quiet;
-  const root = resolve(process.cwd(), argv.cwd);
   const sw = new SpinnerWheel("Initializing... %s");
   return init({
     force: true,
     handler: handler({ json, quiet, sw }),
     patch: argv.patch,
     project: argv.project,
-    root,
+    root: resolve(process.cwd(), argv.cwd),
     template: argv.template,
   })
     .then((project) => {

package/bin/arc-inspect.js

@@ -17,12 +17,14 @@ const log = require("../src/util/log");
 const output = require("../src/util/output");
 const pkg = require("../package.json");
 const rc = require("../src/util/rc");
+const spinner = require("../src/util/spinner");
 
 // [use]
 
 const findRc = rc.findRc;
 const print = output.print;
 const resolve = path.resolve;
+const SpinnerWheel = spinner.SpinnerWheel;
 
 // [declare]
 
@@ -33,27 +35,46 @@ const SUBCMD = "inspect";
 
 const conf = {
   json: false,
-  key: "",
+  selector: null,
   ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
 };
 
 // [function]
 
+const handler = function ({ json, sw }) {
+  return {
+    onInspectFetch() {
+      sw.start(json);
+    },
+  };
+};
+
+// [function]
+
 const start = function (argv) {
   const json = argv.json;
-  const key = argv.key;
+  const selector = argv.selector;
+  const sw = new SpinnerWheel("Loading... %s");
   return inspect({
-    key,
+    game: null,
+    handler: handler({ json, sw }),
     root: resolve(process.cwd(), argv.cwd),
+    selector,
   })
     .then((data) => {
-      print(data, { key, toml: !json });
+      if (json) {
+        print(data);
+        return;
+      }
+      sw.stop(true);
+      print(data, { key: selector, toml: true });
     })
     .catch((ex) => {
       const message = ex.message;
       if (json) {
         print({ error: { message } });
       } else {
+        sw.stop(true);
         log.hd("Inspect aborted.");
         log.p(message);
       }
@@ -67,11 +88,11 @@ const main = function (argv) {
   return start(
     yargs(hideBin(argv))
       .scriptName(`${CMD} ${SUBCMD}`)
-      .usage("$0 [key] [options]")
-      .command("$0 [key]", false, (cli) =>
-        cli.positional("key", {
-          default: conf.key,
-          describe: "Metadata key",
+      .usage("$0 [selector] [options]")
+      .command("$0 [selector]", false, (cli) =>
+        cli.positional("selector", {
+          default: conf.selector,
+          describe: "Property selector",
           type: "string",
         }),
       )

package/bin/arc-login.js

@@ -4,7 +4,6 @@
 // [import]
 
 const hideBin = require("yargs/helpers").hideBin;
-const open = require("open");
 const qrcode = require("qrcode-terminal");
 const yargs = require("yargs/yargs");
 
@@ -14,11 +13,13 @@ const log = require("../src/util/log");
 const login = require("../src/cli/login");
 const pkg = require("../package.json");
 const rc = require("../src/util/rc");
+const shell = require("../src/util/shell");
 const spinner = require("../src/util/spinner");
 
 // [use]
 
 const findRc = rc.findRc;
+const launch = shell.launch;
 const SpinnerWheel = spinner.SpinnerWheel;
 
 // [declare]
@@ -77,7 +78,7 @@ const handler = function ({ browser, qrcode: qr, sw }) {
         if (browser) {
           log.nlp("Press Enter to open the URL.");
           onLoginEnter(() => {
-            open(link).catch(() => {});
+            launch(link);
           });
         }
       });

package/bin/arc-logout.js

@@ -11,18 +11,32 @@ const yargs = require("yargs/yargs");
 const log = require("../src/util/log");
 const logout = require("../src/cli/logout");
 const pkg = require("../package.json");
+const rc = require("../src/util/rc");
+
+// [use]
+
+const findRc = rc.findRc;
 
 // [declare]
 
 const CMD = "arc";
 const SUBCMD = "logout";
 
+// [define]
+
+const conf = {
+  quiet: false,
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
 // [function]
 
-const start = function () {
+const start = function (argv) {
   return logout()
     .then(() => {
-      log.hs("Logged out.");
+      if (!argv.quiet) {
+        log.hs("Logged out.");
+      }
     })
     .catch((ex) => {
       log.hd("Logout aborted.");
@@ -38,6 +52,12 @@ const main = function (argv) {
     yargs(hideBin(argv))
       .scriptName(`${CMD} ${SUBCMD}`)
       .usage("$0 [options]")
+      .option("quiet", {
+        alias: "q",
+        default: conf.quiet,
+        describe: "Output only errors",
+        type: "boolean",
+      })
       .help("help")
       .alias("help", "h")
       .version(pkg.version)

package/bin/arc-open.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const path = require("node:path");
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const cfguri = require("../src/config/uri");
+const log = require("../src/util/log");
+const open = require("../src/cli/open");
+const phrase = require("../src/phrase");
+const pkg = require("../package.json");
+const rc = require("../src/util/rc");
+const shell = require("../src/util/shell");
+
+// [use]
+
+const findRc = rc.findRc;
+const launch = shell.launch;
+const resolve = path.resolve;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "open";
+
+// [define]
+
+const conf = {
+  browser: false,
+  game: "self",
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const start = function (argv) {
+  return open({
+    game: argv.game,
+    root: resolve(process.cwd(), argv.cwd),
+  })
+    .then((data) => {
+      const page = data?.page;
+      if (!page) {
+        throw new Error(phrase.noGameId());
+      }
+      launch(
+        argv.browser
+          ? `${cfguri.HOST_HTTP_WWW}${page}`
+          : `${cfguri.HOST_APP_STORE}${page}`,
+      );
+    })
+    .catch((ex) => {
+      log.hd("Open aborted.");
+      log.p(ex.message);
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [game] [options]")
+      .command("$0 [game]", false, (cli) =>
+        cli.positional("game", {
+          default: conf.game,
+          describe: "Game handle or ID",
+          type: "string",
+        }),
+      )
+      .option("browser", {
+        default: conf.browser,
+        describe: "Open in a web browser",
+        type: "boolean",
+      })
+      .option("cwd", {
+        alias: "C",
+        default: ".",
+        describe: "Set the working directory",
+        type: "string",
+      })
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict()
+      .parse(),
+  );
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-pack.js

@@ -12,6 +12,7 @@ const yargs = require("yargs/yargs");
 
 // [import]
 
+const cfgworkflow = require("../src/config/workflow");
 const log = require("../src/util/log");
 const output = require("../src/util/output");
 const pack = require("../src/cli/pack");
@@ -36,9 +37,9 @@ const SUBCMD = "pack";
 // [define]
 
 const conf = {
-  input: null,
+  input: cfgworkflow.deploy_dir,
   json: false,
-  output: null,
+  output: ".arc/package/game.zip",
   quiet: false,
   ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
 };

package/bin/arc-play.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const path = require("node:path");
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const cfguri = require("../src/config/uri");
+const log = require("../src/util/log");
+const phrase = require("../src/phrase");
+const pkg = require("../package.json");
+const play = require("../src/cli/play");
+const rc = require("../src/util/rc");
+const shell = require("../src/util/shell");
+const spinner = require("../src/util/spinner");
+
+// [use]
+
+const findRc = rc.findRc;
+const launch = shell.launch;
+const resolve = path.resolve;
+const SpinnerWheel = spinner.SpinnerWheel;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "play";
+
+// [define]
+
+const conf = {
+  browser: false,
+  game: "self",
+  quiet: false,
+  release: "production",
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const handler = function ({ quiet, sw }) {
+  return {
+    onPlayFetch() {
+      sw.start(quiet);
+    },
+  };
+};
+
+// [function]
+
+const start = function (argv) {
+  const sw = new SpinnerWheel("Opening... %s");
+  return play({
+    game: argv.game,
+    handler: handler({ quiet: argv.quiet, sw }),
+    release: argv.release,
+    root: resolve(process.cwd(), argv.cwd),
+  })
+    .then((data) => {
+      const orientation = data?.orientation;
+      const url = data?.url;
+      if (!orientation || !url) {
+        throw new Error(phrase.noGameId());
+      }
+      sw.stop(true);
+      launch(
+        argv.browser ? url : `${cfguri.HOST_APP_PLAY}/${orientation}/${url}`,
+      );
+    })
+    .catch((ex) => {
+      sw.stop(true);
+      log.hd("Play aborted.");
+      log.p(ex.message);
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [game] [options]")
+      .command("$0 [game]", false, (cli) =>
+        cli.positional("game", {
+          default: conf.game,
+          describe: "Game handle or ID",
+          type: "string",
+        }),
+      )
+      .option("release", {
+        alias: "r",
+        default: conf.release,
+        describe: "Release channel or version",
+        type: "string",
+      })
+      .option("browser", {
+        default: conf.browser,
+        describe: "Open in a web browser",
+        type: "boolean",
+      })
+      .option("quiet", {
+        alias: "q",
+        default: conf.quiet,
+        describe: "Output only errors",
+        type: "boolean",
+      })
+      .option("cwd", {
+        alias: "C",
+        default: ".",
+        describe: "Set the working directory",
+        type: "string",
+      })
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict()
+      .parse(),
+  );
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-validate.js

@@ -41,7 +41,6 @@ const conf = {
 
 const start = function (argv) {
   const json = argv.json;
-  const quiet = argv.quiet;
   return validate({ root: resolve(process.cwd(), argv.cwd) })
     .then((issues) => {
       const count = issues.length;
@@ -50,7 +49,7 @@ const start = function (argv) {
       } else if (count) {
         log.hd(`${count} ${count === 1 ? "issue" : "issues"} found.`);
         log.p(issues.map((error) => `✗ ${error}`));
-      } else if (!quiet) {
+      } else if (!argv.quiet) {
         log.hs("No issues found.");
       }
       process.exit(count ? 1 : 0);

package/bin/arc-whoami.js

@@ -48,7 +48,7 @@ const handler = function ({ json, sw }) {
 
 const start = function (argv) {
   const json = argv.json;
-  const sw = new SpinnerWheel("Checking login... %s");
+  const sw = new SpinnerWheel("Checking... %s");
   return whoami({ handler: handler({ json, sw }) })
     .then((current) => {
       const profile = current?.profile;

package/package.json

@@ -7,8 +7,9 @@
     "arc-inspect": "bin/arc-inspect.js",
     "arc-login": "bin/arc-login.js",
     "arc-logout": "bin/arc-logout.js",
+    "arc-open": "bin/arc-open.js",
     "arc-pack": "bin/arc-pack.js",
-    "arc-predeploy": "bin/arc-predeploy.js",
+    "arc-play": "bin/arc-play.js",
     "arc-validate": "bin/arc-validate.js",
     "arc-whoami": "bin/arc-whoami.js"
   },
@@ -46,7 +47,9 @@
     "./inspect": "./src/cli/inspect.js",
     "./login": "./src/cli/login.js",
     "./logout": "./src/cli/logout.js",
+    "./open": "./src/cli/open.js",
     "./pack": "./src/cli/pack.js",
+    "./play": "./src/cli/play.js",
     "./predeploy": "./src/cli/predeploy.js",
     "./validate": "./src/cli/validate.js",
     "./whoami": "./src/cli/whoami.js"
@@ -58,5 +61,5 @@
   "license": "Apache-2.0",
   "main": "./src/cli/index.js",
   "name": "arcadible",
-  "version": "0.1.18"
+  "version": "0.1.20"
 }

package/src/account.js

@@ -71,15 +71,16 @@ const get = function (onRefresh) {
       }
       throw ex;
     })
-    .then((account) => {
-      if (!account || !account.session) {
+    .then((current) => {
+      const session = current?.session;
+      if (!session) {
         return null;
       }
-      return expired(account.session)
+      return expired(session)
         ? (onRefresh &&
-            onRefresh((renew) => (renew ? refresh(account) : null))) ||
+            onRefresh((renew) => (renew ? refresh(current) : null))) ||
             null
-        : account;
+        : current;
     });
 };
 

package/src/action/inspect/media.js

@@ -0,0 +1,39 @@
+"use strict";
+
+// [declare]
+
+const ART = [
+  "banner",
+  "banner_video",
+  "cover",
+  "cover_video",
+  "icon",
+  "icon_video",
+  "poster",
+  "poster_video",
+  "wordmark",
+  "wordmark_animated",
+];
+
+// [declare]
+
+const MEDIA = ".arcadible";
+
+// [function]
+
+const dehydrate = function (game) {
+  for (const key of ART) {
+    const media = game[key];
+    if (media && typeof media === "object" && media.src) {
+      const index = media.src.indexOf(MEDIA);
+      if (index !== -1) {
+        game[key] = media.src.slice(index);
+      }
+    }
+  }
+  return game;
+};
+
+// [export]
+
+module.exports = { dehydrate };

package/src/action/inspect/tool.js

@@ -6,18 +6,54 @@ const dotProp = require("dot-prop");
 
 // [import]
 
+const api = require("../../api");
+const media = require("./media");
+const phrase = require("../../phrase");
 const project = require("../../parser/project");
 
 // [function]
 
-const inspect = function (proj, key) {
+const select = function (proj, key) {
   return key ? dotProp.get(proj, key, null) : proj;
 };
 
 // [function]
 
-const main = function ({ key, root }) {
-  return project(root).then((proj) => inspect(proj, key));
+const inspect = function (id) {
+  return api
+    .discoverGameBuilds(id, {
+      channel: "production",
+      select: "manifest",
+    })
+    .then((builds) => {
+      if (!builds.length) {
+        throw new Error(phrase.noProductionBuild(id));
+      }
+      const manifest = builds[0]?.manifest ?? {};
+      if (manifest.game) {
+        media.dehydrate(manifest.game);
+      }
+      return manifest;
+    });
+};
+
+// [function]
+
+const main = function ({ game: id, root, selector }, { onInspectFetch }) {
+  const local = !id;
+  if (onInspectFetch && !local) {
+    onInspectFetch({ game: id });
+  }
+  if (local) {
+    return project(root).then((data) => select(data, selector));
+  }
+  if (id === "self") {
+    return project(root)
+      .then(({ game }) => game?.handle ?? game?.id)
+      .then(inspect)
+      .then((data) => select(data, selector));
+  }
+  return inspect(id).then((data) => select(data, selector));
 };
 
 // [export]

package/src/action/open/tool.js

@@ -0,0 +1,24 @@
+"use strict";
+
+// [import]
+
+const project = require("../../parser/project");
+
+// [function]
+
+const open = function (id) {
+  return id ? { page: `/play/${id}` } : null;
+};
+
+// [function]
+
+const main = function ({ game: id, root }) {
+  if (id === "self") {
+    return project(root).then(({ game }) => open(game?.handle ?? game?.id));
+  }
+  return Promise.resolve(open(id));
+};
+
+// [export]
+
+module.exports = main;

package/src/action/play/tool.js

@@ -0,0 +1,42 @@
+"use strict";
+
+// [import]
+
+const api = require("../../api");
+const cfguri = require("../../config/uri");
+const project = require("../../parser/project");
+
+// [function]
+
+const play = function (id, release) {
+  if (!id) {
+    return Promise.resolve(null);
+  }
+  const target = release === "production" ? "" : `:${release}`;
+  const url = `${cfguri.HOST_HTTP_PLAY}/${id}${target}/`;
+  return api
+    .discoverGame(id, { select: "orientation" })
+    .catch(() => null)
+    .then((game) => ({
+      orientation: game?.orientation ?? "natural",
+      url,
+    }));
+};
+
+// [function]
+
+const main = function ({ game: id, release, root }, { onPlayFetch }) {
+  if (onPlayFetch) {
+    onPlayFetch({ game: id });
+  }
+  if (id === "self") {
+    return project(root).then(({ game }) =>
+      play(game?.handle ?? game?.id, release),
+    );
+  }
+  return play(id, release);
+};
+
+// [export]
+
+module.exports = main;

package/src/api.js

@@ -42,6 +42,18 @@ const postUpload = function (form, opts) {
 
 // [function]
 
+const discoverGame = function (id, opts) {
+  return request.get(endpoint(`/discover/games/${id}`), opts);
+};
+
+// [function]
+
+const discoverGameBuilds = function (id, opts) {
+  return request.get(endpoint(`/discover/games/${id}/builds`), opts);
+};
+
+// [function]
+
 const gameBuild = function (id, version, opts) {
   return request.get(endpoint(`/games/${id}/builds/${version}`), opts);
 };
@@ -49,6 +61,8 @@ const gameBuild = function (id, version, opts) {
 // [export]
 
 module.exports = {
+  discoverGame,
+  discoverGameBuilds,
   flow,
   gameBuild,
   postAuthRefresh,

package/src/cli/index.js

@@ -8,7 +8,9 @@ const init = require("./init");
 const inspect = require("./inspect");
 const login = require("./login");
 const logout = require("./logout");
+const open = require("./open");
 const pack = require("./pack");
+const play = require("./play");
 const predeploy = require("./predeploy");
 const validate = require("./validate");
 const whoami = require("./whoami");
@@ -22,7 +24,9 @@ module.exports = {
   inspect,
   login,
   logout,
+  open,
   pack,
+  play,
   predeploy,
   validate,
   whoami,

package/src/cli/inspect.js

@@ -6,8 +6,8 @@ const inspectTool = require("../action/inspect/tool");
 
 // [function]
 
-const main = function (conf) {
-  return inspectTool(conf);
+const main = function ({ handler, ...conf }) {
+  return inspectTool(conf, handler);
 };
 
 // [export]

package/src/cli/open.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const openTool = require("../action/open/tool");
+
+// [function]
+
+const main = function (conf) {
+  return openTool(conf);
+};
+
+// [export]
+
+module.exports = main;

package/src/cli/play.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const playTool = require("../action/play/tool");
+
+// [function]
+
+const main = function ({ handler, ...conf }) {
+  return playTool(conf, handler);
+};
+
+// [export]
+
+module.exports = main;

package/src/config/uri.js

@@ -2,13 +2,17 @@
 
 // [declare]
 
-const SLD = "arcadible";
+const DOMAIN = "arcadible";
+const PROTOCOL = DOMAIN;
 
 // [export]
 
 module.exports = {
-  HOST_HTTP_ACCOUNT: `https://account.${SLD}.com`,
-  HOST_HTTP_API: `https://api.${SLD}.com`,
-  HOST_HTTP_DEVELOPER: `https://developer.${SLD}.com`,
-  HOST_HTTP_WWW: `https://${SLD}.com`,
+  HOST_APP_PLAY: `${PROTOCOL}://play`,
+  HOST_APP_STORE: `${PROTOCOL}://store`,
+  HOST_HTTP_ACCOUNT: `https://account.${DOMAIN}.com`,
+  HOST_HTTP_API: `https://api.${DOMAIN}.com`,
+  HOST_HTTP_DEVELOPER: `https://developer.${DOMAIN}.com`,
+  HOST_HTTP_PLAY: `https://play.${DOMAIN}.com`,
+  HOST_HTTP_WWW: `https://${DOMAIN}.com`,
 };

package/src/config/url.js

@@ -4,14 +4,10 @@
 
 const cfguri = require("./uri");
 
-// [declare]
-
-const SLD = "arcadible";
-
 // [export]
 
 module.exports = {
   GETTING_STARTED: `${cfguri.HOST_HTTP_DEVELOPER}/guides/games/getting-started`,
   LINK: `${cfguri.HOST_HTTP_ACCOUNT}/link`,
-  MANIFEST: `${cfguri.HOST_HTTP_DEVELOPER}/references/${SLD}-manifest`,
+  MANIFEST: `${cfguri.HOST_HTTP_DEVELOPER}/references/arcadible-manifest`,
 };

package/src/parser/readme.js

@@ -95,7 +95,7 @@ const extractDescription = function (doc) {
   const parts = [];
   let node = first.nextSibling;
   while (node && node !== last) {
-    parts.push(node.outerHTML || node.textContent);
+    parts.push(node.outerHTML ?? node.textContent);
     node = node.nextSibling;
   }
   return trimWhitespace(parts.join(""));
@@ -135,7 +135,7 @@ const findReadme = function (root) {
     README.map((file) =>
       pathExists(join(root, file)).then((exists) => (exists ? file : null)),
     ),
-  ).then((files) => files.find(Boolean) || null);
+  ).then((files) => files.find(Boolean) ?? null);
 };
 
 // [function]
@@ -145,7 +145,7 @@ const main = function (root) {
     .then((file) => (file ? readFile(join(root, file), "utf8") : null))
     .then((buf) => (buf === null ? null : parseReadme(buf)))
     .then(deepCompact)
-    .then((game) => ({ game: game || null }));
+    .then((game) => ({ game: game ?? null }));
 };
 
 // [export]

package/src/phrase.js

@@ -74,6 +74,18 @@ const loginFailed = function () {
 
 // [function]
 
+const noGameId = function () {
+  return "No game handle or ID.";
+};
+
+// [function]
+
+const noProductionBuild = function () {
+  return "No production build found.";
+};
+
+// [function]
+
 const notLoggedIn = function () {
   return "Not logged in. Run `arc login` to log in.";
 };
@@ -144,6 +156,8 @@ module.exports = {
   issuesFound,
   loginExpired,
   loginFailed,
+  noGameId,
+  noProductionBuild,
   noVideoMetadata,
   noVideoTrack,
   notLoggedIn,

package/src/prompt/template.js

@@ -2,7 +2,8 @@
 
 // [declare]
 
-const REPO = "arcadible";
+const OWNER = "arcadible";
+const REPO = "starter";
 
 // [export]
 
@@ -10,32 +11,37 @@ module.exports = {
   select: {
     choices: [
       {
-        description: "Plain JavaScript starter.",
-        name: "Default",
-        value: `${REPO}/starter`,
+        alias: "blank",
+        description: "Blank JavaScript starter.",
+        name: "Blank",
+        value: `${OWNER}/${REPO}`,
       },
       {
+        alias: "threejs",
         description: "Three.js starter.",
         name: "Three.js",
-        value: `${REPO}/starter-threejs`,
+        value: `${OWNER}/${REPO}-threejs`,
       },
       {
+        alias: "phaser",
         description: "Phaser starter.",
         name: "Phaser",
-        value: `${REPO}/starter-phaser`,
+        value: `${OWNER}/${REPO}-phaser`,
       },
       {
+        alias: "pixijs",
         description: "PixiJS starter.",
         name: "PixiJS",
-        value: `${REPO}/starter-pixijs`,
+        value: `${OWNER}/${REPO}-pixijs`,
       },
       {
+        alias: "babylonjs",
         description: "Babylon.js starter.",
         name: "Babylon.js",
-        value: `${REPO}/starter-babylonjs`,
+        value: `${OWNER}/${REPO}-babylonjs`,
       },
     ],
-    default: `${REPO}/starter`,
+    default: `${OWNER}/${REPO}`,
     message: "Template",
   },
 };

package/src/schema/game.js

@@ -305,7 +305,7 @@ const zId = function () {
     .string(
       message(field, [
         "Must be defined.",
-        "Run `arc init` to generate a new ID.",
+        "Run `arc init` to generate a new game ID.",
       ]),
     )
     .uuid(message(field, ["Must be a valid UUID."]))

package/src/schema/workflow.js

@@ -71,7 +71,7 @@ const zDeployDir = function (root, { build }) {
       (file) => build || existsCheck(root, file),
       message(field, [
         "Must exist when no build step is defined.",
-        "Run `arc inspect workflow` for details.",
+        "Run `arc inspect` for details.",
       ]),
     );
 };

package/src/util/http.js

@@ -6,10 +6,11 @@ const HttpError = class extends Error {
 
   // [constructor]
 
-  constructor(status, message) {
+  constructor(status, { message, title }) {
     super(message);
-    this.name = "HttpError";
     this.status = status;
+    this.name = title;
+    this.message = `HttpError: ${this.name} (${this.status})`;
   }
 };
 

package/src/util/output.js

@@ -23,8 +23,8 @@ const printJson = function (data) {
 
 // [function]
 
-const printToml = function (data, key = "value") {
-  const field = key.split(".").at(-1);
+const printToml = function (data, key) {
+  const field = (key ?? "value").split(".").at(-1);
   if (data === null) {
     write(`# ${field} = null`);
     return;

package/src/util/rc.js

@@ -33,7 +33,7 @@ const config = function (cmd, argv, option) {
 // [function]
 
 const findRc = function (cmd, subcmd, argv, option) {
-  return rc(cmd, {}, { config: config(cmd, argv, option) })[subcmd] || {};
+  return rc(cmd, {}, { config: config(cmd, argv, option) })[subcmd] ?? {};
 };
 
 // [export]

package/src/util/request.js

@@ -19,7 +19,7 @@ const CLIENT_VERSION = pkg.version;
 const parse = function (resp) {
   return resp.json().then((json) => {
     if (!resp.ok) {
-      throw new HttpError(resp.status, json.data.message);
+      throw new HttpError(resp.status, json.data);
     }
     return json.data;
   });

package/src/util/shell.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const open = require("open");
+
+// [function]
+
+const launch = function (uri) {
+  open(uri).catch(() => {});
+};
+
+// [export]
+
+module.exports = { launch };

package/src/util/video.js

@@ -50,7 +50,7 @@ const readMp4 = function (file) {
   let video = null;
   mp4.onReady = (info) => {
     const track = info.tracks.find((t) => t.video);
-    if (!track || !track.video) {
+    if (!track?.video) {
       error = new Error(phrase.noVideoTrack());
       return;
     }

package/bin/arc-predeploy.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-"use strict";