arcadible 0.1.0 → 0.1.2

package/bin/arc-default.js

@@ -3,10 +3,6 @@
 
 // [import]
 
-const path = require("node:path");
-
-// [import]
-
 const hideBin = require("yargs/helpers").hideBin;
 const yargs = require("yargs/yargs");
 
@@ -14,43 +10,47 @@ const yargs = require("yargs/yargs");
 
 const pkg = require("../package.json");
 
-// [use]
-
-const dirname = path.dirname;
-const join = path.join;
-
 // [declare]
 
 const CMD = "arc";
 
 // [function]
 
-const fixBin = function (argv) {
-  argv[1] = join(dirname(argv[1]), CMD);
-  return hideBin(argv);
-};
-
-// [function]
-
-const start = function (cli) {
+const parse = function (cli) {
   const argv = cli.parse();
   if (!argv._.length) {
     cli.showHelp();
   }
 };
 
-// [start]
-
-start(
-  yargs(fixBin(process.argv))
-    .usage(`${CMD} <command> [options]`)
-    .command("check", "Check workspace for issues.")
-    .command("deploy", "Deploy to Arcadible.")
-    .command("inspect", "Inspect project details.")
-    .command("pack", "Pack for distribution.")
-    .help("help")
-    .alias("help", "h")
-    .version(pkg.version)
-    .alias("version", "v")
-    .strict(),
-);
+// [function]
+
+const main = function (argv) {
+  return parse(
+    yargs(hideBin(argv))
+      .scriptName(CMD)
+      .usage("$0 <command> [options]")
+      .command("deploy", "Deploy to Arcadible")
+      .command("init", "Initialize a project")
+      .command("inspect", "Inspect project metadata")
+      .command("login", "Log in to Arcadible")
+      .command("logout", "Log out of Arcadible")
+      .command("validate", "Validate workspace")
+      .command("whoami", "Show current account")
+      .help("help")
+      .alias("help", "h")
+      .version(pkg.version)
+      .alias("version", "v")
+      .strict(),
+  );
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-deploy.js

@@ -12,15 +12,17 @@ const yargs = require("yargs/yargs");
 
 // [import]
 
-const deploy = require("../src/cmd/deploy");
+const deploy = require("../src/cli/deploy");
+const log = require("../src/util/log");
+const output = require("../src/util/output");
 const pkg = require("../package.json");
 const rc = require("../src/util/rc");
+const validate = require("../src/cli/validate");
 
 // [use]
 
-const dirname = path.dirname;
 const findRc = rc.findRc;
-const join = path.join;
+const print = output.print;
 const resolve = path.resolve;
 
 // [declare]
@@ -31,6 +33,7 @@ const SUBCMD = "deploy";
 // [define]
 
 const conf = {
+  json: false,
   production: false,
   quiet: false,
   ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
@@ -38,49 +41,117 @@ const conf = {
 
 // [function]
 
-const fixBin = function (argv) {
-  argv[1] = join(dirname(argv[1]), CMD);
-  return hideBin(argv);
+const handler = function ({ json, quiet }) {
+  return {
+    onBegin() {
+      if (!json && !quiet) {
+        log.p("Deploying project...");
+      }
+    },
+    onInfo({ level, message }) {
+      if (json || quiet) {
+        return;
+      }
+      switch (level) {
+        case "warn":
+          log.pw(`⚠ ${message}`);
+          return;
+        default:
+          log.p(`• ${message}`);
+      }
+    },
+  };
 };
 
 // [function]
 
-const start = function (cli) {
-  const argv = cli.parse();
-  deploy({
-    pre: !argv.production,
-    preId: "rc",
-    quiet: argv.quiet,
-    root: resolve(process.cwd(), argv.cwd),
-  });
+const start = function (argv) {
+  const json = argv.json;
+  const pre = !argv.production;
+  const quiet = argv.quiet;
+  const root = resolve(process.cwd(), argv.cwd);
+  return validate({ root })
+    .then((issues) => {
+      const valid = !issues.length;
+      if (!valid) {
+        throw new Error("Validate failed. Run `arc validate` for details.");
+      }
+      return deploy({
+        direct: false,
+        handler: handler({ json, quiet }),
+        pre,
+        preId: "rc",
+        root,
+      });
+    })
+    .then((data) => {
+      if (json) {
+        print({ version: data });
+        return;
+      }
+      if (!quiet) {
+        log.p(`✓ ${pre ? "Prerelease" : "Release"} v${data.to} submitted.`);
+        log.hs("Deployed.");
+      }
+    })
+    .catch((ex) => {
+      const message = ex.message;
+      if (json) {
+        print({ error: { message } });
+      } else {
+        log.hd("Deploy aborted.");
+        log.p(message);
+      }
+      process.exit(1);
+    });
 };
 
-// [start]
+// [function]
 
-start(
-  yargs(fixBin(process.argv))
-    .usage(`${CMD} ${SUBCMD} [options]`)
-    .option("production", {
-      alias: "p",
-      default: conf.production,
-      describe: "Deploy to production.",
-      type: "boolean",
-    })
-    .option("quiet", {
-      alias: "q",
-      default: conf.quiet,
-      describe: "Suppress standard output and show only errors.",
-      type: "boolean",
-    })
-    .option("cwd", {
-      alias: "C",
-      default: ".",
-      describe: "Run in the specified path.",
-      type: "string",
-    })
-    .help("help")
-    .alias("help", "h")
-    .version(pkg.version)
-    .alias("version", "v")
-    .strict(),
-);
+const main = function (argv) {
+  return start(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 [options]")
+      .option("production", {
+        alias: "p",
+        default: conf.production,
+        describe: "Deploy to production.",
+        type: "boolean",
+      })
+      .option("json", {
+        alias: "j",
+        default: conf.json,
+        describe: "Format output as JSON.",
+        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-init.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+"use strict";
+
+// [import]
+
+const path = require("node:path");
+
+// [import]
+
+const hideBin = require("yargs/helpers").hideBin;
+const prompts = require("@inquirer/prompts");
+const yargs = require("yargs/yargs");
+
+// [import]
+
+const cfgurl = require("../src/config/url");
+const init = require("../src/cli/init");
+const log = require("../src/util/log");
+const output = require("../src/util/output");
+const pkg = require("../package.json");
+const project = require("../src/prompt/project");
+const rc = require("../src/util/rc");
+const starter = require("../src/prompt/starter");
+
+// [use]
+
+const findRc = rc.findRc;
+const input = prompts.input;
+const print = output.print;
+const relative = path.relative;
+const resolve = path.resolve;
+const select = prompts.select;
+
+// [declare]
+
+const CMD = "arc";
+const SUBCMD = "init";
+
+// [define]
+
+const conf = {
+  force: false,
+  json: false,
+  quiet: false,
+  yes: false,
+  ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
+};
+
+// [function]
+
+const handler = function ({ json, quiet }) {
+  return {
+    onBegin() {
+      if (!json && !quiet) {
+        log.p("Initializing project...");
+      }
+    },
+    onInfo() {},
+  };
+};
+
+// [function]
+
+const start = function (argv) {
+  const json = argv.json;
+  const quiet = argv.quiet;
+  const root = resolve(process.cwd(), argv.cwd);
+  return init({
+    force: argv.force,
+    handler: handler({ json, quiet }),
+    project: argv.project,
+    root,
+    starter: argv.starter,
+  })
+    .then((data) => {
+      const dir = relative(root, data.path);
+      if (json) {
+        print({ project: data });
+        return;
+      }
+      if (!quiet) {
+        log.hsnl("Initialized.");
+        log.h("Next steps:");
+        log.pnl(
+          [data.path === root ? null : `cd ${dir}`, "npm install", "arc deploy"]
+            .filter(Boolean)
+            .join(" && "),
+        );
+        log.h("Getting started:");
+        log.p(cfgurl.GETTING_STARTED);
+      }
+      // degit sometimes hangs
+      process.exit(0);
+    })
+    .catch((ex) => {
+      const message = ex.message;
+      if (json) {
+        print({ error: { message } });
+      } else {
+        log.hd("Init aborted.");
+        log.p(message);
+      }
+      process.exit(1);
+    });
+};
+
+// [function]
+
+const prompt = async function ({ yes, ...argv }) {
+  const opts = { ...argv };
+  if (yes) {
+    opts.project ??= project.input.default;
+    opts.starter ??= starter.select.default;
+    return opts;
+  }
+  if (!argv.project) {
+    opts.project = await input(project.input);
+  }
+  if (!argv.starter) {
+    opts.starter = await select(starter.select);
+  }
+  return opts;
+};
+
+// [function]
+
+const main = function (argv) {
+  return prompt(
+    yargs(hideBin(argv))
+      .scriptName(`${CMD} ${SUBCMD}`)
+      .usage("$0 <project> [options]")
+      .command("$0 <project>", false, (cli) =>
+        cli.positional("project", {
+          describe: "Set the project directory.",
+          type: "string",
+        }),
+      )
+      .option("starter", {
+        alias: "t",
+        describe: "Select a project starter.",
+        type: "string",
+      })
+      .option("yes", {
+        alias: "y",
+        default: conf.yes,
+        describe: "Answer prompts using default values.",
+        type: "boolean",
+      })
+      .option("force", {
+        alias: "f",
+        default: conf.force,
+        describe: "Overwrite an existing directory.",
+        type: "boolean",
+      })
+      .option("json", {
+        alias: "j",
+        default: conf.json,
+        describe: "Format output as JSON.",
+        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(),
+  )
+    .then(start)
+    .catch((ex) => {
+      if (ex && ex.name === "ExitPromptError") {
+        process.exit(0);
+      }
+    });
+};
+
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };

package/bin/arc-inspect.js

@@ -12,15 +12,16 @@ const yargs = require("yargs/yargs");
 
 // [import]
 
-const inspect = require("../src/cmd/inspect");
+const inspect = require("../src/cli/inspect");
+const log = require("../src/util/log");
+const output = require("../src/util/output");
 const pkg = require("../package.json");
 const rc = require("../src/util/rc");
 
 // [use]
 
-const dirname = path.dirname;
 const findRc = rc.findRc;
-const join = path.join;
+const print = output.print;
 const resolve = path.resolve;
 
 // [declare]
@@ -32,55 +33,75 @@ const SUBCMD = "inspect";
 
 const conf = {
   json: false,
-  topic: "manifest",
+  key: "",
   ...findRc(CMD, SUBCMD, process.argv, ["--cwd", "-C"]),
 };
 
 // [function]
 
-const fixBin = function (argv) {
-  argv[1] = join(dirname(argv[1]), CMD);
-  return hideBin(argv);
+const start = function (argv) {
+  const json = argv.json;
+  const key = argv.key;
+  return inspect({
+    key,
+    root: resolve(process.cwd(), argv.cwd),
+  })
+    .then((data) => {
+      print(data, { key, toml: !json });
+    })
+    .catch((ex) => {
+      const message = ex.message;
+      if (json) {
+        print({ error: { message } });
+      } else {
+        log.hd("Inspect aborted.");
+        log.p(message);
+      }
+      process.exit(1);
+    });
 };
 
 // [function]
 
-const start = function (cli) {
-  const argv = cli.parse();
-  inspect({
-    json: argv.json,
-    root: resolve(process.cwd(), argv.cwd),
-    topic: argv.topic,
-  });
+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: "Select a metadata key.",
+          type: "string",
+        }),
+      )
+      .option("json", {
+        alias: "j",
+        default: conf.json,
+        describe: "Format output as JSON.",
+        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(),
+  );
 };
 
-// [start]
-
-start(
-  yargs(fixBin(process.argv))
-    .usage(`${CMD} ${SUBCMD} [options]`)
-    .option("topic", {
-      alias: "t",
-      choices: ["manifest", "manifest:game", "manifest:workflow"],
-      default: conf.topic,
-      describe: "Output details about a topic.",
-      type: "string",
-    })
-    .option("json", {
-      alias: "j",
-      default: conf.json,
-      describe: "Format standard output in JSON.",
-      type: "boolean",
-    })
-    .option("cwd", {
-      alias: "C",
-      default: ".",
-      describe: "Run in the specified path.",
-      type: "string",
-    })
-    .help("help")
-    .alias("help", "h")
-    .version(pkg.version)
-    .alias("version", "v")
-    .strict(),
-);
+// [main]
+
+if (require.main === module) {
+  main(process.argv);
+}
+
+// [export]
+
+module.exports = { main };